Hugo を org-mode で使う時の注意点

技術情報を GitHub Pages で公開するにあたって、 Hugo を使うことにした。

Hugo は Markdown で静的サイトを構築するツールだが、org-mode にも対応している。 「対応」といっても、当然完全なものではない。

今回 Hugo を org-mode で使ってハマった点を紹介する。

*「TITLE は文書の先頭に書く」

hugo で使用する .org のファイルは、先頭に TITLE を書かなければならない。

.org に記載されている #+TITLE 自体は認識しているようなのだが、 それが先頭に無い限りその記事のタイトルとしては認識されない。

例えば、 emacs では次のように文書内に coding 等を指定することは良くあると思うが、 こうすると Hugo は TITLE を認識してくれない。

# -*- coding:utf-8 -*-
#+TITLE: Hugo を org-mode で使う時の注意点

これが判明するまでに、1 時間以上掛ったよ。。