Clojureでブログを作った
このブログはClojure製の静的サイトジェネレータCryogenで作った。
動機
現在有給消化中のため暇である。プログラマ的暇潰しが必要だったのだが、ブログを作るのはそれなりに楽しめそうな気がした。
あと、過去にブログサービスを使ってたときブログが長続きしなかった理由に、わたしは物書きじゃあないので簡単にブログが書けるとかいう部分が琴線に触れない、というようなものが根底にあるような気もする🤔
自分で作るならその心配はない。
ついでに折角GitHubのアカウントも持ってるので、GitHub Pagesを使わない手はない。blogのコードをrepoに登録しておけば芝生も青々としてええな！的な。
また別の観点としてブログサービスを選ぶとなった場合、書く記事の内容が技術的なものだったり単なる趣味の話だったり内容がブレると思うので、利用規約に触れて垢バンされるようなサービスは選び辛い。ちょうど良い選択かも知れない。
そこで今回はブログ自体を自分で作ってしまおうと決めた。
因みにClojureを選んだのは個人的な好みである。
静的サイトジェネレータの選定
普通にググって調べようと思ってたけど、いまはこんなのクソ便利なんがあるのね...→StaticGen
LanguageをClojureにしたら3個hitしたのでそれぞれ見てみた。
Misakiは永らくメンテされてないからなし。 CryogenもPerunも、検索したら日本語の情報にhitするのでやりがいに違いはなさそう。 単純に⭐が多いのとBootを使ったことがないというだけの理由でCryogenを使うことにした。
(後知恵だが、ここはもっと慎重に考えた方が良かった)
Cryogenを使ってぶろぐを作ろうぜ
ドキュメントが充実してるので、書いたてることに従うだけで簡単にできた。
出来上がったコードはこちら→My personal blog project
以降に記すコマンド例はPowerShellで実行したものである。筆者はWindows10ユーザなので。
手始めに
Leiningenでテンプレートを作成する。
lein new cryogen blog
Retrieving cryogen/lein-template/0.3.7/lein-template-0.3.7.pom from clojars
Retrieving leinjacker/leinjacker/0.4.2/leinjacker-0.4.2.pom from clojars
Retrieving org/clojure/core.contracts/0.0.1/core.contracts-0.0.1.pom from central
Retrieving org/clojure/pom.contrib/0.0.26/pom.contrib-0.0.26.pom from central
Retrieving org/clojure/core.unify/0.5.3/core.unify-0.5.3.pom from central
Retrieving cryogen/lein-template/0.3.7/lein-template-0.3.7.jar from clojars
Retrieving org/clojure/core.contracts/0.0.1/core.contracts-0.0.1.jar from central
Retrieving org/clojure/core.unify/0.5.3/core.unify-0.5.3.jar from central
Retrieving org/clojure/clojure/1.4.0/clojure-1.4.0.jar from central
Retrieving leinjacker/leinjacker/0.4.2/leinjacker-0.4.2.jar from clojars
Generating fresh 'lein new' Cryogen project.
ブログを動かしてみよう
lein ring server
ブラウザに表示された。OK👍
コンテンツを整理する
わたしの場合はMarkdownで書くのでAsciiDocのディレクトリは消してしまう。サーバ起動中にこれをやると例外が発生する、止めてからやるのが良いだろう。
Remove-Item -Recurse -Path ./resources/templates/ascii
あとsampleで置いてあるpostやaboutを自分用に書き換えるなど。
テーマを作る
themeはデフォでblue, blue_centered, lotus, nucleusの4種類置いてある。lotusを使うとエラーになったけど、これを直すのが目的じゃないので無視した🙈
自分用のテーマとしては何が良いかな？と検討して、お気に入りのSolarizedにしようと決めた。terminalやeditorはSolarized darkを使っているが、ブログはlightでやろうと思う。syntax highlightingについてはいつも通りのdarkを採用することにした。
Solarizedを参考に自分でthemeを作る。元にするのはblue_centeredにした。ブラウザの開発者ツールで見てみてもレスポンシブデザインになってたし、cssのコード量も少なくてシンプルなのがいい。
resources/templates/themesにファイル名solarized_lightでコピって書き換える。
基本は書いたあるルールに沿うけど一部それとなく変える。カラーコードの編集はsassにしたら楽だろうけどコピった元はそうじゃないので、該当する箇所を書き換えるだけに留めた。
Cryogenのsyntax highlightingはhighlight.jsが採用されている。
デフォの24種だと使わないやつもいるので削って、使いそうな言語を足したものをhighlight.jsで作ってダウンロードする。
これは手動でダウンロードして、デフォのhighlight.pack.jsに上書きした。
スタイルはbase.htmlでdefaultが指定されているのでsolarized_darkを選ぶ。ついでにhighlight.jsのversionも9.7から9.13.1へ上げちゃう。
404 Page not foundのときのページがどうやって表示されるのかわからなかったが、GitHub Pagesの機能で提供されるルールに従えば良い様子。
Customizing GitHub Pages / Creating a custom 404 page for your GitHub Pages site
デフォの404ページのスタイルが他のページとぜんぜん違うので、スタイルに合わせておいた。
ページが縦に長くなって垂直スクロールバーが出るとコンテンツのズレが生じるのだけど、これ多分bootstrapに起因する問題か🤔悩ましいが一旦そのままに。
これでおおよそのデザイン面は完成した。
作業中のコードは一旦BitBucketのprivate repoにブチ込んでおいたのだけど、GitHubの無償アカウントでもprivate repoが使えるようになって分ける理由がなくなってしまった...まあよし。
あと、
- Bootstrap3から4に上げたい
- Google Analytics
など残しているが、一旦はコンテンツの公開を優先して後回しにする予定。
GitHub Pagesにうｐる
GitHub Pagesの説明とCryogen - GitHub Pagesを見たらできる。
作るのはユーザーのpageなので、まずkrymtkts.github.ioのrepoを作る。
中身は空で。Licenseの選択もなし。
Cryogenのドキュメントに従い、config.ednのblog-prefixキーの値は空にする。
あとはCryogenが出力したresource/publicを先程作ったrepoのmasterブランチにpushするのみ。
この出力先resource/publicを変更する方法がわからなかったので、krymtkts.github.ioという名前のシンボリックリンクを作って、あたかもそういう名前のフォルダをGitで管理してる感を醸し出して茶を濁した。
New-Item -Value '.\blog\resources\public\' -Path './' -Name 'krymtkts.github.io' -ItemType SymbolicLink
cd krymtkts.github.io
git init
echo "# krymtkts.github.io" >> README.md
git add README.md
git commit -m "First commit"
git add .
git commit -m 'Add contents'
git remote add origin git@github.com:krymtkts/krymtkts.github.io.git
git push -u origin master
これでわたしのブログがpublishされたのであった🎉
めでたしめでたし...
To be continued
で終わらなかった。
これを作りきって、急激にCryogenに興味がなくなってしまった。
結局の所、テンプレートエンジンにSelmerを使ってることで、HTMLやスタイルの編集自体にClojure感の薄さがあってなんか楽しみがないのかなと。最初から予想できそうな結果やけどな🤔
コンテンツ自体はMarkdownで書くし可搬性があるので記事の更新はしつつ、次段階としてPerunで作り直してみようと思う。
破壊と創造こそが人類の本質ですね(違う