技術スタック

SSG フレームワーク

→zola

以下特徴：

  • Rust 製の SSG フレームワーク
  • markdown で記事を書くことができる
  • Rust 製だから早い
  • 有志のテーマが充実（個人的感想）
  • 日本語のドキュメントがほぼないのがちょっとマイナス

使用テーマ

→anemone(github repository)

正直、めっちゃおしゃれだと思う。開発者さんに感謝。

経緯

エンジニアとして得た知見を発信したかったため。

以前はdeno/freshを使って markdown からサイトを表示する SSG を自作していた。

シンタックスハイライトや、mermaid.js の組み込みを頑張ったりしていたが、記事のタグ付けの実装あたりで車輪の再発明が辛くなった。

また deno deploy ができて便利だったが、金欠のため課金をやめてしまったのでそのタイミングで zola に切り替えた。

これを書いている段階では公開されてないが、これから github actions で公開する予定。

zola を使ったブログの始め方

基本は公式の手順の通り。

個人的なアドバイスポイントは、

  • zola init の直後に zola serve を行い、続けて theme をセッティングする
    • 公式の通りに進めても、zola serve が意図しないタイミングでこけた
    • チュートリアル完了後に theme を設定しても反映されなかった（なのでzola initの直後に theme を設定する。これだとうまくいく）
      • 俗に言う「おまかん」：お前の環境だけだ！の可能性あり
  1. zola のインストール インストール方法（公式）
  2. zola init myblogs
  3. ここですぐにzola serve
  4. （任意の theme を設定）⇦ ここは任意かも
    1. テーマ一覧から好きなテーマを探す
    2. /themes/以下にリポジトリをクローン
    3. （追加の処理があれば）テーマのリポジトリの指示を実行
  5. 後はチュートリアル通り

その他補足

  • 作成したブログのリポジトリ(zola initしたディレクトリ)をクローンする際には themes 以下をサブモジュール化する

  • サブモジュールが含まれるリポジトリのクローン方法

    1. git submodule init
    2. git submodule update