2005-10-31 [長年日記]

[Q3] ドキュメント

ドキュメントを書かなくてはといい続けて早半年。ここまで書けない*1のはやはりツールが合っていないのだろうということで、Wikiで書くのはどうだろうと画策中です。DocBookで書こうとするとどうしても全体の構成を考えてしまったりして書き出せないので、書けるところからばらばらに書いていこうという算段です。

今のWikiに追加するとごちゃごちゃしてしまいそうなのと、Wiki記法よりは書き慣れているRDで書きたいというのもあって、Hikiをインストールしてみました。普通にインストールしてから、RDtoolを置いて、hiki.cgiの先頭行でライブラリを参照できるようにし*2、hikiconf.rbでstyleをrd+にした上で、既存のページをすべて削除したら使えるようになりました。

さて、今度こそ書けるでしょうか。

*1  書かないとも

*2  #!/usr/bin/ruby -I/.../rdtoolというように

[]