misc:software:Emacs:mode:howm:応用:howm閲覧システムの構築

初期設定

Sphinxを導入する

• Sphinx-Users.jp — Python製ドキュメンテーションビルダー、Sphinxの日本ユーザ会

生成手順

howm のファイルを収集して日付毎に作成し直す

pandoc を使って github flavored markdown から reStructuredText へと変換する

参考サイト

SphinxをMarkdownを使って記述する | misty-magic.h

pandoc -f markdown_github+definition_lists -t rst -o test.rst test.md

Sphinx で html を生成する

make html

Sphinxの検索システムを強化するよう、searchtools.js にパッチを適用する

参考サイト

Sphinxの全文検索を複合語に強くする | ありえるえりあ

cd _build/html/_static
patch -u searchtools.js < searchtools.js.diff