サイト全体の注記

このサイトについて

このサイトは、 Grav 公式ドキュメント の日本語訳です。

GitHub Pages で静的サイトとして出力しており、 Grav のような動的サイトではないため、一部再現できないところがあります。

個人的には、この公式ドキュメントは、 詳しすぎる と思います。
Grav が、他の CMS と比較して優れているところは、学習曲線のユルさ (ちょっと学べば、ある程度までは動かせるところ) だと思うので、こんなに本格的なドキュメントは、よっぽど困った時だけ参照すれば良いと思います。 (とはいえ、困ったときに頼るところがあるのは、ありがたいことです。公式ドキュメントを書いてくれた方々には感謝しています。)

基本的な動かし方は、さまざまな方の解説サイトやブログ記事がすでにありますし、多少古い記事でも現在とそれほど操作感は変わらないので、特に Grav 初心者のうちは、それらを参照した方が理解しやすいかもしれません。
ある程度慣れてきて、細かい設定などが気になって来たら、この公式ドキュメントが役に立つのではないかと思っています。
そして、このドキュメントに書いていない場合は、 ヘルプ を頼る方法が用意されています。

更新状況

2025-08-12 の GitHub のコミット まで対応しています。

訳文について

未訳部分や分からなかった部分は、英語のままにしています。
訳文のミスなどありましたら、 GitHub などから教えていただけると、大変ありがたいです。

Grav のよくある質問

サイトを日本語化(langをjaに)したい
サイドバーの「設定」を選択し、「サイト」タブの「既定の言語」をjaにしてください。
管理パネルの表示を日本語化したい
サイドバー上部にある自身のアカウントを選択し、遷移先ページの「言語」を「日本語」にしてください。（ただし2025年8月時点で、管理パネルの日本語翻訳の進捗率は57%程度でした）
エディタで改行しても、サイトで改行されない
ただのMarkdownでは、改行に2つのスペースが必要です。スペースを不要にしたい場合は、 Markdown extraを有効にしてください
インストール時にパスワードが設定できない
パスワードの複雑度は、system.pwd_regexで決まっており、初期設定では数字、英大文字、英小文字を含む8文字以上が必要です。
管理パネルの表示項目が多すぎるので、減らしたい
サイドバーの「アカウント」を選択し、新しいユーザーを作り、権限を必要最小限に変更してください。新規アカウントの作成は、画面右上の「追加」からできます。
管理パネル下部の「問題を見つけたら、GitHubに...」を消したい
サイドバーの「プラグイン」を選択後、Admin Panelを選択し、「Show GitHub Link」を無効にしてください。

全ページ一覧

  1. 入門編
    1. Grav とはどんなもの?
    2. システム要件
    3. インストール
    4. チュートリアル
    5. config 設定
    6. フォルダ構造
    7. ヘルプが必要なとき
    8. Gravとプラグインのアップデート
  2. コンテンツ
    1. ページ
    2. ヘッダー / フロントマター
    3. ページ・コレクション
    4. マークダウン構文
    5. ページリンク
    6. 画像リンク
    7. メディア
    8. タクソノミー
    9. モジュラーページ
    10. ルーティング
    11. 多言語サイト
    12. コンテンツタイプ
  3. テーマ
    1. テーマの基本
    2. テーマのチュートリアル
    3. Twig入門
    4. Twigのタグ・フィルタ・関数
      1. カスタムタグ
      2. カスタムフィルタ
      3. カスタム関数
    5. テーマ設定
    6. テーマ変数
    7. アセットマネージャー
    8. デザインのカスタマイズ
  4. プラグイン
    1. プラグインの基本
    2. プラグインのインストール
    3. プラグインのチュートリアル
    4. イベントフック
    5. Gravのライフサイクル
    6. プラグインで Flex を使う
  5. 管理パネル
    1. 導入
    2. ダッシュボード
      1. System 設定
      2. Site 設定
      3. プロフィール
    3. アカウント
      1. ユーザーアカウント
      2. ユーザーグループ
      3. config 設定
      4. パーミッション
    4. ページ
      1. エディタ（Content タブ）
      2. エディタ（Options タブ）
      3. エディタ（Advanced タブ）
      4. エディタ（Security タブ）
      5. config 設定
      6. ページのパーミッション
    5. プラグイン
      1. オプション
    6. テーマ
    7. セキュリティ
      1. 2要素認証
      2. フラッドプロテクション
    8. ツール
    9. 拡張
      1. 管理パネルのイベントフック
    10. 管理パネルのよくある質問
  6. フォーム
    1. ブループリント
      1. リファレンス：ブループリントのform.fields
      2. 具体例：プラグインのブループリント
      3. 具体例：プラグイン設定
      4. 具体例：ページのブループリント
      5. 具体例：ブループリントの設定
      6. ハウツー：ファイルを追加アップロード
      7. 高度なブループリントの機能
    2. フロントエンドのフォーム
      1. リファレンス：フォームオプション
      2. リファレンス：form.fields の一覧
      3. 具体例：コンタクトフォーム
      4. リファレンス：フォームのアクション
      5. ハウツー：モジュラーページ中のフォーム
      6. ハウツー：Ajax送信
  7. CLIコンソール
    1. コマンドラインの導入
    2. Gravコマンド
    3. Plugin コマンド
    4. GPMコマンド
    5. Scriptによるアップデート
  8. 応用編
    1. Flex オブジェクト
      1. 管理パネル
        1. 導入
        2. コンテンツリスト画面
        3. コンテンツエディタ画面
        4. Config 設定画面
      2. Flex オブジェクトを使う
        1. Flex
        2. Flex ディレクトリ
        3. Flex コレクション
        4. Flex オブジェクト
      3. カスタムディレクトリタイプ
        1. ブループリント
    2. パフォーマンスとキャッシュ
    3. デバッグとログ
    4. 環境設定
    5. マルチサイト設定
    6. プラグインの優先度
    7. スケジューラ
    8. バックアップ
    9. Grav の開発
      1. Grav 1.6 未満からのアップデート
      2. Grav 1.6 へのアップデート
      3. Grav 1.7 へのアップデート
    10. YAML構文
    11. グループとパーミッション
    12. サイト URL の変更
  9. Web サーバとホスティング
    1. Web/App Servers
      1. Nginx
      2. Grav ビルトイン Web サーバ
    2. レンタルサーバー
      1. Rochen Web Hosting
      2. WireNine
      3. Crucial Web Hosting
      4. SiteGround
      5. Arvixe
      6. Dreamhost
      7. alwaysdata
    3. VPS Hosting
      1. DigitalOcean
      2. Linode
      3. RoseHosting
      4. Vultr
      5. 共通事項 ubuntu 18
    4. PaaS Hosting
      1. Fortrabbit - PHP hosting
      2. Heroku
      3. Cloudways - Managed Cloud for PHP Hosting
      4. Microsoft Azure
      5. Dokku
    5. DDEV によるローカル開発
    6. Gitによるデプロイ
    7. PHP ビルトインサーバー
    8. WSL(Windows Subsystem for Linux)
  10. レシピ集
    1. 一般的なレシピ
    2. Twigレシピ
    3. プラグインレシピ
    4. 管理パネルレシピ
    5. チュートリアル
      1. ブログを構築する
  11. トラブルシューティング
    1. 404 Not Found
    2. Grav サーバーエラー
    3. 500 Internal Server Error
    4. 403 Forbidden
    5. Invalid Security Token
    6. パーミッション
    7. Proxy 問題
    8. 一般的な問題
    9. .htaccess
  12. サイトの引っ越し
    1. Drupal 7 から Grav への引っ越し
    2. WordPressからGravへの引っ越し
  13. セキュリティ
    1. 概要
    2. 推奨するセキュリティ設定
    3. ユーザー
    4. 開発者
    5. サーバーサイド
    6. レポート
  14. Grav API
  15. ヒントと Tips
    1. ヒントとTips
      1. Blog メタデータ