チュートリアル
前の章の手順どおりに Grav のインストール が完了していることを前提に、ここでは引き続き Grav を操作してみて、使い方に慣れていきましょう。
Grav はデータベースを必要としないため、非常に簡単に操作できますし、 Grav のインストール作業と他の重要なデータソース間で問題を引き起こす心配がありません。
もし何かうまくいかない場合も、たいていの場合、とても簡単に解決できます。
コンテンツの基本
まず、 Grav がコンテンツを保存する場所について理解しましょう。
今後の章 でより詳しく説明しますが、今のところ覚えておいてほしいのは、すべてのユーザーコンテンツは、 Grav の user/pages/ フォルダに保存されるということです。
現在（通常のインストール直後）、その pages フォルダには、2つのフォルダがあり、最初のものが 01.home で、2つ目が 02.typography となっているはずです。
フォルダ名の 01. という部分は、無くても良いのですが、あることでいくつかの便利な機能が提供されます。
まず、フォルダ名の数字部分があることにより、ページの順序が明確に定義されます。
たとえば、01 は 02 の前に来ますが、00 は 01 より前に来ます。
そして同時に、フォルダ名の数字部分があることで、 Grav はそのページをメニューに表示します。
ここで大事な事は、 . までの数字部分は、 URL から削除されます。
ホームページの設定
[!訳注]
ここでの “ホームページ” とは、webサイトのページ一般を指すのではなく、ドメインの一番上にあるトップページことで、たとえばhttps://yoursite.comにアクセスしたときに表示されるページのことです。
user/config/system.yaml ファイルには、その ホームページ の場所を設定するオプションがあります。
言い換えると、あなたのサイト http://yoursite.com のルートフォルダから、 Grav が指し示す場所を設定できます。
インストールした環境でこの設定ファイルを確認すると、すでに /home の別名として指し示されていることが分かると思います。
このドキュメントでは、このままにしておきます。
ページ編集
Grav のページは、 マークダウン 構文で構成されています。
マークダウンは、コンピュータが容易に解析し、 HTML に変換できるプレーンなテキストフォーマット構文です。
基本的な記号（例： 太字、斜体、 見出し、リストなど）を使用することで、 HTML の複雑さを知らなくても、簡単に書けます。
マークダウンの利点は、エラー率の低さと、読みやすさ、覚えやすさ、使いやすさなどにあります。
利用可能な構文の幅広い書き方 については、その例とともにドキュメントを読んでいただくとして、今は先に進みましょう。
トップページをテキストエディタで開いてみます。
トップページを制御しているファイルは、 user/pages/01.home/ というフォルダにある default.md というファイルです。
コンテンツはすべて、 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).マークダウンで書くことがいかに簡単かを理解するために、少し掘り下げてみましょう。
--- という目印の間にあるものは、 ページヘッダ であり、 YAML という、わかりやすいフォーマットで書かれています。
.md ファイルに置かれた、このような設定ブロックは、 YAML フロントマター として知られています。
title: Home
body_classes: title-center title-h1h2このブロックは、そのページの HTML タイトルタグ（ブラウザのタブに表示される文章）を設定します。
テーマ編集では、 page.title 属性から使うこともできます。
このページのさまざまなオプションを設定できる 標準的なヘッダーがいくつかあります 。
他の例として、 menu: 何かのテキスト もあります。メニューの表示名を上書きする設定です。
デフォルトでは、 Grav はタイトルをメニューに表示します。
# Say Hello to Grav!
## installation successful...マークダウンのこの # や ハッシュ記号 構文は、タイトルを意味します。
ひとつの # と半角スペースとテキストは、 HTML の <h1> 見出しに変換されます。
## または2つのハッシュ記号は、 <h2> タグに変換されます。
もちろん、 HTML で使える <h6> タグまで、6つのハッシュ記号： ###### わたしの6段階目の見出し が使えます。
Congratulations! You have installed the **Base Grav Package** that provides a **simple page** and the default **Quark** theme to get you started.これは、 HTML に変換されるとき、普通の <p> タグで包まれる、シンプルな段落です。
** というマークは、太字つまり <strong> タグの（かつては <b> タグの）目印です。
斜体は、 _ マークでテキストを包むことで示せます。
!! 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 プラグインによってカスタムされたマークダウンを使っています。
段落の先頭に、 ! （イクスクラメーションマーク）を、1つ ! から、4つ !!!! まで置くことにより、簡単に注意書きが作れます。
この概要では、マークダウンを書くための、いくつかの重要なポイントを説明しましたが、 より詳細な説明 をぜひチェックし、十分に理解してください。
[!Info]
.mdファイルを保存するときは、UTF8で保存してください。このことで、言語ごとの特殊文字が使えるようになります。
新しいページの追加
Grav で新しいページを作るのは、簡単なことです。次のような単純なステップを踏むだけです：
- pages フォルダ（
user/pages/）に移動して、新しいフォルダを作ります。今回はたとえば、 明示的なデフォルトの順序 を利用して、03.mypageというフォルダにしましょう。 - テキストエディタを起動し、新しいファイルを作成します。そして次のようなサンプルコードを貼り付けます。
--- title: My New Page --- # My New Page! This is the body of **my new page** and I can easily use _Markdown_ syntax here. - このファイルを
user/pages/03.mypage/にdefault.mdとして保存します。このことで、 Grav は、現在のテーマにある default テンプレート（user/themes/quark/templates/default.html.twig）を使って、ページを表示します。 - これで終わりです！ ブラウザをリロードして、ページ上部のメニューに新しいページがあることを確認してください。
メニューの “Typography” の後に、自動的にページが表示されたことでしょう。
メニューの表示を変えたい場合は、 menu: 私のページ という設定をそのページのフロントマターのダッシュマーク（ --- ）の間に追記してください。
おめでとうございます！
Grav で、新しいページができました。
Grav では、もっといろんなことができます。
引き続き読み進めて、より高度な可能性と、より深い特長を理解してください。
[!Info]
この新しいページにアクセスするときに問題が発生した場合、（ Apache サーバの場合のみ）.htaccessファイルが無いか、もしくは.htaccessファイルのRewriteBaseコマンドを編集する必要があるかもしれません。より詳しくは、 トラブルシューティング の章をご覧ください。