review 3.0.0 → 4.2.0

data/doc/pdfmaker.md

@@ -84,6 +84,47 @@ Since Re:VIEW 3.0, review-jlreq.cls is also provided. This class file extends jl
 
 `review-init --latex-template=review-jlreq` command copies the review-jlreq.cls set to `sty` folder.
 
+### Handing over custom parameters
+
+For technical reasons, only a small part of the YAML parameters in config.yml is converted to TeX macros. Re:VIEW's internal `config.erb` ( https://github.com/ kmuto/review/blob/master/templates/latex/ config.erb ) ERB script manages this. You cannot change this script.
+
+If you want to give YAML parameters to TeX, you can use your own ERB script that do the YAML to TeX conversion. This is done by creating `layouts/config-local.tex.erb` in the project folder.
+
+After evaluation and embedding of `config.erb`, `config-local.tex. erb` will be evaluated and embedded as well. For example,
+
+`config.yml`:
+
+```
+mycustom:
+  mystring: HELLO_#1
+  mybool: true
+```
+
+`layouts/config-local.tex.erb`:
+
+```
+\def\mystring{<%= escape(@config['mycustom']['mystring']) %>}
+<%- if @config['mycustom']['mybool'] -%>
+\def\mybool{true}
+<%- end -%>
+```
+
+will be parsed:
+
+```
+ …
+\makeatother
+%% BEGIN: config-local.tex.erb
+\def\mystring{HELLO\textunderscore{}\#1}
+\def\mybool{true}
+%% END: config-local.tex.erb
+
+\usepackage{reviewmacro}
+ …
+```
+
+Refer to these macros in your sty file.
+
 ## Important Changes about LaTeX in Re:VIEW 2.0
 
 * Default LaTeX compiler is upLaTeX, not pLaTeX.
@@ -100,7 +141,7 @@ Default settings of Re:VIEW is below:
 
 ```yaml
 texcommand: uplatex
-texoptions: "-interaction=nonstopmode -file-line-error"
+texoptions: "-interaction=nonstopmode -file-line-error -halt-on-error"
 texdocumentclass: ["review-jsbook", "uplatex,twoside"]
 dvicommand: dvipdfmx
 dvioptions: "-d 5"

data/doc/quickstart.ja.md

@@ -8,11 +8,11 @@ Re:VIEW は GNU Lesser General Public License Version 2.1 に基づいて配布
 
 このドキュメントでは、Re:VIEW のセットアップから変換の例までを簡単に説明します。
 
-このドキュメントは、Re:VIEW 3.0 に基づいています。
+このドキュメントは、Re:VIEW 4.2 に基づいています。
 
 ## セットアップ
 
-Re:VIEW は Ruby 言語で記述されており、Linux/Unix 互換システムで動作します。macOS および Windows Cygwin でも動作可能です。Ruby gem あるいは Git のいずれかを使ってダウンロード・展開します。
+Re:VIEW は Ruby 言語で記述されており、Linux/Unix 互換システムで動作します。macOS および Windows でも動作可能です。Ruby gem あるいは Git のいずれかを使ってダウンロード・展開します。
 
 なお、Re:VIEW フォーマット自体は文字で表現されたタグが付いている以外は単なるテキストファイルなので、エディタ、OS については UTF-8 文字エンコーディングさえ使用できれば制限はありません。
 
@@ -34,7 +34,7 @@ Ruby gem の bin ディレクトリにパスを通すようにしておいてく
 $ gem update review
 ```
 
-Gemfile を使っている場合は、以下の行を Gemfile に追加して、`bundle`コマンドを実行します。
+Gemfile を使っている場合は、以下の行を Gemfile に追加して、`bundle` コマンドを実行します。
 
 ```Gemfile
 gem 'review'
@@ -58,29 +58,37 @@ review というディレクトリに展開されるので、review/bin にパ
 $ git pull
 ```
 
-## Re:VIEW ドキュメントの作成
+## Re:VIEW プロジェクトの作成
 
 ### 雛型の作成
-review-init コマンドを使って、雛型となる作業フォルダを作成できます。
+review-init コマンドを使って、雛型となるプロジェクトフォルダを作成できます。
 
 ```
-$ review-init ドキュメント名
+$ review-init プロジェクト名
 ```
 
-これで指定のドキュメント名のフォルダが用意され、中に次のようなファイルが置かれます。
+TeX を利用した PDF 作成を目的としているならば、雛型の作成時に、Web ブラウザによるウィザードモードで基本版面設計を行うことができます。これには `-w` オプションを付けます。
 
- * ドキュメント名を冠した「.re」拡張子を持つファイル（Re:VIEW フォーマットテキストファイル）
+```
+$ review-init -w プロジェクト名
+```
+
+「http://localhost:18000」に Web ブラウザでアクセスし、文字数×行数および余白を調整できます。
+
+これで指定のプロジェクト名のフォルダが用意され、中に次のようなファイルが置かれます。
+
+ * プロジェクト名を冠した「.re」拡張子を持つファイル（Re:VIEW フォーマットテキストファイル）
  * config.yml : 設定ファイル
+ * config-ebook.yml : 電子ブック用設定ファイル（ウィザードモード使用時）
  * catalog.yml : カタログファイル（目次構成）
  * Rakefile : rake コマンドのルールファイル
  * images : 画像の配置フォルダ
- * layouts : レイアウトファイルの配置フォルダ
  * style.css : サンプルスタイルシート
  * sty : スタイルファイル配置フォルダ（TeX 用）
  * doc : 本ドキュメントを含む使い方のドキュメント
  * lib : 主に rake コマンドの詳細ルールファイル
 
-review-init コマンドによらず、独自に作業フォルダを作成してもかまいません。
+review-init コマンドによらず、独自にプロジェクトフォルダを作成してもかまいません。
 
 ### Re:VIEW テキストの作成と変換
 
@@ -115,28 +123,37 @@ review-init コマンドによらず、独自に作業フォルダを作成し
 
 テキストファイルの文字エンコーディングには、UTF-8 を使用してください。
 
-### PDF 化と EPUB 化、プレインテキスト化
+### PDF 化と EPUB 化、プレインテキスト化、XML 化
+
+review-*maker コマンドで一括して変換作成ができます。
 
-review-pdfmaker コマンドで PDF ブックの作成、review-epubmaker コマンドで EPUB ファイルの作成、review-textmaker コマンドでプレインテキストの作成ができます。
+- review-pdfmaker コマンド：PDF ブックの作成
+- review-epubmaker コマンド：EPUB ファイルの作成
+- review-textmaker コマンド：プレインテキストの作成
+- review-idgxmlmaker コマンド：InDesign XML の作成
 
 PDF を作成するには、TeXLive2012 以上の環境が必要です。EPUB を作成するには、rubyzip gem あるいは zip コマンドが必要です（MathML も使いたいときには、 [MathML ライブラリ](http://www.hinet.mydns.jp/?mathml.rb)も必要です）。
 
 いずれのコマンドも、必要な設定情報を記した YAML 形式ファイルを引数に指定して実行します。review-init コマンドで作成した環境には、デフォルトで config.yml として用意されているので、これを利用します。
 
 ```bash
-$ review-pdfmaker config.yml     ←PDFの作成
-$ review-epubmaker config.yml    ←EPUBの作成
-$ review-textmaker config.yml    ←テキストの作成（装飾情報あり）
-$ review-textmaker -n config.yml ←テキストの作成（装飾情報なし）
+$ review-pdfmaker config.yml       ←PDFの作成
+$ review-pdfmaker config-ebook.yml ←電子ブック設定でのPDFの作成
+$ review-epubmaker config.yml      ←EPUBの作成
+$ review-textmaker config.yml      ←テキストの作成（装飾情報あり）
+$ review-textmaker -n config.yml   ←テキストの作成（装飾情報なし）
+$ review-idgxmlmaker config.yml    ←InDesign XMLの作成
 ```
 
 rake コマンドを利用できるなら、次のように実行することもできます。
 
 ```bash
 $ rake pdf  ←PDFの作成
+$ REVIEW_CONFIG_FILE=config-ebook.yml rake pdf ←電子ブック設定でのPDFの作成
 $ rake epub ←EPUBの作成
 $ rake text  ←テキストの作成（装飾情報あり）
 $ rake plaintext ←テキストの作成（装飾情報なし）
+$ rake idgxml ←InDesign XMLの作成
 ```
 
 config.yml のサンプルについては以下を参照してください。
@@ -177,7 +194,7 @@ Re:VIEW の使用実例については、https://github.com/reviewml/review-samp
 $ review-compile --target text sample.re > sample.txt    ←テキストにする
 $ review-compile --target html sample.re > sample.html   ←HTMLにする
 $ review-compile --target latex sample.re > sample.tex   ←LaTeXにする
-$ review-compile --target idgxml sample.re > sample.xml  ←XMLにする
+$ review-compile --target idgxml sample.re > sample.xml  ←InDesign XMLにする
 $ review-compile --target markdown sample.re > sample.md ←Markdownにする
 ```
 
@@ -200,20 +217,23 @@ $ review-preproc --replace ファイル ←ファイルを更新したもので
 $ review-vol
 ```
 
-より細かな見出し一覧などを出したいときには、review-index コマンドを使うのもよいでしょう。
+より細かな見出し一覧などを出したいときには、review-index コマンドを使うとよいでしょう。
 
 ```bash
-$ review-index --level 掘り下げる見出しレベル数 -a
+$ review-index -l 掘り下げる見出しレベル数
+$ review-index -l 掘り下げる見出しレベル数 -d ←分量の詳細を表示
 ```
 
-## ドキュメントフォルダを新しい Re:VIEW バージョンに追従する方法
+review-vol と review-index では、文字数や行数、見込みページなど各値に大きな差が出ることがあります。これは、review-vol がごく簡単にファイルから概算しているのに対し、review-index は実際に内部でコンパイルして比較的精密に計量しているからです。
+
+## プロジェクトフォルダを新しい Re:VIEW バージョンに追従する方法
 
-Re:VIEW は定期的に更新されています。おおむね後方互換性を保持していますが、新しいバージョン固有の機能を利用したいときには、ドキュメントフォルダを新しいバージョンに更新する review-update コマンドを利用します。
+Re:VIEW は定期的に更新されています。おおむね後方互換性を保持していますが、新しいバージョン固有の機能を利用したいときには、プロジェクトフォルダを新しいバージョンに更新する review-update コマンドを利用します。
 
 ```bash
 $ review-update
-** review-update はプロジェクトを 3.0.0 に更新します **
-config.yml: 'review_version' を '3.0' に更新しますか? [y]/n ←Enterで実行
+** review-update はプロジェクトを 4.1.0 に更新します **
+config.yml: 'review_version' を '4.0' に更新しますか? [y]/n ←Enterで実行
 Rakefile は Re:VIEW バージョンのもの (/.../review/samples/sample-book/src/Rakefile) で置き換えられます。本当に進めますか? [y]/n
 lib/tasks/review.rake は Re:VIEW バージョンのもの (/.../review/samples/sample-book/src/lib/tasks/review.rake) で置き換えられます。本当に進めますか? [y]/n
 INFO: 新しいファイル /.../sty/plistings.sty が作成されました。
@@ -223,15 +243,15 @@ INFO: 新しいファイル /.../sty/review-custom.sty が作成されました
 INFO: 新しいファイル /.../sty/review-jsbook.cls が作成されました。
 INFO: 新しいファイル /.../sty/review-style.sty が作成されました。
 INFO: 新しいファイル /.../sty/review-base.sty が作成されました。
-INFO: 新しいファイル /.../sty/gentombow09j.sty が作成されました。
+INFO: 新しいファイル /.../sty/gentombow.sty が作成されました。
 完了しました。
 ```
 
 ## クレジット
 
-Re:VIEW は、青木峰郎によって最初に作成されました。武藤健志がこの開発・保守を引き継ぎ、2018年11月時点では、武藤健志、高橋征義、角征典が開発・保守を継続しています。
+Re:VIEW は、青木峰郎によって最初に作成されました。武藤健志がこの開発・保守を引き継ぎ、2020年3月時点では、武藤健志、高橋征義、角征典が開発・保守を継続しています。
 
-バグ・パッチの報告、開発者用メーリングリストなどについての情報は、
+バグ・パッチの報告、その他の情報は、
 
 * http://reviewml.org/
 * https://github.com/kmuto/review/wiki

data/doc/quickstart.md

@@ -9,7 +9,7 @@ Re:VIEW is free software under the terms of the GNU Lesser General Public Licens
 
 This article describes how to setup Re:VIEW and use it.
 
-The supported version of the article is Re:VIEW 3.0.
+The supported version of the article is Re:VIEW 4.2.
 
 ## Set up Re:VIEW
 
@@ -59,7 +59,7 @@ $ git pull
 
 ## Writing Re:VIEW Document
 
-### Generating template fiels
+### Generating template files
 
 After setup, you can use `review-init` command to generate Re:VIEW project directory.
 
@@ -72,14 +72,23 @@ $ ls hello
 Rakefile     catalog.yml  config.yml   hello.re     images/      layouts/     sty/         style.css
 ```
 
+If your purpose is to create a PDF using TeX, it is a good idea to use the wizard mode for basic layouting in a web browser. Add `-w` option to review-init.
+
+(notice: currently wizard UI supports only Japanese language)
+
+```bash
+$ review-init -w hello
+(access http://localhost:18000 on Web browser)
+```
+
 In `hello` directory, many files are generated.
 
 * `*.re` : Re:VIEW format file.
 * config.yml : configuration file
+* config-ebook.yml : configuration file for ebook (when using the wizard mode)
 * catalog.yml : catalog file (for TOC)
 * Rakefile : rule file for `rake` command
 * images : folder for images
-* layouts : forlder for layout files
 * style.css : sample stylesheet
 * sty : style files for LaTeX
 * doc : various documents (including this document)
@@ -116,29 +125,38 @@ The web site of Re:VIEW is @{https://reviewml.org/}.
 
 You should use UTF-8 as encodings in text files.
 
-### generating PDF, EPUB, and plain-text
+### generating PDF, EPUB, plain-text, and InDesign XML
+
+To convert files in the project, use review-*maker command.
 
-You can generate a PDF file with `review-pdfmaker` command.  Also you can generate an EPUB file with `review-epubmaker` command, and can generate an plain-text file with 'review-textmaker' command.
+- review-pdfmaker: generate PDF
+- review-epubmaker: generate EPUB
+- review-textmaker: genrate plaintext
+- review-idgxmlmaker: genrate InDesign XML
 
-To generate PDF, you should install TeXLive 2012 or later.  To generate EPUB, you should install zip command.
+To generate PDF, you should install TeXLive 2012 or later. To generate EPUB, you should install zip command.
 When you want to use MathML, you should install [MathML library](http://www.hinet.mydns.jp/?mathml.rb)
 
-Each maker need `config.yml`, configuration YAML files.  `review-init` command generates `config.yml` in default.
+Each maker need `config.yml`, configuration YAML files. `review-init` command generates `config.yml` in default.
 
 ```bash
-$ review-pdfmaker config.yml     ## generate PDF
-$ review-epubmaker config.yml    ## generate EPUB
-$ review-textmaker config.yml    ## generate text with decoration
-$ review-textmaker -n config.yml ## generate text without decoration
+$ review-pdfmaker config.yml       ## generate PDF
+$ review-pdfmaker config-ebook.yml ## generate PDF (for ebook)
+$ review-epubmaker config.yml      ## generate EPUB
+$ review-textmaker config.yml      ## generate text with decoration
+$ review-textmaker -n config.yml   ## generate text without decoration
+$ review-idgxmlmaker config.yml    ## generate InDesign XML
 ```
 
 You also can generate them with Rake.
 
 ```bash
 $ rake pdf       ## generate PDF
+$ REVIEW_CONFIG_FILE=config-ebook.yml rake pdf       ## generate PDF (for ebook)
 $ rake epub      ## generate EPUB
 $ rake text      ## generate text with decoration
 $ rake plaintext ## generate text without decoration
+$ rake idgxml    ## generate InDesign XML
 ```
 
 There is a sample YAML file [config.yml.sample](https://github.com/kmuto/review/blob/master/doc/config.yml.sample) in the same directory of this document.
@@ -205,17 +223,20 @@ $ review-vol
 You can also use `review-index` command to generate header list.
 
 ```bash
-$ review-index --level <heading level> -a
+$ review-index --level <heading level>
+$ review-index --level <heading level> -d  ## show volumes also
 ```
 
+review-vol and review-index can have large differences in the number of characters, lines, and pages. While review-vol only estimates from the file, review-index actually compiles and calculates.
+
 ## how to update the document folder to the new Re:VIEW version
 
-Re:VIEW is updated regularly. We Re:VIEW team watch the backward compatibility carefully, but if you want to use the features in the new version, you can use review-update command to update the document folder.
+Re:VIEW is updated regularly. We Re:VIEW team watch the backward compatibility carefully, but if you want to use the features in the new version, you can use review-update command to update the project folder.
 
 ```bash
 $ review-update
-** review-update updates your project to 3.0.0 **
-config.yml: Update 'review_version' to '3.0'? [y]/n
+** review-update updates your project to 4.1.0 **
+config.yml: Update 'review_version' to '4.0'? [y]/n
 Rakefile will be overridden with Re:VIEW version (/.../review/samples/sample-book/src/Rakefile). Do you really proceed? [y]/n
 lib/tasks/review.rake will be overridden with Re:VIEW version (/.../review/samples/sample-book/src/lib/tasks/review.rake). Do you really proceed? [y]/n
 INFO: new file /.../sty/plistings.sty is created.
@@ -225,13 +246,13 @@ INFO: new file /.../sty/review-custom.sty is created.
 INFO: new file /.../sty/review-jsbook.cls is created.
 INFO: new file /.../sty/review-style.sty is created.
 INFO: new file /.../sty/review-base.sty is created.
-INFO: new file /.../sty/gentombow09j.sty is created.
+INFO: new file /.../sty/gentombow.sty is created.
 Finished.
 ```
 
 ## Copyright
 
-The original author of Re:VIEW is Minero Aoki. The current maintainer is Kenshi Muto(@kmuto), and committers are Masayoshi Takahashi and Masanori Kado (September 2018).
+The original author of Re:VIEW is Minero Aoki. The current maintainer is Kenshi Muto(@kmuto), and committers are Masayoshi Takahashi and Masanori Kado (March 2020).
 
 If you want to report bugs and patches, or to get more information, see:
 

data/lib/epubmaker/epubcommon.rb

@@ -1,6 +1,6 @@
 # = epubcommon.rb -- super class for EPUBv2 and EPUBv3
 #
-# Copyright (c) 2010-2017 Kenshi Muto and Masayoshi Takahashi
+# Copyright (c) 2010-2019 Kenshi Muto and Masayoshi Takahashi
 #
 # This program is free software.
 # You can distribute or modify this program under the terms of
@@ -36,10 +36,9 @@ module EPUBMaker
       if @producer.config['coverimage']
         file = nil
         @producer.contents.each do |item|
-          if !item.media.start_with?('image') || item.file !~ /#{@producer.config["coverimage"]}\Z/
+          if !item.media.start_with?('image') || item.file !~ /#{@producer.config['coverimage']}\Z/
             next
           end
-
           s << %Q(    <meta name="cover" content="#{item.id}"/>\n)
           file = item.file
           break
@@ -327,8 +326,14 @@ EOT
 
       if has_part
         @producer.contents.each do |item|
-          item.level += 1 if item.chaptype == 'part' || item.chaptype == 'body'
-          item.notoc = true if (item.chaptype == 'pre' || item.chaptype == 'post') && !item.level.nil? && (item.level + 1 == toclevel) # FIXME: part processing
+          if item.chaptype == 'part' && item.level > 0
+            # sections in part
+            item.level -= 1
+          end
+          # down level for part and chaps. pre, appendix, post are preserved
+          if item.chaptype == 'part' || item.chaptype == 'body'
+            item.level += 1
+          end
         end
         toclevel += 1
       end

data/lib/epubmaker/epubv2.rb

@@ -39,7 +39,7 @@ module EPUBMaker
         if @producer.config[item].is_a?(Array)
           s << @producer.config.names_of(item).map { |i| %Q(    <dc:#{item}>#{CGI.escapeHTML(i)}</dc:#{item}>\n) }.join
         else
-          s << %Q(    <dc:#{item}>#{CGI.escapeHTML(@producer.config.name_of(item))}</dc:#{item}>\n)
+          s << %Q(    <dc:#{item}>#{CGI.escapeHTML(@producer.config.name_of(item).to_s)}</dc:#{item}>\n)
         end
       end
 

data/lib/epubmaker/epubv3.rb

@@ -26,6 +26,7 @@ module EPUBMaker
     # Return opf file content.
     def opf
       @opf_metainfo = opf_metainfo
+      @opf_coverimage = opf_coverimage
       @opf_manifest = opf_manifest
       @opf_toc = opf_tocx
       @package_attrs = ''

data/lib/epubmaker/producer.rb

@@ -192,7 +192,8 @@ module EPUBMaker
       current = Dir.pwd
       basedir ||= current
 
-      new_tmpdir = tmpdir.nil? ? Dir.mktmpdir : tmpdir
+      # use Dir to solve a path for Windows (see #1011)
+      new_tmpdir = Dir[File.join(tmpdir.nil? ? Dir.mktmpdir : tmpdir)][0]
       if epubfile !~ %r{\A/}
         epubfile = "#{current}/#{epubfile}"
       end
@@ -269,7 +270,8 @@ module EPUBMaker
           'rename_for_legacy' => nil,
           'verify_target_images' => nil,
           'force_include_images' => [],
-          'cover_linear' => nil
+          'cover_linear' => nil,
+          'back_footnote' => nil
         },
         'externallink' => true,
         'contentdir' => '.',

data/lib/review/book.rb

@@ -19,7 +19,7 @@ require 'review/book/index'
 module ReVIEW
   module Book
     def self.load(dir)
-      Base.load dir
+      Base.load(dir)
     end
   end
 end

data/lib/review/book/base.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2009-2018 Minero Aoki, Kenshi Muto
+# Copyright (c) 2009-2019 Minero Aoki, Kenshi Muto
 #               2002-2008 Minero Aoki
 #
 # This program is free software.
@@ -29,7 +29,6 @@ module ReVIEW
         @chapter_index = nil
         @config = ReVIEW::Configure.values
         @catalog = nil
-        @read_part = nil
         @warn_old_files = {} # XXX for checking CHAPS, PREDEF, POSTDEF
         @basedir_seen = {}
         update_rubyenv
@@ -80,7 +79,7 @@ module ReVIEW
       def page_metric
         if config['page_metric'].respond_to?(:downcase) && config['page_metric'].upcase =~ /\A[A-Z0-9_]+\Z/
           ReVIEW::Book::PageMetric.const_get(config['page_metric'].upcase)
-        elsif config['page_metric'].is_a?(Array) && config['page_metric'].size == 5
+        elsif config['page_metric'].is_a?(Array) && (config['page_metric'].size == 5 || config['page_metric'].size == 4)
           ReVIEW::Book::PageMetric.new(*config['page_metric'])
         else
           config['page_metric']
@@ -137,19 +136,20 @@ module ReVIEW
 
       def chapter_index
         return @chapter_index if @chapter_index
-
-        contents = chapters
-        # TODO: contents += parts.find_all { |prt| prt.id.present? }
+        @chapter_index = ChapterIndex.new
+        each_chapter do |chap|
+          @chapter_index.add_item(Index::Item.new(chap.id, chap.number, chap))
+        end
         parts.each do |prt|
           if prt.id.present?
-            contents << prt
+            @chapter_index.add_item(Index::Item.new(prt.id, prt.number, prt))
           end
         end
-        @chapter_index = ChapterIndex.new(contents)
+        @chapter_index
       end
 
       def chapter(id)
-        chapter_index[id]
+        chapter_index[id].content
       end
 
       def next_chapter(chapter)
@@ -175,9 +175,7 @@ module ReVIEW
       end
 
       def volume
-        vol = Volume.sum(chapters.map(&:volume))
-        vol.page_per_kbyte = page_metric.page_per_kbyte
-        vol
+        Volume.sum(parts.map(&:volume) + chapters.map(&:volume))
       end
 
       def load_config(filename)
@@ -189,8 +187,8 @@ module ReVIEW
         return @catalog if @catalog.present?
 
         catalogfile_path = filename_join(@basedir, config['catalogfile'])
-        if File.file? catalogfile_path
-          @catalog = File.open(catalogfile_path, 'r:BOM|utf-8') { |f| Catalog.new(f) }
+        if File.file?(catalogfile_path)
+          @catalog = File.open(catalogfile_path, 'rt:BOM|utf-8') { |f| Catalog.new(f) }
         end
         if @catalog
           @catalog.validate!(@config, basedir)
@@ -202,7 +200,7 @@ module ReVIEW
         if catalog
           catalog.chaps
         else
-          read_file(config['chapter_file'])
+          read_file(config['chapter_file']).split("\n")
         end
       end
 
@@ -210,7 +208,7 @@ module ReVIEW
         if catalog
           catalog.predef
         else
-          read_file(config['predef_file'])
+          read_file(config['predef_file']).split("\n")
         end
       end
 
@@ -218,7 +216,7 @@ module ReVIEW
         if catalog
           catalog.appendix
         else
-          read_file(config['postdef_file']) # for backward compatibility
+          read_file(config['postdef_file']).split("\n") # for backward compatibility
         end
       end
 
@@ -226,17 +224,15 @@ module ReVIEW
         if catalog
           catalog.postdef
         else
-          ''
+          []
         end
       end
 
       def read_part
-        return @read_part if @read_part
-
         if catalog
-          @read_part = catalog.parts
+          catalog.parts
         else
-          @read_part = File.read(File.join(@basedir, config['part_file']))
+          File.read(File.join(@basedir, config['part_file'])).split("\n")
         end
       end
 
@@ -258,39 +254,39 @@ module ReVIEW
 
       def prefaces
         if catalog
-          return mkpart_from_namelist(catalog.predef.split("\n"))
+          return Part.mkpart_from_namelist(self, catalog.predef)
         end
 
         begin
           predef_file = filename_join(@basedir, config['predef_file'])
           if File.file?(predef_file)
-            mkpart_from_namelistfile(predef_file)
+            Part.mkpart_from_namelistfile(self, predef_file)
           end
-        rescue FileNotFound => err
-          raise FileNotFound, "preface #{err.message}"
+        rescue FileNotFound => e
+          raise FileNotFound, "preface #{e.message}"
         end
       end
 
       def appendix
         if catalog
-          names = catalog.appendix.split("\n")
-          chaps = names.each_with_index.map { |n, idx| mkchap_ifexist(n, idx) }.compact
-          return mkpart(chaps)
+          names = catalog.appendix
+          chaps = names.each_with_index.map { |name, number| Chapter.mkchap_ifexist(self, name, number + 1) }.compact
+          return Part.mkpart(chaps)
         end
 
         begin
           postdef_file = filename_join(@basedir, config['postdef_file'])
           if File.file?(postdef_file)
-            mkpart_from_namelistfile(postdef_file)
+            Part.mkpart_from_namelistfile(self, postdef_file)
           end
-        rescue FileNotFound => err
-          raise FileNotFound, "postscript #{err.message}"
+        rescue FileNotFound => e
+          raise FileNotFound, "postscript #{e.message}"
         end
       end
 
       def postscripts
         if catalog
-          mkpart_from_namelist(catalog.postdef.split("\n"))
+          Part.mkpart_from_namelist(self, catalog.postdef)
         end
       end
 
@@ -300,13 +296,13 @@ module ReVIEW
         list = parse_chapters
         # NOTE: keep this = style to work this logic.
         if pre = prefaces
-          list.unshift pre
+          list.unshift(pre)
         end
         if app = appendix
-          list.push app
+          list.push(app)
         end
         if post = postscripts
-          list.push post
+          list.push(post)
         end
         list
       end
@@ -324,7 +320,7 @@ module ReVIEW
                 chap = Chapter.new(self, num += 1, chap, File.join(contentdir, chap))
                 chap
               end
-              Part.new(self, part += 1, chaps, read_part.split("\n")[part - 1])
+              Part.new(self, part += 1, chaps, read_part[part - 1])
             else
               chap = Chapter.new(self, num += 1, entry, File.join(contentdir, entry))
               if chap.number
@@ -337,12 +333,11 @@ module ReVIEW
           end
         end
 
-        chap = read_chaps.
-               strip.lines.map(&:strip).join("\n").split(/\n{2,}/).
+        chap = read_chaps.map(&:strip).join("\n").split(/\n{2,}/).
                map do |part_chunk|
           chaps = part_chunk.split.map { |chapid| Chapter.new(self, num += 1, chapid, File.join(contentdir, chapid)) }
-          if part_exist? && read_part.split("\n").size > part
-            Part.new(self, part += 1, chaps, read_part.split("\n")[part - 1])
+          if part_exist? && read_part.size > part
+            Part.new(self, part += 1, chaps, read_part[part - 1])
           else
             Part.new(self, nil, chaps)
           end
@@ -350,42 +345,6 @@ module ReVIEW
         chap
       end
 
-      def mkpart_from_namelistfile(path)
-        chaps = []
-        File.read(path, mode: 'r:BOM|utf-8').split.each_with_index do |name, idx|
-          if path =~ /PREDEF/
-            chaps << mkchap(name)
-          else
-            chaps << mkchap(name, idx + 1)
-          end
-        end
-        mkpart(chaps)
-      end
-
-      def mkpart_from_namelist(names)
-        mkpart(names.map { |n| mkchap_ifexist(n) }.compact)
-      end
-
-      def mkpart(chaps)
-        chaps.empty? ? nil : Part.new(self, nil, chaps)
-      end
-
-      def mkchap(name, number = nil)
-        name += ext if File.extname(name).empty?
-        path = File.join(contentdir, name)
-        raise FileNotFound, "file not exist: #{path}" unless File.file?(path)
-        Chapter.new(self, number, name, path)
-      end
-
-      def mkchap_ifexist(name, idx = nil)
-        name += ext if File.extname(name).empty?
-        path = File.join(contentdir, name)
-        if File.file?(path)
-          idx += 1 if idx
-          Chapter.new(self, idx, name, path)
-        end
-      end
-
       def read_file(filename)
         unless @warn_old_files[filename]
           @warn_old_files[filename] = true
@@ -394,9 +353,9 @@ module ReVIEW
           end
         end
         res = ''
-        File.open(filename_join(@basedir, filename), 'r:BOM|utf-8') do |f|
+        File.open(filename_join(@basedir, filename), 'rt:BOM|utf-8') do |f|
           f.each_line do |line|
-            next if /\A#/ =~ line
+            next if line.start_with?('#')
             line.gsub!(/#.*\Z/, '')
             res << line
           end