記事を書く

Grav ページの構造

この項は基本的な情報の概説ですから，興味がなければ飛ばしても構いません。ただ，目を通しておくと Grav での記事の作成・管理が理解しやすくなるかもしれません。

Grav におけるページは，基本的にディレクトリ（フォルダ）ひとつと Markdown ファイルひとつからなります。

このページであれば，01.write-an-article というディレクトリと，その中にある Deafult.md というファイルからなります。".md" という拡張子は Markdown を意味し，データとしてはプレーンテキストです。これが Grav におけるページのファシルシステム上の実体です。文字通りフラットなファイルであることがわかりますね。

ディレクトリ名の先頭にある 01. は Grav が自動的に割り当てたもので，メニュー等での表示順序を決定します。基本的に意識する必要はありません。

Default.md の中は，メタデータと記事本文が入っています。メタデータは以下のようなもので，記事の基本的な性質が記録されています。この部分を frontmatter と言います。

---
title: 記事を書く
---

このデータは，html の <head> 内のメタデータを生成するときなどに利用されます。この記事ではややこしいことは何もしていないのでタイトルがあるだけですが，出力される html に複雑なメタデータを付けたい場合には，以下のように複雑になります。

---
title: Blog Post Title
publish_date: Date the blog post will go live
date: Date the blog post was written
metadata:
    'og:title': Blog Post Title
    'og:type': article
    'og:description': Description of what your blog post is covering.  This will be visible when people share your post on social media.
    'og:url': The URL of the blog post
    'og:site_name': The name of the overall site the blog post belongs to. 
    'og:locale': The language your blog post is written in
    'og:image': The image you reference here will be visible when shared on social media. 
    'twitter:card' : The type of Twitter card that should be used. 
    'twitter:site' : Your Twitter handle
    'twitter:title' : Blog Post Title
    'twitter:description' : Description of what your blog post is covering.  This will be visible when people share your post on social media.
    'twitter:image' : The image you reference here will be visible when shared on social media. 
    'twitter:creator': The twitter handle of the blog post author. 
taxonomy:
    category: [Blog post category]
    tag: [Tag 1, Tag 2, Tag 3, Tag 4]
    author: Author's name
---

Blogging Metadata | Grav Documentation