config
や任意の Markdown ファイル (.md
) の先頭には YAML でデータ変数を定義することができます。
変数 | 説明 |
---|---|
type | ブログサイトを作成する場合は blog を指定します。 |
paginate | 1 つのリストページ (トップページを含む) に表示する記事の数を指定します。 |
siteurl | サイトの URL を指定します。サイト URL は http:// または https:// から始まります。末尾には / を含みません。末尾に / を含めた場合は自動的に取り除かれます。タイトルのリンク URL や sitemap 、 OGP プロパティ (og:url ) で使用されます。 |
icon | アイコンファイルをルートフォルダー (config のあるパス) からの相対パスで指定します。このアイコンはタイトルバーに表示されます。ブラウザーのタブ等に表示される favicon ではありません。(favicon を指定したい場合はルートフォルダーに favicon を配置してください。) |
title | タイトルを指定します。タイトルバーに表示されます。指定された値は <title> タグと OGP プロパティ (og:site_name と og:title ) にも設定されます。必要に応じて各ページの Markdown ファイルで上書き定義しましょう。 |
description | ページの説明を指定します。指定された値は <meta name="description" content="..."> と OGP プロパティ (og:description ) に設定されます。各ページの Markdown ファイルで上書き定義しましょう。 |
author | ページの著者名を指定します。著者名はページのフッターに表示されます。指定を省略すると著者名の代わりにメールアドレスが表示されます。 |
mailto | 著者のメールアドレスを指定します。ページフッターに表示される著者名またはメールアドレスの mailto リンクになります。メールアドレスの指定を省略するとページフッターに著者名もメールアドレスも表示されなくなります。 |
image | イメージファイルを siteurl からの相対パスで指定します。指定された値は OGP プロパティ (og:image ) に設定されます。指定を省略すると og:image は出力されません。 |
ブログサイトでは 1 つの Markdown ファイルが 1 つの記事に対応します。
記事には post
テンプレートファイルが適用されます。template
変数で適用するテンプレートを指定することはできません。
記事は年月日で分類したフォルダー (yyyy
) に配置することを推奨しています。
変数 | 説明 |
---|---|
date | 記事の日付を yyyy-mm-dd の形式で指定します。 |
title | 記事のタイトルを指定します。 |
description | 記事の説明を指定します。 |
categories | 記事のカテゴリーを指定します。複数のカテゴリーを指定する場合は全体を [ で ] で囲み、 各カテゴリーを , で区切ります。カテゴリーに日本語を使う場合は末尾に (...) で英数字のみの表記を繋げてください。これはカテゴリーページの URL として使用されます。たとえば プログラミング(programming) と記述するとカテゴリー名が 「プログラミング」、 カテゴリーページの URL が 「programming」 になります。すべての記事でカテゴリー URL を明示する必要はありません。1 つの記事で プログラミング(programming) というカテゴリー指定がされていれば、 他の記事では プログラミング というカテゴリー指定でも構いません。自動的にカテゴリー URL は 「programming」 になります。新しいカテゴリーを初めて使うときは (...) でカテゴリー URL を定義する、 と覚えておくと良いと思います。カテゴリー名が半角英数字のみの場合も (...) を省略できます。たとえば、 カテゴリー名が 「Java」 の場合に Java(java) と書く必要はありません。Java と書くだけで自動的にカテゴリー URL は java になります。(自動的に小文字への変換がおこなわれます。) |
thumbnail | サイドバーに表示されるサムネイル画像を記事ファイル (.md ) からの相対パスで指定します。指定を省略した場合、 thumbnail.(png|webp|jpg|gif) が検索され見つかればそれを使用します。見つからなければさらに、 image.(png|webp|jpg|gif) を検索し見つかればそれを使用します。それでも見つからなければ、 記事中で最初に出現する画像を使用します。サムネイルは 64x48 に収まるように自動的に外接リサイズして表示されます。意図しない切り抜きを避けたい場合は 64x48 もしくは縦横比 4:3 の画像をサムネイルとして用意してください。 |
image | OGP プロパティ (og:image ) に設定される画像を記事ファイル (.md ) からの相対パスで指定します。指定を省略した場合、 image.(png|webp|jpg|gif) が検索され見つかればそれを使用します。見つからなければ、 記事中で最初に出現する画像を使用します。ここに指定した画像は、 はてなブックマーク、 Twitter、 Facebook 等の SNS から参照されるときに使われます。 |
draft | 変数 draft を定義すると、 この記事が作成中であることを示します。変数名 draft が定義されていればよいので値は指定しなくても構いません。作成中の記事がある場合、 Catalpa は作成中の記事のみを処理するようになります。これは処理時間の短縮するのに効果的です。変数 draft の値を skip にすると、 その記事はスキップされ Catalpa の処理対象となりません。作成中の記事を保留してブログサイト全体を出力したい場合に skip が役に立ちます。 |
変数 | 説明 |
---|---|
baseurl | ベース URL が相対パスで格納されます。ルートフォルダーに配置した Markdown ファイルで ${baseurl} を参照した場合、 値は空文字になります。ルートフォルダーの sub フォルダーに配置した Markdown ファイルで ${baseurl} を参照した場合、 値は ../ になります。たとえば、 ${baseurl}img はどの階層に配置された Markdown ファイルから参照してもルートフォルダーの img を指し示します。 |
path | ページの (ルートフォルダーを基準とした) 相対パスが格納されます。この値は URL エンコードされていません。Freemarker の組み込み機能 ?url_path を使うことで URL エンコードされた文字列を参照できます。先頭に / (スラッシュ) は含まれません。${siteurl} と連結することでページの URL を表わすことができます。${siteurl!}/${path!?url_path} |
url | ページの URL が格納されます。この値は URL エンコードされています。${siteurl!}/${path!?url_path} と同等の値が格納されています。 |
date | ページの最終更新日が格納されます。入力ソースとなった Markdown ファイル、 テンプレートファイル、 CSS ファイルの中で最も新しい日付が最終更新日となります。テンプレートファイルや CSS ファイルを書き換えると、 それを参照している複数のページの最終更新日付が更新されることに注意してください。ページに表示する最終更新日を明確にコントロールしたい場合は ${date を参照せずにユーザー定義の変数を参照するようにテンプレートを書き換えてください。 |
content | ページコンテンツの最終更新日が格納されます。入力ソースとなった Markdown ファイルの日付が格納されます。テンプレートファイルや CSS ファイルを書き換えてもこの日付は影響を受けません。 |
_PREVIEW | Catalpa のローカルサーバー機能でプレビューしていることを示すフラグです。プレビュー時は true になります。「名前を付けて保存」 するときは false になります。 |