ブログを移転した

これまでは約二年ほど はてブロに, メモや学習ログなどを投稿し, 利用させて頂いていたが, $\LaTeX$ の記述においてはてブロ固有の独特な記法を必要とされることがあり, これらの点で 少し不便に感じていたので, 新たにブログを立ち上げこちらに移転することとした. このブログは github pages でホスティングされており, Pelican という Static site generator によって成り立っている. またテーマは, nikhil-theme をフォークして利用させて頂いている.

移転で行った作業

流れとしては, 通常通り, pip で Pelican を導入し, pelican-quickstart によって必要なディレクトリ階層と, 最低限のファイル構成を得て, そこから諸々の設定を行った. Pelican + github pages でブログを管理する事例はとても多く, またドキュメントも充実しており, 特別困ることはなかったが, いくつかテーマの修正, 機能追加などを行った. 本ブログ構造や管理に関する変更の記録は, 本エントリにて随時更新している.

• HTTP コンテンツが入り混じっていたため, これを修正した.
• Pelican の 3.7.0 から PAGES という context variable が pages に変更されており, そのままでは正常にレンダリングされないためこれを修正した.
• favicon の生成を ImageMagick で行い, これを Wiki 通りに設定した.
• コメント機能となる DISQUS を追加した.
• CC ライセンスを追加した.
• 検索機能を追加した.
• 404 ページを追加した.
• pelican_dynamic プラグインを fork し, 少し修正して導入して d3.js が動くようにした.
• テーマ内臓のシンタックスハイライトのスタイルシートが Mathjax の利用するスタイルシートと衝突しており(該当部分), 数式が緑色でレンダリングされてしまっていた. これを, ワークアラウンドとして Mathjax の使うクラスに対してcolor: inherit;を指定し, 修正した¹.
• python-livereload を用いて記事のライブビューができるようにした. バックグラウンドで立ち上がって欲しいので, それら諸々をシェルスクリプトで書いた (以下の gist をサブモジュールとしてマスターブランチに登録している).

• ローカルマシンでのサイト生成をやめ, 特定ブランチへのプッシュをトリガーに Bitbucket Pipeline によってサイト生成, デプロイを行うこととした.

構造

フォークしたテーマと pelican-plugins をマスターブランチのサブモジュールとして置いた. マスターブランチには, ブログ記事の下書きなども貯めようと思っていたため, 特別これを公開する意味はない. そこで, マスターブランチは private リポジトリとして bitbucket に, gh-pages ブランチは github にホスティングして頂くこととした².

• master (非公開なのでここに貼っても特別意味はないが)
• gh-pages

gh-pages への反映は, ghp-import を利用している. 記事を公開しようとするたびに毎度ブランチをチェックアウトするのは面倒なので, Makefile にコマンドを書いておき, そのコマンド一発で記事の生成と gh-pages へのプッシュを行えるようにした. また, bitbucket には標準搭載の CI (bitbucket Pipelines) があるので, master ブランチへのプッシュをトリガーに, 自動で記事の生成テストを行うようにしている.