review 0.6.0

data/bin/review-index

@@ -0,0 +1,108 @@
+#!/usr/bin/env ruby
+#
+#
+# Copyright (c) 1999-2007 Minero Aoki
+#               2008-2010 Minero Aoki, Kenshi Muto
+#
+# This program is free software.
+# You can distribute or modify this program under the terms of
+# the GNU LGPL, Lesser General Public License version 2.1.
+# For details of the GNU LGPL, see the file "COPYING".
+#
+
+require 'pathname'
+
+bindir = Pathname.new(__FILE__).realpath.dirname
+$LOAD_PATH.unshift((bindir + '../lib').realpath)
+
+require 'review/book'
+require 'review/tocparser'
+require 'review/tocprinter'
+require 'optparse'
+
+def main
+  Signal.trap(:INT) { exit 1 }
+  Signal.trap(:PIPE, 'IGNORE')
+  _main
+rescue Errno::EPIPE
+  exit 0
+end
+
+def _main
+  $KCODE = 'UTF-8' unless defined?(Encoding)
+
+  printer_class = ReVIEW::TextTOCPrinter
+  source = nil
+  upper = ReVIEW::TOCPrinter.default_upper_level
+  param = {
+    "inencoding" => "UTF-8",
+    "outencoding" => "UTF-8"
+  }
+
+  parser = OptionParser.new
+  parser.on('--inencoding=ENCODING', 'Set input encoding. (UTF-8, EUC, JIS, and SJIS)') {|enc|
+    param["inencoding"] = enc
+  }
+  parser.on('--outencoding=ENCODING', 'Set output encoding. (UTF-8[default], EUC, JIS, and SJIS)') {|enc|
+    param["outencoding"] = enc
+  }
+  parser.on('-a', '--all', 'print all chapters.') {
+    begin
+      source = ReVIEW.book
+    rescue ReVIEW::Error => err
+      error_exit err.message
+    end
+  }
+  parser.on('-p', '--part N', 'list only part N.') {|n|
+    source = ReVIEW.book.part(Integer(n)) or
+        error_exit "part #{n} does not exist in this book"
+  }
+  parser.on('-l', '--level N', 'list upto N level (1..4, default=4)') {|n|
+    upper = Integer(n)
+    unless (0..4).include?(upper)  # 0 is hidden option
+      $stderr.puts "-l/--level option accepts only 1..4"
+      exit 1
+    end
+  }
+  parser.on('--text', 'output in plain text (default)') {
+    printer_class = ReVIEW::TextTOCPrinter
+  }
+  parser.on('--html', 'output in HTML') {
+    printer_class = ReVIEW::HTMLTOCPrinter
+  }
+  parser.on('--idg', 'output in InDesign XML') {
+    printer_class = ReVIEW::IDGTOCPrinter
+  }
+  parser.on('--help', 'print this message and quit.') {
+    puts parser.help
+    exit 0
+  }
+  begin
+    parser.parse!
+  rescue OptionParser::ParseError => err
+    $stderr.puts err.message
+    $stderr.puts parser.help
+    exit 1
+  end
+  if source
+    unless ARGV.empty?
+      error_exit '-a/-s option and file arguments are exclusive'
+    end
+  else
+    source = ReVIEW::ChapterSet.for_argv
+  end
+
+  begin
+    printer_class.new(upper, param).print_book source
+  rescue ReVIEW::Error, Errno::ENOENT => err
+    raise if $DEBUG
+    error_exit err.message
+  end
+end
+
+def error_exit(msg)
+  $stderr.puts "#{File.basename($0)}: #{msg}"
+  exit 1
+end
+
+main

data/bin/review-preproc

@@ -0,0 +1,140 @@
+#!/usr/bin/env ruby
+#
+# $Id: review-preproc 3761 2007-12-31 07:20:09Z aamine $
+#
+# Copyright (c) 2010 Minero Aoki, Kenshi Muto
+# Copyright (c) 1999-2007 Minero Aoki
+#
+# This program is free software.
+# You can distribute or modify this program under the terms of
+# the GNU LGPL, Lesser General Public License version 2.1.
+# For details of the GNU LGPL, see the file "COPYING".
+#
+
+require 'pathname'
+
+bindir = Pathname.new(__FILE__).realpath.dirname
+$LOAD_PATH.unshift((bindir + '../lib').realpath)
+
+require 'review/preprocessor'
+require 'review/unfold'
+require 'lineinput'
+require 'stringio'
+require 'fileutils'
+require 'optparse'
+
+def sigmain
+  Signal.trap(:PIPE, 'IGNORE')
+  Signal.trap(:INT) { exit 1 }
+  main
+rescue Errno::EPIPE
+  exit 0
+end
+
+def main
+  $KCODE = 'UTF-8' unless defined?(Encoding)
+
+  param = {
+    "inencoding" => "UTF-8",
+    "outencoding" => "UTF-8",
+  }
+
+  mode = :output
+  parser = OptionParser.new
+  parser.banner = "Usage: #{File.basename($0)} [-c|-d|-s|--replace] [<file>...]"
+  parser.on('--inencoding=ENCODING', 'Set input encoding. (UTF-8, EUC, JIS, and
+SJIS)') {|enc|
+    param["inencoding"] = enc
+  }
+  parser.on('--outencoding=ENCODING', 'Set output encoding. (UTF-8[default], EUC
+, JIS, and SJIS)') {|enc|
+    param["outencoding"] = enc
+  }
+  parser.on('-c', '--check', 'Check if preprocess is needed.') {
+    mode = :check
+  }
+  parser.on('-d', '--diff', 'Show diff from current file.') {
+    mode = :diff
+  }
+  parser.on('--replace', 'Replace file by preprocessed one.') {
+    mode = :replace
+  }
+  parser.on('-s', '--strip', 'Strip preprocessor tags.') {
+    mode = :strip
+  }
+  parser.on('--final', 'Unfold text and strip preprocessor tags.') {
+    mode = :final
+  }
+  parser.on('--help', 'Print this message and quit.') {
+    puts parser.help
+    exit 0
+  }
+  begin
+    parser.parse!
+  rescue OptionParser::ParseError => err
+    $stderr.puts err.message
+    $stderr.puts parser.help
+    exit 1
+  end
+
+  pp = ReVIEW::Preprocessor.new(ReVIEW::Repository.new)
+  pp.setParameter(param)
+  current_file = nil
+  ARGV.each do |path|
+    current_file = path
+    case mode
+    when :output
+      File.open(path) {|f|
+        pp.process f, $stdout
+      }
+    when :replace
+      File.write "#{path}.pptmp", preproc(pp, path)
+      File.rename "#{path}.pptmp", path
+    when :diff, :check
+      tmp = '/tmp/review.pptmp'
+      begin
+        File.write tmp, preproc(pp, path)
+        if mode == :check
+          system "diff -qu #{path} #{tmp} >/dev/null || echo #{path}"
+        else
+          system "diff -u #{path} #{tmp}"
+        end
+      ensure
+        FileUtils.rm_f tmp
+      end
+    when :strip
+      File.open(path) {|f|
+        ReVIEW::Preprocessor::Strip.new(f).each do |line|
+          puts line
+        end
+      }
+    when :final
+      u = ReVIEW::Unfold.new
+      File.open(path) {|f|
+        u.unfold ReVIEW::Preprocessor::Strip.new(f), $stdout
+      }
+    else
+      raise "must not happen: #{mode}"
+    end
+  end
+rescue ReVIEW::Error => err
+  raise if $DEBUG
+  $stderr.puts err.message
+  exit 1
+end
+
+def preproc(pp, path)
+  buf = StringIO.new
+  File.open(path) {|f|
+    pp.process f, buf
+  }
+  buf.string
+end
+
+def File.write(path, str)
+  File.open(path, 'w') {|f|
+    f.write str
+  }
+end
+
+sigmain

data/bin/review-validate

@@ -0,0 +1,51 @@
+#!/usr/bin/env ruby
+# Copyright (c) 2010 Kenshi Muto
+#
+# This program is free software
+# You can distribute or modify this program under the terms of
+# the GNU LGPL, Lesser General Public License version 2.1.
+# For details of the GNU LGPL, see the file "COPYING".
+#
+
+# simple validator for ReVIEW
+
+block = nil
+maxcolcount = 0
+colcount = 0
+ln = 0
+
+ARGF.each {|line|
+  ln = ln + 1
+  if line =~ /\A\/\/([a-z]+).+\{/
+    # block
+    _block = $1
+    puts "#{ln}: block #{_block} started, but previous block #{block} didn't close yet." unless block.nil?
+    block = _block
+  elsif line =~ /\A\/\/\}/
+    puts "#{ln}: block seen ended, but not opened." if block.nil?
+    block = nil
+    maxcolcount = 0
+    colcount = 0
+  elsif line =~ /\A(\d+\.)\s+/
+    # number
+    unless ["list", "emlist", "listnum", "emlistnum", "cmd", "image", "table"].include?(block)
+      puts "#{ln}: found $1 without the head space. Is it correct?"
+    end
+  elsif line =~ /\A\*\s+/
+    # itemize
+    unless ["list", "emlist", "listnum", "emlistnum", "cmd", "image", "table"].include?(block)
+      puts "#{ln}: found '*' without the head space. Is it correct?"
+    end
+  elsif line =~ /\A\s+(\d+\.)\s+/ && line =~ /\A\s+\*\s+/
+    unless ["list", "emlist", "listnum", "emlistnum", "cmd", "image", "table"].include?(block)
+      puts "#{ln}: found itemized list or numbered list in #{block}. Is it correct?"
+    end
+  elsif block == "table"
+    if line !~ /\A\-\-\-\-\-/
+      # table
+      colcount = line.split("\t").size
+      maxcolcount = colcount if maxcolcount == 0
+      puts "#{ln}: the number of table columns seems mismatch. (#{maxcolcount} != #{colcount})" if colcount != maxcolcount
+    end
+  end
+}

data/bin/review-vol

@@ -0,0 +1,106 @@
+#!/usr/bin/env ruby
+#
+# $Id: review-vol 3901 2008-02-11 20:04:59Z aamine $
+#
+# Copyright (c) 2003-2007 Minero Aoki
+#
+# This program is free software.
+# You can distribute or modify this program under the terms of
+# the GNU LGPL, Lesser General Public License version 2.1.
+# For details of the GNU LGPL, see the file "COPYING".
+#
+
+require 'pathname'
+
+bindir = Pathname.new(__FILE__).realpath.dirname
+$LOAD_PATH.unshift((bindir + '../lib').realpath)
+
+require 'review/book'
+require 'review/exception'
+require 'optparse'
+require 'nkf'
+
+def main
+  $KCODE = 'UTF-8' unless defined?(Encoding)
+
+  @param = {
+    "inencoding" => "UTF-8",
+    "outencoding" => "UTF-8"
+  }
+
+  part_sensitive = false
+  parser = OptionParser.new
+  parser.on('-P', '--part-sensitive', 'Prints volume of each parts.') {
+    part_sensitive = true
+  }
+  parser.on('--inencoding=ENCODING', 'Set input encoding. (UTF-8, EUC, JIS, and SJIS)') {|enc|
+    @param["inencoding"] = enc
+  }
+  parser.on('--outencoding=ENCODING', 'Set output encoding. (UTF-8[default], EUC, JIS, and SJIS)') {|enc|
+    @param["outencoding"] = enc
+  }
+  parser.on('--help', 'Print this message and quit') {
+    puts parser.help
+    exit 0
+  }
+  begin
+    parser.parse!
+  rescue OptionParser::ParseError => err
+    $stderr.puts err.message
+    $stderr.puts parser.help
+    exit 1
+  end
+
+  book = ReVIEW.book
+  book.setParameter(@param)
+  if part_sensitive
+    sep = ""
+    book.each_part do |part|
+      print sep; sep = "\n"
+      puts "Part #{part.number}" if part.number
+      part.each_chapter do |chap|
+        print_chapter_volume chap
+      end
+      puts '    --------------------'
+      print_volume part.volume
+    end
+    puts '============================='
+    print_volume book.volume #puts "Total #{book.volume}"
+  else
+    book.each_chapter do |chap|
+      chap.setParameter(@param)
+      print_chapter_volume chap
+    end
+    puts '============================='
+    print_volume book.volume #puts "Total #{book.volume}"
+  end
+rescue ReVIEW::ApplicationError, Errno::ENOENT => err
+  raise if $DEBUG
+  $stderr.puts "#{File.basename($0)}: #{err.message}"
+  exit 1
+end
+
+def print_chapter_volume(chap)
+  vol = chap.volume
+  title = chap.title
+  if @param["outencoding"] =~ /^EUC$/i
+    title = NKF.nkf("-W -e", title)
+  elsif @param["outencoding"] =~ /^SJIS$/i
+    title = NKF.nkf("-W -s", title)
+  elsif @param["outencoding"] =~ /^JIS$/i
+    title = NKF.nkf("-W -j", title)
+  end
+  printf "%s %3dKB %6dC %5dL %3dP %s %-s\n",
+         chapnumstr(chap.number), vol.kbytes, vol.chars, vol.lines, vol.page,
+         "#{chap.name} ".ljust(25, '.'), title
+end
+
+def print_volume(vol)
+  printf "    %3dKB %6dC %5dL %3dP\n", vol.kbytes, vol.chars, vol.lines, vol.page
+end
+
+def chapnumstr(n)
+  n ? sprintf('%2d.', n) : '   '
+end
+
+main

data/doc/format.re

@@ -0,0 +1,486 @@
+= ReVIEW フォーマット
+
+ReVIEW フォーマットの文法について解説します。ReVIEW
+フォーマットは ASCII の EWB を基本としながら、一部に
+RD や各種 Wiki の文法をとりいれて簡素化しています。
+
+== 段落
+
+段落の間は英語の段落のように一行空けます。ただし、組版に
+まわすときは前処理して 1 段落を 1 行に変更してあります。
+
+=== [例]
+
+//emlist{
+  だんらくだんらく〜〜〜
+  この行も同じ段落
+
+  次の段落〜〜〜
+//}
+
+== 章・節・項・段
+
+章・節・項・段のキャプションは「=」「==」「===」「====」
+です。5 レベル以上は使えません。
+
+=== [例]
+
+//emlist{
+  = 章のキャプション
+
+  == 節のキャプション
+
+  === 項のキャプション
+
+  ==== 段のキャプション
+//}
+
+== コラムなど
+
+節や項の文法に [column] を追加するとコラムのキャプションに
+なります。
+
+=== [例]
+
+//emlist{
+  ===[column] コンパイラコンパイラ
+//}
+
+このとき、「=」と「[column]」は必ずくっつけて書かなければ
+なりません。空白があってもいけません。
+
+== 箇条書き
+
+箇条書き (HTML で言う ul) は「*」で表現します。
+ネストはしません。
+
+=== [例]
+
+//emlist{
+  * 第一の項目
+  * 第二の項目
+  * 第三の項目
+//}
+
+== 番号付き箇条書き
+
+番号付きの箇条書き (HTML で言う ol) は「1. 〜」「2. 〜」
+「3. 〜」で示します。ネストはしません。
+
+=== [例]
+
+//emlist{
+  1. 第一の条件
+  2. 第二の条件
+  3. 第三の条件
+//}
+
+== 用語リスト
+
+用語リスト (HTML で言う dl) は「:」を使って示します。
+
+=== [例]
+
+//emlist{
+    : Alpha
+        DEC の作っていた RISC CPU。
+        浮動小数点数演算が速い。
+    : POWER
+        IBM とモトローラが共同製作した RISC CPU。
+        派生として POWER PC がある。
+    : SPARC
+        Sun が作っている RISC CPU。
+        CPU 数を増やすのが得意。
+//}
+
+頭の「:」それ自体はテキストではないので注意してください。
+
+また、リスト内でも後述するインライン命令は有効です。
+
+== ソースコードなどのリスト
+
+ソースコードリストにはキャプションの付くリストとキャプ
+ションの付かないリストがあります。キャプション付きリス
+トは「//list[識別子][キャプション]{ 〜 //}」で、
+キャプションなしリストは「//emlist{ 〜 //}」です。
+
+=== [例1]
+
+//emlist{
+  //list[main][main()]{    ←「main」が識別子で「main()」がキャプション
+  int
+  main(int argc, char **argv)
+  {
+      puts("OK");
+      return 0;
+  }
+  //}
+//}
+
+=== [例2]
+
+//emlist{
+  //emlist{
+  printf("hello");
+  //}
+//}
+
+ブロック内でも後述するインライン命令は有効です。
+
+また本文中で「リスト X を見てください」のようにリストを指定
+する場合は、//list で指定した識別子を使って「@<raw>{@<list>{main\}}」
+と表記します。
+
+== ソースコードの引用
+
+ソースコードを引用する場合、ファイル名が必要です。
+
+=== [例]
+
+//emlist{
+  //source[/hello/world.rb]{
+   puts "hello world!"
+  //}
+//}
+
+== 行番号付きキャプションありリスト
+
+キャプションありのリスト(list)で自動的に行番号がつきます。
+
+=== [例]
+
+//emlist{
+  //listnum[hello][ハローワールド]{
+   puts "hello world!"
+  //}
+//}
+
+参照方法はlistと変わりません。
+
+=== [例]
+
+//emlist{
+  ..は@<raw>{@<list>{hello\}}をみてください。
+//}
+
+== 行番号付きキャプションなしリスト
+
+キャプション無しのリスト(emlist)で自動的に行番号がつきます。
+
+=== [例]
+
+//emlist{
+  //emlistnum{
+   puts "hello world!"
+  //}
+//}
+
+== 本文中でのソースコード引用
+
+本文中でソースコードを引用して記述します。
+
+=== [例]
+
+//emlist{
+  @<raw>{@<code>{p = obj.ref_cnt\}}
+//}
+
+== コマンドラインのキャプチャ
+
+コマンドラインの操作を示すときは //cmd{ 〜 //} を使います。
+
+=== [例]
+
+//emlist{
+  //cmd{
+  $ ls /
+  //}
+//}
+
+ブロック内でも後述するインライン命令は有効です。
+
+== 図
+
+図は //image{ 〜 //} で指定します。執筆中はアスキーアートで
+代替しているため、ダミーのアスキーアートが入っていることがあり
+ます。この部分は、組版時には単に無視してください。
+
+=== [例]
+
+//emlist{
+  //image[unixhistory][UNIX系OSの簡単な系譜]{
+	      System V 系列
+	      +----------- SVr4 --> 各種商用UNIX（Solaris, AIX, HP-UX, ...）
+  V1 --> V6 --|
+	      +--------- 4.4BSD --> FreeBSD, NetBSD, OpenBSD, ...
+	      BSD 系列
+
+		    --------------> Linux
+  //}
+//}
+
+また本文中で「図 X を見てください」のように図を指定する場合は、
+ //image で指定した識別子を用いて「@<raw>{@<img>{unixhistory\}}」と
+記述します。//image と @<raw>{@<img>} でつづりが違うので注意してください。
+
+== 表
+
+表は //table[識別子][キャプション]{ 〜 //} です。ヘッダと内容を
+分ける罫線は「------」で書き込んであります。
+
+カラム間は任意個数のタブで区切ります。また、カラム先頭の「.」は削
+除されるので、カラムの先頭文字が「.」の場合は「.」をもう一つ余計に
+付けてください。例えば「.」という内容のカラムは「..」と書きます。
+また、空のカラムは「.」と書けます。
+
+=== [例]
+
+//emlist{
+
+  //table[envvars][重要な環境変数]{
+  名前            意味
+  -------------------------------------------------------------
+  PATH            コマンドの存在するディレクトリ
+  TERM            使っている端末の種類。linux・kterm・vt100など
+  LANG            ユーザのデフォルトロケール。日本語ならja_JP.eucJPやja_JP.utf8
+  LOGNAME         ユーザのログイン名
+  TEMP            一時ファイルを置くディレクトリ。/tmpなど
+  PAGER           manなどで起動するテキスト閲覧プログラム。lessなど
+  EDITOR          デフォルトエディタ。viやemacsなど
+  MANPATH         manのソースを置いているディレクトリ
+  DISPLAY         X Window Systemのデフォルトディスプレイ
+  //}
+//}
+
+本文中で「表 X を見てください」のように表を指定する場合は
+@<raw>{@<table>{envvars\}} という表記を使います。
+
+表内でも後述するインライン命令は有効です。
+
+== 引用
+
+引用は「//quote{ 〜 //}」を使って記述します。
+
+=== [例]
+
+//emlist{
+    //quote{
+    百聞は一見に如かず。
+    //}
+//}
+
+引用内でも後述するインライン命令は有効です。
+また、いまのところ引用内で別のブロック構文を使うことはできません。
+
+== 脚注
+
+脚注は「//footnote」を使って記述します。
+
+=== [例]
+
+//emlist{
+  パッケージは本書のサポートサイトから入手できます@<raw>{@<fn>{site\}}。
+  各自ダウンロードしてインストールしておいてください。
+  //footnote[site][本書のサポートサイト： http://i.loveruby.net/ja/stdcompiler ]
+//}
+
+本文中の「@<raw>{@<fn>{site\}}」は脚注番号に置換され、「本書のサポート
+サイト……」という文は実際の脚注に変換されます。
+
+== 参考文献の定義
+
+参考文献は同一ディレクトリ内の bib.re に定義します。
+  //bibpaper[site][キャプション]{..コメント..}
+コメントが無い場合も定義可能です。
+  //bibpaper[site][キャプション]
+
+=== [例]
+
+//emlist{
+  //bibpaper[lins][Lins, 1991]{
+  Refael D. Lins. A shared memory architecture for parallel study of
+  algorithums for cyclic reference_counting. Technical Report 92,
+  Computing Laboratory, The University of Kent at Canterbury , August
+  1991
+  //}
+//}
+
+本文中で参考文献を参照したい場合は次のようにしてください。
+
+=== [例]
+
+//emlist{
+  …という研究が知られています(@<raw>{@<bib>{lins\}})
+//}
+
+== リード文
+
+リード文は //read{ 〜 //} で指定します。lead でなく read
+なのは、ASCII の EWB が「read」を使っていたからです。
+
+=== [例]
+
+//emlist{
+  //read{
+  本章ではまずこの本の概要について話し、
+  次にLinuxでプログラムを作る方法を説明していきます。
+  //}
+//}
+
+== 空白制御
+
+: //noindent
+    段落冒頭のインデントなし
+
+: //linebreak
+    改行
+
+: //pagebreak
+    改ページ
+
+== コメント
+
+正式なタグでは伝達できない情報を記述するために //comment を使います。
+
+=== [例]
+
+//emlist{
+  //comment[ここで 1 行あける]
+//}
+
+== その他の文法
+
+ReVIEW は任意のブロックを追加可能なので、本によって専用ブロックを
+使う場合があります。これまでに使った例を以下に示します。
+
+: //prototype
+    関数プロトタイプ。『ふつうのLinuxプログラミング』で使用。
+
+: //type
+    関数の型宣言。『ふつうのHaskellプログラミング』で使用。
+
+== 段落中で使う文法 (インライン命令)
+
+: @<raw>{@<list>{program\}}
+    「リスト1.5」のような文字列に置換される。
+
+: @<raw>{@<img>{unixhistory\}}
+    「図1.3」のような文字列に置換される。
+
+: @<raw>{@<table>{ascii\}}
+    「表1.2」のような文字列に置換される。
+
+: @<raw>{@<fn>{site\}}
+    脚注番号に置換される。
+
+: @<raw>{@<kw>{信任状, credential\}}
+    キーワード。太字などにして強調してください。
+
+: @<raw>{@<chap>{advanced\}}
+    「第17章」のような、章番号を含むテキストに置換される。
+
+: @<raw>{@<title>{advanced\}}
+    その章の章題に置換される。
+
+: @<raw>{@<chapref>{advanced\}}
+    『第17章「さらに進んだ話題」』のように、章番号とタイトル
+    を含むテキストに置換される。
+
+: @<raw>{@<bou>{ふさわしい\}}
+    傍点。
+
+: @<raw>{@<ruby>{直截, ちょくせつ\}}
+    ルビ。
+
+: @<raw>{@<ami>{重点ポイント\}}
+    文字に対するアミかけ。
+
+: @<raw>{@<b>{どうしても\}}
+    太字。
+
+== 著者用タグ (プリプロセッサ命令)
+
+これまでに説明したタグはすべて最終段階まで残り、見ために
+影響を与えます。それに対して以下のタグは著者が使うための
+専用タグであり、最終段階ではすべて消されてしまいます。
+
+: #@#
+    コメント。この行には何を書いても無視される。
+
+: #@warn(...)
+    警告メッセージ。プリプロセス時にメッセージが出力される。
+
+: #@require, #@provide
+    キーワードの依存関係を宣言する。
+
+: #@mapfile(ファイル名) 〜 #@end
+    ファイルの内容をその場に展開する。
+
+: #@maprange(ファイル名, 範囲名) 〜 #@end
+    ファイル内の範囲をその場に展開する。
+
+: #@mapoutput(コマンド) 〜 #@end
+    コマンドを実行して、その出力結果を展開する。
+
+== HTMLのレイアウト機能
+
+CHAPSファイルが置かれているディレクトリに layouts/layout.erb
+を置くとその html を ERB で評価します。
+
+=== [例1]
+
+//emlist{
+  <html>
+    <head>
+      <title><%= title %></title>
+    </head>
+//}
+
+=== [例2]
+
+//emlist{
+  <html>
+    <head>
+      <title><%= title %></title>
+    </head>
+    <body>
+      <%= body %>
+      <hr/>
+    </body>
+  </html>
+//}
+
+== 部タイトル取得(目次生成機能)
+
+PART ファイルに定義してください。
+PART ファイルは CHAPS の部わけと対応しています。
+
+=== [例]
+
+//emlist{
+CHAPS:
+  intro.re
+  start.re
+  end.re
+
+PART:
+  (序章なので空行)
+  はじまりの部
+  おわりの部
+//}
+
+== リンク
+
+Web ハイパーリンクを記述するには、リンクに @<raw>{@<href>}、アンカーに //label
+を使います。リンクの書式は @<raw>{@<href>{URL, 文字表現\}} で、「, 文字表現」を
+省略すると URL がそのまま使われます。URL 中に , を使いたいときには、\,
+と表記してください。
+
+[例]
+//emlist{
+ @<raw>{@<href>{http://github.com/, GitHub\}}
+ @<raw>{@<href>{http://www.google.com/\}}
+ @<raw>{@<href>{#point1, ドキュメント内ポイント\}}
+ @<raw>{@<href>{chap1.html#point1, ドキュメント内ポイント\}}
+ //label[point1]
+//}