GitHub Pagesで始める開発ブログ

2023-02-12

始めましてエンジニアの yusei-wy です。 2023年はアウトプットを増やしたいと考えていて開発ブログを再開することにしました。
以前は Hugo を使っていたのですが、数記事で更新が止まってしまったので心機一転新しく始めることに。
最近は Astro などいろいろな静的サイトジェネレーターがありますが、結果としては最近は Rust に興味があるので今回は Zora を選択。

環境構築

1. brew install zola
2. mkdir blog && cd blog
3. zola init

検索

Zola には検索機能がありますが、対応しているのは英語のみ。日本語に対応するには一手間必要。 Japanese full-text search using Elasticlunr in Zola

まず検索機能は無効化して始め必要になったら調べる方針にしました。

config.toml

build_search_index = false

デプロイ

GitHubPages にデプロイする手順

1. public リポジトリを GitHub 上に作成
2. ナビゲーションの [Settings] を選択
3. サイドバーの Code and automation から [Pages] を選択
4. Branch をメインブランチに設定
5. フォルダは docs/ を選択
6. [保存] で公開

以降は選択したブランチに push するだけで最新版が公開される。

コミットメッセージを書くのが面倒であれば以下のような Makefile を書くと make deploy で stage, commit, deploy までできて便利です。

DATETIME = $(shell date "+%Y-%m-%d %H:%M:%S")

deploy:
	make build
	git add .
	git commit -m "deploy $(DATETIME)"
	git push -u origin main