ruby-dev

黒田 拓 と言います。

個人的な必要にかられて、RDocをi18n化してみました。パッチは1.8.6-p36に対
するものです。

Rubyのソースに次の要領で複数の言語で記述したコメントを書いておいて、

----
  # Print out `hoge'
  # lang: ja
  # 「ほげ」を出力
  def hoge
     puts "hoge"
  end
----

これからドキュメントを生成するときに

*日本語のみ
*英語のみ
*日本語と英語両方

から選べるようになります。

詳細は http://www.hinet.mydns.jp/~hiraku/hiki/hiki.cgi?RDoci18n に書いて
おきました。


もし取り込んでいただければ光栄です。

Attachments (1)

rdoc_i18n_1.8.6-p36.patch (2.29 KB, text/x-diff)

diff -ur ruby-1.8.6-p36.orig/lib/rdoc/options.rb ruby-1.8.6-p36/lib/rdoc/options.rb
--- ruby-1.8.6-p36.orig/lib/rdoc/options.rb	2007-02-13 08:01:19.000000000 +0900
+++ ruby-1.8.6-p36/lib/rdoc/options.rb	2007-08-04 18:18:37.000000000 +0900
@@ -94,6 +94,10 @@
   # scan newer sources than the flag file if true.
   attr_reader :force_update
 
+  # Language of Document
+  attr_reader :lang
+  attr_reader :lang_strict
+
   module OptionList
 
     OPTION_LIST = [
@@ -238,6 +242,10 @@
         "name of the current file will be substituted;\n" +
         "if the URL doesn't contain a '\%s', the\n" +
         "filename will be appended to it." ],
+      [ "--lang",          "-l",   "language",
+        "Set language of document."],
+      [ "--lang-strict",   "-L",  nil,
+        "Use ONLY language-specified(or not specified) document."],
     ]
 
     def OptionList.options
@@ -409,6 +417,8 @@
         when "--template"      then @template      = arg
         when "--title"         then @title         = arg
         when "--webcvs"        then @webcvs        = arg
+        when "--lang"          then @lang          = arg
+        when "--lang-strict"   then @lang_strict   = true
 
         when "--accessor" 
           arg.split(/,/).each do |accessor|
diff -ur ruby-1.8.6-p36.orig/lib/rdoc/parsers/parse_rb.rb ruby-1.8.6-p36/lib/rdoc/parsers/parse_rb.rb
--- ruby-1.8.6-p36.orig/lib/rdoc/parsers/parse_rb.rb	2007-02-13 08:01:19.000000000 +0900
+++ ruby-1.8.6-p36/lib/rdoc/parsers/parse_rb.rb	2007-08-04 18:18:37.000000000 +0900
@@ -2343,6 +2343,7 @@
       end
 
       remove_private_comments(comment)
+      remove_unwanted_lang(comment)
     end
 
     def remove_private_comments(comment)
@@ -2350,6 +2351,25 @@
       comment.sub!(/^#--.*/m, '')
     end
 
+    def remove_unwanted_lang(comment)
+      dl = @options.lang || "" # Document Language
+      strict = @options.lang_strict
+      sl = "" # Section Language
+      r = ""
+      comment.each_line do |l|
+        if l=~/^\s*\#?\s*lang:/
+          sl = l[/lang:\s*([a-z]{2})/, 1] || ""
+          r << l[/(^.*?)lang/, 1] << "\n"
+        else
+          if strict
+            r << l if sl==dl
+          else
+            r << l if dl.empty? || sl.empty? || sl==dl
+          end
+        end
+      end
+      comment.replace(r)
+    end
 
 
     def get_symbol_or_name

Thread

Prev Next

In This Thread

Prev Next

[#31320] Import RubyGems to Ruby 1.9 — "NAKAMURA, Hiroshi" <nakahiro@...>

[#31323] Bignum#to_s の Karatsuba 基数変換による高速化 — "Kenta Murata" <muraken@...>

[#31330] Rubyアソシエーション設立のご報告 — Shugo Maeda <shugo@...>

[#31333] Invalid error message by illegal regexp — KIMURA Koichi <kimura.koichi@...>

[#31344] IO.popen with an array in trunk — sheepman <sheepman@...>

[#31345] RDoc i18n化パッチ — KURODA Hiraku <hiraku@...>

[#31349] Array#[]=(pos, length, val) and Array#[]=(range, val) — sheepman <sheepman@...>

[#31351] set_trace_func NULL pointer given — eklerni <eklerni@...>

[#31356] nmake don't have $< macro — KIMURA Koichi <kimura.koichi@...>

[#31357] invalid string for Date.parse — Yukihiro Matsumoto <matz@...>

[#31360] infinite loop at peephole optimization — "Yusuke ENDOH" <mame@...>

[#31361] retry neglects signals — "Yusuke ENDOH" <mame@...>

[#31362] typo in enum.c — Kazuhiro NISHIYAMA <zn@...>

[#31371] simultaneous exceptions dump core — "Yusuke ENDOH" <mame@...>

[#31372] jump in rescue clause in eval dumps core — "Yusuke ENDOH" <mame@...>

[#31373] jump in ensure dumps core — "Yusuke ENDOH" <mame@...>

[#31374] ARGF.each_byte yields a string — Tanaka Akira <akr@...>

[#31376] Re: [ ruby-Bugs-9490 ] Date module, step method, infinite loop if +step+ is 0 should raise an exception? — Urabe Shyouhei <shyouhei@...>

[#31377] Re: [ ruby-Patches-11719 ] add a :passive option to open-uri's open method — Urabe Shyouhei <shyouhei@...>

[#31378] Re: [ ruby-Patches-11954 ] CGI::HTTP_STATUS is incomplete — Urabe Shyouhei <shyouhei@...>

[#31379] Re: [ ruby-Bugs-10646 ] Failure parsing dates returned by WIN32OLE — Urabe Shyouhei <shyouhei@...>

[#31380] Re: [ ruby-Bugs-1823 ] NUM2UINT and rb_num2ull do not rase RangeError for negative Fixnum — Urabe Shyouhei <shyouhei@...>

[#31397] File exists - /tmp/bootstraptest.tmpwd — Tanaka Akira <akr@...>

[#31403] Re: [ ruby-Bugs-3361 ] Ruby 1.8.4 parse errors — Urabe Shyouhei <shyouhei@...>

[#31404] negative allocation size in rb_f_sprintf — Tietew <tietew+ruby-dev@...>

[#31407] [BUG] Stack consistency error (sp: 11, bp: 12) — Tanaka Akira <akr@...>

[#31416] Dir.mktmpdir — Tanaka Akira <akr@...>

[#31417] Process.euid [BUG] Segmentation fault — Tanaka Akira <akr@...>

[#31420] method `method_missing' called on terminated object (0xb7cbd6dc) (NotImplementedError) — Tanaka Akira <akr@...>

[#31424] Re: [ruby-cvs:20177] Re: Ruby:r12931 (trunk): * io.c (argf_close): always close via method. — Nobuyoshi Nakada <nobu@...>

[#31434] LP64: -0x10000000000000001 << -0x80000001 — Tanaka Akira <akr@...>

[#31437] yield [0] to {|*,v|} — Tanaka Akira <akr@...>

[#31438] /bin/sh: BASERUBY@: command not found — Tanaka Akira <akr@...>

[#31439] typo in ChangeLog — Kazuhiro NISHIYAMA <zn@...>

[#31440] yield [1] to {|v,&b| p v } — Tanaka Akira <akr@...>

[#31448] Ruby's (new) Bizarre Operator(s) — Nobuyoshi Nakada <nobu@...>

[#31462] Dir.mktmpdir for 1.8 — Tanaka Akira <akr@...>

[#31464] lambda {|a| p a }.call(1,2) — Tanaka Akira <akr@...>

[#31470] nested fiber invocation — Yukihiro Matsumoto <matz@...>

[#31472] lambda {|&b|}.call(3) — Tanaka Akira <akr@...>

[#31473] setter of $! — SASADA Koichi <ko1@...>

[#31475] lambda {|(v0,v1),v2|}.call([1],2) — Tanaka Akira <akr@...>

[#31480] trunk/test/ruby/test_proc.rb:127 — SASADA Koichi <ko1@...>

[#31481] trunk/test/test_time.rb — SASADA Koichi <ko1@...>

[#31492] SEGV: def m() yield [] end; m(&lambda {|*v| p v}) — Tanaka Akira <akr@...>

[#31502] {|(a,a)|} — Tanaka Akira <akr@...>

[#31507] {|(a)|} assigns outer local variable — Tanaka Akira <akr@...>

[#31511] trunk/test/ruby/test_eval.rb — SASADA Koichi <ko1@...>

[#31522] a, a = 1, 2 — Tanaka Akira <akr@...>

[#31525] いくつかのバグ報告と提案(5点) — eklerni <eklerni@...>

[#31531] 多重代入の*とto_ary — eklerni <eklerni@...>

[#31539] strtod の精度 — Satoshi Nakagawa <snakagawa@...>

[#31547] duck typing — "NAKAMURA, Hiroshi" <nakahiro@...>

[#31561] ignore exception message — SASADA Koichi <ko1@...>

[#31566] test_set and test_hash — Tanaka Akira <akr@...>

[#31576] test/win32ole — SASADA Koichi <ko1@...>

[#31583] Fiber reviesed — SASADA Koichi <ko1@...>

[#31592] [BUG] iseq_compile_each: unknown node: NODE_METHOD — Tanaka Akira <akr@...>

[#31603] benchmark of loops — SASADA Koichi <ko1@...>

[#31609] catch without a tag argument — Tanaka Akira <akr@...>

[#31625] IO.sysdup2, IO.sysdup, IO.sysclose — Tanaka Akira <akr@...>

[#31643] Re: [ruby-list:43915] Re: Hashへの生成順は保障されないのか？ — SASADA Koichi <ko1@...>

[#31646] Re: [ruby-cvs:20498] Ruby:r13261 (trunk): * encoding.c: provide basic features for M17N. — Tanaka Akira <akr@...>

[#31650] ungetc — Tanaka Akira <akr@...>

[#31651] rb_enc_mbclen — Tanaka Akira <akr@...>

[#31652] test/ruby/ — SASADA Koichi <ko1@...>

[#31659] each_byte and break — Tanaka Akira <akr@...>

[#31661] String#inspectで無限ループ — akira yamada / やまだあきら <akira@...>

[#31663] return in rescue in while in eval dumps core — "Yusuke ENDOH" <mame@...>

[#31665] String#slice! — WATANABE Tetsuya <Tetsuya.WATANABE@...>

[#31666] IndexError in rindex — Nobuyoshi Nakada <nobu@...>

[#31669] Re: [ ruby-Bugs-11882 ] recursive invokation of garbage_collect() in dlptr_free() — Urabe Shyouhei <shyouhei@...>

[#31671] Array#slice! — Satoshi Nakagawa <snakagawa@...>

[#31672] -Kオプションとparser->encの関係 — akira yamada / やまだあきら <akira@...>

[#31674] flush_register_windowsの"ta 0x83" — akira yamada / やまだあきら <akira@...>

[#31678] optimize empty hash space — Tanaka Akira <akr@...>

[#31679] ruby_1_8_5 undefined reference to `_RSTRING_PTR' — Masaki Suketa <masaki.suketa@...>

[#31682] mkmf.rb:310:in `method_missing': undefined method `quote' for nil:NilClass — akira yamada / やまだあきら <akira@...>

[#31684] WindowsのUnicodeファイル名 — OJ <oj@24.am>

[#31687] instance variable as formal argument — "Yusuke ENDOH" <mame@...>

[#31351] set_trace_func　NULL pointer given — eklerni <eklerni@...>