From: TAKAHASHI Masayoshi <maki@...>
Date: 1999-02-15T19:04:26+09:00
Subject: [ruby-list:12086] Re: Documentation

高橋征義です。

ozawa@aisoft.co.jpさん：
> ドキュメントなんですが、HTMLよりは、そろそろXMLに移行しておくと機械的
> 処理の際など、将来的に幸せかもしれませんね。
> 
> ……という話は何度か出てますが、なかなか実現しませんな^^;

PODも……。

> この手のものでは、最近SmartDocに興味があります。
> <http://www.asahi-net.or.jp/~dp8t-asm/java/tools/SmartDoc/index_ja.html>

これはなんかHTMLとLaTeXの中間みたいな感じですね。Rubyのマニュアルを
書くのであれば、もうちょっと「文書」よりも「データ」寄りに記述していく
方がいいのでは。というか、

http://www.goto.info.waseda.ac.jp/~fukusima/ruby/xml/

↑これでいいんじゃないかと思います。あるいは、このDTDで書いたXMLを
元にして、SmartDocに変換するとか。

# でもサンプルのページ(String.html)はEUCとISO-2022-JPが混ざっている
# のでちとマズいです(^^; ＞福嶋さん

高橋征義 (株式会社アイナック)              Email:maki@inac.co.jp