一般サイトで使用できる変数

config.yml や任意の Markdown ファイル （.md） の先頭には YAML でデータ変数を定義することができます。

config.ymlファイルに定義できる変数

変数	説明
siteurl	サイトの URL を指定します。サイト URL は http:// または https:// から始まります。末尾には / を含みません。末尾に / を含めた場合は自動的に取り除かれます。タイトルのリンク URL や sitemap.xml、 OGP プロパティ （og:url） で使用されます。
title	タイトルを指定します。タイトルバーに表示されます。指定された値は <title> タグと OGP プロパティ （og:site_name と og:title） にも設定されます。必要に応じて各ページの Markdown ファイルで上書き定義しましょう。
description	サイトの説明を指定します。指定された値は <meta name="description" content="..."> と OGP プロパティ （og:description） に設定されます。各ページの Markdown ファイルで上書き定義しましょう。
copyright	サイトの著作の年を指定します。著作の年はページのフッターに表示されます。
author	サイトの著者名を指定します。著者名はページのフッターに表示されます。指定を省略すると著者名の代わりにメールアドレスが表示されます。
mailto	著者のメールアドレスを指定します。ページフッターに表示される著者名またはメールアドレスの mailto リンクになります。
image	イメージファイルを siteurl からの相対パスで指定します。指定された値は OGP プロパティ （og:image） に設定されます。指定を省略すると og:image は出力されません。

Markdownファイルに定義できる変数

変数	説明
template	Markdown ファイルに適用するテンプレート名を指定します。指定を省略した場合、 default.ftl がテンプレートとして適用されます。テンプレート名の指定では拡張子 .ftl を省略することもできます。テンプレートはルートフォルダーの templates フォルダーから検索されます。

Markdown ファイルの YAML front matter では config.yml で定義されている変数を上書きしたり、 ユーザー独自の変数を定義することができます。title や description などページごとに変えたほうが良いものはなるべく Markdown ファイルで指定するようにしましょう。

自動的に定義される変数

変数	説明
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 が格納されます。${siteurl!}/${path!?url_path} と同等の値が格納されています。この値は URL エンコードされています。
dateModified	ページの最終更新日が格納されます。入力ソースとなった Markdown ファイル、 テンプレートファイル、 CSS ファイルの中で最も新しい日付が最終更新日となります。テンプレートファイルや CSS ファイルを書き換えると、 それを参照している複数のページの最終更新日付が更新されることに注意してください。ページに表示する最終更新日を明確にコントロールしたい場合は ${dateModified} を参照せずにユーザー定義の変数を参照するようにテンプレートを書き換えてください。
contentLastModified	ページコンテンツの最終更新日が格納されます。入力ソースとなった Markdown ファイルの日付が格納されます。テンプレートファイルや CSS ファイルを書き換えてもこの日付は影響を受けません。
_PREVIEW	Catalpa のローカルサーバー機能でプレビューしていることを示すフラグです。プレビュー時は true になります。「名前を付けて保存」 するときは false になります。

戻る