ブログ始めました

Pipenv の設定

まずは， Pipenv を使って依存ライブラリを入れてく:

pip install pipenv
pipenv install pelican

Pelican の設定

pipenv run pelican-quickstart

をやって，適当に質問に答えていく．今回は， GitHub Pages にデプロイする前提なのでそういう感じで答えていく．あと， Makefile の方が使いたかったのでそっちを使って，作られた tasks.py は消しといた．ただ作られたやつそのままだとちょっと不便なので， Makefile の以下の箇所は変えた．

1
2
3
4
5
6
7

- PELICAN?=pelican
- GHP_IMPORT?=ghp-import
+ PELICAN?=pipenv run pelican
+ GHP_IMPORT?=pipenv run ghp-import

- GITHUB_PAGES_BRANCH=master
+ GITHUB_PAGES_BRANCH=gh-pages

GitHub へのデプロイのためには， ghp-import というパッケージが必要っぽいのでそれも入れた:

pipenv install ghp-import

後は， https://docs.getpelican.com/en/stable/settings.html を見ながら， pelicanconf.py と publishconf.py を適当にいじった．最終的な結果は，右上の GitHub ボタンからソースに飛べるので適当に見てください．

2つだけ言っておくと，

• pelicanconf.py の内容は選ぶテーマによってかなり書く内容が異なる．後， Pelican の本体とテーマでパラメータ名が異なったりする．なので，パラメータが効かなかった場合，テーマのテンプレートを読みにいかないといけない場合がある．
• make html では pelicanconf.py が， make publish では publishconf.py が参照されてビルドされる．この時， MENUITEMS などに他ページへのリンクを書いたりすると，公開する URL によってはリンクの調整が必要になったりする．今回は /blog/ 以下に公開するので，リンクを /somefile とか書くとずれる．見た感じ Pelican ではこの調整をしてくれないので，今回は publishconf.py で調整を明示的にやるコードを書いた．

後ディレクトリ構成は，基本的に content の下に

• articles: 記事を書いて置く．
• pages: 記事でない静的文書コンテンツを置く．
• asset: 文書でない静的ファイルを置く．

みたいな構成にした (asset 以外は標準の配置) ．後 asset は STATIC_PATHS に指定して Pelican にコピーしてもらう必要があるので，それもやった．

テーマの選別

だいぶ見にくいけど， http://www.pelicanthemes.com/ からテーマが色々見れるっぽい．とりあえず良さそうで開発も活発そうな Flex を使うことにした．

Git submodule を使ってテーマをリポジトリに追加する:

git submodule add https://github.com/alexandrevicenzi/Flex.git themes/Flex

後は， pelicanconf.py に以下を足せばいい:

THEME = './themes/Flex'

https://github.com/alexandrevicenzi/Flex/tree/master/docs を参考に pelicanconf.py を色々修正．後，気になったデザインを修正して， content/asset/custom.css に置いた．これを CUSTOM_CSS パラメータに指定すると Flex テーマが読み込んでくれる．

プラグインの設定

公式プラグインが全て1つのリポジトリで管理されてるっぽい．とりあえずそれを， Git submodule で追加:

git submodule add https://github.com/getpelican/pelican-plugins.git plugins

後は， pelicanconf.py に以下を追加する:

PLUGIN_PATHS = ['plugins']

とりあえず，

• tipue_search
• related_posts

の2つを導入しといた．まあ，機を見て他にも導入したり導入やめたりするかも．

プライバシーポリシーとか諸々の設置

左にある諸々を書いた． pages 以下に置くと自動で認識して表示される．順番を制御したかったので， pelicanconf.py に以下の記述を足した:

PAGES_SORT_ATTRIBUTE = 'source_path'

このパラメータは Flex テーマで処理される．標準で PAGE_ORDER_BY というパラメータもあるんだけど，現状未対応っぽい [4]．後はページを表示したい順に，ファイル名に接頭辞で番号をつければ良い．

Google Analytics とかの導入を見据えて，いくつかのサイトを参考にしながらプライバシーポリシーを設置した．参考にしたのは以下のサイト:

Quora のプライバシー規定

かなりの部分参考にしたって感じ． デザインは結構終わってるけど，かなり詳細に書いてあって好感が持てる内容だった．

https://jp.quora.com/about/privacy

Google のプライバシーポリシー

2番目に参考にした． こちらも内容が丁寧で好感が持てる． ただ， Quora とのユーザ層の違いと多分法務部がかなりちゃんとチェックしてるんだろうけど， ところどころぼかしてあったり，エンジニアの対外的な態度と違う内容 (危険性を説明すべきところを，まるで問題ないように説明している) が書いてあったりする．そこら辺は，さすが大企業だなって感じだった (こなみ) ．

https://policies.google.com/privacy?hl=ja

Qiita のプライバシーポリシー

一応参考にした． ただ，どっちかというと他の2つより規定みたいな感じだった． よく言えばちゃんとしている，悪く言えば説明する気がないみたいな感じ． 正直どこら辺参照したかすら覚えてない．

https://qiita.com/privacy

Google Analytics 的には， Cookie の使用と Google Analytics の使用が明示されていれば良いっぽい [3]． 後は，免責事項とか適当に足したサイトの説明とかも足した．

GitHub Pages の有効化

リポジトリの Settings から gh-pages ブランチの内容を GitHub Pages で表示させるようにした．

後，パーソナルサイトは今の所作る予定がないので， https://mizunashi-mana.github.io/ は https://mizunashi-mana.github.io/blog/ にリダイレクトされるようにした．内容は https://github.com/mizunashi-mana/mizunashi-mana.github.io/blob/ed6aebc132267360a7ccd95717d7b5fe64ec7fa2/index.html にあるけど，単純に refresh でリダイレクト指定して，それでだめなら JavaScript にフォールバックする感じ．

これで， make github すると GitHub Pages にデプロイされるようになる．

Circle CI による自動デプロイ環境

事故を防ぐため， PR で記事を追加していくことにした． master はプロテクトして基本プッシュせず， PR がマージされた時に Circle CI を回すようにした．

Circle CI は https://circleci.com/docs/2.0/language-python/ を参考に Python のバージョンを 3.7 にして，色々書くみたいなことやった．最終的な内容は， https://github.com/mizunashi-mana/blog/blob/master/.circleci/config.yml から見れるので気になったらどうぞ．

後， gh-pages の方はビルドを止めるため，何のタスクもない設定ファイルを追加した:

version: 2
jobs: {}
workflows:
  version: 2

後は， GITHUB_TOKEN 環境変数を既に Circle CI 使ってるプロジェクトから import してくればおk．一から作る場合は， https://github.com/settings/tokens から適当に発行すれば良さそう．