横あるき

変なことを書き綴るサイトです。

5月のOSS Gate東京もくもく会に参加した

OSS Gate東京ミートアップという名前だったイベントを、先月からもくもく会という名前で開催している。1

もくもく会はswamp09さんと相談しながら継続して開催できていて、今回はそんな開催側の2人以外で久々に引き続きリピートで3人参加してくれた。

また、ツイッターでDebianにコントリビュートしたい人が前回参加してくれたことを書いたらhenrichさんが反応して参加してくれた。

Debianがsalsa.debian.orgに移行したあとも、レガシーなシステム(debbugsなど)とどう整合性をもたせるのかなどまだまだこれからの話らしいとか、DebConf18は台湾で気軽に行けるからおすすめとか、

  • 解決すると喜ばれるような問題を見つけよう
  • 適切な相手や場所にコンタクトできるようにしておこう

といった、Debian然りOSSに関わった活動をする上で知っておくとよさそうなことを、実体験を交えて沢山お話をきけた。

もくもく会が終わったあとに秋葉原駅まで行く途中にHUBがあるなあという話から数人でHUBチョムチョム秋葉原店に行こうとしたら、ちょうど開店何周年かで終日ハッピーアワーのため、盛況でお店に入れなかった。

そこからなんやかやでHUB秋葉原店という別のところまで移動して、小一時間くらい雑談した。

クバータを注文した

  1. 4月のふりかえりイベントでミートアップをもくもく会とフォローアップというイベントに分けて開催しようということになった。 [return]

記事の文体をですます調から変えてみます

OSS Gateで知り合ったkoicさんという人がいて、その人のブログがほぼ毎日更新されていて、すごいなあと思っていた。

去年koicさんに「どうしてそんなにこまめに日記を書けるんですか？」という質問をしたんだけど、その際に知ったことや気づいたことは以下のような感じ。

  • 「1回休み」という記事を作って、後から書き換えたり書き換えなかったりする日が結構ある
  • 一回休みじゃないけど1文だけの日もある
  • 文体はあえてですます調にしていない。本人的にはですますのほうが書きやすいけど訓練としてそうしているらしい。

こまめに書いている人のしていることを部分的にでもまねたら、自分も記事を書く頻度が上がるかなあと思ったので、とりあえず文体から変えてみようと思う。

ブログをオレオレCMSからHugoに移行した

移行の経緯

前回の記事から半年経っていますね。何でこんなに間が空いたかを説明できるような納得感のある理由があるかといえば、ないです。

しいて言えば(やっぱりある)、3年前に作って使っていたシェルスクリプトなCMS、site.shでブログを管理していましたが、

  1. データと処理がごちゃごちゃでつらい
  2. 記事執筆用のオレオレフォーマットを拡張したくても面倒くさい
  3. シェルスクリプトで全部やろうとするのが良くないのでは？
  4. 他の言語だとかなり良さげなのが既にあるので作り直すのもな…

という堂々巡りを2年くらい前からやっており、微妙なsite.shの使い勝手の悪さで、記事を書くモチベーションが下がっていました。それで、この度ようやくHugoに移行する決心がついたというわけです。

Hugoを選んだ理由

  • site.shが完成しようかという時に初めて知った静的サイトジェネレータがHugoだった
  • 生成が早そう

という2点がメインです。Go言語が好きと言えるほど使ったことはないです。が、テンプレート処理が標準パッケージなところとか、ありものを組み合わせている感じがして好きです。1

Hugoでサイトを組んでみた印象としては、色々なやり方があって、ベストプラクティスっぽいものはなさそうだなあということです。それだけ作り方に幅があるのは良いことだと思いますが、どこから手を付けたら良いか迷いましたので、ポイントかなというのをいくつか紹介したいと思います。

Hugoでサイトを組んでいた時の気づき

ArchetypesとSection Templatesの関係性

  • contentディレクトリ下の構成でSectionが定まる
  • archetypes/<section>.mdを作るとhugo newでSectionにあわせた雛形を作ってくれる
  • mdにtype: <section>で明示的に指定することもできる。(省略しても良い)

Base(Block)/Partial/Internal TemplatesとShortcodesの関係性

  • Base Templatesは{{ block }}にしたところを{{ define }}で書き換えられる
  • Partial Templatesはlayouts/partials/**.htmlを{{ partial }}で使いまわせる
  • Internal Templatesはあらかじめ用意されたPartial Templatesみたいなもん
  • Internal Templatesをカスタムする場合はここをみてPartial Templatesにすればいい
  • 個人的には{{ block }}と{{ define }}と{{ partial }}はPugのextendsとblockとincludesに似ていると思った
  • Shortcodesは記事の中で凝ったマークアップ構造を使いたい時に使う
  • Lookup Orderを見ながらテンプレートを配置すると良い

configの細かいところ

  • preserveTaxonomyNamesをtrueにしとかないと、タグの文字列がurlizeされる
  • hasCJKLanguageをtrueにしとかないと、.Summaryがスペース区切りの単語数でカウントされて、RSSフィードのdescriptionとかめちゃ長くなる2
  • BlackfridayのplainIDAnchorsをfalseにしとかないと、同じ文字列の見出しが2つあるとidが重複する

最近のHugo(0.32〜)は便利

  • 画像や動画をstaticに置かないといけなかったのが、<記事のディレクトリ>/index.mdで一緒に置けるようになった3
    • これは活用してる
  • 画像の最適化もしてくれるようになった
    • これは活用してない

Hugoに移行した結果

Markdownで記事が書けるようになったのは、前と比較したら良くなったかなと思います。勘違いしてほしくないのは、私はそんなにMarkdownが好きではないということです(面倒くさい人だ)。それでも、リストのネストが簡単に書けるようになったのは良かったですね。

それと同じくらい、Shortcodeが使えるようになったのも良かったです。site.shで記法を拡張したかったのは、任意のHTMLコードを使いまわせるようなところだったので。

今回移行するに当たってHugoのテーマも作成したので、参考になればさいわいです。

https://github.com/knokmki612/hugo-pencil-and-ruler

これで記事を書くペースが上がるといいなぁ…

  1. シェルスクリプトで頑張っていたからそう感じるのかねぇ…いや、シェルスクリプト的にはコマンドを活用すれば良くて、自分がそういう風にうまく書けなかっただけだな… [return]
  2. Hugo のサマリーが大きすぎる件 - awm-Tech [return]
  3. Hugo 0.32から記事と同じ場所に画像を置けるようになった - blog.ton-up.net [return]