Jekyllテーマ自作第2回は設定ファイルの作成です。今回のサイト制作に必要な設定をしていきます。
Jekyllのテーマを自作する 基本編 記事一覧
- Jekyllのテーマを自作する 基本編 – はじめに –
- Jekyllのテーマを自作する 基本編 – 第1回 – 初期データを作成する
- Jekyllのテーマを自作する 基本編 – 第2回 – 設定ファイルを作成する ←いまここ
- Jekyllのテーマを自作する 基本編 – 第3回 – 基本レイアウトを作成する
- Jekyllのテーマを自作する 基本編 – 第4回 – Sass(CSS)でスタイルを作成する
- Jekyllのテーマを自作する 基本編 – 第5回 – titleタグとmeta descriptionを作成する
- Jekyllのテーマを自作する 基本編 – 第6回 – トップページに記事一覧を作成する
- Jekyllのテーマを自作する 基本編 – 第7回 – ページネーションを作成する
- Jekyllのテーマを自作する 基本編 – 第8回 – 記事のフィード(feed.xml)を作成する
- Jekyllのテーマを自作する 基本編 – 第9回(終) – まとめ
設定ファイルで設定をする
第1回で作成した「_config.yml」に以下を記述します。YAMLの記述方法に従って記述します。
YAMLの基本についてはこちらをご覧ください。
上から順を追って説明していきます。
title | サイト名。 |
---|---|
description | サイトの説明文。 |
baseurl | サイトのドメイン以下のパス。本シリーズではなし(空欄)にします。 |
url | サイトの公開URL。基本的にサイト内リンクでは相対パスを使いますが、feed.xmlなどで利用されるため、記述が必要です。 |
author.name | 作者名。今回はフッターのコピーライトの部分に使います。また、author.nameは本シリーズの後半に登場するfeed.xml内でも使われます。 |
author.email | 作者のメールアドレス。author.emailは本シリーズの後半に登場するfeed.xml内でも使われます。 |
author.github | Githubのアカウント名を入力します。フッターのGithubマークからのリンクURLに使います。 |
author.twitter | Twitterのアカウント名を入力します。フッターのTwitterマークのリンクURLに使います。 |
paginate | 記事一覧で、1ページに表示する記事数を設定します。これを設定することで、ページネーションが有効になります。 |
paginate_path | ページネーションに使われるパスを設定します。デフォルトは「page:num」です。今回はデフォルトと同じ値ですが、分かりやすく記述しておきます。 |
sass.style | Sassのコンパイルの出力スタイルを設定します。「expanded」「nested」「compact」「compressed」の4種類があります。デフォルトは「nested」です。たぶん。Sassと聞いてピンとこない方はおググりください。 |
gems | このテーマで使用するgemを指定します。今回はページネーションを作成するための「jekyll-paginate」と、フィードを自動で出力するための「jekyll-feed」を使うので、この2つを記述しておきます。 |
設定した値の取得方法
ここで設定した値は、以降作成する各ページやレイアウト内で、以下のようにして取得し出力できます。
{{ site.設定名 }}
例えば、タイトルを表示する場合は、{{ site.title }}、Twitterアカウント名を取得する場合は{{ site.author.twitter }}となります。
さて、サイトの設定は以上です。次回は、サイトの基本レイアウトを作成していきます。