review-retrovert 0.9.7 → 0.9.8

data/testdata/mybook/config.yml

@@ -36,6 +36,21 @@ aut:
   - name:    カウプラン機関極東支部
     file-as: カウプランキカンキョクトウシブ
 
+# (Starter拡張) 奥付に載せるデータ。現在はPDFのみ対応。
+additional:
+  # 技書博では発行責任者とその連絡先が必須になった。
+  # 詳しくはこのページを参照：
+  # https://esa-pages.io/p/sharing/13039/posts/115/7fbe936149a836eac678.html#奥付の記載
+  - key:     発行者   # サークル名ではなく個人名（ペンネーム可）
+    value:   
+  - key:     連絡先   # メールアドレス推奨
+    value:
+    ### 連絡先の例：
+    #value:
+    #  - xxxxx@example.com          # メールアドレス
+    #  - https://www.example.com/   # WebサイトURL
+    #  - "@xxxxx"                   # Twitterアカウント（先頭に '@' をつけること）
+
 # 以下はオプション
 # 以下はオプション(autと同じように配列書式で複数指定可能)。
 # 読みの指定はaut:の例を参照。
@@ -74,16 +89,18 @@ prt: ○○印刷所
 # a-trl, trl: 翻訳者
 
 # 刊行日(省略した場合は実行時の日付)
-date: 2020-02-29
+date: 2021-07-10
 # 発行年月。YYYY-MM-DD形式による配列指定。省略した場合はdateを使用する
 # 複数指定する場合は次のように記述する
 # [["初版第1刷の日付", "初版第2刷の日付"], ["第2版第1刷の日付"]]
 # 日付の後ろを空白文字で区切り、任意の文字列を置くことも可能。
-history: [["2020-02-29 ver 1.0"]]
+history:
+  - # 初版
+    - 2021-07-10 ver 1.0 （技術書典11）
 # [experimental] 新刊を頒布したイベント名（例：「技術書典6（2019年春）新刊」）
-pubevent_name: 技術書典8（2020年春）新刊
+pubevent_name: 技術書典11（2021年夏）新刊
 # 権利表記(配列で複数指定可)
-rights: (C) 2020 カウプラン機関極東支部
+rights: (C) 2021 カウプラン機関極東支部
 # description: 説明
 # subject: 短い説明用タグ(配列で複数指定可)
 # type: 書籍のカテゴリーなど(配列で複数指定可)
@@ -198,6 +215,10 @@ titlepage: true
 # contentdir: null
 contentdir: contents
 
+# @<w>命令で使用する単語ファイルのパス。文字コードは必ずUTF-8。
+# CSV形式 (*.csv) とタブ区切りテキスト (*.txt または *.tsv) が利用可能。
+words_file: data/words.txt     # [f1.csv, f2.txt] のように複数指定も可能
+
 # 1ページの行数文字数と1kbごとのページ数を用紙サイズで指定する(A5 or B5)。
 # page_metric: A5
 #
@@ -294,7 +315,7 @@ epubmaker:
   # epubmaker:階層を使うものはここまで
 
 # LaTeX用のスタイルファイル(styディレクトリ以下に置くこと)
-texstyle: [reviewmacro, starter, mystyle, mytitlepage, mycolophon]
+texstyle: [reviewmacro, starter, mytitlepage, mycolophon, mystyle]
 #
 # LaTeX用のdocumentclassを指定する
 # texdocumentclass: ["jsbook", "uplatex,oneside"]
@@ -317,7 +338,7 @@ texoptions: "-halt-on-error -file-line-error"  # エラー時にインタラク
 dvicommand: dvipdfmx
 #
 # LaTeX用のdvi変換コマンドのオプションを指定する
-dvioptions: "-d 5 -z 3"  # -z 9 だと画像を最大圧縮する（ただし時間がかかる）
+dvioptions: "-q -d 5 -z 3"  # -z 9 だと画像を最大圧縮する（ただし時間がかかる）
 
 # 以下のパラメータを有効にするときには、
 # pdfmaker:
@@ -344,20 +365,28 @@ pdfmaker:
   # 画像のscale=X.Xという指定を画像拡大縮小率からページ最大幅の相対倍率に変換します。
   # image_scale2width: true
   #
+  # 索引
+  makeindex:                      # true なら本の巻末に索引をつける
+  # 索引作成コマンドの設定
+  makeindex_command: upmendex          # 索引を生成するコマンド（デフォルト値：mendex）
+  makeindex_options: "-q -g"           # 索引見出しを「あ か さ た な は …」にする
+  #makeindex_options: "-q"             # 索引見出しを「あ い う え お か …」にする
+  #makeindex_options: "-f -r -I utf8"  # （参考：Re:VIEWでのデフォルト値）
+  makeindex_sty: sty/indexstyle.ist    # スタイルファイル
+  makeindex_dic: data/terms.txt        # 用語の読み仮名が書かれたファイル
+  makeindex_mecab: false               # 読み仮名を形態素解析で自動取得するか？
+  makeindex_mecab_opts: "-Oyomi"       # 形態素解析エンジン「MeCab」のオプション
+  #
   # 奥付を作成するか。trueを指定するとデフォルトの奥付、ファイル名を指定するとそれがcolophon.htmlとしてコピーされる
   colophon: true
   #
   # 表紙に配置し、書籍の影絵にも利用する画像ファイル。同人誌の印刷では一般的に、表紙は本文と別ファイルにするので、ここはnullにする。
   #coverimage: null
-  ### Starterでは、表紙をPDFで用意してください。電子用PDFでのみ挿入されます。
-  ### ・デフォルトでは印刷用PDFファイルが生成させるので挿入されません。
-  ### ・config-starter.ymlで「target: ebook」を設定するか、または
-  ###   環境変数「STARTER_TARGET=ebook」を設定すると電子用になり、
-  ###   表紙PDFが挿入されます。
-  ### ・表紙用PDFファイルは images/ フォルダ直下に置いてください。
-  coverpdf_files: [cover_a5.pdf]  # PDFファイル名（複数指定可）（PNGやJPGはダメ）
-  backcoverpdf_files: []  # 裏表紙のPDFファイル名（複数指定可）（PNGやJPGはダメ）
-  coverpdf_option: "offset=-2.3mm 2.3mm" # 必要に応じて微調整すること
+  #
+  ### 【注意】次の設定項目は config-starter.yml に移動し、項目名も変わりました。
+  ###   ・coverpdf_files:     => frontcover_pdffile:
+  ###   ・backcoverpdf_files: => backcover_pdffile:
+  ###   ・coverpdf_option:    => includepdf_option:
   #
   # pdfmaker:階層を使うものはここまで
 

data/testdata/mybook/contents/00-preface.re

@@ -1,4 +1,4 @@
-= まえがき
+= まえがき / はじめに
 
 //centering{
 ＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊ @<strong>{注意} ＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊
@@ -58,7 +58,7 @@ $ @<userinput>{vi catalog.yml}          @<balloon>{各章のファイル名を
 本書では次のような人を対象としています。
 
  * XXXについて興味がある人
- * XXXの入門書を読んだ人（まったくの初心者は対象外です）
+ * XXXの入門書を読んだ初級者の人（まったくの初心者は対象外です）
 
 
 ====[notoc] 前提とする知識
@@ -81,3 +81,49 @@ $ @<userinput>{vi catalog.yml}          @<balloon>{各章のファイル名を
 
 本書はXXXX氏とXXXX氏にレビューしていただきました。
 この場を借りて感謝します。ありがとうございました。
+
+
+
+//clearpage
+
+==[notoc] 凡例
+
+本書では、プログラムコードを次のように表示します。太字は強調を表します。
+
+//list[][]{
+print("Hello, @<b>|world|!\n");       @<balloon>{太字は強調}
+//}
+
+プログラムコードの差分を表示する場合は、追加されたコードを太字で、削除されたコードを取り消し線で表します。
+
+//list[][]{
+@<del>|print("Hello, @<b>|world|!\n");|       @<balloon>{取り消し線は削除したコード}
+@<b>|print("Hello, "+name+"!\n");|    @<balloon>{太字は追加したコード}
+//}
+
+長い行が右端で折り返されると、折り返されたことを表す小さな記号がつきます。
+
+//list[][]{
+123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_123456789_
+//}
+
+ターミナル画面は、次のように表示します。
+行頭の「@<code>|$ |」はプロンプトを表し、ユーザが入力するコマンドには薄い下線を引いています。
+
+//terminal{
+$ @<userinput>|echo Hello|       @<balloon>{行頭の「$ 」はプロンプト、それ以降がユーザ入力}
+//}
+
+本文に対する補足情報や注意・警告は、次のようなノートや囲み枠で表示します。
+
+//note[ノートタイトル]{
+ノートは本文に対する補足情報です。
+//}
+
+//info[タイトル]{
+本文に対する補足情報です。
+//}
+
+//caution[タイトル]{
+本文に対する注意・警告です。
+//}

data/testdata/mybook/contents/01-install.re

@@ -39,6 +39,9 @@ e-upTeX 3.14159265-p3.7.1-u1.22-161114-2.6 (utf8.uptex) (TeX Live 2017/Debian)
 ...(省略)...
 //}
 
+#@#なおmacOSのようにRubyが使える環境なら、「@<code>|docker pull kauplan/review2.5|」のかわりに「@<code>|rake setup:dockerimage|」を実行してもいいです（内部で同じことを行います）。
+なおmacOSのようにRubyが使える環境なら、「@<code>|rake setup:dockerimage|」を実行すると自動的に「@<code>|docker pull kauplan/review2.5|」が実行されます。
+
 
 === macOSを使っている場合
 
@@ -61,14 +64,42 @@ ruby 2.3.7p456 (2018-03-28 revision 63024) [universal.x86_64-darwin18]
 
 実際の出力結果は上と少し違うはずですが、だいたい合っていればOKです。
 
-また、必要なライブラリをインストールするために、以下のコマンドも実行してください（各行の先頭にある「@<code>{$ }」は入力せず、それ以降のコマンドを入力してください）。
+また必要なライブラリをインストールするために、以下のコマンドも実行してください（各行の先頭にある「@<code>{$ }」は入力せず、それ以降のコマンドを入力してください）。
 
 //terminal[][必要なライブラリをインストール]{
+### Rubyに詳しくない初心者向け
+$ @<userinput>{rake setup:rubygems}
+
+### Rubyに詳しい人向け
 $ @<userinput>{gem install review --version=2.5}
 $ @<userinput>{review version}
 2.5.0   @<balloon>{必ず「2.5.0」であること（より新しいバージョンは未サポート）}
 //}
 
+//note[macOS標準のRubyでは「gem install」がエラーになる]{
+macOSには標準でRubyがインストールされていますが、それを使って「@<code>|gem install|」を実行するとエラーになります。
+
+//terminal[][macOS標準のRubyではgemがインストールできない]{
+$ gem install review --version=2.5
+ERROR:  While executing gem ... (Gem::FilePermissionError)
+    You don't have write permissions for the /Library/Ruby/Gems/2.3.0 directory.
+//}
+
+このエラーを回避するには、次のような方法があります。
+
+ - (a) Homebrewなどを使って別のRubyをインストールする。
+ - (b) @<file>{~/.gemrc}に「@<code>{install: --user-install}」という行を追加する。
+ - (c) 「@<file>{rubygems/}」のようなフォルダを作り、そのパスを環境変数@<code>|$GEM_HOME|に設定する。
+
+しかしRubyやコマンドラインに慣れていない初心者にとっては、どの方法も難しいでしょう。
+
+そこで、(c)に相当する作業を自動的に行えるようにしました。
+それが、Rubyに詳しくない初心者向けのコマンド「@<code>|rake setup:rubygems|」です。
+詳しいことは@<file>{lib/tasks/starter.rake}の中の「@<code>|task :rubygems|」の定義を見てください。
+また環境変数@<code>|$GEM_HOME|を設定するかわりに、@<file>{Rakefile}の冒頭で@<code>|Gem.path|を設定しています。
+
+//}
+
 ==== MacTeXのインストール
 
 次に、MacTeXをダウンロードします。MacTeXとは、macOS用のTeXLiveです。
@@ -83,7 +114,7 @@ MacTeXはサイズが大きい（約4GB）ので、本家ではなく以下の
 
 ダウンロードができたら、ダブルクリックしてインストールしてください。
 
-インストールしたら、Terminal.appで次のコマンドを入力し、動作を確認してください（各行の先頭にある「@<code>{$ }」は入力せず、それ以降のコマンドを入力してください）。
+インストールしたらTerminal.appで次のコマンドを入力し、動作を確認してください（各行の先頭にある「@<code>{$ }」は入力せず、それ以降のコマンドを入力してください）。
 
 //terminal[][MacTeXのインストールができたことを確認]{
 $ @<userinput>{which uplatex}     @<balloon>{下線が引かれたコマンドだけを入力すること}
@@ -121,7 +152,7 @@ C:\Users\yourname> @<userinput>{ruby --version}  @<balloon>{「ruby --version」
 ruby 2.6.6-1 [x64-mingw32]
 //}
 
-実際の出力結果は上と少し違うと思いますが、だいたい合っていればOKです。
+実際の出力結果は上と少し違うでしょうが、だいたい合っていればOKです。
 
 また以下のコマンドを実行し、必要なライブラリをインストールします。
 
@@ -147,7 +178,7 @@ e-upTeX 3.14159265-p3.7.1-u1.22-161114-2.6 (utf8.uptex) (TeX Live 2020/W32TeX)
 ...（以下省略）...
 //}
 
-実際の出力結果は上と少し違うと思いますが、だいたい合っていればOKです。
+実際の出力結果は上と少し違うでしょうが、だいたい合っていればOKです。
 
 
 == プロジェクトを作成
@@ -267,6 +298,8 @@ C:\Users\yourname\mybook> @<userinput>{dir *.pdf} @<balloon>{PDFファイルが
 
  * エラーが発生したときの対処法は@<secref>{02-tutorial|subsec-compileerror}で簡単に説明しています。
    必ず読んでください。
- * ePubファイルを生成するときは「@<code>{rake epub}」または「@<code>{rake docker:epub}」、HTMLファイルを生成するときは「@<code>{rake web}」または「@<code>{rake docker:epub}」を実行してください。
+ * HTMLファイルを生成するときは「@<code>{rake web}」（または「@<code>{rake docker:web}」）を実行してください。
+ * ePubファイルを生成するときは「@<code>{rake epub}」（または「@<code>{rake docker:epub}」）を実行してください。
+ * Markdownファイルを生成するときは「@<code>{rake markdown}」（または「@<code>{rake docker:markdown}」）を実行してください。
  * Starterでは「@<code>{review-pdfmaker}」コマンドや「@<code>{review-epubmaker}」コマンドが使えません（実行はできますが望ましい結果にはなりません）。
    必ず「@<code>{rake pdf}」や「@<code>{rake epub}」を使ってください。

data/testdata/mybook/contents/02-tutorial.re

@@ -13,7 +13,7 @@
 
 
 
-== 用語の説明
+=={sec-terminology} 用語の説明
 
 このあとの説明で使用する用語を紹介します。
 
@@ -132,28 +132,28 @@
 	@<LaTeX>{}で使うスタイルファイルが置かれるフォルダです。
 #@# : @<file>{sty/jumoline.sty}
 #@#	@<LaTeX>{}で使うスタイルファイルのひとつです。
-#@# : @<file>{sty/mycolophon.sty}
-#@#	奥付@<fn>{fn-7ypmf}の内容が書かれたスタイルファイルです。
-#@#	奥付を変更したい場合はこのファイルを編集します。
+ : @<file>{sty/mycolophon.sty}
+	奥付@<fn>{fn-7ypmf}の内容が書かれたスタイルファイルです。
+	奥付を変更したい場合はこのファイルを編集します。
  : @<file>{sty/mystyle.sty}
 	ユーザが独自に@<LaTeX>{}マクロを定義・上書きするためのファイルです。
 	中身は空であり、ユーザが自由に追加して構いません。
  : @<file>{sty/mytextsize.sty}
 	PDFにおける本文の高さと幅を定義したファイルです。
 	@<LaTeX>{}では最初に本文の高さと幅を決める必要があるので、他のスタイルファイルから分離されてコンパイルの最初に読み込めるようになっています。
-#@# : @<file>{sty/mytitlepage.sty}
-#@#	大扉@<fn>{fn-cq9ws}の内容が書かれたスタイルファイルです。
-#@#	大扉のデザインを変更したい場合はこのファイルを編集します。
- : @<file>{sty/starter.sty}
+ : @<file>{sty/mytitlepage.sty}
+	大扉@<fn>{fn-cq9ws}の内容が書かれたスタイルファイルです。
+	大扉のデザインを変更したい場合はこのファイルを編集します。
+ : @<file>{sty/starter*.sty}
 	Starter独自のスタイルファイルです。
 	ここに書かれた@<LaTeX>{}マクロを変更したい場合は、このファイルを変更するよりも「@<file>{sty/mystyle.sty}」に書いたほうがバージョンアップがしやすくなります。
- : @<file>{sty/starter-headline.sty}
-	章(Chapter)や節(Section)や項(Subsection)の@<LaTeX>{}マクロが定義されたファイルです。
+#@# : @<file>{sty/starter-headline.sty}
+#@#	章(Chapter)や節(Section)や項(Subsection)の@<LaTeX>{}マクロが定義されたファイルです。
 
 
 //footnote[fn-zuxns][原稿ファイルを置くフォルダ名は「@<file>{config.yml}」の「@<code>|contentdir: contents|」で変更できます。]
-#@#//footnote[fn-7ypmf][@<em>{奥付}とは、本のタイトルや著者や出版社や版や刷などの情報が書かれたページのことです。通常は本のいちばん最後のページに置かれます。]
-#@#//footnote[fn-cq9ws][@<em>{大扉}とは、タイトルページのことです。表紙のことではありません。]
+//footnote[fn-7ypmf][@<em>{奥付}とは、本のタイトルや著者や出版社や版や刷などの情報が書かれたページのことです。通常は本のいちばん最後のページに置かれます。]
+//footnote[fn-cq9ws][@<em>{大扉}とは、タイトルページのことです。表紙のことではありません。]
 
 
 == 原稿の追加と変更
@@ -169,8 +169,11 @@
 まずはこれを変更してみましょう。
 
  - (1) まず、お好みのテキストエディタを使って「@<file>{mybook/contents/00-preface.re}」を開いてください。
- - (2) 次に、先頭の「@<code>{= はじめに}」の下に、何でもいいので適当なテキストを追加して（例：@<list>{6f3fh}）、原稿ファイルを保存してください。
- - (3) 原稿ファイルを保存したら、MacならTerminal.app@<fn>{f90kk}、Windowsならコマンドプロンプトを開き、「@<code>{rake pdf}」（またはDockerを使っているなら「@<code>{rake docker:pdf}」）を実行してください。
+ - (2) 次に、先頭の「@<code>{= はじめに}」の下に何か適当なテキストを追加して（例：@<list>{6f3fh}）、原稿ファイルを保存してください。
+ - (3) 原稿ファイルを保存したら、コンパイル@<fn>{fn-r19pw}しましょう。
+       MacならTerminal.app@<fn>{f90kk}、Windowsならコマンドプロンプトを開き、「@<code>{rake pdf}」（またはDockerを使っているなら「@<code>{rake docker:pdf}」）を実行してください。
+
+//footnote[fn-r19pw][「コンパイル」とは、ここでは原稿ファイルからPDFファイル（またはHTMLやePub）を生成することです。このあとも使う用語なので覚えてください。また用語については@<secref>{sec-terminology}も参照してください。]
 
 //list[6f3fh][原稿ファイルの内容]{
 = はじめに
@@ -187,7 +190,8 @@
 
 //note[プロジェクトのフォルダに原稿ファイルがあるとコンパイルエラー]{
 
-原稿ファイルを「@<file>{contents/}」に置くよう設定している場合、もし原稿ファイル(@<file>{*.re})がプロジェクトのフォルダ（たとえば「@<file>{mybook/}」の直下）にあると、コンパイル@<fn>{fn-zt1bb}できずエラーになります。
+Starterのデフォルトでは、原稿ファイル(@<file>{*.re})を「@<file>{contents/}」フォルダに置くよう設定されています。
+この場合、もし原稿ファイルがプロジェクトのフォルダ（たとえば「@<file>{mybook/}」の直下）にあると、コンパイル@<fn>{fn-zt1bb}できずエラーになります。
 
 エラーになるのは、Starterの仕組みに起因します。
 Starterではコンパイル時に、「@<file>{contents/}」に置かれた原稿ファイル（@<file>{*.re}）をプロジェクトフォルダの直下にコピーしてからコンパイルします）@<fn>{fn-g6oit}。
@@ -236,7 +240,7 @@ Starterではコンパイル時に、「@<file>{contents/}」に置かれた原
 本文本文本文
 //}
 
-//note[原稿ファイルには番号をつけるべき？]{
+//note[原稿ファイルに番号をつけるべきか]{
 この例では原稿ファイル名を「@<file>{01-test.re}」にしました。
 しかしファイル名に「@<file>{01-}」のような番号は、必ずしもつける必要はありません（つけてもいいし、つけなくてもいい）。
 
@@ -343,7 +347,7 @@ YAMLについてはGoogle検索で調べてください。
 
 ==={subsec-compileerror} コンパイルエラーになったら
 
-PDFファイルを生成するときにエラーになったら、以下の点を確認してください。
+PDFファイルの生成がエラーになったら、以下の点を確認してください。
 
  * インライン命令がきちんと閉じているか
  * ブロック命令の引数が足りているか、多すぎないか
@@ -358,6 +362,28 @@ PDFファイルを生成するときにエラーになったら、以下の点
 
 詳しくは@<secref>{05-faq|sec-compileerror}を見てください。
 
+それでもエラーになる場合は、中間ファイルを削除してみましょう。
+たとえばプロジェクト名が「@<file>{mybook}」だったら、「@<file>{mybook-pdf}」というフォルダが作られているはずです。
+これを削除してから、コンパイルし直してみてください。
+
+//terminal[][中間ファイルを削除してコンパイルし直す]{
+$ @<userinput>{rm -rf mybook-pdf}       @<balloon>{中間ファイルを削除して、}
+$ @<userinput>{rake pdf}                @<balloon>{コンパイルし直す}
+//}
+
+それでもダメなら、「@<hlink>{https://twitter.com/search?q=%23reviewstarter, #reviewstarter}」というタグでツイートしていただければ、相談に乗ります。
+
+
+=== 文章をチェックする
+
+Starterでは、「textlint」というツールを使って原稿の文章をチェックできます。
+
+たとえば「Starterを使うときれいなPDFを作成@<bou>{することが}できます」という文章は、「Starterを使うときれいなPDFを作成@<bou>{できます}」のように簡潔にできます。
+このような指摘を行ってくれるのがtextlintです。
+
+textlintをStarterのプロジェクトで使う方法は、@<secref>{06-bestpractice|sec-textlint}で解説しています。
+今はまだtextlintを使う必要はありませんが、Starterに慣れてきたら使ってみてください。
+
 
 
 =={sec-basicsyntax} 基本的な記法
@@ -379,27 +405,27 @@ PDFファイルを生成するときにエラーになったら、以下の点
 行コメントは「@<code>{#@#}」で、また範囲コメントは「@<code>{#@+++}」と「@<code>{#@---}」で表します。
 どちらも行の先頭から始まってないと、コメントとして認識されません。
 
-//list[][サンプル]{
-本文1
-@<b>|#@#|本文2
-本文3
+//list[][サンプル][]{
+本文1。
+@<b>|#@#|本文2。
+本文3。
 
 @<b>|#@+++|
-本文4
+本文4。
 @<b>|#@---|
-本文5
+本文5。
 //}
 
 //sampleoutputbegin[表示結果]
 
-本文1
-#@#本文2
-本文3
+本文1。
+#@#本文2。
+本文3。
 
 #@+++
-本文4
+本文4。
 #@---
-本文5
+本文5。
 
 //sampleoutputend
 
@@ -414,10 +440,11 @@ PDFファイルを生成するときにエラーになったら、以下の点
 改行は無視されるか、または半角空白扱いになります。
 通常は1文ごとに改行して書きます。
 
-//list[][サンプル]{
-言葉を慎みたまえ！君はラピュタ王の前にいるのだ！
+//list[][サンプル][]{
+言葉を慎みたまえ。君はラピュタ王の前にいるのだ。
 
-これから王国の復活を祝って、諸君にラピュタの力を見せてやろうと思ってね。見せてあげよう、ラピュタの雷を！
+これから王国の復活を祝って、諸君にラピュタの力を見せてやろうと思ってね。
+見せてあげよう、ラピュタの雷を！
 
 旧約聖書にあるソドムとゴモラを滅ぼした天の火だよ。
 ラーマヤーナではインドラの矢とも伝えているがね。
@@ -425,9 +452,10 @@ PDFファイルを生成するときにエラーになったら、以下の点
 
 //sampleoutputbegin[表示結果]
 
-言葉を慎みたまえ！君はラピュタ王の前にいるのだ！
+言葉を慎みたまえ。君はラピュタ王の前にいるのだ。
 
-これから王国の復活を祝って、諸君にラピュタの力を見せてやろうと思ってね。見せてあげよう、ラピュタの雷を！
+これから王国の復活を祝って、諸君にラピュタの力を見せてやろうと思ってね。
+見せてあげよう、ラピュタの雷を！
 
 旧約聖書にあるソドムとゴモラを滅ぼした天の火だよ。
 ラーマヤーナではインドラの矢とも伝えているがね。
@@ -444,7 +472,7 @@ PDFファイルを生成するときにエラーになったら、以下の点
 章(Chapter)や節(Section)といった見出しは、「@<code>{= }」や「@<code>{== }」で始めます。
 また章には概要を書くといいでしょう。
 
-//list[][サンプル]{
+//list[][サンプル][]{
 @<b>|=| 章(Chapter)見出し
 
 @<b>|//abstract{|
@@ -474,7 +502,8 @@ Starterでは、章(Chapter)は1ファイルにつき1つだけにしてくだ
 
 番号なし箇条書きは「@<code>{ * }」で始めます（先頭に半角空白が必要）。
 
-//list[][サンプル]{
+//needvspace[latex][6zw]
+//list[][サンプル][]{
 @<b>| * |箇条書き1
 @<b>| * |箇条書き2
 @<b>| ** |入れ子の箇条書き
@@ -495,7 +524,7 @@ Starterでは、章(Chapter)は1ファイルにつき1つだけにしてくだ
 番号つき箇条書きは「@<code>{ 1. }」のように始める方法と、「@<code>{ - A. }」のように始める方法があります（どちらも先頭に半角空白が必要）。
 後者では番号の自動採番はされず、指定された文字列がそのまま出力されます。
 
-//list[][サンプル]{
+//list[][サンプル][]{
  @<b>|1.| この記法では数字しか指定できず、
  @<b>|2.| また入れ子にもできない。
 
@@ -528,7 +557,7 @@ Starterでは、章(Chapter)は1ファイルにつき1つだけにしてくだ
 //footnote[axm3t][先頭の半角空白は入れるようにしましょう。過去との互換性のため、先頭の半角空白がなくても動作しますが、箇条書きとの整合性のために半角空白を入れることを勧めます。]
 //footnote[diwmv][説明文のインデントは、半角空白でもタブ文字でもいいです。]
 
-//list[][サンプル]{
+//list[][サンプル][]{
 @<b>| : |用語1
     説明文。
     説明文。
@@ -558,17 +587,17 @@ Starterでは、章(Chapter)は1ファイルにつき1つだけにしてくだ
 太字は「@<code>|@@<nop>{}<b>{...}|」で囲み、強調は「@<code>|@@<nop>{}<B>{...}|」または「@<code>|@@<nop>{}<strong>{...}|」で囲みます。
 強調は、太字になるだけでなくフォントがゴシック体になります。
 
-//list[][サンプル]{
-テキスト@<b>|@@<nop>$$<b>{|テキスト@<b>|}|テキスト
+//list[][サンプル][]{
+テキスト@<b>|@@<nop>$$<b>{|テキスト@<b>|}|テキスト。
 
-テキスト@<b>|@@<nop>$$<B>{|テキスト@<b>|}|テキスト
+テキスト@<b>|@@<nop>$$<B>{|テキスト@<b>|}|テキスト。
 //}
 
 //sampleoutputbegin[表示結果]
 
-テキスト@<b>{テキスト}テキスト
+テキスト@<b>{テキスト}テキスト。
 
-テキスト@<B>{テキスト}テキスト
+テキスト@<B>{テキスト}テキスト。
 
 //sampleoutputend
 
@@ -599,6 +628,16 @@ Starterでは、章(Chapter)は1ファイルにつき1つだけにしてくだ
 //}
 
 
+=== 等幅フォント
+
+文字列を等幅フォントで表示するには、「@<code>|@@<nop>{}<tt>{...}|」を使います。
+ただしこれを使うことはお勧めしません。
+それよりも、それぞれの用途に合ったインライン命令を使いましょう。
+
+ * プログラムコードやコマンド文字列を表すには「@<code>|@@<nop>{}<code>{...}|」を使ってください。
+ * ファイル名を表すには「@<code>|@@<nop>{}<file>{...}|」を使ってください。
+
+
 === プログラムリスト
 
 プログラムリストは「@<code>|//list[ラベル][説明文]{ ... //}|」で囲みます。
@@ -607,7 +646,7 @@ Starterでは、章(Chapter)は1ファイルにつき1つだけにしてくだ
   * 「@<code>|@@<nop>{}<list>{ラベル名}|」のようにプログラムリストを参照できます。
   * 説明文に「@<code>{]}」を含める場合は、「@<code>{\]}」のようにエスケープします。
 
-//list[][サンプル]{
+//list[][サンプル][]{
 サンプルコードを@<b>|@@<nop>$$<list>{fib1}|に示します。
 
 @<b>|//list[fib1][フィボナッチ数列]|{
@@ -629,7 +668,7 @@ def fib(n):
 
 
 
-第1引数も第2引数も、省略できます。
+第1引数と第2引数のどちらも、省略できます。
 たとえば第1引数だけを省略するには「@<code>|//list[][説明]{|」のようにします。
 両方とも省略するには「@<code>|//list[][]{|」または「@<code>|//list{|」のようにします。
 
@@ -637,7 +676,7 @@ def fib(n):
 たとえば次の例では、追加した箇所を「@<code>|@@<nop>{}<b>{...}|」で@<fn>{0hz8w}、削除した箇所を「@<code>|@@<nop>{}<del>{...}|」で表しています。
 //footnote[0hz8w][プログラムリストの中では、「@<code>|@@<nop>{}<B>{}|」（強調）ではなく「@<code>|@@<nop>{}<b>{}|」（太字）を使ってください。なぜなら、「@<code>|@@<nop>{}<B>{}|」を使うとフォントが等幅フォントからゴシック体に変更されてしまい、表示がずれてしまうからです。]
 
-//list[][サンプル]{
+//list[][サンプル][]{
 /@<nop>$$/list{
 function fib(n) {
   @<b>{@@<nop>$$<del>|}if (n <= 1) { return n; }@<b>{|}
@@ -661,8 +700,12 @@ function fib(n) {
 
 
 
+その他、行番号をつけたり外部ファイルを読み込んだりできます。
 プログラムコードについての詳細は@<secref>{03-syntax|sec-program}を参照してください。
 
+また出力結果を表す「@<code>|//output|」という命令もあります。
+詳細は@<secref>{03-syntax|subsec-output}を参照してください。
+
 //note[ブロック命令]{
 「@<code>|//list{ ... //}|」のような形式の命令を、@<B>{ブロック命令}といいます。
 ブロック命令は入れ子にできますが（Starterによる拡張）、できないものもあります。
@@ -676,7 +719,7 @@ function fib(n) {
 次の例では、引数にラベル名と説明文字列を指定します。
 また「@<code>|@@<nop>{}<userinput>{...}|」はユーザ入力を表します。
 
-//list[][サンプル]{
+//list[][サンプル][]{
 @<b>|//terminal[term-1][PDFを生成]{|
 $ @@<nop>$$<userinput>{rake pdf}          @@<nop>$$<balloon>{Dockerを使わない場合}
 $ @@<nop>$$<userinput>{rake docker:pdf}   @@<nop>$$<balloon>{Dockerを使う場合}
@@ -704,8 +747,9 @@ $ @<userinput>{rake docker:pdf}   @<balloon>{Dockerを使う場合}
 === 脚注
 
 脚注は、脚注をつけたい箇所に「@<code>|@@<nop>{}<fn>{ラベル}|」をつけ、段落の終わりに「@<code>|//footnote[ラベル][脚注文]|」を書きます。
+脚注文の中では「@<code>|]|」を「@<code>|\]|」と書いてください。
 
-//list[][サンプル]{
+//list[][サンプル][]{
 本文テキスト@<b>|@@<nop>$$<fn>{fn-12}|。
 
 @<b>|//footnote[fn-12][このように脚注文を書きます。]|
@@ -730,7 +774,7 @@ $ @<userinput>{rake docker:pdf}   @<balloon>{Dockerを使う場合}
  * 画像ファイルの拡張子は指定しません。
  * ラベルを使って「@<code>|@@<nop>{}<img>{ラベル}|」のように参照できます。
 
-//list[][サンプル]{
+//list[][サンプル][]{
 @<b>|//image[tw-icon][サンプル画像][scale=0.3]|
 //}
 
@@ -750,8 +794,8 @@ Starterでは、画像を入れる位置を指定したり、画像の周りに
 
 Starterでは、本文を補足する文章を「ノート」という囲み枠で表します。
 
-//list[][サンプル]{
-/@<nop>$$/note[ムスカの苦手なもの]{
+//list[][サンプル][]{
+@<b>|//note|[ムスカの苦手なもの]{
 実は、ムスカには「虫が苦手」という公式な設定があります。
 有名な『読める、読めるぞ！』のシーンでムスカが顔の周りに群がるハエを追い払うのは、邪魔だったからだけでなく、虫が苦手だったからです。
 /@<nop>$$/}
@@ -771,6 +815,47 @@ Starterでは、本文を補足する文章を「ノート」という囲み枠
 ノート本文には箇条書きやプログラムコードを埋め込めます。
 詳しくは@<secref>{03-syntax|sec-note}を参照してください。
 
+また、補足情報や注意喚起や警告を表す囲み枠もあります。
+詳しくは@<secref>{03-syntax|subsec-miniblock}を参照してください。
+
+//list[][サンプル][]{
+@<b>|//info|[解決のヒント]{
+本製品を手に取り、古くから伝わるおまじないを唱えてみましょう。
+すると天空の城への門が開きます。
+/@<nop>$$/}
+
+@<b>|//caution|[使用上の注意]{
+本製品を石版にかざすと、天空の城から雷が発射されます。
+周りに人がいないことを確かめてから使用してください。
+/@<nop>$$/}
+
+@<b>|//warning|[重大な警告]{
+本製品を持ったまま滅びの呪文を唱えると、天空の城は自動的に崩壊します。
+大変危険ですので、決して唱えないでください。
+/@<nop>$$/}
+//}
+
+//sampleoutputbegin[表示結果]
+
+//info[解決のヒント]{
+本製品を手に取り、古くから伝わるおまじないを唱えてみましょう。
+すると天空の城への門が開きます。
+//}
+
+//caution[使用上の注意]{
+本製品を石版にかざすと、天空の城から雷が発射されます。
+周りに人がいないことを確かめてから使用してください。
+//}
+
+//warning[重大な警告]{
+本製品を持ったまま滅びの呪文を唱えると、天空の城は自動的に崩壊します。
+大変危険ですので、決して唱えないでください。
+//}
+
+//sampleoutputend
+
+
+
 
 === 表
 
@@ -781,7 +866,7 @@ Starterでは、本文を補足する文章を「ノート」という囲み枠
  * ヘッダの区切りは「@<code>{-}」または「@<code>{=}」を12個以上並べます。
  * ラベルを使って「@<code>|@@<nop>{}<table>{ラベル}|」のように参照できます。
 
-//list[][サンプル]{
+//list[][サンプル][]{
 @<b>|//table[tbl-31][サンプル表]{|
 Name	Val1	Val2
 @<b>|--------------------|
@@ -804,6 +889,7 @@ BB	56	78
 
 
 PDFではセルの右寄せ・左寄せ・中央揃えができます。
+またCSVファイルからデータを読み込めます。
 詳しくは@<secref>{03-syntax|sec-table}を参照してください。
 
 
@@ -811,7 +897,7 @@ PDFではセルの右寄せ・左寄せ・中央揃えができます。
 
 @<LaTeX>{}の書き方を使って数式を記述できます。
 
-//list[][サンプル]{
+//list[][サンプル][]{
 @<b>|//texequation[euler][オイラーの公式]{|
 e^{i\theta} = \sin{\theta} + i\cos{\theta}
 @<b>|//}|
@@ -834,6 +920,129 @@ e^{i\theta} = \sin{\theta} + i\cos{\theta}
 詳しくは@<secref>{03-syntax|sec-mathexpr}を参照してください。
 
 
+=== 会話形式
+
+Starterでは、会話形式も書けます。
+会話形式は、アイコン画像を使う方法と使わない方法があります。
+
+//list[][サンプル][]{
+@<b>|//talklist{|
+@<b>|//talk[avatar-b]|{
+あの方は何も盗らなかったわ。私のために闘ってくださったんです。
+/@<nop>$$/}
+@<b>|//talk[avatar-g]|{
+いや、ヤツはとんでもないものを盗んでいきました……
+あなたの心です。
+/@<nop>$$/}
+@<b>|//}|
+//}
+
+//sampleoutputbegin[表示結果]
+
+//talklist{
+//talk[avatar-b]{
+あの方は何も盗らなかったわ。私のために闘ってくださったんです。
+//}
+//talk[avatar-g]{
+いや、ヤツはとんでもないものを盗んでいきました……
+あなたの心です。
+//}
+//}
+
+//sampleoutputend
+
+
+
+//list[][サンプル][]{
+@<b>|//talklist{|
+@<b>|//talk[][クラリス]|{
+あの方は何も盗らなかったわ。私のために闘ってくださったんです。
+/@<nop>$$/}
+@<b>|//talk[][銭形警部]|{
+いや、ヤツはとんでもないものを盗んでいきました……
+あなたの心です。
+/@<nop>$$/}
+@<b>|//}|
+//}
+
+//sampleoutputbegin[表示結果]
+
+//talklist{
+//talk[][クラリス]{
+あの方は何も盗らなかったわ。私のために闘ってくださったんです。
+//}
+//talk[][銭形警部]{
+いや、ヤツはとんでもないものを盗んでいきました……
+あなたの心です。
+//}
+//}
+
+//sampleoutputend
+
+
+
+詳しくは@<secref>{03-syntax|sec-talk}を参照してください。
+
+//note[白黒印刷でも判別できる画像を使う]{
+このサンプルでは、色が違うだけのアイコン画像を使っています。
+そのせいで、白黒印刷すると誰が誰だか判別できなくなります。
+もし白黒印刷するなら、色に頼らず判別できるようなアイコン画像を使いましょう。
+//}
+
+//needvspace[latex][4zw]
+//note[会話形式にしても分かりやすくはならない]{
+@<B>{会話形式を採用しても、説明が分かりやすくなるとは限りません。}
+会話形式にすると楽しさや親しみやすさを向上できますが、それは説明の分かりやすさとは違います。
+
+会話形式だけど説明がよく分からない本はたくさんあります。
+先生役や先輩役のキャラクターが何かの説明をして、それが読者には伝わっていないのに、生徒役や後輩役のキャラクターが「なるほど！」とか「そういうことか！」と言っているような本、見たことありませんか？
+先生や先輩の説明を苦もなく理解できるほどの優秀な生徒や後輩は、本の中にしかいません。
+
+同様のことはマンガ形式にもいえます。
+分かりやすく説明したいなら分かりやすく説明する技術を学ぶべきであり、マンガにしたり会話形式にすることではありません。
+
+たとえば、『@<href>{https://www.c-r.com/book/detail/1108, わかばちゃんと学ぶ　Git使い方入門}』が分かりやすいのはマンガだからではなく、分かりやすく説明する技術を作者の湊川先生が身につけているからです@<fn>{fn-pwgc3}。
+@<B>{分かりやすく説明できる人がたまたまマンガで説明しているから分かりやすいのであって、マンガや会話形式にすれば何でも分かりやすくなるわけではありません。}
+ここを履き違えないようにしましょう。
+//}
+
+//footnote[fn-pwgc3][@<href>{https://www.youtube.com/watch?v=t2eiA2ylNW0, 湊川先生による文章改善の発表動画}を見ると、分かりやすく説明する技術を先生自身が持っていることがよく分かります。]
+
+
+=== 用語、索引
+
+用語は「@<code>|@@<nop>{}<term>{用語名((よみかた))}|」のように書くとゴシック体で表示され、かつ本の巻末の索引に載ります。
+ゴシック体にするけど索引に載せないなら「@<code>|@@<nop>{}<termnoidx>{用語名}|」、ゴシック体にせず索引に載せるなら「@<code>|@@<nop>{}<idx>{用語名((よみかた))}|」、索引に載せるけど表示はしないなら「@<code>|@@<nop>{}<hidx>{用語名((よみかた))}|」とします。
+
+索引は、デフォルトではオフになっています。
+索引を使うには、@<file>{config.yml}で「@<code>|makeindex: true|」を設定してください（370行目ぐらいにあります）。
+索引は@<LaTeX>{}の機能を使うので、今のところPDFでしかサポートされません。
+また索引機能をオンにすると@<LaTeX>{}のコンパイル回数が増えるので、コンパイル時間が延びます。
+原稿執筆中はオフにし、完成間近になったらオンにするといいでしょう。
+
+なお索引に登録する用語が何もない場合は、索引を使おうとするとコンパイルエラーになります。
+本文に1つでも「@<code>|@@<nop>{}<term>{}|」や「@<code>|@@<nop>{}<idx>{}|」を入れてから索引機能を有効化してください。
+
+Starterでは索引語の親子関係を指定したり、ページ番号のかわりに「〜を見よ」と指定できます。
+詳しくは@<secref>{03-syntax|sec-term}を参照してください。
+
+
+=== 単語展開
+
+キーを単語に展開できます。
+たとえば辞書ファイル「@<file>{data/words.txt}」の中に、キー「apple」に対応した単語「アップル」が登録されているとします。
+すると、本文に「@<code>|@@<nop>{}<w>{apple}|」と書くと「アップル」に展開されます。
+「@<code>|@@<nop>{}<wb>{apple}|」なら展開して太字になります。
+また「@<code>|@@<nop>{}<W>{apple}|」なら展開して強調表示します。
+#@#「@<code>|@@<nop>{}<wb>{apple}|」なら展開して太字になります（「@<code>|@@<nop>{}<b>{@@<nop>{}<w>{apple}}|」と同じです）。
+#@#また「@<code>|@@<nop>{}<W>{apple}|」なら展開して強調表示します（「@<code>|@@<nop>{}<B>{@@<nop>{}<w>{apple}}|」と同じです）。
+
+この機能は、表記が定まっていない単語に使うと便利です。
+たとえば「Apple」と「アップル」のどちらの表記にするか悩んでるなら、本文には `@<w>{apple}` と書いておけば、あとから辞書の中身を変えるだけでどちらの表記にも対応できます。
+
+詳しくは@<secref>{03-syntax|sec-words}を参照してください。
+
+
 
 =={sec-pdftype} 印刷用PDFと電子用PDF
 
@@ -843,24 +1052,29 @@ Starterでは、印刷用と電子用とを切り替えてPDFファイルを生
 
 === 印刷用と電子用を切り替えてPDFを生成する
 
-Starterでは、環境変数「@<code>{$STARTER_TARGET}」を設定することで印刷用と電子用とを切り替えます。
+Starterでは、印刷用と電子用とを切り替えてPDFを生成できます（デフォルトは印刷用）。
+具体的には次のどれかを行います@<fn>{fn-0xkt4}。
+
+ * 「@<code>|rake pdf @<b>{t=pbook}|」を実行すると印刷用PDFが生成され、「@<code>|rake pdf @<b>{t=ebook}|」@<fn>{fn-3pf5z}を実行すると電子用PDFが生成される。
+ * 環境変数「@<code>{$STARTER_TARGET}」を「@<code>|pbook|」に設定してから「`rake pdf`」を実行すると印刷用PDFが生成され、「@<code>|ebook|」に設定してから実行すると電子用PDFが生成される。
+ * 「@<file>{config-starter.yml}」に設定項目「@<code>{target:}」があるので、これを「@<code>{pbook}」（印刷用）または「@<code>{ebook}」（電子用）に設定する。
+
+//footnote[fn-0xkt4][強制力はこの順序であり、設定ファイルより環境変数のほうが、また環境変数より`rake`コマンドのオプションのほうが優先されます。]
+//footnote[fn-3pf5z][「@<code>{pbook}」は「printing book」、「@<code>{ebook}」は「electronic book」を表します。]
 
 //terminal[][macOSやLinuxの場合@<fn>{fn-3pf5z}]{
+$ @<userinput>{rake pdf @<b>{t=pbook}}    @<balloon>{印刷用PDFを生成}
+$ @<userinput>{rake pdf @<b>{t=ebook}}    @<balloon>{電子用PDFを生成}
+## または
 $ @<userinput>{@<b>{export STARTER_TARGET=pbook}}  @<balloon>{印刷用に設定}
 $ @<userinput>{rake pdf}          @<balloon>{またはDockerを使うなら rake docker:pdf}
-
 $ @<userinput>{@<b>{export STARTER_TARGET=ebook}}  @<balloon>{電子用に設定}
 $ @<userinput>{rake pdf}          @<balloon>{またはDockerを使うなら rake docker:pdf}
 //}
 
-//footnote[fn-3pf5z][「@<code>{pbook}」は「printing book」、「@<code>{ebook}」は「electronic book」を表します。]
-
 Windowsの場合は、「@<code>{set STARTER_TARGET=pbook}」や「@<code>{set STARTER_TARGET=ebook}」を使って環境変数を設定してください。
 
-または、「@<file>{config-starter.yml}」に設定項目「@<code>{target:}」があるので、これを「@<code>{pbook}」（印刷用）または「@<code>{ebook}」（電子用）に設定してもいいです。
-
-ただし、この設定よりも環境変数「@<code>{$STARTER_TARGET}」のほうが優先されます。
-設定ファイルを変更しても切り替わらなくて困った場合は、環境変数を未設定に戻しましょう。
+環境変数を未設定に戻すには、次のようにします。
 
 //terminal[][macOSやLinuxの場合]{
 $ @<userinput>{@<b>{unset STARTER_TARGET}}    @<balloon>{環境変数を未設定に戻す}
@@ -879,7 +1093,11 @@ $ @<userinput>{@<b>{unset STARTER_TARGET}}    @<balloon>{環境変数を未設
 	具体的には、見開きにおいて内側の余白を約2cm、外側の余白を約1.5cmにしています@<fn>{fn-yuyf5}。
 	これは見開きでの読みやすさを確保したうえで本文幅をできるだけ広げるための工夫です。@<br>{}
 	電子用では見開きを考慮する必要がないので、左右の余白幅は同じに設定されます。
-: 表紙
+ : ノンブル
+	印刷用には自動的にノンブルがつき、電子用にはつきません。
+	「ノンブル」とはすべてのページにつけられる通し番号であり、印刷所に入稿するときに必要です。
+	ノンブルについての詳細は@<secref>{05-faq|sec-nombre}を参照してください。
+ : 表紙
 	印刷用では、表紙がつきません。
 	なぜなら、表紙のPDFファイルは本文とは別にして印刷所に入稿するからです。@<br>{}
 	電子用では、（設定されていれば）表紙がつきます@<fn>{fn-yybgl}。
@@ -888,72 +1106,65 @@ $ @<userinput>{@<b>{unset STARTER_TARGET}}    @<balloon>{環境変数を未設
 //footnote[fn-yuyf5][余白幅は初期設定によって多少の違いがあります。設定の詳細は「@<file>{sty/mytextsize.sty}」を見てください。]
 //footnote[fn-yybgl][表紙のつけ方は@<secref>{04-customize|subsec-coverpdf}を見てください。]
 
-またこれらの違いに加えて、印刷用PDFファイルにはノンブルをつける必要があります。
-詳しくは次で説明します。
 
 
-=== ノンブル
+=={sec-preview} 高速プレビュー
+
+ページ数が多くなると、PDFファイルへのコンパイルに時間がかかるようになり、執筆に支障が出ます。
 
-「ノンブル」とは全ページにつける通し番号のことです。
-ページ番号と似ていますが、次のような違いがあります。
+ここでは高速にプレビューするための機能を紹介します。
 
- * ページ番号は目次と本文で番号が連続してなかったり、空白ページにはついてなかったりするので、通し番号にはなっていません。
-   ノンブルは全ページを通じて連続した番号になっています。
- * ページ番号は読者のためにあるので、ページ内で目につくところに置かれます。
-   ノンブルは印刷所だけが分かればいいので（ページの順番を確認するため）、ページ内で目立たない場所に小さく置かれます。
 
-詳しくは「ノンブル qiita.com」でGoogle検索してください。
+=== 指定した章だけをコンパイルする
 
-印刷所に入稿するPDFファイルには、ノンブルが必要になることがあります。
-ノンブルが必要かどうかは印刷所によって異なり、たとえば「日光企画」なら必須、「ねこのしっぽ」なら必須ではありません。
-詳しくは入稿先の印刷所に聞いてください。
+Starterでは、指定した章(Chapter)だけを@<LaTeX>{}でコンパイルできます。
+これは章の数が多い場合や、著者が多数いる合同誌の場合にはとても効果的です。
+具体的には次のようにします。
 
-Starterでは、PDFファイルにノンブルをつける機能が用意されています。
+ * 「@<code>|rake pdf @<b>{c=03-syntax}|」のようにすると、「@<file>{03-syntax.re}」だけをコンパイルします。
+ * または環境変数「@<code>|$STARTER_CHAPTER|」を設定する方法でも、章を指定できます。
 
-//terminal[][PDFファイルにノンブルをつける]{
-$ @<userinput>{rake pdf}           @<balloon>{PDFファイルを生成する}
-$ @<userinput>{rake pdf:nombre}    @<balloon>{PDFファイルにノンブルをつける}
+//terminal[][例：03-syntax-faq.reだけをコンパイルする]{
+$ @<userinput>{@<b>{rake pdf c=03-syntax}}   @<balloon>{「.re」はつけない}
+### または
+$ @<userinput>{@<b>{export STARTER_CHAPTER=03-syntax}}   @<balloon>{「.re」はつけない}
+$ @<userinput>{rake pdf}   @<balloon>{Dockerを使っているなら rake docker:pdf}
 //}
 
-Dockerを使っている場合は、「@<code>{rake pdf:nombre}」のかわりに「@<code>{rake docker:pdf:nombre}」を使ってください。
-また「@<code>{rake pdf:nombre}」はノンブルをつけるだけであり、再コンパイルはしないので注意してください。
+コンパイルする章を指定したとき、Starterは次のような動作になります。
 
-なお「@<href>{https://kauplan.org/pdfoperation/, PDFOperation}」を使っても、PDFファイルにノンブルが簡単につけられます。
+ * 他の章は無視されます。
+ * 表紙や、目次や、大扉や、奥付も無視されます。
+ * @<LaTeX>{}のコンパイル回数が1回だけになります（コンパイル時間を短縮するため）。
 
-//note[ノンブル用フォントの埋め込み]{
-残念ながら、「@<code>{rake pdf:nombre}」でノンブルをつけるとそのフォントがPDFファイルに埋め込まれません（これはPDFファイルを操作しているライブラリの限界によるものです）。
-そのため、印刷所に入稿するまえにフォントを埋め込む必要があります。
+なお「@<code>{$STARTER_CHAPTER}」を設定した場合、全体をコンパイルするときにはリセットしてください。
 
-対策方法は@<href>{https://kauplan.org/pdfoperation/}を見てください。
+//terminal[][全体をコンパイルする]{
+$ @<userinput>{@<b>{unset STARTER_CHAPTER}}    @<balloon>{「$」はつけないことに注意}
 //}
 
 
-=={sec-preview} 高速プレビュー
+=== コンパイル回数を1回だけに制限する
 
-ページ数が多くなると、PDFファイルへのコンパイルに時間がかかるようになり、執筆に支障が出ます。
+Re:VIEWおよびStarterでは、@<LaTeX>{}のコンパイルが最大で3回行われます@<fn>{mb3pa}。
 
-ここでは高速にプレビューするための機能を紹介します。
+//footnote[mb3pa][索引があると、コンパイル回数がもう1回増えます。]
 
+ * 1回目のコンパイルで章や節のページ番号が分かる。
+ * 2回目のコンパイルで目次が作成される。
+ * もし2回目のコンパイルでページ番号が変わると、3回目のコンパイルが行われる。
 
-=== 指定した章だけをコンパイルする
+しかし、ページ番号が合ってなくてもいいからとにかく仕上がりを確認したい場面はよくあり、そんなときは3回もコンパイルされるのは時間の無駄です。
 
-Starterでは、環境変数「@<code>{$STARTER_CHAPTER}」を設定するとその章(Chapter)だけをコンパイルします。
-これは章の数が多い場合や、著者が多数いる合同誌の場合にはとても効果的です。
+そこでStarterでは、@<LaTeX>{}のコンパイル回数を制限する機能を用意しました。
 
-//terminal[][例：03-syntax-faq.reだけをコンパイルする]{
-$ @<userinput>{@<b>{export STARTER_CHAPTER=03-syntax}}   @<balloon>{「.re」はつけない}
-$ @<userinput>{rake pdf}   @<balloon>{Dockerを使っているなら rake docker:pdf}
+ * 「@<code>|rake pdf @<b>{n=1}|」のようにすると、@<LaTeX>{}のコンパイルが1回しか行われません。
+ * または環境変数「@<code>|$STARTER_COMPILETIMES|」を「@<code>|1|」に設定する方法でも、同じように制限できます。
 
-$ @<userinput>{@<b>{STARTER_CHAPTER=03-syntax rake pdf}}  @<balloon>{これでもよい}
-//}
-
-このとき、他の章は無視されます。
-また表紙や目次や大扉や奥付も無視されます。
-
-全体をコンパイルする場合は、「@<code>{$STARTER_CHAPTER}」をリセットしてください。
-
-//terminal[][全体をコンパイルする]{
-$ @<userinput>{@<b>{unset STARTER_CHAPTER}}    @<balloon>{「$」はつけないことに注意}
+//terminal[][@<LaTeX>{}のコンパイル回数を1回に制限してコンパイル]{
+$ @<userinput>{rake pdf @<b>{n=1} }
+### または
+$ @<userinput>{@<b>{STARTER_COMPILETIMES=1} rake pdf}
 //}
 
 
@@ -963,18 +1174,27 @@ Starterでは、画像の読み込みを省略する「ドラフトモード」
 ドラフトモードにすると、画像のかわりに枠線が表示されます。
 こうすると、（@<LaTeX>{}のコンパイル時間は変わりませんが）DVIファイルからPDFを生成する時間が短縮されます。
 
-この機能は、図やスクリーンショットが多い場合や、印刷用に高解像度の画像を使っている場合は、特に効果が高いです。
+図やスクリーンショットが多い場合や、印刷用に高解像度の画像を使っている場合は、この機能は特に効果が高いです。
 
-ドラフトモードにするには、@<file>{config-starter.yml}で「@<code>{draft: true}」を設定するか、または環境変数「@<em>{$STARTER_DRAFT}」に何らかの値を入れてください。
+ドラフトモードにするには、次のどれを実行します@<fn>{fn-b5nlc}。
 
-//terminal[][ドラフトモードにしてPDFを生成する]{
-$ @<userinput>{export STARTER_DRAFT=1}  @<balloon>{ドラフトモードをonにする}
-$ @<userinput>{rake pdf}                @<balloon>{またはDocker環境なら rake docker:pdf}
+ * 「@<code>|rake pdf @<b>{d=on}|」でコンパイルする。
+ * 環境変数「@<em>{$STARTER_DRAFT}」の値を「@<code>|on|」に設定してからコンパイルする。
+ * @<file>{config-starter.yml}で「@<code>{draft: true}」を設定してからコンパイルする。
 
-$ @<userinput>{unset STARTER_DRAFT}     @<balloon>{ドラフトモードをoffにする}
+//footnote[fn-b5nlc][強制力はこの順序であり、設定ファイルより環境変数のほうが、また環境変数より`rake`コマンドのオプションのほうが優先されます。]
+
+//terminal[][画像読み込みを省略するドラフトモードでPDFを生成する]{
+$ @<userinput>{rake pdf @<b>{d=on}}     @<balloon>{ドラフトモードをonにする}
+### または
+$ @<userinput>{export STARTER_DRAFT=on} @<balloon>{ドラフトモードをonにする}
+$ @<userinput>{rake pdf}                @<balloon>{またはDocker環境なら rake docker:pdf}
 //}
 
-また「ドラフトモードにしてPDF生成時間を短縮したい、でもこの画像は表示して確認したい」という場合は、「@<code>|//image[...][...][@<b>{draft=off}]|」のように指定すると、その画像はドラフトモードが解除されてPDFに表示されます。
+環境変数の設定をクリアするには、「@<code>|unset STARTER_DRAFT|」を実行してください。
+
+また「ドラフトモードにしてPDF生成時間を短縮したい、でもこの画像は表示して確認したい」というときもあるでしょう。
+そんなときは「@<code>|//image[...][...][@<b>{draft=off}]|」のように指定すると、その画像はドラフトモードが解除されてPDFに表示されます。
 
 
 === 自動リロードつきHTMLプレビュー
@@ -998,11 +1218,11 @@ $ @<userinput>{rake docker:web:server}   @<balloon>{Dockerを使っている場
 いくつか注意点があります。
 
  * 表示はHTMLで行っているため、PDFでの表示とは差異があります。
-   執筆中はHTMLでプレビューし、区切りのいいところでPDFで表示を確認するといいでしょう。
+   執筆中はHTMLでプレビューし、区切りのいいところでPDFによる表示を確認するといいでしょう。
  * 今のところ数式はプレビューできません。
  * 変更が反映されるのは、開いているページと対応した原稿ファイルが変更された場合だけです。
    たとえば「@<file>{foo.html}」を開いているときに「@<file>{foo.re}」を変更するとプレビューに反映されますが、別の「@<file>{bar.re}」を変更しても反映されません。
  * 画面右上の「Rebuild and Reload」リンクをクリックすると、原稿ファイルが変更されていなくても強制的にコンパイルとリロードがされます。
  * 原稿ファイルに入力間違いがあった場合は、画面にエラーが表示されます。
-   エラー表示はあまり分かりやすくはないので、今後改善される予定です。
+   エラー表示はあまり分かりやすくないので、今後改善される予定です。
  * Webサーバを終了するには、Controlキーを押しながら「c」を押してください。