サイトジェネレーターを Zola に変更

20210612zola rust ssg

サイトジェネレーターを Zola に変更

最近、 rust を再開したので、 Static Site Generator を go 製の hugo から rust 製の zola に変更してみた。

https://www.getzola.org/

hugo のからの引っ越し

zola インストール

初期化

config.toml を hugo 版から zola 版に書き換える。

最低限 base_url。

プレビューしてみる

$ zola serve

一部の記事でエラーが出る。

Reason: There is a link that is missing a URL

どの記事がまずいかはわかるが、何行目とか場所はわからないのかしら。適当になおす。

$ zola check

の方がデバッグ向け。いくつかなおしたら、エラーは出なくなった。

テンプレートを用意する

https://www.getzola.org/documentation/getting-started/overview/

に従って基本的なテンプレートを作成。 index.html, section.html, page.html の3種類のテンプレートがサーチされる。 section.html と page.html は、section のフロントマター、 template, page_template で変更できる。

zola の content 構成

section(フォルダ) に page が所属するという構成みたい。 section とうのは単なるフォルダではなくて、folder/index.md もしくは folder/_index.md をさす。

root => index.html
- section
  - _index.md (セクションになる) => section.html
  - page1.md => page.html
  - page2.md => page.html
  - subsection (_index.md が無いのでセクションでは無い) => レンダリングされない
    - page3.md (orphan page) => page.html
    - page4.md (orphan page) => page.html

セクションに所属しない page は orphan page となり、 section.pages のように列挙することができなくなる。すべてのフォルダに _index.md を配置してセクション化するという設計思想のようだ。

セクションが木構造になっていて、page が leaf になる。