review 3.0.0.preview4 → 3.0.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a903b095f340bf40a4e98b60b691541b9ce7ba19a178db25b88463d9125144ca
-  data.tar.gz: 18f15f4b01e4deb47acbc22538e7d894d84338215f207da3efc22f21621d4ca8
+  metadata.gz: 792d5855801da09c439c877981ba7105633189c70527b5a2c26709ab6383ea84
+  data.tar.gz: e615658f6848efabd7802189744f84888717fc83f5a1113ec38e15e7c075487e
 SHA512:
-  metadata.gz: 71f9400d75229765b867201152a2bcb7a48d9ce208da28f83adcac2f5f322a37ee0f3efa338b0a012e377c84d75d5c2afc6e9d25ad04306b0a27da7cbea0d75d
-  data.tar.gz: e3e8e3ef0d54aadff4c02206791e2f1c2477c05ec857a7b8ef5cac53d5922a9da99786fa5daf1a00ab7afbdb1a0c5d62ccec0622ffab92201655ad8ffd51c650
+  metadata.gz: 1136c1217fb03c8dfb42c8320946832ebc4a25c20769b0d46e1d2e32e98144ca702f20785e343a5b20a8572184543438cb348d571e2033eeaf3bbd2635785f9e
+  data.tar.gz: a8ac7a9b84bbc9b90f18533351dd71a1a36a24bdcdf5deb78fd38eff9550e99d8284ec33f9c574b1b75f3045089257b010e507bb450205f61f0b5966336411bb

data/NEWS.ja.md

@@ -1,3 +1,64 @@
+# Version 3.0.0 release candidate
+## 非互換の変更
+* PDFMaker: review-jsbook の見出しの文字サイズを、オリジナルの jsbook に準拠しました ([#1152])
+* PDFMaker: review-jsbook において、3.0.0 preview 4 までの Q,W,L,H で指定する方法をやめ、fontsize などの単位付きパラメータを使うようにしました。3.0.0 preview 3 〜 3.0.0 preview 4 で作成したプロジェクトに対しては、review-update コマンドで新しいパラメータに移行できます ([#1151],[#1201])
+
+## バグ修正
+* PDFMaker: review-jsbook クラスファイルで hiddenfolio パラメータと tombopaper パラメータを同時に使用すると hiddenfolio パラメータが無視される問題を修正しました ([#1158])
+* PDFMaker: review-jsbook クラスファイルで paperwidth, paperheight パラメータが効かない問題を修正しました ([#1171])
+* review-update で sty フォルダの更新が無視されることがあるのを修正しました ([#1183])
+
+## 機能強化
+* PDFMaker: review-jsbook において、fontsize パラメータで標準の文字サイズ、baselineskip パラメータで標準の行の高さを pt や Q、mm などの単位付きで指定できるようにしました ([#1151])
+* PDFMaker: 何らかの事情でオリジナルの jsbook.cls クラスファイルを使い続けたいユーザー向けに、review-jsbook セットのスタイルファイルを流用可能にしました ([#1177])
+* PDFMaker: ユーザーが任意のスタイルや `//embed` 命令で利用できるよう、review-jsbook および review-jlreq に空ページを作成する `\oneblankpage`、必要に応じて改ページすることで次のページが必ず偶数ページになるようにする `\clearoddpage` のマクロを追加しました ([#1175],[#1182])
+* PDFMaker: review-jsbook および review-jlreq クラスファイルのドキュメントオプションパラメータに、生成 PDF の種類を指定する `media` を追加しました。3.0.0 preview3 で導入した `cameraready` パラメータと同じ意味です（どちらを使ってもかまいません）([#1181])
+* PDFMaker: 部の中で節などの下位見出しを利用できるようになりました ([#1195])
+* PDFMaker: 部があるときには `\reviewusepart` というマクロを定義するようにしました ([#1199])
+* review-init が生成する config.yml ファイルで、`texdocumentclass` パラメータをコメントアウトされた状態ではなく明示指定するようにしました ([#1202])
+* PDFMaker: `//tsize` 命令で幅が明示指定されている場合には、表中の改行（`@<br>`）を `\newline` マクロで表現するようにしました ([#1206])
+* PDFMaker: TeX における表の列幅の表現として、`L{幅}`（左寄せ・均等配置なし）, `C{幅}`（中央寄せ）, `R{幅}`（右寄せ） を利用できるようにしました ([#1208])
+* PDFMaker: バージョン間の実装差異を避けるため、スナップショットの jsbook.cls (2018/06/23) および gentombow.sty (2018/08/30 v0.9j) を sty フォルダにコピーしてそれを利用するようにしました ([#1210])
+
+## バグ修正
+* PDFMaker: review-jlreq クラスファイルで serial_pagination および startpage が動作していなかったのを修正しました ([#1204])
+
+## ドキュメント
+* IDGXML のドキュメント format_idg.ja.md を更新しました ([#1188])
+* クイックスタートガイド quickstart.ja.md に review-update について説明を追加しました ([#1189])
+* サンプル設定ファイル config.yml.sample のコメント類を更新しました ([#1190])
+* PDFMaker のドキュメント pdfmaker.ja.md を更新しました ([#1191])
+* 縦書きについてのドキュメント writing_vertical.ja.md を更新しました ([#1198])
+* review-jsbook のドキュメントを更新しました ([#1203])
+* review-jlreq のドキュメントを更新しました ([#1204])
+
+## コントリビューターのみなさん
+* [@munepi](https://github.com/munepi)
+
+[#1151]: https://github.com/kmuto/review/issues/1151
+[#1152]: https://github.com/kmuto/review/issues/1152
+[#1158]: https://github.com/kmuto/review/issues/1158
+[#1171]: https://github.com/kmuto/review/issues/1171
+[#1175]: https://github.com/kmuto/review/pull/1175
+[#1177]: https://github.com/kmuto/review/pull/1177
+[#1181]: https://github.com/kmuto/review/issues/1181
+[#1182]: https://github.com/kmuto/review/pull/1182
+[#1183]: https://github.com/kmuto/review/issues/1183
+[#1188]: https://github.com/kmuto/review/pull/1188
+[#1189]: https://github.com/kmuto/review/pull/1189
+[#1190]: https://github.com/kmuto/review/pull/1190
+[#1191]: https://github.com/kmuto/review/pull/1191
+[#1195]: https://github.com/kmuto/review/issues/1195
+[#1198]: https://github.com/kmuto/review/pull/1198
+[#1199]: https://github.com/kmuto/review/pull/1199
+[#1201]: https://github.com/kmuto/review/pull/1201
+[#1202]: https://github.com/kmuto/review/pull/1202
+[#1203]: https://github.com/kmuto/review/pull/1203
+[#1204]: https://github.com/kmuto/review/pull/1204
+[#1206]: https://github.com/kmuto/review/issues/1206
+[#1208]: https://github.com/kmuto/review/pull/1208
+[#1210]: https://github.com/kmuto/review/issues/1210
+
 # Version 3.0.0 preview 4
 ## 新機能
 * 旧バージョンのプロジェクトを新しいバージョンに合わせたものに更新する `review-update` コマンドを導入しました ([#1144])
@@ -13,10 +74,6 @@
 * PDFMaker: review-jlreq.cls クラスファイルでも hiddenfolio パラメータを利用できるようにしました ([#1147])
 * EPUBMaker/WEBMaker: imgmath 機能を有効にしたときに、各 `//texequation` に対してフォントサイズを明示して渡すようにしました ([#1146])
 
-## ドキュメント
-
-## コントリビューターのみなさん
-
 [#1144]: https://github.com/kmuto/review/issues/1144
 [#1146]: https://github.com/kmuto/review/issues/1146
 [#1147]: https://github.com/kmuto/review/issues/1147

data/NEWS.md

@@ -1,3 +1,64 @@
+# Version 3.0.0 release candidate
+## Breaking Changes
+* PDFMaker: heading character size of review-jsbook becomes the same as the original jsbook ([#1152])
+* PDFMaker: Q, W, L, H parameters of review-jsbook are withdrawn. Projects created in the past preview version can be updated with the review-update command ([#1151],[#1201])
+
+## Bug Fixes
+* PDFMaker: fixes an issue that hiddenfolio parameter was ignored when using both hiddenfolio and tombopaper in review-jsbook ([#1158])
+* PDFMaker: fixes a problem that the paperwidth and paperheight parameters of review-jsbook didn't work ([#1171])
+* fixes an issue that review-update ignored update of sty folder ([#1183])
+
+## Enhancements
+* PDFMaker: in review-jsbook, you can specify the font size with `fontsize` parameter and the line height with `baselineskip` parameter with units such as pt and mm ([#1151])
+* PDFMaker: users who want to continue using the original jsbook.cls class file for some reason can use sty files of review-jsbook set ([#1177])
+* PDFMaker: add useful macros to review-jsbook and review-jlreq for users. `\oneblankpage` creates an empty page. `\clearoddpage` breaks page as necessary so that the next page is always an even page ([#1175],[#1182])
+* PDFMaker: add `media` parameter that specifies the type of PDF to review-jsbook and review-jlreq. This has the same meaning as `cameraready` ([#1181])
+* PDFMaker: sections are now allowed in part ([#1195])
+* PDFMaker: `\reviewusepart` macro is defined when theare is a part ([#1199])
+* `texdocumentclass` parameter is explicit (not a comment) when creating config.yml by review-init ([#1202])
+* PDFMaker: line feed (`@<br>`) in the table is now represented by `\newline` macro when the width is explicity specified with `//tsize` ([#1206])
+* PDFMaker: enable to use `L{width}` (left justified), `C{width}` (centering), `R{width}` (right justified) as representation of the table column width ([#1208])
+* PDFMaker: to avoid implementation differences between versions, the snapshots jsbook.cls (2018/06/23) and gentombow.sty (2018/08/30 v0.9j) are copied to the `sty` folder ([#1210])
+
+## Bug Fixes
+* PDFMaker: fix serial_pagination and startpage were not working in review-jlreq class ([#1204])
+
+## Docs
+* update `format_idg.ja.md` ([#1188])
+* add note about review-update command to quickstart guide `quickstart.ja.md` ([#1189])
+* update comments of `config.yml.sample` ([#1190])
+* update `pdfmaker.ja.md` ([#1191])
+* update `writing_vertical.ja.md`  ([#1198])
+* update document of review-jsbook ([#1203])
+* update document of review-jlreq ([#1204])
+
+## Contributors
+* [@munepi](https://github.com/munepi)
+
+[#1151]: https://github.com/kmuto/review/issues/1151
+[#1152]: https://github.com/kmuto/review/issues/1152
+[#1158]: https://github.com/kmuto/review/issues/1158
+[#1171]: https://github.com/kmuto/review/issues/1171
+[#1175]: https://github.com/kmuto/review/pull/1175
+[#1177]: https://github.com/kmuto/review/pull/1177
+[#1181]: https://github.com/kmuto/review/issues/1181
+[#1182]: https://github.com/kmuto/review/pull/1182
+[#1183]: https://github.com/kmuto/review/issues/1183
+[#1188]: https://github.com/kmuto/review/pull/1188
+[#1189]: https://github.com/kmuto/review/pull/1189
+[#1190]: https://github.com/kmuto/review/pull/1190
+[#1191]: https://github.com/kmuto/review/pull/1191
+[#1195]: https://github.com/kmuto/review/issues/1195
+[#1198]: https://github.com/kmuto/review/pull/1198
+[#1199]: https://github.com/kmuto/review/pull/1199
+[#1201]: https://github.com/kmuto/review/pull/1201
+[#1202]: https://github.com/kmuto/review/pull/1202
+[#1203]: https://github.com/kmuto/review/pull/1203
+[#1204]: https://github.com/kmuto/review/pull/1204
+[#1206]: https://github.com/kmuto/review/issues/1206
+[#1208]: https://github.com/kmuto/review/pull/1208
+[#1210]: https://github.com/kmuto/review/issues/1210
+
 # Version 3.0.0 preview 4
 ## New Features
 * new command `review-update` is added, which updates the setting of the project files to the new version ([#1144])
@@ -13,10 +74,6 @@
 * PDFMaker: support hiddenfolio parameter with review-jlreq.cls ([#1147])
 * EPUBMaker/WEBMaker: when imgmath function is enabled, font size is passed to each `//texequation` ([#1146])
 
-## Docs
-
-## Contributors
-
 [#1144]: https://github.com/kmuto/review/issues/1144
 [#1146]: https://github.com/kmuto/review/issues/1146
 [#1147]: https://github.com/kmuto/review/issues/1147

data/README.md

@@ -101,7 +101,8 @@ Exception:
 * doc/*, samples/*: MIT License. See [LICENSE](https://github.com/kmuto/review/blob/master/doc/LICENSE) file.
 * jumoline.sty, vendor/jumoline: The LaTeX Project Public License. See [LPPL](https://github.com/kmuto/review/blob/master/vendor/jumoline/lppl.txt) file.
 * plistings.sty, vendor/plistings: MIT License. See [LICENSE](https://github.com/kmuto/review/blob/master/vendor/plistings/LICENSE) file.
-* gentombow09j.sty, vendor/gentombow: BSD License. See [LICENSE](https://github.com/kmuto/review/blob/master/vendor/gentombow/LICENSE) file.
+* gentombow.sty, vendor/gentombow: BSD License. See [LICENSE](https://github.com/kmuto/review/blob/master/vendor/gentombow/LICENSE) file.
+- jsbook.sty, vendor/jsclasses: BSD License. See [LICENSE](https://github.com/kmuto/review/blob/master/vendor/jsclasses/LICENSE) file.
 
 ## Copyright
 

data/doc/config.yml.sample

@@ -65,14 +65,14 @@ aut: ["青木峰郎", "武藤健志", "高橋征義", "角征典"]
 # a-trl, trl: 翻訳者
 
 # 刊行日(省略した場合は実行時の日付)
-# date: 2016-04-20
+# date: 2018-11-11
 # 発行年月。YYYY-MM-DD形式による配列指定。省略した場合はdateを使用する
 # 複数指定する場合は次のように記述する
 # [["初版第1刷の日付", "初版第2刷の日付"], ["第2版第1刷の日付"]]
 # 日付の後ろを空白文字で区切り、任意の文字列を置くことも可能。
-# history: [["2016-04-20 v1.0.0版発行"]]
+# history: [["2016-04-20 v1.0.0版発行", "2018-11-11 v3.0.0版発行"]]
 # 権利表記(配列で複数指定可)
-# rights: (C) 2016 Re:VIEW Developers
+# rights: (C) 2016-2018 Re:VIEW Developers
 # description: 説明
 # subject: 短い説明用タグ(配列で複数指定可)
 # type: 書籍のカテゴリーなど(配列で複数指定可)
@@ -97,10 +97,10 @@ debug: null
 stylesheet: ["sample.css"]
 
 # ePUBのバージョン (2か3)
-# epubversion: 2
+# epubversion: 3
 #
 # HTMLのバージョン (4か5。epubversionを3にしたときには5にする)
-# htmlversion: 4
+# htmlversion: 5
 
 # 目次として抽出する見出しレベル
 toclevel: 3
@@ -110,16 +110,6 @@ toclevel: 3
 # 本文でセクション番号を表示する見出しレベル
 secnolevel: 2
 
-# 以下のsecnolevelはまだ未実装。
-# 前付でセクション番号を表示する見出しレベル(未実装)
-# pre_secnolevel: 0
-#
-# 後付(付録)でセクション番号を表示する見出しレベル(未実装)
-# post_secnolevel: 1
-#
-# 部番号を表示する見出しレベル(未実装)
-# part_secnolevel: 1
-
 # 本文中に目次ページを作成するか。省略した場合はnull (作成しない)
 # toc: true
 
@@ -186,14 +176,51 @@ secnolevel: 2
 # @<w>命令で使用する単語ファイルのパス
 # words_file: words.csv
 
-# 1ページの行数文字数と1kbごとのページ数を用紙サイズで指定する(A5 or B5)。
+# review-vol向けのヒント情報
+# 1ページの行数文字数と1kbごとのページ数を用紙サイズで指定する(A5 or B5)
 # page_metric: A5
 #
 # あるいは、配列で指定することもできる
-# 各数字の意味は、順にリストの行数、リストの1行字数、テキストの行数、テキストの1行字数、1kバイト毎のページ数
+# 各数字の意味は、順にリストの行数、リストの1行字数、テキストの行数、テキストの1行字数、1kバイトごとのページ数
 # page_metric: [40,80,40,80,2]
 
-# ページ送りの送り方向、page-progression-directionの値("ltr"|"rtl"|"default")
+# EPUBおよびWeb生成における数式の画像化指定
+# TeXの数式を画像化するか。省略した場合はnull (作成しない)
+# imgmath: true
+
+# imgmathがtrueの場合の設定
+# 以下のパラメータを有効にするときには、
+# imgmath_options:
+#    パラメータ: 値
+#    パラメータ: 値
+#   ...
+# という構成にする必要がある(インデントさせる)
+# imgmath_options:
+  # 使用する画像拡張子。通常は「png」か「svg」（svgの場合は、pdfcrop_pixelize_cmdの-pngも-svgにする）
+  # format: png
+  # 変換手法。pdfcrop または dvipng
+  # converter: pdfcrop
+  # プリアンブルの内容を上書きするファイルを指定する（デフォルトはupLaTeX+jsarticle.clsを前提とした、lib/review/makerhelper.rbのdefault_imgmath_preambleメソッドの内容）
+  # preamble_file: null
+  # 基準のフォントサイズ
+  # fontsize: 10
+  # 基準の行間
+  # lineheight: 12
+  # converterにpdfcropを指定したときのpdfcropコマンドのコマンドライン。プレースホルダは
+  # %i: 入力ファイル、%o: 出力ファイル
+  # pdfcrop_cmd: "pdfcrop --hires %i %o"
+  # PDFから画像化するコマンドのコマンドライン。プレースホルダは
+  # %i: 入力ファイル、%o: 出力ファイル、%O: 出力ファイルから拡張子を除いたもの
+  # %p: 対象ページ番号
+  # pdfcrop_pixelize_cmd: "pdftocairo -png -r 90 -f %p -l %p -singlefile %i %O"
+  # pdfcrop_pixelize_cmdが複数ページの処理に対応していない場合に単ページ化するか
+  # extract_singlepage: null
+  # extract_singlepageがtrueの場合に単ページ化するコマンドのコマンドライン
+  # pdfextract_cmd: "pdfjam -q --outfile %o %i %p"
+  # converterにdvipngを指定したときのdvipngコマンドのコマンドライン
+  # dvipng_cmd: "dvipng -T tight -z 9 -p %p -l %p -o %o %i"
+
+# EPUBにおけるページ送りの送り方向、page-progression-directionの値("ltr"|"rtl"|"default")
 # direction: "ltr"
 
 # EPUBのOPFへの固有の追加ルール
@@ -285,8 +312,9 @@ epubmaker:
 # texstyle: ["reviewmacro"]
 #
 # LaTeX用のdocumentclassを指定する
-# review-jsbook.clsのオプションについてはsty/README.mdを参照
-# texdocumentclass: ["review-jsbook", "cameraready=print,paper=a5"]
+# オプションについてはsty/README.mdを参照
+# デフォルトは印刷用。電子配布版を作るには media=ebook とする
+# texdocumentclass: ["review-jsbook", "media=print,paper=a5"]
 #
 # LaTeX用のコマンドを指定する
 # texcommand: "uplatex"

data/doc/config.yml.sample-simple

@@ -1,7 +1,7 @@
 # simple sample of config.yml
 review_version: 3.0
 
-debug: true
+# debug: true
 
 ## inherited configuratons
 
@@ -20,9 +20,9 @@ aut: ["Masayoshi Takahashi"]
 # edt: null
 pbl: "Re:VIEW Publishing inc."
 prt: "Re:VIEW Printing inc."
-date: 2016-05-03
-history: [["2012-01-30"],["2016-04-20","2016-05-03"]]
-rights: (C) 2016 Re:VIEW Commiters, some rights reserved.
+date: 2018-11-11
+history: [["2012-01-30"],["2016-04-20","2016-05-03"],["2018-11-11"]]
+rights: (C) 2016-2018 Re:VIEW Commiters, some rights reserved.
 description: sample config.yml file for Re:VIEW book
 urnid: urn:uid:http://reviewml.org/review-sample-book
 # isbn: null
@@ -68,10 +68,11 @@ epubmaker:
 
 ## for LaTeX
 
-texstyle: reviewmacro
-texdocumentclass: ["jsbook", "uplatex,oneside"]
+texstyle: ["reviewmacro"]
+texdocumentclass: ["review-jsbook", "media=print,paper=a5,cover=false"]
 
 ## for PDFMaker
 
 pdfmaker:
   colophon: true
+  # coverimage: cover-a5.ai

data/doc/format_idg.ja.md

@@ -40,7 +40,7 @@ Re:VIEW フォーマットから、Adobe 社の DTP ソフトウェア「InDesig
 `@<dtp>{ 〜 }` で「`<? dtp 〜 ?>`」という XML インストラクションを埋め込みます。処理系に渡す任意の文字列を指定できますが、次のような文字列を特殊文字指定できます。
 
 * maru : 番号リストの各段落先頭で使い、このリスト段落の番号は丸数字であることを示す
-* return  改行記号文字
+* return : 改行記号文字
 * autopagenumber : 現ページ番号
 * nextpageunmber : 次ページ番号
 * previouspagenumber : 前ページ番号
@@ -91,7 +91,7 @@ Re:VIEW フォーマットから、Adobe 社の DTP ソフトウェア「InDesig
 
 ## 表セル幅の指定
 
-`//tsize[|latex|1列目の幅,2列目の幅,...]` で、続く `//table` の表の列幅を指定します（単位mm）。これを利用するときには、`review compile --target=idgxml` を実行する際、オプション`--table=表幅` を付ける必要があります（表幅の単位は mm）。列幅指定の個数が実際の列数に満たない場合、残りの列は均等分割したものとなります。列幅の合計が表幅を超えると警告が表示されます。
+`//tsize[|idgxml|1列目の幅,2列目の幅,...]` で、続く `//table` の表の列幅を指定します（単位mm）。これを利用するときには、`review compile --target=idgxml` を実行する際、オプション`--table=表幅` を付ける必要があります（表幅の単位は mm）。列幅指定の個数が実際の列数に満たない場合、残りの列は均等分割したものとなります。列幅の合計が表幅を超えると警告が表示されます。
 
 ## 表セルの結合やスタイル指定
 `@<dtp>{table 表オプション}` を各セルに入れることで、そのセルの挙動を制御します。
@@ -102,3 +102,7 @@ Re:VIEW フォーマットから、Adobe 社の DTP ソフトウェア「InDesig
 * `rowspan=行数` : 下方向に結合
 * `type=名前` : セルの種類の指定
 * `align=位置` : セル内の内容の位置。通常の用途では left|center|right のいずれか
+
+実際には、スクリプトで判断して後処理することを想定しています。
+
+* 例: https://github.com/kmuto/reviewindesignbook/blob/master/book-IDGXML/book-IDGXML-02modifyTable.jsx

data/doc/pdfmaker.ja.md

@@ -7,16 +7,107 @@ Re:VIEW の review-pdfmaker は、フリーソフトウェアの簡易 DTP シ
 * https://texwiki.texjp.org/?TeX入手法
 
 ## Re:VIEW バージョンによる変化についての注意
-* Re:VIEW 3.0 より、使用するデフォルトのクラスファイルを jsbook.cls から review-jsbook.cls に変更しました。以下の「review-jsbook.cls について」を参照してください。
+* Re:VIEW 3.0 より、使用するデフォルトのクラスファイルを jsbook.cls から review-jsbook.cls に変更しました。また、別のクラスファイルとして review-jlreq.cls も提供しています。以下の「新しいレイアウトファイルおよび review-jsbook.cls について」を参照してください。
 * Re:VIEW 2.0 より、LaTeX コンパイラのデフォルトが pLaTeX から upLaTeX になりました。以下の「upLaTeX について」を参照してください。
 * Re:VIEW 2.0 より、image タグに `scale` オプションを使って倍率数値を定義していた場合の挙動が変わりました。以下の「scale オプションの挙動について」を参照してください。
 * Re:VIEW 2.0 より、config.yml 等の設定ファイルで使われる `prt` のデフォルトが「発行所」ではなく「印刷所」になりました。「発行所」には `pbl` のほうをお使いください。
 
-## review-jsbook.cls について
+## 新しいレイアウトファイルおよび review-jsbook.cls について
 
-★TBD
+Re:VIEW 3.0 より、デフォルトのクラスファイルを jsbook.cls から review-jsbook.cls に切り替えました。
 
-`texdocumentclass` で明示的な設定をしていない場合は、config.yml の `review_version` の値に基づいて切り替えられ、2.0 の場合は従来の jsbook.cls が使われるようになっています。
+`texdocumentclass` で明示的な設定をしていない場合は、config.yml の `review_version` の値に基づいて切り替えられます。`review_version` が 2.0 の場合は、互換性保持のために従来のレイアウトファイルおよび jsbook.cls が使われるようになっています。
+
+### レイアウトファイル `layout.tex.erb` の変更
+
+レイアウトファイル  `layout.tex.erb` は Re:VIEW 2 バージョンのものから一新され、互換性はなくなりました。
+
+これまでは `layout.tex.erb` の中で config.yml の値などの判定を Ruby の埋め込みコードで処理していましたが、config.yml の値はまず TeX のマクロに文字列として格納され、そのマクロをクラスファイルやスタイルファイルで参照して使用します。これにより、（TeX の知識はより必要になりますが）upLaTeX 以外の別のコンパイラを使用したり、独自のクラスファイルやスタイルファイルを作ったりすることが容易になります。
+
+config.yml から TeX マクロへの転換は、Re:VIEW プログラムの `templates/latex/config.erb` で実装されています。この結果、新しい `layout.tex.erb` における Ruby の埋め込みコードは以下のプリアンブルの箇所のみとなります。
+
+```
+\documentclass[<%= @documentclassoption %>]{<%= @documentclass %>}
+<%= latex_config %>
+<%- if @config['texstyle'] -%>
+<%-   [@config['texstyle']].flatten.each do |x| -%>
+\usepackage{<%= x %>}
+<%-   end -%>
+<%- end -%>
+
+\begin{document}
+
+```
+
+新しい `layout.tex.erb` では、以下のようなマクロを定義あるいは変更することで書籍を構成します。
+
+* `\reviewbegindocumenthook` : ドキュメント開始直後のフック
+* `\reviewcoverpagecont` : 表紙
+* `\reviewfrontmatterhook` : 前付の前のフック
+* `\reviewtitlepagecont` : 大扉
+* `\revieworiginaltitlepagecont` : 翻訳書における原書大扉
+* `\reviewcreditfilecont` : クレジット情報
+* `\reviewprefacefiles` : 前付（PREDEF）
+* `\reviewtableofcontents` : 目次
+* `\reviewmainmatterhook` : 本文の前のフック
+* `\reviewchapterfiles` : 本文（CHAPS）
+* `\reviewappendixhook` : 付録の前のフック
+* `\reviewappendixfiles` : 付録（APPENDIX）
+* `\reviewbackmatterhook` : 後付の前のフック
+* `\reviewpostdeffiles` : 後付（POSTDEF）
+* `\reviewprintindex` : 索引
+* `\reviewprofilepagecont` : 著者紹介
+* `\reviewadvfilepagecont` : 広告
+* `\reviewcolophonpagecont` : 奥付
+* `\reviewbackcovercont` : 裏表紙
+* `\reviewenddocumenthook` : ドキュメント終了直前のフック
+
+過去のバージョンのように全面的に Ruby の埋め込みコードで各種の処理をしたいときには、任意の `layouts/layout.tex.erb` を使用し続けることも可能です。
+
+### review-jsbook.cls の構成
+
+`review-init` コマンドで新たなドキュメントフォルダを作成すると sty フォルダに以下のファイルが展開されます。
+
+* `review-jsbook.cls` : 紙面表現の基本的な設計を提供するクラスファイルです。
+* `jsbook.cls` : jsbook オリジナルのコピーです。TeX 配布物でのバージョン違いの差異を避けるため、Re:VIEW 本体でスナップショットを保持しています。
+* `plistings.sty` : プログラムコードのハイライト表現を行う支援パッケージです。
+* `jumoline.sty` : 下線を表現する支援パッケージです。
+* `gentombow.sty` : トンボを表現する支援パッケージです。
+* `reviewmacro.sty` : 以下のスタイルファイルを取り込むスタイルファイルです。このファイルを config.yml の texstyle パラメータで指定すれば、すべてのスタイルファイルが取り込まれます。
+* `review-base.sty` : Re:VIEW固有のマクロ名と TeX のマクロとを結び付けるスタイルファイルです。また、`layout.tex.erb` の各マクロの実体を定義します。
+* `review-style.sty` : 基本的な見映えに加えて見た目の調整を定義するスタイルファイルです。review-jsbook.cls が提供するこのファイルは、従来のバージョンとの互換性を持たせたもので、華やかさを追求したものではありません。
+* `review-custom.sty` : このファイルは空の内容で、ユーザーが任意でマクロを追加したり既存のマクロを上書きしたりすることを想定したスタイルファイルです。
+
+review-jsbook.cls は従来の jsbook.cls を包み、以下の機能を提供します。
+
+* ドキュメントクラスオプションでほとんどの紙面設計を設定できます。
+* クラスオプション `media=print` （デフォルト）で印刷用に適した紙面、`media=ebook` で電子PDF媒体に適した紙面を作成します。印刷用ではデジタルトンボおよび紙面上トンボを配置し、表紙は付けません。電子用ではトンボなしの仕上がりサイズで、表紙を付けます。明示的に表紙の有無を指定することも可能です（`cover=trueまたはfalse`）。
+* クラスオプション `paper=紙サイズ` で用紙サイズを指定できます。
+* クラスオプション `fontsize=基本文字サイズ`、`baselineskip=基本行送り`、`line_length=1行の字詰め`、`number_of_lines=行数`、`head_space=天`、`guter=ノド` による基本版面設計が可能です。
+* クラスオプション `startpage=ページ番号` で大扉のページ開始番号を指定できます。
+* クラスオプション `serial_pagination=trueまたはfalse` でページ番号を大扉からアラビア数字で通すことができます。
+* クラスオプション `hiddenfolio=プリセット` でノドに隠しノンブルを入れることができます（プリセットは `nikko-pc` など）。
+
+texdocumentclass パラメータに何も指定をしなければ、以下のようになります。
+
+* 印刷用（`media=print`）。トンボあり
+* 表紙なし
+* 用紙はA4（`paper=a4`）
+* 表紙なし（`cover=false`）
+* 基本版面の基本文字サイズは 10pt、ほかは jsbook を継承
+* 隠しノンブルなし
+
+その他の詳細な設定については、sty フォルダにある README.md を参照してください。
+
+既存のドキュメントフォルダを Re:VIEW 3.0 （およびより新しいバージョン）に更新するには、ドキュメントフォルダ内で review-update コマンドを実行します。これで、スタイルファイルのコピーや、config.yml 等の既存のパラメータを解析して妥当なオプション指定に移行するといった処理が行われます。
+
+### review-jlreq.cls の構成
+
+Re:VIEW 3.0 から review-jlreq.cls という別のクラスファイルも用意しています。review-jlreq.cls は「日本語組版処理の要件」( https://www.w3.org/TR/jlreq/ja/ ) に基づく紙面設計を採用している jlreq.cls を包んだクラスファイルです。
+
+`review-init --latex-template=review-jlreq` コマンドで、このクラスファイルを使うように sty フォルダへファイルが展開されます。
+
+その他の詳細な設定については、sty フォルダにある README.md を参照してください。
 
 ## Re:VIEW 2.0 以前の情報