Zolaに入門した

最終更新日:

2019-12-11

このサイトはZolaで作っているのですが，日本語の情報がほとんどなく少し苦労しました。後でまた振り返る事ができるよう，メモを残しておきます。

Tips

もっと読むの実装

Zolaではpage.summaryでそのページの概要を取得することができます。page.summaryにはfront-matter(+++で囲まれたところ)との間の要素が文字列として格納されています。下の例だと"このサイト〜おきます。" のところがpage.summaryになります。

+++
title = "Zolaに入門した"
date = 2019-12-11
+++

このサイトは[Zola](https://www.getzola.org/)で作っているのですが，日本語の情報がほとんどなく少し苦労しました。後でまた振り返る事ができるよう，メモを残しておきます。

<!-- more -->

## Tips

これを利用すると以下のようにして実装できます。

<h2><a href="{{ page.permalink }}">{{ page.title }}</a></h2>
{{ page.summary | safe }}
<a href="{{ page.permalink }}">続きを読む</a>

以下のように表示されるはずです。(これは私の書いたCSSが適用された状態)

注意点として，ページの頭にタイトルを入れていると，それもpage.summaryに含まれてしまいます。そのため，タイトルは上の例のように，templateファイル側で取得・表示するのがいいと思います。

最近の記事一覧の実装

Zolaの組み込み関数に，get_sectionというものがあります。実際に作ってみたものが下の例で，引数にそのセクションの_index.mdファイルへのパスを渡し，セクションの情報を取得。それをsection変数に格納し，その中のページ情報をfor文を回して取得・表示する。といった流れになっています。

# content/blog/post.md
+++
title = "Zolaに入門した"
+++

<h3>最近の記事</h3>
<nav>
    {% set section = get_section(path="blog/_index.md") %}
    {% for page in section.pages %}
        <p><a href="{{ page.permalink }}">{{ page.title | safe }}</a></p>
    {% endfor %}
</nav>

このように表示されるはずです。

参考になる資料

下記の資料はZolaでのサイト制作の助けになると思います。

Zolaに入門した

Tips

もっと読むの実装

最近の記事一覧の実装

参考になる資料

公式ドキュメント

Example

Tera