ruby-list

Toshです。

In message "[ruby-list:21138] Re: rubyman ? (Re: RD with URL)"
    on 00/03/03, Koji Arai <JCA02266@nifty.ne.jp> writes:
>> ># 以下のようなツールが欲しいとか言って見る。
>
>> 僕もこういう感じのことは考えてました。
>
>まぁ、そもそもそのためにメソッドインデックスを長々と議論して
>いたわけでした。(忘れそうになってました^^;)
>
>道具はほぼ揃ってる(揃えて頂いた^^)ので、後はヤルだけですか。

あと、別ファイルへの参照の細かい部分を決めればだいたい、くらいでしょうか。

>>   * rubymanのためにはRDの置き場所となるディレクトリ(例えば、
>>     /usr/local/share/ruby/rd/とか)が必要で、参照解決のためにも
>>     こういうのはあった方がよさそう。
>
>これはそうですね。
>
>>   * manだとセクションで分かれているけど、rubymanはツリーになってた
>>     ほうがいいかも。
>
>(また引合に出しますが^^;)infoのdirのようなページ(基本はこっ
>ち)とリファレンス用のページを2種類用意すると良いのかな？
>
>rubyman     # ユーザマニュアルのトップページ表示
>rubyman -r  # リファレンスマニュアル用のクラスツリー表示
>
>とか。

ツリーにするとするならどちらかというとInfoのdirよりはportsのREADME.html
みたいな感じを想像します。
  rubyman stdlib/net
でnet/以下のライブラリのRDの一覧、とか。
それでも、階層無視して全てのRDの一覧も必要かな？

>>   * rubymanは単純なコマンドで実現できるのか？(直接画面の表示を
>>     レンダリングしたりはあまりやりたくない(^^;; )
>
>これはよくわからないけれど、とりあえずw3mとか使うんじゃダメ
>です？私はよく rd2 hoge.rd | w3m -T text/html とかやります。
># また何か誤解してるかも。

"rd2 $* | w3m -T text/html"とかなら僕も.bashrcとかで定義して使っていますが、
他のファイルの参照は普通にHTMLのAとか使っていると、それをたどってちゃんと
目的のHTMLが出るようにするにはあらかじめHTMLを全部作っておいて決められた
ディレクトリに置いておくか、もしくはrubymanをCGIにして、とかしないとだめで
すよね。
# 誤解してるの僕の方かも？

>>   * manはソフトウェアをインストールするときに一緒にインストールするけど、
>
>インデックスのことを考えるとそうですね。これはoptional って
>ことで、make install-index とすればrmiを作ってくれるとかでよ
>いかな？このときに、上記のトップページを更新すれば良いですね。
>Texinfoのinstall-infoコマンドみたいに。
>
>>   * そうするとやっぱりRuby Documentation Projectみたいな組織がRuby界の
>>     ありとあらゆるRDを集中管理か！？
>
>「ありとあらゆる」はともかく標準ライブラリのRD化プロジェクト
>は必要でしょうね。私はえーごが書けないのと、あまり人のライブ
>ラリは使わない(使えない)点でお役に立てそうにないのですが。

この最後の方のはあくまで話半分ですが。(^^;;

とりあえずは標準ライブラリ、でしょうねぇ。
英語に関してはruby-talkの方に熱心なrubyistの方がたくさんいらっしゃる
ようなので、どんなにまずい英語だろうと向こうの人達が読める言語で書いて
ありさえすれば向こうで勝手に直してくれるだろうとふっきることに僕は
決めました。(^^;;

>rubymanがあると勝手についてきてくれるんじゃないかなと期待は
>するんですが。ま、少しずつやりましょうね。
>
>とりあえず、この程度でも便利ではある。
>
>#!/usr/local/bin/ruby
>
>rbfile = ARGV.shift
>
>$LOAD_PATH.each do |dir|
>  docdir = File.join(dir, 'doc')
>  htmlpath = File.join(dir, docdir, rbfile) + '.html'
>  rbpath = File.join(dir, rbfile) + '.rb'
>
>  if File.directory? docdir
>    if File.exist? htmlpath
>      exec "w3m #{htmlpath}"
>    end
>    if File.file? rbpath
>      exec "rd2 #{rbpath} > #{htmlpath} && w3m #{htmlpath}"
>    end
>  end
>
>  if File.file? rbpath
>    exec "rd2 #{rbpath} | w3m -T text/html"
>  end
>end

僕は前からこんなのが.bashrcに。
  rdm ()
  {
    rd2 -r rd/rd2html-lib.rb $1 | w3m -T text/html
  }

# ところでFile.joinなんて初めて知りました。
# これ使わないとWinの方で動かないかも？(汗)

---
Tosh
Toshiro Kuwabara

Thread

Prev Next

In This Thread

Prev Next