Lazy Diary @ Hatena Blog

PowerShell / Java / miscellaneous things about software development, Tips & Gochas. CC BY-SA 4.0/Apache License 2.0

ドキュメンテーション・ツール

rsyncssh と cron の話をまとめたい。HTML をそのまま書くのもバカバカしくなってきたので、適当なツールを探す。

reStructuredText + Docutils
Vine Linux 2.6r4 に入っている Python 1.5 では動かない。
APT(Almost Plain Text) + aptconvert
VineJ2SE を入れて動かす。動くんだけど、日本語が通らない。"conversion error: unsupported encoding 'EUC_JP_LINUX'" だって。LANG=ja_JP.SJIS にして、入力ファイルを nkfSJIS にしたらエラーは出なくなったけど、相変わらず出力は化けっぱなし。
RD + RDtool
日本語についても問題なく動く。但し、画像を挿入するための notation というか directive がない。
Markdown
そもそも HTML にしか吐けない。

なんだか代理戦争 (Python vs. Java vs. Ruby vs. Perl) の様相を呈してきましたよ!

aptconvert を Windows に入れたら上手く動くかなぁ。テストしてみますよ。それから、とっとと Vine 3.1 に移行しろという話でもあるかもしれない。
他にもツールがあったら教えてくださいな。