[ruby-dev:31346] Re: RDoc i18n化パッチ

なかだです。

At Sat, 4 Aug 2007 19:09:46 +0900,
KURODA Hiraku wrote in [ruby-dev:31345]:
> 個人的な必要にかられて、RDocをi18n化してみました。パッチは1.8.6-p36に対
> するものです。

基本的には、こういった機能追加は1.8ではなく1.9でしょう。

> Rubyのソースに次の要領で複数の言語で記述したコメントを書いておいて、
> 
> ----
>   # Print out `hoge'
>   # lang: ja
>   # 「ほげ」を出力
>   def hoge
>      puts "hoge"
>   end
> ----
> 
> これからドキュメントを生成するときに
> 
> *日本語のみ
> *英語のみ
> *日本語と英語両方
> 
> から選べるようになります。

個人的な感想としては
* lang: が視覚的な区切りとして認識しづらい
* 出力されたHTMLのcharsetがiso8859-1のまま
* 異なるエンコーディングはどう扱うべきか
といったあたりが疑問です。

細かいことをいうと、remove_unwanted_langがちょっとまどろっこしい
かな。

    def remove_unwanted_lang(comment)
      dl = @options.lang        # Document Language
      strict = @options.lang_strict
      sl = nil                  # Section Language
      r = []
      comment.each_line do |l|
        if l.sub!(/^(\s*\#?)\s*lang:\s*([a-z]{2})(?=\s|$)/n, '\1')
          sl = $2
          r << l
        elsif sl == dl or !(strict || (dl && sl))
          r << l
        end
      end
      comment.replace(r.join)
    end


-- 
--- 僕の前にBugはない。
--- 僕の後ろにBugはできる。
    中田 伸悦