Hugo で AsciiDoc しようとしてハマった話

環境

• OS: Ubuntu 16.04
• Hugo: v0.37

Hugo は snap install hugo でインストールした．

事象

.adoc ファイルを含むサイトをビルドしようとすると，asciidoctor と asciidoc が見つからないと怒られる．

% hugo
Building sites … ERROR 2018/03/31 17:21:14 asciidoctor / asciidoc not found in $PATH: Please install.
                  Leaving AsciiDoc content unrendered.

ところが，両方とも PATH 上には存在する．

% which asciidoctor
/usr/bin/asciidoctor

% which asciidoc
/usr/bin/asciidoc

原因

Hugo のインストールに Snappy を使っていた (snap install hugo でインストールしていた) のが原因．
Snappy 環境から外部のプログラムを呼び出すことができないらしい．

解決法

おとなしく APT からインストールするか，deb ファイルをダウンロードしてきてインストールする．

Snappy 環境の Hugo の削除

まず，Snappy 環境の Hugo をアンインストールする．

% sudo snap remove hugo

Hugo の入れなおし

楽にインストールしたいなら，APT でインストール:

% sudo apt install hugo

新版を使いたいなら，deb ファイルをダウンロードしてきてインストール:

% wget https://github.com/gohugoio/hugo/releases/download/v0.37.1/hugo_0.37.1_Linux-64bit.deb
% sudo dpkg -i hugo_0.37.1_Linux-64bit.deb

参考文献

• https://discourse.gohugo.io/t/solved-asciidoctor-asciidoc-not-found-in-path/10017/9