基本的な操作方法

インストール に成功したら、続けて設定を触ることで、より快適な環境を手に入れられます。

Grav はデータベースが不要なので、Grav のインストールと他の重要なデータソースとの間で問題を起こすことを意識せず、非常に簡単に作業することができます。何か問題が発生しても、一般的に非常に簡単に回復することが容易です。

コンテンツの基本

まず、Grav がコンテンツを保存する場所についてよく理解しましょう。すべてのユーザー・コンテンツは user/pages/ フォルダに格納されていることを認識しておく必要があります。

インストール直後、/user/pages フォルダには 2 つのフォルダがあり、最初のフォルダは 01.home、2つ目は 02.typography となっています。01. の部分はフォルダのオプションで、便利なものがいくつか用意されています。

ひとつに、ページの順番を明示的に定義することができます。例えば、01. は 02. の前に来て、00. は 01. の前に来る。

もうひとつ、フォルダ名の数字部分は、このページをメニューに表示させることを明示的に Grav に伝えます。注意すべきは、. までの数字部分は、URL から削除されることです。

ホームページ構造

user/config/system.yaml にホームページの場所を設定するオプションの記述があります。言い換えれば、サイト('http://yoursite.com.') のルートを参照するときに Grav が返す場所です。

インストール直後の設定ファイルを確認すると、すでに /home がエイリアスとして設定されていることが分かります。この例ではこのままにしておくのがよいでしょう。

ページ編集

Grav のページは、Markdown で記述されます。Markdown はコンピュータが容易に解析し、HTMLに変換することができるプレーンテキスト形式の構文です。太字、斜体、見出し、リストなどの基本的なテキスト記号で表現するため、複雑なHTMLの知識がなくても簡単に記述することができます。Markdown のメリットは、エラー率が低いこと、読みやすいこと、学習しやすく使いやすいことなどがあります。

使用可能な構文については、ドキュメントで例を挙げて詳しく説明していますが、とりあえずは、これに従ってください。

テキストエディタでホームページを開いてください。ホームページを制御するファイルは user/pages/01.home/ フォルダにあり、default.md と呼ばれています。作成したコンテンツはすべて、Grav インストール内のuser/pages/ フォルダに作成されます。

テキストエディタでページを編集すると、以下のような内容になります。

---
title: Home
body_classes: title-center title-h1h2
---

# Say Hello to Grav!
## installation successful...

Congratulations! You have installed the **Base Grav Package** that provides a **simple page** and the default **Quark** theme to get you started.

!! If you see a **404 Error** when you click `Typography` in the menu, please refer to the [troubleshooting guide](https://learn.getgrav.org/troubleshooting/page-not-found).

Markdown で書くことがいかに簡単であるかを理解してもらうために、これを少し分解してみましょう。ファイルの先頭にある --- の間に書かれているのがページヘッダーで、これは YAML というわかりやすいフォーマットで書かれています。.md ファイルの中にあるこの設定ブロックは一般的に YAML Front Matter と呼ばれています。

title: Home
body_classes: title-center title-h1h2

この YAML Front Matter には、ページのHTMLタイトルタグ（ブラウザのタブに表示されるテキスト）を設定します。また、テーマから page.title でアクセスすることもできます。このページにはいくつかの標準的なヘッダーがあり、さまざまなオプションを設定できます。他の例としては、menu: Something があります。メニューにページ名を表示するためのテキストを上書きすることができるものです。デフォルトでは、Grav はメニューの値としてタイトルを使用します。

# Say Hello to Grav!
## installation successful...

# はタイトルを示します。# はHTMLの <h1> タグに変換されます。## は <h2> タグに変換されます。もちろん、これはHTMLで有効な <h6> タグまで対応でき、###### は、H6 になります。

Congratulations! You have installed the **Base Grav Package** that provides a **simple page** and the default **Quark** theme to get you started.

これは単純な段落で、HTML に変換すると通常の <p> タグに包まれることになります。** は太字を表し、HTMLでは <strong> (以前は <b> だった) 。斜体は、_ で囲むことで表示されます。
このセクションでは、同梱のmarkdown-noticesプラグインで提供されるカスタムマークダウン機能を使用しています。この機能により、テキストの段落の前に、!(エクスクラメーションマーク) シンボルを前置することで、簡単な通知を作成することができます。

!! If you see a **404 Error** when you click `Typography` in the menu, please refer to the [troubleshooting guide](https://learn.getgrav.org/troubleshooting/page-not-found).

このセクションでは、markdown-notices plugin で提供されるカスタム・マークダウン機能を使用します。この機能により、テキストの段落の前に、! から !!!! を前置することで、簡単な通知を作成することができます。

この概要は、Markdown を書くためのいくつかの重要なポインタを提供するものですが、より詳細な説明を確認することで、より深く理解することができます。

新しいページを追加する

Grav で新しいページを作成するのは簡単です。以下の簡単なステップを踏むだけです。

1. user/pages/ フォルダーに移動し、新しいフォルダーを作成します。この例では、明示的なデフォルトの順序を使用するために、フォルダ名を 03.mypage とします。
2. テキストエディタを起動し、新規ファイルを作成し、以下のサンプルコードを貼り付けてください。

---
title: My New Page
---

# My New Page!

This is the body of **my new page** and I can easily use _Markdown_ syntax here.

3. Save this file in the user/pages/03.mypage/ folder as default.md. This will tell Grav to render the page using the default template in the current theme: user/themes/quark/templates/default.html.twig.
   3.このファイルを user/pages/03.mypage/ フォルダに default.md という名前で保存します。これで、現在のテーマのデフォルトテンプレートである user/themes/quark/templates/default.html.twig を使用してページを表示するように Grav が動作します。
4. 以上で完了です。ブラウザを再読み込みすると、上部メニューに新しいページが表示されます。

このページは、"Typography" メニューの後に自動的に表示されます。メニューに表示される名前を変更したい場合は --- の間に menu.My Page を追加してください。

おめでとうございます！これで Grav で新しいページを作成することに成功しました。Grav でできることはまだまだたくさんあります。さらに高度な機能や詳細な機能について、このまま読み進めてください。