review 0.9.0 → 1.0.0

data/bin/review-index

@@ -96,7 +96,8 @@ def _main
       error_exit '-a/-s option and file arguments are exclusive'
     end
   else
-    source = ReVIEW::ChapterSet.for_argv
+    puts parser.help
+    exit 0
   end
 
   begin

data/bin/review-pdfmaker

@@ -45,86 +45,51 @@ def main
   values = YAML.load_file(yamlfile)
   check_book(values)
   basedir = Dir.pwd
-  path = build_path(values)
+  @path = build_path(values)
   bookname = values["bookname"]
-  Dir.mkdir(path)
+  Dir.mkdir(@path)
 
-  pre = 0
-  body = 0
-  post = 0
-  @pre_str = ""
-  @chap_str = ""
-  @post_str = ""
-  toccount = 2
+  @chaps_filenames = Hash.new{|h, key| h[key] = ""}
 
   if File.exists?("PREDEF")
-    File.open("PREDEF") {|chaps|
-      chaps.each_line {|l|
-        next if l =~ /^#/
-        pre = pre + 1
-        toccount = toccount + 1
-        fork {
-          STDOUT.reopen("#{path}/pre#{pre}.tex")
-          exec("review-compile --target=latex --level=1 #{values["params"]} #{l}")
-        }
-        Process.waitall
-        @pre_str << %Q|\\input{pre#{pre}.tex}\n|
-      }
-    }
+    output_chaps("PREDEF", values)
   end
   if File.exists?("CHAPS")
-    File.open("CHAPS") {|chaps|
-      chaps.each_line {|l|
-        body = body + 1
-        toccount = toccount + 1
-        next if l =~ /^#/
-        fork {
-          STDOUT.reopen("#{path}/chap#{body}.tex")
-          exec("review-compile --target=latex --level=#{values["secnolevel"]} #{values["params"]} #{l}")
-        }
-        Process.waitall
-        @chap_str << %Q|\\input{chap#{body}.tex}\n|
-      }
-    }
+    output_chaps("CHAPS", values)
   end
   if File.exists?("POSTDEF")
-    File.open("POSTDEF") {|chaps|
-      chaps.each_line {|l|
-        next if l =~ /^#/
-        post = post + 1
-        toccount = toccount + 1
-        fork {
-          STDOUT.reopen("#{path}/post#{post}.tex")
-          exec("review-compile --target=latex --level=1 #{values["params"]} #{l}")
-        }
-        Process.waitall
-        @post_str << %Q|\\input{post#{post}.tex}\n|
-      }
-    }
+    output_chaps("POSTDEF", values)
   end
-  values["pre_str"] = @pre_str
-  values["chap_str"] = @chap_str
-  values["post_str"] = @post_str
+  values["pre_str"]  = @chaps_filenames["PREDEF"]
+  values["chap_str"] = @chaps_filenames["CHAPS"]
+  values["post_str"] = @chaps_filenames["POSTDEF"]
 
   values["usepackage"] = ""
   if values["texstyle"]
     values["usepackage"] = "\\usepackage{#{values['texstyle']}}"
   end
 
-  copy_images("./images", "#{path}/images")
-  copyStyToDir(Dir.pwd + "/sty", path)
+  copy_images("./images", "#{@path}/images")
+  copyStyToDir(Dir.pwd + "/sty", @path)
+  copyStyToDir(Dir.pwd, @path, "tex")
 
-  Dir.chdir(path) {
+  Dir.chdir(@path) {
     template = get_template(values)
     File.open("./book.tex", "wb"){|f| f.write(template)}
    
     ## do compile
+    enc = values["params"].to_s.split(/\s+/).find{|i| i =~ /\A--outencoding=/ }
+    kanji = enc ? enc.split(/=/).last.gsub(/-/, '').downcase : 'utf8'
     fork {
-      exec("platex book.tex")
+      exec("platex -kanji=#{kanji} book.tex")
     }
     Process.waitall
     fork {
-      exec("platex book.tex")
+      exec("platex -kanji=#{kanji} book.tex")
+    }
+    Process.waitall
+    fork {
+      exec("platex -kanji=#{kanji} book.tex")
     }
     Process.waitall
     fork {
@@ -132,8 +97,24 @@ def main
     }
     Process.waitall
   }
-  FileUtils.cp("#{path}/book.pdf", "#{basedir}/#{bookname}.pdf")
+  FileUtils.cp("#{@path}/book.pdf", "#{basedir}/#{bookname}.pdf")
+end
 
+def output_chaps(chapsfile, values)
+  File.open(chapsfile) {|chaps|
+    chaps.each_line {|l|
+      next if l =~ /^#/
+      file_id = File.basename(l.chomp.strip,".*")
+      filename = "#{file_id}.tex"
+      fork {
+        STDOUT.reopen("#{@path}/#{filename}")
+        $stderr.puts "compiling #{l}"
+        exec("review-compile --target=latex --level=#{values["secnolevel"]} #{values["params"]} #{l}")
+      }
+      Process.waitall
+      @chaps_filenames[chapsfile] << %Q|\\input{#{filename}}\n|
+    }
+  }
 end
 
 def copy_images(from, to)
@@ -142,16 +123,89 @@ def copy_images(from, to)
     copyImagesToDir(from, to)
     Dir.chdir(to) {
       fork {
-        exec("ebb *.png *.jpg")
+        begin
+          exec("extractbb *.png *.jpg */*.jpg */*.png;extractbb -m *.png *.jpg */*.jpg */*.png")
+        rescue
+          exec("ebb *.png *.jpg */*.jpg */*.png")
+        end
       }
     }
   Process.waitall
   end
 end
 
+def make_titlepage(values, authors)
+  coverfile = values["coverfile"]
+  if coverfile
+    coverfile_sty = coverfile.sub(/\.[^.]+$/, ".tex")
+    if File.exist?(coverfile_sty)
+      titlepage = File.read(coverfile_sty)
+      return titlepage
+    end
+  end
+
+  ## use default titlepage template
+  titlepage = <<EOB
+\\begin{titlepage}
+EOB
+  if values["coverimage"]
+    titlepage += <<EOB
+  \\begin{center}
+    %%%\\mbox{}\\vskip5zw%
+    \\includegraphics[width=\\textwidth,height=\\textheight,keepaspectratio]{./images/#{values["coverimage"]}}
+  \\end{center}
+  \\clearpage
+EOB
+  end
+  titlepage += <<EOB
+\\thispagestyle{empty}
+\\begin{center}%
+  \\mbox{} \\vskip5zw
+   \\reviewtitlefont%
+    {\\Huge #{values["booktitle"]} \\par}%
+    \\vskip 15em%
+    {\\huge
+      \\lineskip .75em
+      \\begin{tabular}[t]{c}%
+        #{authors}
+      \\end{tabular}\\par}%
+    \\vfill
+    {\\large #{values["date"]} 版\\hspace{2zw}#{values["prt"]}　発行\\par}%
+\\vskip4zw\\mbox{}
+  \\end{center}%
+\\end{titlepage}
+EOB
+
+  return titlepage
+end
+
 def get_template(values)
+  dclass = values["texdocumentclass"] || []
+  documentclass =  dclass[0] || "jsbook"
+  documentclassoption =  dclass[1] || "oneside"
+
+  okuduke = ""
+  authors = ""
+
+  if values["aut"]
+    okuduke += "著　者 & #{values["aut"]} \\\\\n"
+    authors = values["aut"]+ "\\vspace*{1zh} 著"
+  end
+  if values["trl"]
+    authors += " \\\\\n"+values["trl"]+ "\\vspace*{1zh} 訳"
+    okuduke += "翻　訳 & #{values["trl"]} \\\\\n"
+  end
+  if values["edt"]
+    okuduke += "編集者 & #{values["edt"]} \\\\\n"
+  end
+  okuduke += <<EOB
+発行所 & #{values["prt"]} \\\\
+EOB
+
+  titlepage = make_titlepage(values, authors)
+
   str = <<EOB
-\\documentclass[oneside]{jsbook}
+\\documentclass[#{documentclassoption}]{#{documentclass}}
 \\usepackage[deluxe]{otf}
 \\usepackage[dvipdfmx]{color}
 \\usepackage[dvipdfmx]{graphicx}
@@ -182,17 +236,21 @@ def get_template(values)
 \\newcommand{\\parasep}{\\vspace*{3zh}}
 \\setlength{\\footskip}{30pt}
 
-\\usepackage[dvipdfm,bookmarks=true,bookmarksnumbered=true,colorlinks=true,%
-            pdftitle={#{values["booktitle"]}},%
-            pdfauthor={#{values["aut"]}}]{hyperref}
-
 %% Bookmarkの文字化け対策（日本語向け）
 \\ifnum 46273=\\euc"B4C1 % 46273 == 0xB4C1 == 漢(EUC-JP)
-  \\AtBeginDvi{\\special{pdf:tounicode EUC-UCS2}}%
+  \\usepackage{atbegshi}%
+  \\AtBeginShipoutFirst{\\special{pdf:tounicode EUC-UCS2}}%
+  %%\\AtBeginDvi{\\special{pdf:tounicode EUC-UCS2}}%
 \\else
-  \\AtBeginDvi{\\special{pdf:tounicode 90ms-RKSJ-UCS2}}%
+  \\usepackage{atbegshi}%
+  \\AtBeginShipoutFirst{\\special{pdf:tounicode 90ms-RKSJ-UCS2}}%
+  %%\\AtBeginDvi{\\special{pdf:tounicode 90ms-RKSJ-UCS2}}%
 \\fi
 
+\\usepackage[dvipdfm,bookmarks=true,bookmarksnumbered=true,colorlinks=true,%
+            pdftitle={#{values["booktitle"]}},%
+            pdfauthor={#{values["aut"]}}]{hyperref}
+
 \\newenvironment{reviewimage}{%
   \\begin{figure}[H]
     \\begin{center}}{%
@@ -241,6 +299,12 @@ def get_template(values)
 \\newcommand{\\reviewlistcaption}[1]{%
   \\medskip{\\small\\noindent #1}\\vspace*{-1.3zw}}
 
+\\newcommand{\\reviewemlistcaption}[1]{%
+  \\medskip{\\small\\noindent #1}\\vspace*{-1.3zw}}
+
+\\newcommand{\\reviewcmdcaption}[1]{%
+  \\medskip{\\small\\noindent #1}\\vspace*{-1.3zw}}
+
 \\newcommand{\\reviewimageref}[1]{%
   図 #1}
 \\newcommand{\\reviewtableref}[1]{%
@@ -264,6 +328,22 @@ def get_template(values)
 \\newcommand{\\reviewmainfont}[0]{%
  }
 
+\\newcommand{\\reviewcolophon}[0]{%
+  \\backmatter
+  \\clearpage}
+\\newcommand{\\reviewappendix}[0]{%
+  \\appendix}
+
+\\makeatletter
+\\def\\maxwidth{%
+  \\ifdim\\Gin@nat@width>\\linewidth
+    \\linewidth
+  \\else
+    \\Gin@nat@width
+  \\fi
+}
+\\makeatother
+
 #{values["usepackage"]}
 
 \\usepackage[T1]{fontenc}
@@ -271,35 +351,10 @@ def get_template(values)
 \\begin{document}
 
 \\reviewmainfont
-
-\\begin{titlepage}
 EOB
-  if values["coverimage"]
-    str += <<EOB
-  \\begin{center}
-    \\mbox{}\\vskip5zw%
-    \\includegraphics[scale=1.0]{./images/#{values["coverimage"]}}
-  \\end{center}
-  \\clearpage
-EOB
-  end
+
+  str += titlepage
   str += <<EOB
-\\thispagestyle{empty}
-\\begin{center}%
-  \\mbox{} \\vskip5zw
-   \\reviewtitlefont%
-    {\\Huge #{values["booktitle"]} \\par}%
-    \\vskip 15em%
-    {\\huge
-      \\lineskip .75em
-      \\begin{tabular}[t]{c}%
-        #{values["aut"]}\\vspace*{1zh} 著
-      \\end{tabular}\\par}%
-    \\vfill
-    {\\large #{values["date"]} 版\\hspace{2zw}#{values["prt"]}　発行\\par}%
-\\vskip4zw\\mbox{}
-  \\end{center}%
-\\end{titlepage}
 
 \\renewcommand{\\chaptermark}[1]{{}}
 \\frontmatter
@@ -315,13 +370,12 @@ EOB
 #{values["chap_str"]}
 
 \\renewcommand{\\chaptermark}[1]{\\markboth{\\appendixname\\thechapter~#1}{}}
-\\appendix
+\\reviewappendix
 
 #{values["post_str"]}
 
 %% okuduke
-\\backmatter
-\\clearpage
+\\reviewcolophon
 \\thispagestyle{empty}
 
 \\vspace*{\\fill}
@@ -333,9 +387,7 @@ EOB
 }
 
 \\begin{tabular}{ll}
-著　者 & #{values["aut"]} \\\\
-編集者 & #{values["edt"]} \\\\
-発行所 & #{values["prt"]} \\\\
+#{okuduke}
 \\end{tabular}
 　\\\\
 \\rule[0pt]{14cm}{1pt} \\\\
@@ -353,7 +405,7 @@ def copyImagesToDir(dirname, copybase)
       if FileTest.directory?("#{dirname}/#{fname}")
         copyImagesToDir("#{dirname}/#{fname}", "#{copybase}/#{fname}")
       else
-        if fname =~ /\.(png|gif|jpg|jpeg|svg)$/i
+        if fname =~ /\.(png|gif|jpg|jpeg|svg|pdf)$/i
           Dir.mkdir(copybase) unless File.exist?(copybase)
           FileUtils.cp "#{dirname}/#{fname}", copybase
         end
@@ -362,11 +414,16 @@ def copyImagesToDir(dirname, copybase)
   }
 end
 
-def copyStyToDir(dirname, copybase)
+def copyStyToDir(dirname, copybase, extname = "sty")
+  unless File.directory?(dirname)
+    $stderr.puts "No such directory - #{dirname}"
+    return
+  end
+
   Dir.open(dirname) {|dir|
     dir.each {|fname|
       next if fname =~ /^\./
-      if fname =~ /\.(sty)$/i
+      if fname =~ /\.(#{extname})$/i
         Dir.mkdir(copybase) unless File.exist?(copybase)
         FileUtils.cp "#{dirname}/#{fname}", copybase
       end

data/bin/review-vol

@@ -29,6 +29,7 @@ def main
   }
 
   part_sensitive = false
+  basedir = nil
   parser = OptionParser.new
   parser.on('-P', '--part-sensitive', 'Prints volume of each parts.') {
     part_sensitive = true
@@ -39,6 +40,9 @@ def main
   parser.on('--outencoding=ENCODING', 'Set output encoding. (UTF-8[default], EUC, JIS, and SJIS)') {|enc|
     @param["outencoding"] = enc
   }
+  parser.on('--directory=DIR', 'Compile all chapters in DIR.') {|path|
+    basedir = path
+  }
   parser.on('--help', 'Print this message and quit') {
     puts parser.help
     exit 0
@@ -51,13 +55,13 @@ def main
     exit 1
   end
 
-  book = ReVIEW.book
+  book = basedir ? ReVIEW::Book.load(basedir) : ReVIEW.book
   ReVIEW.book.param = @param
   if part_sensitive
     sep = ""
     book.each_part do |part|
       print sep; sep = "\n"
-      puts "Part #{part.number}" if part.number
+      puts "Part #{part.number} #{part.name}" if part.number
       part.each_chapter do |chap|
         print_chapter_volume chap
       end

data/doc/format.rdoc

@@ -9,7 +9,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 段落(本文)の間は英語の段落のように1行空けます。ただし、組版に
 まわすときは前処理して1段落を1行に変更してあります。
 
-[例]
+例:
 
     だんらくだんらく〜〜〜
     この行も同じ段落
@@ -22,7 +22,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 章・節・項・段など、見出しは「=」「==」「===」「====」「=====」です。6 レベル以上は使えません。
 
-[例]
+例:
 
     = 章のキャプション
 
@@ -40,22 +40,34 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 節や項の見出しに [column] を追加するとコラムのキャプションになります。
 
-[例]
+例:
 
     ===[column] コンパイラコンパイラ
 
 このとき、「=」と「[column]」は間を開けず、必ず続けて書かなければ
 なりません。空白があってもいけません。
 
+次の節や項を待たずにコラムを終了する場合は、「===[/column]」を記述します。
+
+例:
+
+    ===[column] コンパイラコンパイラ
+
+    コラムの内容
+
+    ===[/column]
+
 == 箇条書き
 
 箇条書き (HTML で言う ul) は「*」で表現します。
-ネストはしません。
+ネストは「**」のように深さに応じて数を増やします。
 
-[例]
+例:
 
   * 第一の項目
+  ** 第一の項目のネスト
   * 第二の項目
+  ** 第二の項目のネスト
   * 第三の項目
 
 箇条書きを書くには、行頭に1つ以上の空白を必ず入れるようにします。
@@ -66,7 +78,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 番号付きの箇条書き (HTML で言う ol) は「1. 〜」「2. 〜」
 「3. 〜」で示します。ネストはしません。
 
-[例]
+例:
 
   1. 第一の条件
   2. 第二の条件
@@ -78,7 +90,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 用語リスト (HTML で言う dl) は「:」と、続く空白で始まる行を使って示します。
 
-[例]
+例:
 
     : Alpha
         DEC の作っていた RISC CPU。
@@ -105,7 +117,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 連番なしリストは「//emlist[キャプション]{ 〜 //}」です。
 //emlistのキャプションは省略できます。
 
-[例]
+例:
 
   //list[main][main()]{    ←「main」が識別子で「main()」がキャプション
   int
@@ -116,7 +128,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
   }
   //}
 
-[例]
+例:
 
   //emlist{
   printf("hello");
@@ -132,7 +144,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 ソースコードを引用する場合、ファイル名が必要です。
 
-[例]
+例:
 
   //source[/hello/world.rb]{
    puts "hello world!"
@@ -145,7 +157,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 連番ありのリスト(list)で自動的に行番号がつきます。
 
-[例]
+例:
 
   //listnum[hello][ハローワールド]{
    puts "hello world!"
@@ -153,7 +165,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 参照方法はlistと変わりません。
 
-[例]
+例:
 
   ..は@<list>{hello}をみてください。
 
@@ -161,7 +173,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 連番なしのリスト(emlist)で自動的に行番号がつきます。
 
-[例]
+例:
 
   //emlistnum{
    puts "hello world!"
@@ -171,7 +183,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 本文中でソースコードを引用して記述します。
 
-[例]
+例:
 
   @<code>{p = obj.ref_cnt}
 
@@ -179,7 +191,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 コマンドラインの操作を示すときは //cmd{ 〜 //} を使います。
 
-[例]
+例:
 
   //cmd{
   $ ls /
@@ -193,16 +205,16 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 代替しているため、ダミーのアスキーアートが入っていることがあり
 ます。この部分は、組版時には単に無視してください。
 
-[例]
+例:
 
   //image[unixhistory][UNIX系OSの簡単な系譜]{
-	      System V 系列
-	      +----------- SVr4 --> 各種商用UNIX（Solaris, AIX, HP-UX, ...）
+  	      System V 系列
+  	      +----------- SVr4 --> 各種商用UNIX（Solaris, AIX, HP-UX, ...）
   V1 --> V6 --|
-	      +--------- 4.4BSD --> FreeBSD, NetBSD, OpenBSD, ...
-	      BSD 系列
-
-		    --------------> Linux
+  	      +--------- 4.4BSD --> FreeBSD, NetBSD, OpenBSD, ...
+  	      BSD 系列
+  
+  		    --------------> Linux
   //}
 
 3番目の引数として、画像の倍率・大きさを指定することができます。
@@ -218,17 +230,29 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 //indepimage[ファイル名][キャプション] で番号が振られていない画像ファイルを生成します。キャプションは省略できます。
 
-[例]
+例:
 
   //indepimage[unixhistory2]
 
 同様のことは、//numberlessimageでも使えます。
 
-[例]
+例:
 
   //numberlessimage[door_image_path][扉絵]
 
-※ただし、//indepimageと機能的にかぶっているので、将来は廃止され、//indexpimageに統合される予定です。
+※ただし、//indepimageと機能的にかぶっているので、将来は廃止され、//indepimageに統合される予定です。
+
+== グラフ表現ツールを使った図
+
+//graph[ファイル名][コマンド名][キャプション] で各種グラフ表現ツールを使った画像ファイルの生成ができます。キャプションは省略できます。
+
+例: gnuplotの使用
+
+  //graph[sin_x][gnuplot]{
+      plot sin(x)
+  //}
+
+コマンド名には、「graphviz」「gnuplot」「blockdiag」「aafigure」のいずれかを指定できます。ツールはそれぞれ別途インストールする必要があります。
 
 == 表
 
@@ -240,7 +264,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 付けてください。例えば「.」という内容のカラムは「..」と書きます。
 また、空のカラムは「.」と書けます。
 
-[例]
+例:
 
   //table[envvars][重要な環境変数]{
   名前            意味
@@ -265,7 +289,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 引用は「//quote{ 〜 //}」を使って記述します。
 
-[例]
+例:
 
     //quote{
     百聞は一見に如かず。
@@ -278,7 +302,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 脚注は「//footnote」を使って記述します。
 
-[例]
+例:
 
   パッケージは本書のサポートサイトから入手できます@<fn>{site}。
   各自ダウンロードしてインストールしておいてください。
@@ -294,7 +318,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 コメントが無い場合も定義可能です。
 //bibpaper[site][キャプション]
 
-[例]
+例:
 
   //bibpaper[lins][Lins, 1991]{
   Refael D. Lins. A shared memory architecture for parallel study of
@@ -305,7 +329,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 本文中で参考文献を参照したい場合は次のようにしてください。
 
-[例]
+例:
 
   …という研究が知られています(@<bib>{lins})
 
@@ -314,7 +338,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 リード文は //lead{ 〜 //} で指定します。
 歴史的経緯により//read{ 〜 //} でも使えます。
 
-[例]
+例:
 
   //lead{
   本章ではまずこの本の概要について話し、
@@ -325,7 +349,7 @@ RD や各種 Wiki の文法をとりいれて簡素化しています。
 
 LaTeX の式を挿入するには、//texequation{ 〜 //} を使います。
 
-[例]
+例:
 
   //texequation{
   \sum_{i=1}^nf_n(x)
@@ -345,16 +369,42 @@ LaTeX の式を挿入するには、//texequation{ 〜 //} を使います。
 
 最終結果に出力されないコメントを記述したい場合は「#@#」を使ってください。
 
-[例]
+例:
 
   #@# ここで 1 行あける
 
 また、修正が必要な警告的コメントには#@warn(...)を使ってください。
 
-[例]
+例:
 
   #@warn(あとで書く)
 
+== 生データ行
+
+ReVIEW のタグ範囲を越えて何か特別な行を挿入したい場合、//raw を使います。
+
+例:
+
+  //raw[|html|<div class="special">\nここは特別な行です。\n</div>]
+
+「|ビルダ名|そのまま出力させる内容」という書式です。
+
+ビルダ名には「html」「latex」「idgxml」「top」のいずれかが入り、(複数のビルダにまたがる指定が必要かは別として)「,」で区切って複数指定することも可能です。
+「バックスラッシュ+n」は改行に変換されます。
+該当のビルダを使用しているときのみ、内容が出力されます。
+
+例:
+
+  (HTMLビルダの場合:)
+  <div class="special">
+  ここは特別な行です。
+  </div>
+
+  (ほかのビルダの場合は単に無視されて何も出力されない)
+
+//raw およびこの後に紹介する @<raw> インラインタグは、誤った内容を入れると
+構造化文書を容易に破壊し得ることに注意してください。
+
 == その他の文法
 
 ReVIEW は任意のブロックを追加可能なので、本によって専用ブロックを
@@ -389,7 +439,7 @@ ReVIEW は任意のブロックを追加可能なので、本によって専用
 @<icon>{samplephoto}:: インライン画像。
 @<uchar>{2460}:: Unicode文字の出力。引数は16進数で指定する。
 @<href>{http://www.google.com/}:: リンク。URLで指定できる
-@<raw>{@<foo>{bar\}}:: そのまま出力する。「}」は「\」でエスケープする。
+@<raw>{|ビルダ名|<span>★</span>}:: そのまま出力する。「}」は「バックスラッシュ+}」でエスケープする。ビルダ名は「html」「latex」「idgxml」「top」のいずれかで、「,」で区切って複数指定することも可能。該当のビルダを使用時のみ、出力される。内容に「バックスラッシュ+n」を入れると改行に変換される。
 
 == 著者用タグ (プリプロセッサ命令)
 
@@ -409,13 +459,7 @@ ReVIEW は任意のブロックを追加可能なので、本によって専用
 CHAPSファイルが置かれているディレクトリに layouts/layout.erb
 を置くとその html を ERB で評価します。
 
-[例]
-
-  <html>
-    <head>
-      <title><%= title %></title>
-    </head>
-[例]
+例:
 
   <html>
     <head>
@@ -432,7 +476,7 @@ CHAPSファイルが置かれているディレクトリに layouts/layout.erb
 PART ファイルに定義してください。
 PART ファイルは CHAPS の部わけと対応しています。
 
-[例]
+例:
 
 CHAPS:
   intro.re
@@ -451,13 +495,13 @@ PART:
 見出し番号と見出しを生成します。
 見出しの階層は"|"で区切って指定してください。
 
-[例]
+例:
 
   @<hd>{はじめに|まずわ}
 
 他の章を参照したい場合は、先頭に章のidを指定してください。  
 
-[例]
+例:
 
   @<hd>{preface|はじめに|まずわ}
 
@@ -468,10 +512,31 @@ Web ハイパーリンクを記述するには、リンクに @<href>、アン
 省略すると URL がそのまま使われます。URL 中に , を使いたいときには、\,
 と表記してください。
 
-[例]
+例:
 
   @<href>{http://github.com/, GitHub}
   @<href>{http://www.google.com/}
   @<href>{#point1, ドキュメント内ポイント}
   @<href>{chap1.html#point1, ドキュメント内ポイント}
   //label[point1]
+
+== 国際化(i18n)
+
+ReVIEWが出力する文字列(「第◯章」「図」「表」など）を、指定した言語に
+合わせて出力することができます。デフォルトは日本語です。
+
+CHAPS などと同じディレクトリに locale.yaml というファイルを用意して、
+以下のように記述します（日本語の場合）。
+
+例:
+
+  locale: ja
+
+既存の表記を書き換えたい場合は、該当する項目を上書きします。
+既存の設定ファイルは lib/review/i18n.yaml にあります。
+
+例:
+
+ locale: ja
+ image: イメージ
+ table: テーブル