review 0.6.0 → 0.9.0

data/bin/review-preproc

@@ -62,7 +62,7 @@ SJIS)') {|enc|
   parser.on('-s', '--strip', 'Strip preprocessor tags.') {
     mode = :strip
   }
-  parser.on('--final', 'Unfold text and strip preprocessor tags.') {
+  parser.on('--final', 'Unfold text and strip preprocessor tags. (deprecated)') {
     mode = :final
   }
   parser.on('--help', 'Print this message and quit.') {
@@ -77,8 +77,7 @@ SJIS)') {|enc|
     exit 1
   end
 
-  pp = ReVIEW::Preprocessor.new(ReVIEW::Repository.new)
-  pp.setParameter(param)
+  pp = ReVIEW::Preprocessor.new(ReVIEW::Repository.new, param)
   current_file = nil
   ARGV.each do |path|
     current_file = path

data/bin/review-vol

@@ -52,7 +52,7 @@ def main
   end
 
   book = ReVIEW.book
-  book.setParameter(@param)
+  ReVIEW.book.param = @param
   if part_sensitive
     sep = ""
     book.each_part do |part|
@@ -68,7 +68,6 @@ def main
     print_volume book.volume #puts "Total #{book.volume}"
   else
     book.each_chapter do |chap|
-      chap.setParameter(@param)
       print_chapter_volume chap
     end
     puts '============================='

data/debian/README.Debian

@@ -0,0 +1,12 @@
+review for Debian
+-----------------
+
+review-epubmaker, is EPUB builder, needs zip package. If you'd like to
+use MathML in HTML, install libmathml-ruby also.
+review-pdfmaker, is PDF builder, needs ptexlive environment.
+   Although ptexlive isn't packaged yet, you can take experimental packages
+   from http://www1.pm.tokushima-u.ac.jp/~kohda/tex/ptexlive.html
+   Plus, review-pdfmaker uses additional style;
+ - jumoline.sty: http://www.para.media.kyoto-u.ac.jp/latex/jumoline.tar.gz
+
+ -- Kenshi Muto <kmuto@debian.org>  Tue, 23 Nov 2010 17:35:59 +0900

data/debian/README.source

@@ -0,0 +1,5 @@
+review for Debian
+-----------------
+
+Rakefile focuses test and gem, not Debian packaging.
+Test needs some gem files are not yet included in Debian pool.

data/debian/changelog

@@ -0,0 +1,5 @@
+review (0.6+20101123) unstable; urgency=low
+
+  * Initial Release. (closes: #)
+
+ -- Kenshi Muto <kmuto@debian.org>  Tue, 23 Nov 2010 17:35:59 +0900

data/debian/compat

@@ -0,0 +1 @@
+7

data/debian/control

@@ -0,0 +1,22 @@
+Source: review
+Section: text
+Priority: optional
+Maintainer: Kenshi Muto <kmuto@debian.org>
+Build-Depends: debhelper (>= 7.0.50~), quilt (>= 0.46-7~)
+Standards-Version: 3.9.1
+Homepage: http://github.com/kmuto/review
+Vcs-Git: git://github.com/kmuto/review.git
+
+Package: review
+Architecture: all
+Depends: ${shlibs:Depends}, ${misc:Depends}, ruby
+Recommends: zip
+Suggests: ptex-bin, okumura-clsfiles, libmathml-ruby
+Description: easy-to-use digital publishing system for Japanese books and ebooks
+ ReVIEW is a digital publishing system for books and ebooks.
+ It is aimed professional Japanese editorial use.
+ .
+ ReVIEW generates HTML, LaTeX, plain text, and Adobe InDesign XML
+ from a text file with simple and extensible tags.
+ .
+ This package provides the builders for EPUB and PDF.

data/debian/copyright

@@ -0,0 +1,60 @@
+This work was packaged for Debian by:
+
+    Kenshi Muto <kmuto@debian.org> on Tue, 23 Nov 2010 17:35:59 +0900
+
+It was downloaded from:
+
+    git://github.com/kmuto/review
+
+Upstream Author(s):
+
+    Minero Aoki <aamine@loveruby.net>, Kenshi Muto <kmuto@debian.org>,
+    and Masayoshi Takahashi <takahashimm@gmail.com>.
+
+Copyright:
+
+    Copyright (C) 2006-2010 Minero Aoki, Kenshi Muto, Masayoshi Takahashi
+
+    For lib/uuid.rb:
+    Copyright(c) 2005 URABE, Shyouhei
+
+License:
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU Lesser General Public License as published by
+    the Free Software Foundation, version 2.1 of the License.
+
+    This package is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public License
+    along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+On Debian systems, the complete text of the GNU Lesser General
+Public License version 2.1 can be found in "/usr/share/common-licenses/LGPL-2.1".
+
+    lib/uuid.rb:
+    Permission is hereby granted, free of  charge, to any person obtaining a copy
+    of  this code, to  deal in  the code  without restriction,  including without
+    limitation  the rights  to  use, copy,  modify,  merge, publish,  distribute,
+    sublicense, and/or sell copies of the code, and to permit persons to whom the
+    code is furnished to do so, subject to the following conditions:
+    
+    The above copyright notice and this permission notice shall be
+    included in all copies or substantial portions of the code.
+    
+    THE  CODE IS  PROVIDED "AS  IS",  WITHOUT WARRANTY  OF ANY  KIND, EXPRESS  OR
+    IMPLIED,  INCLUDING BUT  NOT LIMITED  TO THE  WARRANTIES  OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE  AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+    AUTHOR  OR  COPYRIGHT  HOLDER BE  LIABLE  FOR  ANY  CLAIM, DAMAGES  OR  OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF  OR IN CONNECTION WITH  THE CODE OR THE  USE OR OTHER  DEALINGS IN THE
+    CODE.
+
+The Debian packaging is:
+
+    Copyright (C) 2010 Kenshi Muto <kmuto@debian.org>
+
+and is licensed under the GNU Lesser GPL version 2.1, see above.

data/debian/docs

@@ -0,0 +1,5 @@
+README.rdoc
+ChangeLog
+doc/format.rdoc
+doc/sample.css
+doc/sample.yaml

data/debian/manpage.1.ex

@@ -0,0 +1,59 @@
+.\"                                      Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH REVIEW SECTION "November 23, 2010"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh        disable hyphenation
+.\" .hy        enable hyphenation
+.\" .ad l      left justify
+.\" .ad b      justify to both left and right margins
+.\" .nf        disable filling
+.\" .fi        enable filling
+.\" .br        insert line break
+.\" .sp <n>    insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+review \- program to do something
+.SH SYNOPSIS
+.B review
+.RI [ options ] " files" ...
+.br
+.B bar
+.RI [ options ] " files" ...
+.SH DESCRIPTION
+This manual page documents briefly the
+.B review
+and
+.B bar
+commands.
+.PP
+.\" TeX users may be more comfortable with the \fB<whatever>\fP and
+.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
+.\" respectively.
+\fBreview\fP is a program that...
+.SH OPTIONS
+These programs follow the usual GNU command line syntax, with long
+options starting with two dashes (`-').
+A summary of options is included below.
+For a complete description, see the Info files.
+.TP
+.B \-h, \-\-help
+Show summary of options.
+.TP
+.B \-v, \-\-version
+Show version of program.
+.SH SEE ALSO
+.BR bar (1),
+.BR baz (1).
+.br
+The programs are documented fully by
+.IR "The Rise and Fall of a Fooish Bar" ,
+available via the Info system.
+.SH AUTHOR
+review was written by <upstream author>.
+.PP
+This manual page was written by Kenshi Muto <kmuto@debian.org>,
+for the Debian project (and may be used by others).

data/debian/patches/path.diff

@@ -0,0 +1,91 @@
+indicate /usr/share/review as lib path.Index: review-0.6+20101123/bin/review-check
+===================================================================
+--- review-0.6+20101123.orig/bin/review-check	2010-11-23 21:08:35.525325930 +0900
++++ review-0.6+20101123/bin/review-check	2010-11-23 21:10:00.049309314 +0900
+@@ -13,7 +13,7 @@
+ require 'pathname'
+ 
+ bindir = Pathname.new(__FILE__).realpath.dirname
+-$LOAD_PATH.unshift((bindir + '../lib').realpath)
++$LOAD_PATH.unshift("/usr/share/review")
+ 
+ require 'review/book'
+ require 'optparse'
+Index: review-0.6+20101123/bin/review-checkdep
+===================================================================
+--- review-0.6+20101123.orig/bin/review-checkdep	2010-11-23 21:08:35.537304196 +0900
++++ review-0.6+20101123/bin/review-checkdep	2010-11-23 21:09:46.932891759 +0900
+@@ -13,7 +13,7 @@
+ require 'pathname'
+ 
+ bindir = Pathname.new(__FILE__).realpath.dirname
+-$LOAD_PATH.unshift((bindir + '../lib').realpath)
++$LOAD_PATH.unshift("/usr/share/review")
+ 
+ PREDEF_FILE = 'PREDEF'
+ 
+Index: review-0.6+20101123/bin/review-compile
+===================================================================
+--- review-0.6+20101123.orig/bin/review-compile	2010-11-23 21:08:35.545307445 +0900
++++ review-0.6+20101123/bin/review-compile	2010-11-23 21:10:11.464806373 +0900
+@@ -13,7 +13,7 @@
+ require 'pathname'
+ 
+ bindir = Pathname.new(__FILE__).realpath.dirname
+-$LOAD_PATH.unshift((bindir + '../lib').realpath)
++$LOAD_PATH.unshift("/usr/share/review")
+ 
+ require 'review/compiler'
+ require 'review/book'
+Index: review-0.6+20101123/bin/review-epubmaker
+===================================================================
+--- review-0.6+20101123.orig/bin/review-epubmaker	2010-11-23 21:08:35.557307851 +0900
++++ review-0.6+20101123/bin/review-epubmaker	2010-11-23 21:10:24.345309100 +0900
+@@ -18,7 +18,7 @@
+ require 'pathname'
+ 
+ bindir = Pathname.new(__FILE__).realpath.dirname
+-$LOAD_PATH.unshift((bindir + '../lib').realpath)
++$LOAD_PATH.unshift("/usr/share/review")
+ 
+ require 'uuid'
+ 
+Index: review-0.6+20101123/bin/review-index
+===================================================================
+--- review-0.6+20101123.orig/bin/review-index	2010-11-23 21:08:35.565304467 +0900
++++ review-0.6+20101123/bin/review-index	2010-11-23 21:10:35.780809275 +0900
+@@ -13,7 +13,7 @@
+ require 'pathname'
+ 
+ bindir = Pathname.new(__FILE__).realpath.dirname
+-$LOAD_PATH.unshift((bindir + '../lib').realpath)
++$LOAD_PATH.unshift("/usr/share/review")
+ 
+ require 'review/book'
+ require 'review/tocparser'
+Index: review-0.6+20101123/bin/review-preproc
+===================================================================
+--- review-0.6+20101123.orig/bin/review-preproc	2010-11-23 21:08:35.577305709 +0900
++++ review-0.6+20101123/bin/review-preproc	2010-11-23 21:10:46.252829939 +0900
+@@ -14,7 +14,7 @@
+ require 'pathname'
+ 
+ bindir = Pathname.new(__FILE__).realpath.dirname
+-$LOAD_PATH.unshift((bindir + '../lib').realpath)
++$LOAD_PATH.unshift("/usr/share/review")
+ 
+ require 'review/preprocessor'
+ require 'review/unfold'
+Index: review-0.6+20101123/bin/review-vol
+===================================================================
+--- review-0.6+20101123.orig/bin/review-vol	2010-11-23 21:08:35.589305906 +0900
++++ review-0.6+20101123/bin/review-vol	2010-11-23 21:10:56.212818665 +0900
+@@ -13,7 +13,7 @@
+ require 'pathname'
+ 
+ bindir = Pathname.new(__FILE__).realpath.dirname
+-$LOAD_PATH.unshift((bindir + '../lib').realpath)
++$LOAD_PATH.unshift("/usr/share/review")
+ 
+ require 'review/book'
+ require 'review/exception'

data/debian/patches/series

@@ -0,0 +1 @@
+path.diff

data/debian/review.install

@@ -0,0 +1,13 @@
+bin/review-check	usr/bin
+bin/review-compile	usr/bin
+#bin/review-checkdep	usr/bin
+bin/review-epubmaker	usr/bin
+bin/review-index	usr/bin
+bin/review-pdfmaker	usr/bin
+bin/review-preproc	usr/bin
+bin/review-validate	usr/bin
+bin/review-vol	usr/bin
+lib/lineinput.rb	usr/share/review
+lib/review.rb	usr/share/review
+lib/uuid.rb	usr/share/review
+lib/review	usr/share/review

data/debian/review.links

@@ -0,0 +1,4 @@
+usr/bin/review-compile	usr/bin/review2html
+usr/bin/review-compile	usr/bin/review2latex
+usr/bin/review-compile	usr/bin/review2top
+usr/bin/review-compile	usr/bin/review2idgxml

data/debian/rules

@@ -0,0 +1,13 @@
+#!/usr/bin/make -f
+# -*- makefile -*-
+# Sample debian/rules that uses debhelper.
+# This file was originally written by Joey Hess and Craig Small.
+# As a special exception, when this file is copied by dh-make into a
+# dh-make output file, you may use that output file without restriction.
+# This special exception was added by Craig Small in version 0.37 of dh-make.
+
+# Uncomment this to turn on verbose mode.
+#export DH_VERBOSE=1
+
+%:
+	dh --with quilt $@

data/debian/source/format

@@ -0,0 +1 @@
+3.0 (native)

data/doc/format.rdoc

@@ -0,0 +1,477 @@
+= ReVIEW フォーマット
+
+ReVIEW フォーマットの文法について解説します。ReVIEW
+フォーマットは ASCII の EWB を基本としながら、一部に
+RD や各種 Wiki の文法をとりいれて簡素化しています。
+
+== 段落
+
+段落(本文)の間は英語の段落のように1行空けます。ただし、組版に
+まわすときは前処理して1段落を1行に変更してあります。
+
+[例]
+
+    だんらくだんらく〜〜〜
+    この行も同じ段落
+
+    次の段落〜〜〜
+
+2行以上空いている場合も1行空きと同様に処理します。
+
+== 章・節・項・段(見出し)
+
+章・節・項・段など、見出しは「=」「==」「===」「====」「=====」です。6 レベル以上は使えません。
+
+[例]
+
+    = 章のキャプション
+
+    == 節のキャプション
+
+    === 項のキャプション
+
+    ==== 段のキャプション
+
+    ===== 小段のキャプション
+
+見出しは行の先頭から始める必要があります。行頭に空白が入ると、ただの本文とみなされます。
+
+== コラムなど
+
+節や項の見出しに [column] を追加するとコラムのキャプションになります。
+
+[例]
+
+    ===[column] コンパイラコンパイラ
+
+このとき、「=」と「[column]」は間を開けず、必ず続けて書かなければ
+なりません。空白があってもいけません。
+
+== 箇条書き
+
+箇条書き (HTML で言う ul) は「*」で表現します。
+ネストはしません。
+
+[例]
+
+  * 第一の項目
+  * 第二の項目
+  * 第三の項目
+
+箇条書きを書くには、行頭に1つ以上の空白を必ず入れるようにします。
+行頭に空白を入れず「*」を書くと、ただのテキストとみなされます。
+
+== 番号付き箇条書き
+
+番号付きの箇条書き (HTML で言う ol) は「1. 〜」「2. 〜」
+「3. 〜」で示します。ネストはしません。
+
+[例]
+
+  1. 第一の条件
+  2. 第二の条件
+  3. 第三の条件
+
+番号付き箇条書きも、ただの箇条書きと同様、行頭に1つ以上の空白が必要です。
+
+== 用語リスト
+
+用語リスト (HTML で言う dl) は「:」と、続く空白で始まる行を使って示します。
+
+[例]
+
+    : Alpha
+        DEC の作っていた RISC CPU。
+        浮動小数点数演算が速い。
+    : POWER
+        IBM とモトローラが共同製作した RISC CPU。
+        派生として POWER PC がある。
+    : SPARC
+        Sun が作っている RISC CPU。
+        CPU 数を増やすのが得意。
+
+頭の「:」それ自体はテキストではないので注意してください。
+その後に続く文字列が用語名(HTMLではdt要素)になります。
+
+用語リストの「:」ではじまる行は、行頭に空白があってもなくてもかまいません。
+そして、その行以降、空白で始まる行が用語内容(HTMLではdd要素)になります。
+
+また、リスト内でも後述するインライン命令は有効です。
+
+== ソースコードなどのリスト
+
+ソースコードリストにはキャプションの付くリストとキャプションの付かないリストがあります。
+連番つきリストは「//list[識別子][キャプション]{ 〜 //}」で、
+連番なしリストは「//emlist[キャプション]{ 〜 //}」です。
+//emlistのキャプションは省略できます。
+
+[例]
+
+  //list[main][main()]{    ←「main」が識別子で「main()」がキャプション
+  int
+  main(int argc, char **argv)
+  {
+      puts("OK");
+      return 0;
+  }
+  //}
+
+[例]
+
+  //emlist{
+  printf("hello");
+  //}
+
+ブロック内でも後述するインライン命令は有効です。
+
+また本文中で「リスト X を見てください」のようにリストを指定
+する場合は、//list で指定した識別子を使って「@<list>{main}」
+と表記します。
+
+=== ソースコード専用の引用
+
+ソースコードを引用する場合、ファイル名が必要です。
+
+[例]
+
+  //source[/hello/world.rb]{
+   puts "hello world!"
+  //}
+
+ソースコードの引用は、キャプションをつけた//emlistとあまり違いはありません。
+が、HTMLのCSSなどでは区別した表現ができます。
+
+== 行番号付き連番ありリスト
+
+連番ありのリスト(list)で自動的に行番号がつきます。
+
+[例]
+
+  //listnum[hello][ハローワールド]{
+   puts "hello world!"
+  //}
+
+参照方法はlistと変わりません。
+
+[例]
+
+  ..は@<list>{hello}をみてください。
+
+== 行番号付き連番なしリスト
+
+連番なしのリスト(emlist)で自動的に行番号がつきます。
+
+[例]
+
+  //emlistnum{
+   puts "hello world!"
+  //}
+
+== 本文中でのソースコード引用
+
+本文中でソースコードを引用して記述します。
+
+[例]
+
+  @<code>{p = obj.ref_cnt}
+
+== コマンドラインのキャプチャ
+
+コマンドラインの操作を示すときは //cmd{ 〜 //} を使います。
+
+[例]
+
+  //cmd{
+  $ ls /
+  //}
+
+ブロック内でも後述するインライン命令は有効です。
+
+== 図
+
+図は //image{ 〜 //} で指定します。執筆中はアスキーアートで
+代替しているため、ダミーのアスキーアートが入っていることがあり
+ます。この部分は、組版時には単に無視してください。
+
+[例]
+
+  //image[unixhistory][UNIX系OSの簡単な系譜]{
+	      System V 系列
+	      +----------- SVr4 --> 各種商用UNIX（Solaris, AIX, HP-UX, ...）
+  V1 --> V6 --|
+	      +--------- 4.4BSD --> FreeBSD, NetBSD, OpenBSD, ...
+	      BSD 系列
+
+		    --------------> Linux
+  //}
+
+3番目の引数として、画像の倍率・大きさを指定することができます。
+今のところ「scale=X」で倍率(X倍)が指定できます。
+
+また本文中で「図 X を見てください」のように図を指定する場合は、
+//image で指定した識別子を用いて「@<img>{unixhistory}」と
+記述します。//image と @<img> でつづりが違うので注意してください。
+
+なお、後述しますが、インラインで図を出力するには@<icon>を使用します。
+
+== 番号が振られていない図
+
+//indepimage[ファイル名][キャプション] で番号が振られていない画像ファイルを生成します。キャプションは省略できます。
+
+[例]
+
+  //indepimage[unixhistory2]
+
+同様のことは、//numberlessimageでも使えます。
+
+[例]
+
+  //numberlessimage[door_image_path][扉絵]
+
+※ただし、//indepimageと機能的にかぶっているので、将来は廃止され、//indexpimageに統合される予定です。
+
+== 表
+
+表は //table[識別子][キャプション]{ 〜 //} です。ヘッダと内容を
+分ける罫線は「------」で書き込んであります。
+
+カラム間は任意個数のタブで区切ります。また、カラム先頭の「.」は削
+除されるので、カラムの先頭文字が「.」の場合は「.」をもう一つ余計に
+付けてください。例えば「.」という内容のカラムは「..」と書きます。
+また、空のカラムは「.」と書けます。
+
+[例]
+
+  //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 を見てください」のように表を指定する場合は
+@<table>{envvars} という表記を使います。
+
+表内でも後述するインライン命令は有効です。
+
+== 引用
+
+引用は「//quote{ 〜 //}」を使って記述します。
+
+[例]
+
+    //quote{
+    百聞は一見に如かず。
+    //}
+
+引用内でも後述するインライン命令は有効です。
+また、いまのところ引用内で別のブロック構文を使うことはできません。
+
+== 脚注
+
+脚注は「//footnote」を使って記述します。
+
+[例]
+
+  パッケージは本書のサポートサイトから入手できます@<fn>{site}。
+  各自ダウンロードしてインストールしておいてください。
+  //footnote[site][本書のサポートサイト： http://i.loveruby.net/ja/stdcompiler ]
+
+本文中の「@<fn>{site}」は脚注番号に置換され、「本書のサポート
+サイト……」という文は実際の脚注に変換されます。
+
+== 参考文献の定義
+
+参考文献は同一ディレクトリ内の bib.re に定義します。
+//bibpaper[site][キャプション]{..コメント..}
+コメントが無い場合も定義可能です。
+//bibpaper[site][キャプション]
+
+[例]
+
+  //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
+  //}
+
+本文中で参考文献を参照したい場合は次のようにしてください。
+
+[例]
+
+  …という研究が知られています(@<bib>{lins})
+
+== リード文
+
+リード文は //lead{ 〜 //} で指定します。
+歴史的経緯により//read{ 〜 //} でも使えます。
+
+[例]
+
+  //lead{
+  本章ではまずこの本の概要について話し、
+  次にLinuxでプログラムを作る方法を説明していきます。
+  //}
+
+== TeX式
+
+LaTeX の式を挿入するには、//texequation{ 〜 //} を使います。
+
+[例]
+
+  //texequation{
+  \sum_{i=1}^nf_n(x)
+  //}
+
+== 空白制御
+
+出力される空白を制御するタグとしては、//noindentがあります。
+
+//noindent:: その直後に来る段落冒頭のインデントをなくする(HTMLではnoindentクラスになる)
+
+以前あった「//linebreak」(改行)、「//pagebreak」(改ページ)は廃止になります。
+
+== コメント
+
+以前は「//comment」というタグがありましたが、廃止されます。
+
+最終結果に出力されないコメントを記述したい場合は「#@#」を使ってください。
+
+[例]
+
+  #@# ここで 1 行あける
+
+また、修正が必要な警告的コメントには#@warn(...)を使ってください。
+
+[例]
+
+  #@warn(あとで書く)
+
+== その他の文法
+
+ReVIEW は任意のブロックを追加可能なので、本によって専用ブロックを
+使う場合があります。これまでに使った例を以下に示します。
+
+//prototype:: 関数プロトタイプ。『ふつうのLinuxプログラミング』で使用。
+//type:: 関数の型宣言。『ふつうのHaskellプログラミング』で使用。
+
+拡張文法はreview-ext.rbというファイルで指定できますが、ここでは詳しく触れません。
+
+== 段落中で使う文法 (インライン命令)
+
+@<list>{program}:: 「リスト1.5」のような文字列に置換される。
+@<img>{unixhistory}:: 「図1.3」のような文字列に置換される。
+@<table>{ascii}:: 「表1.2」のような文字列に置換される。
+@<fn>{site}:: 脚注番号に置換される。
+@<kw>{信任状, credential}:: キーワード。太字などにして強調してください。
+@<chap>{advanced}:: 「第17章」のような、章番号を含むテキストに置換される。
+@<title>{advanced}:: その章の章題に置換される。
+@<chapref>{advanced}:: 『第17章「さらに進んだ話題」』のように、章番号とタイトルを含むテキストに置換される。
+@<bou>{ふさわしい}:: 傍点。
+@<ruby>{直截, ちょくせつ}:: ルビ。
+@<ami>{重点ポイント}:: 文字に対するアミかけ。
+@<b>{どうしても}:: 太字。
+@<em>{どうしても}:: 太字(強調)。
+@<i>{どうしても}:: イタリック。
+@<tt>{foo($bar)}:: テキストをテレタイプ文字(等幅フォント)で出力する。
+@<tti>{FooClass}:: テキストをテレタイプ文字(等幅フォント)のイタリックで出力する。
+@<ttb>{BarClass}:: テキストをテレタイプ文字(等幅フォント)の太字で出力する。
+@<br>{}::  段落中改行。
+@<m>{a + \alpha}:: TeXインライン式。
+@<icon>{samplephoto}:: インライン画像。
+@<uchar>{2460}:: Unicode文字の出力。引数は16進数で指定する。
+@<href>{http://www.google.com/}:: リンク。URLで指定できる
+@<raw>{@<foo>{bar\}}:: そのまま出力する。「}」は「\」でエスケープする。
+
+== 著者用タグ (プリプロセッサ命令)
+
+これまでに説明したタグはすべて最終段階まで残り、見ために
+影響を与えます。それに対して以下のタグは著者が使うための
+専用タグであり、最終段階ではすべて消されてしまいます。
+
+#@#:: コメント。この行には何を書いても無視される。
+#@warn(...):: 警告メッセージ。プリプロセス時にメッセージが出力される。
+#@require, #@provide:: キーワードの依存関係を宣言する。
+#@mapfile(ファイル名) 〜 #@end:: ファイルの内容をその場に展開する。
+#@maprange(ファイル名, 範囲名) 〜 #@end:: ファイル内の範囲をその場に展開する。
+#@mapoutput(コマンド) 〜 #@end:: コマンドを実行して、その出力結果を展開する。
+
+== HTMLのレイアウト機能
+
+CHAPSファイルが置かれているディレクトリに layouts/layout.erb
+を置くとその html を ERB で評価します。
+
+[例]
+
+  <html>
+    <head>
+      <title><%= title %></title>
+    </head>
+[例]
+
+  <html>
+    <head>
+      <title><%= title %></title>
+    </head>
+    <body>
+      <%= body %>
+      <hr/>
+    </body>
+  </html>
+
+== 部タイトル取得(目次生成機能)
+
+PART ファイルに定義してください。
+PART ファイルは CHAPS の部わけと対応しています。
+
+[例]
+
+CHAPS:
+  intro.re
+  
+  start.re
+
+  end.re
+
+PART:
+  (序章なので空行)
+  はじまりの部
+  おわりの部
+
+== 見出し参照
+
+見出し番号と見出しを生成します。
+見出しの階層は"|"で区切って指定してください。
+
+[例]
+
+  @<hd>{はじめに|まずわ}
+
+他の章を参照したい場合は、先頭に章のidを指定してください。  
+
+[例]
+
+  @<hd>{preface|はじめに|まずわ}
+
+== リンク
+
+Web ハイパーリンクを記述するには、リンクに @<href>、アンカーに //label
+を使います。リンクの書式は @<href>{URL, 文字表現} で、「, 文字表現」を
+省略すると URL がそのまま使われます。URL 中に , を使いたいときには、\,
+と表記してください。
+
+[例]
+
+  @<href>{http://github.com/, GitHub}
+  @<href>{http://www.google.com/}
+  @<href>{#point1, ドキュメント内ポイント}
+  @<href>{chap1.html#point1, ドキュメント内ポイント}
+  //label[point1]