RubyGems - review - Versions diffs - 2.0.0.beta1 → 2.0.0 - Mend

review 2.0.0.beta1 → 2.0.0

Files changed (150) hide show

checksums.yaml +4 -4
data/.rubocop.yml +66 -1
data/.rubocop_todo.yml +617 -0
data/.travis.yml +16 -1
data/ChangeLog +48 -0
data/Dockerfile +22 -0
data/Gemfile +0 -1
data/README.md +97 -0
data/Rakefile +10 -11
data/appveyor.yml +9 -0
data/bin/review +46 -0
data/bin/review-check +8 -21
data/bin/review-compile +26 -43
data/bin/review-index +9 -22
data/bin/review-init +21 -25
data/bin/review-preproc +9 -13
data/bin/review-validate +1 -1
data/bin/review-vol +3 -17
data/bin/review-webmaker +15 -0
data/doc/NEWS.ja.md +534 -0
data/doc/NEWS.md +538 -0
data/doc/catalog.ja.md +10 -18
data/doc/catalog.md +5 -9
data/doc/config.yml.sample +319 -0
data/doc/customize_epub.ja.md +42 -0
data/doc/format.ja.md +320 -288
data/doc/format.md +277 -170
data/doc/format_idg.ja.md +82 -175
data/doc/pdfmaker.ja.md +61 -0
data/doc/pdfmaker.md +65 -0
data/doc/quickstart.ja.md +88 -98
data/doc/quickstart.md +72 -110
data/doc/sample.css +41 -0
data/doc/writing_vertical.ja.md +55 -0
data/doc/writing_vertical.md +5 -0
data/lib/epubmaker/content.rb +3 -3
data/lib/epubmaker/epubcommon.rb +173 -145
data/lib/epubmaker/epubv2.rb +24 -77
data/lib/epubmaker/epubv3.rb +72 -73
data/lib/epubmaker/producer.rb +54 -30
data/lib/lineinput.rb +48 -0
data/lib/review/book.rb +0 -1
data/lib/review/book/base.rb +47 -27
data/lib/review/book/chapter.rb +48 -19
data/lib/review/book/compilable.rb +10 -14
data/lib/review/book/index.rb +10 -19
data/lib/review/book/page_metric.rb +0 -10
data/lib/review/book/part.rb +17 -3
data/lib/review/builder.rb +84 -68
data/lib/review/catalog.rb +5 -1
data/lib/review/compiler.rb +327 -4657
data/lib/review/configure.rb +84 -10
data/lib/review/converter.rb +28 -0
data/lib/review/epubbuilder.rb +1 -1
data/lib/review/epubmaker.rb +142 -158
data/lib/review/ewbbuilder.rb +5 -5
data/lib/review/exception.rb +1 -1
data/lib/review/extentions.rb +1 -1
data/lib/review/extentions/hash.rb +15 -0
data/lib/review/extentions/string.rb +2 -1
data/lib/review/htmlbuilder.rb +364 -348
data/lib/review/htmltoc.rb +44 -0
data/lib/review/htmlutils.rb +12 -6
data/lib/review/i18n.rb +78 -6
data/lib/review/i18n.yml +7 -4
data/lib/review/idgxmlbuilder.rb +226 -267
data/lib/review/latexbuilder.rb +281 -274
data/lib/review/latexutils.rb +56 -49
data/lib/review/makerhelper.rb +8 -4
data/lib/review/markdownbuilder.rb +80 -124
data/lib/review/pdfmaker.rb +197 -138
data/lib/review/preprocessor.rb +16 -67
data/lib/review/template.rb +24 -0
data/lib/review/textbuilder.rb +1 -1
data/lib/review/textutils.rb +18 -24
data/lib/review/tocparser.rb +51 -106
data/lib/review/tocprinter.rb +61 -117
data/lib/review/topbuilder.rb +119 -126
data/lib/review/unfold.rb +2 -2
data/lib/review/version.rb +1 -1
data/lib/review/webmaker.rb +302 -0
data/lib/review/webtocprinter.rb +48 -0
data/lib/review/yamlloader.rb +47 -0
data/review.gemspec +3 -3
data/templates/html/layout-html5.html.erb +17 -0
data/templates/html/layout-xhtml1.html.erb +20 -0
data/{lib/review → templates/latex}/layout.tex.erb +107 -115
data/templates/ncx/epubv2.ncx.erb +11 -0
data/templates/opf/epubv2.opf.erb +21 -0
data/templates/opf/epubv3.opf.erb +18 -0
data/templates/web/html/layout-html5.html.erb +56 -0
data/templates/web/html/layout-xhtml1.html.erb +20 -0
data/templates/xml/container.xml.erb +6 -0
data/test/assets/test.xml.erb +3 -0
data/test/assets/test_template.tex +28 -71
data/test/assets/test_template_backmatter.tex +1 -9
data/test/sample-book/src/Rakefile +12 -3
data/{doc/sample.yml → test/sample-book/src/config-epub2.yml} +92 -147
data/test/sample-book/src/config.yml +40 -154
data/test/sample-book/src/style-web.css +45 -0
data/test/sample-book/src/style.css +23 -1
data/test/test.re +1 -1
data/test/test_book.rb +15 -17
data/test/test_book_chapter.rb +2 -80
data/test/test_book_part.rb +1 -1
data/test/test_builder.rb +28 -6
data/test/test_catalog.rb +17 -0
data/test/test_compiler.rb +14 -59
data/test/test_configure.rb +94 -0
data/test/test_converter.rb +21 -0
data/test/test_epub3maker.rb +155 -3
data/test/test_epubmaker.rb +245 -30
data/test/test_epubmaker_cmd.rb +2 -2
data/test/test_extentions_hash.rb +60 -0
data/test/test_helper.rb +4 -47
data/test/test_htmlbuilder.rb +282 -175
data/test/test_htmltoc.rb +33 -0
data/test/test_i18n.rb +134 -70
data/test/test_idgxmlbuilder.rb +58 -39
data/test/test_latexbuilder.rb +132 -14
data/test/test_lineinput.rb +5 -26
data/test/test_makerhelper.rb +6 -4
data/test/test_markdownbuilder.rb +23 -5
data/test/test_pdfmaker.rb +86 -20
data/test/test_pdfmaker_cmd.rb +1 -3
data/test/test_review_ext.rb +1 -1
data/test/test_template.rb +27 -0
data/test/test_textutils.rb +36 -0
data/test/test_tocparser.rb +25 -0
data/test/test_topbuilder.rb +34 -2
data/test/test_yamlloader.rb +188 -0
metadata +71 -29
data/README.rdoc +0 -81
data/bin/review-epubmaker-legacy +0 -1024
data/doc/ruby-uuid/README +0 -11
data/doc/ruby-uuid/README.ja +0 -34
data/lib/review/compiler/literals_1_8.kpeg +0 -19
data/lib/review/compiler/literals_1_8.rb +0 -432
data/lib/review/compiler/literals_1_9.kpeg +0 -22
data/lib/review/compiler/literals_1_9.rb +0 -435
data/lib/review/extentions/array.rb +0 -25
data/lib/review/htmllayout.rb +0 -41
data/lib/review/inaobuilder.rb +0 -357
data/lib/review/location.rb +0 -24
data/lib/review/node.rb +0 -267
data/lib/review/review.kpeg +0 -724
data/lib/uuid.rb +0 -312
data/rubocop-todo.yml +0 -456
data/test/test_inaobuilder.rb +0 -247
data/test/test_uuid.rb +0 -157

@@ -32,31 +32,16 @@ rescue Errno::EPIPE
 end
 def _main
-  $KCODE = 'UTF-8' unless defined?(Encoding)
   printer_class = ReVIEW::TextTOCPrinter
   source = nil
   upper = ReVIEW::TOCPrinter.default_upper_level
-  param = {
-    "inencoding" => "UTF-8",
-    "outencoding" => "UTF-8"
-  }
+  param = {}
   book = ReVIEW::Book::Base.load
   opts = OptionParser.new
   opts.version = ReVIEW::VERSION
-  opts.on('--inencoding=ENCODING', 'Set input encoding. (UTF-8, EUC, JIS, and SJIS)') {|enc|
-    param["inencoding"] = enc
-  }
-  opts.on('--outencoding=ENCODING', 'Set output encoding. (UTF-8[default], EUC, JIS, and SJIS)') {|enc|
-    param["outencoding"] = enc
-  }
   opts.on('-a', '--all', 'print all chapters.') {
-    begin
-      source = book
-    rescue ReVIEW::Error => err
-      error_exit err.message
-    end
+    source = book
   }
   opts.on('-p', '--part N', 'list only part N.') {|n|
     source = book.part(Integer(n)) or
@@ -71,7 +56,7 @@ def _main
   }
   opts.on('-l', '--level N', 'list upto N level (1..4, default=4)') {|n|
     upper = Integer(n)
-    unless (0..4).include?(upper)  # 0 is hidden option
+    unless (0..4).include?(upper) # 0 is hidden option
       $stderr.puts "-l/--level option accepts only 1..4"
       exit 1
     end
@@ -82,9 +67,6 @@ def _main
   opts.on('--html', 'output in HTML (deprecated)') {
     printer_class = ReVIEW::HTMLTOCPrinter
   }
-  opts.on('--idg', 'output in InDesign XML') {
-    printer_class = ReVIEW::IDGTOCPrinter
-  }
   opts.on('--help', 'print this message and quit.') {
     puts opts.help
     exit 0
@@ -106,7 +88,12 @@ def _main
   end
   begin
-    printer_class.new(upper, param).print_book source
+    printer = printer_class.new(upper, param)
+    if source.kind_of?(ReVIEW::Book::Part)
+      printer.print_part source
+    else
+      printer.print_book source
+    end
   rescue ReVIEW::Error, Errno::ENOENT => err
     raise if $DEBUG
     error_exit err.message

data/bin/review-init CHANGED

@@ -21,16 +21,19 @@ def main
   opts = OptionParser.new
   opts.version = ReVIEW::VERSION
   opts.banner = "Usage: #{File.basename($0)} [option] dirname"
-  opts.on('-h', '--help', 'print this message and quit.') {
+  opts.on('-h', '--help', 'print this message and quit.') do
     puts opts.help
     exit 0
-  }
-  opts.on('-f', '--force', 'generate files (except *.re) if directory has already existed.') {
+  end
+  opts.on('-f', '--force', 'generate files (except *.re) if directory has already existed.') do
     @force = true
-  }
-  opts.on('-l', '--locale', 'generate locale.yml file.') {
+  end
+  opts.on('-l', '--locale', 'generate locale.yml file.') do
     @locale = true
-  }
+  end
+  opts.on('', '--epub-version VERSION', 'define EPUB version') do |version|
+    @epub_version = version
+  end
   begin
     opts.parse!
   rescue OptionParser::ParseError => err
@@ -80,24 +83,6 @@ end
 def generate_layout(dir)
   FileUtils.mkdir_p dir + '/layouts'
-  File.open("#{dir}/layouts/layout.html.erb", "w") do |file|
-    file.write <<-EOS
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xmlns:ops="http://www.idpf.org/2007/ops" xml:lang="ja">
-<head>
-  <meta http-equiv="Content-Type" content="text/html;charset=UTF-8" />
-  <meta http-equiv="Content-Style-Type" content="text/css" />
-  <link rel="stylesheet" type="text/css" href="style.css" />
-  <meta name="generator" content="Re:VIEW" />
-  <title><%= title %></title>
-</head>
-<body>
-<%= body %>
-</body>
-</html>
-EOS
-  end
 end
 def generate_catalog_file(dir)
@@ -125,7 +110,18 @@ def generate_cover_image(dir)
 end
 def generate_config(dir)
-  FileUtils.cp @review_dir + "/test/sample-book/src/config.yml", dir
+  today = Time.now.strftime("%Y-%m-%d")
+  content = File.read(@review_dir + "/doc/config.yml.sample")
+  content.gsub!(/^#\s*coverimage:.*$/, 'coverimage: cover.jpg')
+  content.gsub!(/^#\s*date:.*$/, "date: #{today}")
+  content.gsub!(/^#\s*history:.*$/, %Q|history: [["#{today}"]]|)
+  content.gsub!(/^#\s*texstyle:.*$/, "texstyle: reviewmacro")
+  content.gsub!(/^(#\s*)?stylesheet:.*$/, %Q|stylesheet: ["style.css"]|)
+  if @epub_version.to_i == 2
+    content.gsub!(/^#.*epubversion:.*$/,'epubversion: 2')
+    content.gsub!(/^#.*htmlversion:.*$/,'htmlversion: 4')
+  end
+  File.open(File.join(dir, "config.yml"), "w"){|f| f.write(content) }
 end
 def generate_style(dir)

data/bin/review-preproc CHANGED

@@ -19,6 +19,7 @@ $LOAD_PATH.unshift((bindir + '../lib').realpath)
 require 'review/preprocessor'
 require 'review/unfold'
 require 'review/version'
+require 'review/extentions'
 require 'lineinput'
 require 'stringio'
 require 'fileutils'
@@ -35,25 +36,20 @@ rescue Errno::EPIPE
 end
 def main
-  $KCODE = 'UTF-8' unless defined?(Encoding)
+  if File.file?("review-preproc-ext.rb")
+    if ENV["REVIEW_SAFE_MODE"].to_i & 2 > 0
+      warn "review-preproc-ext.rb is prohibited in safe mode. ignored."
+    else
+      Kernel.load File.expand_path("review-preproc-ext.rb")
+    end
+  end
-  param = {
-    "inencoding" => "UTF-8",
-    "outencoding" => "UTF-8",
-  }
+  param = {}
   mode = :output
   opts = OptionParser.new
   opts.version = ReVIEW::VERSION
   opts.banner = "Usage: #{File.basename($0)} [-c|-d|-s|--replace] [<file>...]"
-  opts.on('--inencoding=ENCODING', 'Set input encoding. (UTF-8, EUC, JIS, and
-SJIS)') {|enc|
-    param["inencoding"] = enc
-  }
-  opts.on('--outencoding=ENCODING', 'Set output encoding. (UTF-8[default], EUC
-, JIS, and SJIS)') {|enc|
-    param["outencoding"] = enc
-  }
   opts.on('-c', '--check', 'Check if preprocess is needed.') {
     mode = :check
   }

data/bin/review-validate CHANGED

@@ -15,7 +15,7 @@ colcount = 0
 ln = 0
 ARGF.each {|line|
-  ln = ln + 1
+  ln += 1
   if line =~ /\A\/\/([a-z]+).+\{/
     # block
     _block = $1

data/bin/review-vol CHANGED

@@ -21,13 +21,7 @@ require 'optparse'
 include ReVIEW::TextUtils
 def main
-  $KCODE = 'UTF-8' unless defined?(Encoding)
   @config = ReVIEW::Configure.values
-  @config.merge!({
-    "inencoding" => "UTF-8",
-    "outencoding" => "UTF-8"
-  })
   part_sensitive = false
   basedir = nil
@@ -40,12 +34,6 @@ def main
   opts.on('-P', '--part-sensitive', 'Prints volume of each parts.') {
     part_sensitive = true
   }
-  opts.on('--inencoding=ENCODING', 'Set input encoding. (UTF-8, EUC, JIS, and SJIS)') {|enc|
-    @config["inencoding"] = enc
-  }
-  opts.on('--outencoding=ENCODING', 'Set output encoding. (UTF-8[default], EUC, JIS, and SJIS)') {|enc|
-    @config["outencoding"] = enc
-  }
   opts.on('--directory=DIR', 'Compile all chapters in DIR.') {|path|
     basedir = path
   }
@@ -78,15 +66,13 @@ def main
       puts '    --------------------'
       print_volume part.volume
     end
-    puts '============================='
-    print_volume book.volume #puts "Total #{book.volume}"
   else
     book.each_chapter do |chap|
       print_chapter_volume chap
     end
-    puts '============================='
-    print_volume book.volume #puts "Total #{book.volume}"
   end
+  puts '============================='
+  print_volume book.volume #puts "Total #{book.volume}"
 rescue ReVIEW::ApplicationError, Errno::ENOENT => err
   raise if $DEBUG
   $stderr.puts "#{File.basename($0)}: #{err.message}"
@@ -95,7 +81,7 @@ end
 def print_chapter_volume(chap)
   vol = chap.volume
-  title = convert_outencoding(chap.title, @config["outencoding"])
+  title = chap.title
   printf "%s %3dKB %6dC %5dL %3dP %s %-s\n",
          chapnumstr(chap.number), vol.kbytes, vol.chars, vol.lines, vol.page,
          "#{chap.name} ".ljust(25, '.'), title

data/bin/review-webmaker ADDED

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+#
+# This program is free software.
+# You can distribute or modify this program under the terms of
+# the GNU LGPL, Lesser General Public License version 2.1.
+# For details of the GNU LGPL, see the file "COPYING".
+#
+require 'pathname'
+bindir = Pathname.new(__FILE__).realpath.dirname
+$LOAD_PATH.unshift((bindir + '../lib').realpath)
+require 'review/webmaker'
+ReVIEW::WEBMaker.execute(*ARGV)

data/doc/NEWS.ja.md ADDED

@@ -0,0 +1,534 @@
+# Version 2.0.0の主な変更点
+## 新機能
+* デフォルトで `./config.yml` を読み込むようにしました ([#477], [#479])
+* config.yml: `review_version` を追加しました([#276], [#539], [#545])
+   * review_versionをnilにすると警告が表示されません ([#592])
+* 実験的に縦書き機能をサポートしました ([#563])
+* ヘッダ部分に`[notoc]` と `[nodisp]` を使えるようにしました ([#506], [#555])
+* `@<column>` と `@<hd>` で他の章にあるコラムを参照可能にしました ([#333], [#476])
+* `//imgtable` コマンドを追加しました ([#499])
+* 設定ファイルのショートカットキーを使えるようにしました ([#540])
+    * たとえば、epubmaker使用時に `@config["epubmaker"]["foo"]` の代わりに `@config["foo"]` が使えます
+* `inherit` を使って、複数の設定ファイルを読み込み可能にしました ([#511], [#528])
+* i18nのフォーマットを追加しました ([#520])
+* `rake` でテストとrubocopを実行するようにしました ([#587])
+* webmakerを追加しました ([#498])
+* LATEXBuilder: `image_scale2width` オプションを追加しました ([#543])
+* PDFMaker: platex から uplatex に移行しました ([#541])
+* EPUBMaker: 電子協ガイドフォーマットをサポートしました ([#251], [#429])
+* EPUBMaker: `direction` をデフォルトの設定に追加しました ([#508])
+* EPUBMaker: 書籍タイトルや著者の「読み」を追加しました ([#507])
+* review-preproc: 拡張可能にました ([#494])
+* HTMLBuilder: config.yml で epubmaker/externallink: false を設定すると、`@<href>` のハイパーリンクを無効にできるようにしました ([#509], [#544])
+* EPUBMaker: OPFにカスタムプレフィックスと `<meta>` 要素を追加しました ([#513])
+* PDFMaker: 設定ファイルで `history` をサポートしました ([#566])
+## 非互換の変更
+* デフォルトの`epubversion` と `htmlversion` を更新しました ([#542])
+* 'param' の後方互換性を廃止しました ([#594])
+* config.ymlの'pygments:' を廃止しました ([#604])
+* その他、後方互換性を廃止しました ([#560])
+    * layout.erb -> layout.html.erb
+    * locale.yaml -> locale.yml
+    * PageMetric.a5 -> PageMetric::A5
+    * locale.yaml や layout.erb を使っているとエラーになります
+    * `prt` は `発行所` ではなく `印刷所` になります. `発行所` は `pbl` です.([#562, #593])
+* `appendix_format` を廃止しました ([#609])
+* inaobuilder を廃止しました (アップストリームで修正Markdownを使用することになったため) ([#573])
+* 古い epubmaker を削除しました
+* review-compile: `-a/--all` オプションを廃止しました ([#481])
+## バグ修正
+* HTMLのエスケープ処理漏れに対応しました ([#589], [#591])
+* review-epubmaker: すべての画像をコピーするように修正しました ([#224])
+* ``[nonum]`` に関連するバグを修正しました ([#301], [#436], [#506], [#550], [#554], [#555])
+* IDGXMLBuilder: テーブルセルの幅における pt と mm の計算を修正しました ([#558])
+* HTMLBuilder: `//image[scale=XXX]` で `width` の代わりに `class` を使うようにして、epubcheckのテストを通るようにしました ([#482], [#372])
+## リファクタリング
+* EPUBmaker/PDFmakerで名前付きパラメータへを対応しました ([#534])
+* `ReVIEW::YAMLLoader` を追加しました ([#518])
+* いくつかのグローバル変数を削除しました ([#240])
+* テストのwarningを無効にしました ([#597])
+* いくつかのwarningに対応しました (circular require, unused variable, redefining methods, too many args) ([#599], [#601])
+* MakerHelper: class -> module ([#582])
+* review-init: config.yml を doc/config.yml.sample から生成するようにしました ([#580])
+* ReVIEW::Template にテンプレートエンジンを統合しました ([#576])
+  * HTMLBuilder: HTMLLayout を削除しました
+  * LATEXBuilder: テンプレートでインスタンス変数を使うようにしました ([#598])
+  * LATEXBuilder: move lib/review/layout.tex.erb to templates/latex/ ([#572])
+* config.yml.sample を更新しました ([#579])
+* テストから1.8と1.9.3のコードを削除しました(Travis向け) ([#577])
+* LaTeX のテンプレートを修正しました ([#575])
+* ファイルを開くときに BOM|utf-8 フラグを使用するようにしました ([#574])
+* review-preproc: default_external を UTF-8 に設定しました ([#486])
+* デバッグ時の pdf と epub の build_path を修正しました ([#564], [#556])
+* EPUBMakerをリファクタリングしました ([#533])
+* ruby-uuidの代わりにSecureRandom.uuidを使うようにしました ([#497])
+* epubmaker, pdfmaker: system() の代わりに ReVIEW::Converter を使うようにしました ([#493])
+* zipコマンドの代わりにRubyのZipライブラリを使うようにしました ([#487])
+* review-index: TOCParser と TOCPrinter を洗練させました ([#486])
+* 廃止済みのパラメータを削除して、デフォルト値を変更しました ([#547])
+* サンプルファイル config.yml の名前を config.yml.* に変更しました ([#538])
+* `Hash#deep_merge` を追加しました ([#523])
+* LATEXBuilder: `\Underline` の代わりに `\reviewunderline` を使うようにしました ([#408])
+* Configureクラスで 'name' の値を取得できるように `name_of` と `names_of` メソッドを追加しました ([#534])
+* EPUBMaker: colophon_order の場所を変更しました ([#460])
+* TOCPrinter: IDGTOCPrinter を削除しました ([#486])
+* Book#catalog=(catalog) と Catalog.new(obj) を追加しました ([93691d0e2601eeb5715714b4fb92840bb3b3ff8b])
+* Chapter, Part: 遅延読み込みしないようにしました ([#491])
+## ドキュメント
+* README: rdoc -> md ([#610])
+* format.md, quickstart.md を更新しました
+* 縦書きとPDFMakerについて説明を追加しました
+* 英語版のドキュメントを修正しました ([#588])
+## コードコントリビュータ
+* [@arikui1911](https://github.com/arikui1911)
+[#224]: https://github.com/kmuto/review/issues/224
+[#240]: https://github.com/kmuto/review/issues/240
+[#251]: https://github.com/kmuto/review/issues/251
+[#276]: https://github.com/kmuto/review/issues/276
+[#301]: https://github.com/kmuto/review/issues/301
+[#333]: https://github.com/kmuto/review/issues/333
+[#372]: https://github.com/kmuto/review/issues/372
+[#408]: https://github.com/kmuto/review/issues/408
+[#429]: https://github.com/kmuto/review/issues/429
+[#436]: https://github.com/kmuto/review/issues/436
+[#460]: https://github.com/kmuto/review/issues/460
+[#476]: https://github.com/kmuto/review/issues/476
+[#477]: https://github.com/kmuto/review/issues/477
+[#479]: https://github.com/kmuto/review/issues/479
+[#481]: https://github.com/kmuto/review/issues/481
+[#482]: https://github.com/kmuto/review/issues/482
+[#486]: https://github.com/kmuto/review/issues/486
+[#487]: https://github.com/kmuto/review/issues/487
+[#491]: https://github.com/kmuto/review/issues/491
+[#493]: https://github.com/kmuto/review/issues/493
+[#494]: https://github.com/kmuto/review/issues/494
+[#497]: https://github.com/kmuto/review/issues/497
+[#498]: https://github.com/kmuto/review/issues/498
+[#499]: https://github.com/kmuto/review/issues/499
+[#506]: https://github.com/kmuto/review/issues/506
+[#507]: https://github.com/kmuto/review/issues/507
+[#508]: https://github.com/kmuto/review/issues/508
+[#509]: https://github.com/kmuto/review/issues/509
+[#511]: https://github.com/kmuto/review/issues/511
+[#513]: https://github.com/kmuto/review/issues/513
+[#518]: https://github.com/kmuto/review/issues/518
+[#520]: https://github.com/kmuto/review/issues/520
+[#523]: https://github.com/kmuto/review/issues/523
+[#528]: https://github.com/kmuto/review/issues/528
+[#533]: https://github.com/kmuto/review/issues/533
+[#534]: https://github.com/kmuto/review/issues/534
+[#538]: https://github.com/kmuto/review/issues/538
+[#539]: https://github.com/kmuto/review/issues/539
+[#540]: https://github.com/kmuto/review/issues/540
+[#541]: https://github.com/kmuto/review/issues/541
+[#542]: https://github.com/kmuto/review/issues/542
+[#543]: https://github.com/kmuto/review/issues/543
+[#544]: https://github.com/kmuto/review/issues/544
+[#545]: https://github.com/kmuto/review/issues/545
+[#547]: https://github.com/kmuto/review/issues/547
+[#550]: https://github.com/kmuto/review/issues/550
+[#554]: https://github.com/kmuto/review/issues/554
+[#555]: https://github.com/kmuto/review/issues/555
+[#556]: https://github.com/kmuto/review/issues/556
+[#557]: https://github.com/kmuto/review/issues/557
+[#558]: https://github.com/kmuto/review/issues/558
+[#560]: https://github.com/kmuto/review/issues/560
+[#562]: https://github.com/kmuto/review/issues/562
+[#563]: https://github.com/kmuto/review/issues/563
+[#564]: https://github.com/kmuto/review/issues/564
+[#566]: https://github.com/kmuto/review/issues/566
+[#572]: https://github.com/kmuto/review/issues/572
+[#573]: https://github.com/kmuto/review/issues/573
+[#574]: https://github.com/kmuto/review/issues/574
+[#575]: https://github.com/kmuto/review/issues/575
+[#576]: https://github.com/kmuto/review/issues/576
+[#577]: https://github.com/kmuto/review/issues/577
+[#579]: https://github.com/kmuto/review/issues/579
+[#580]: https://github.com/kmuto/review/issues/580
+[#582]: https://github.com/kmuto/review/issues/582
+[#587]: https://github.com/kmuto/review/issues/587
+[#588]: https://github.com/kmuto/review/issues/588
+[#589]: https://github.com/kmuto/review/issues/589
+[#591]: https://github.com/kmuto/review/issues/591
+[#592]: https://github.com/kmuto/review/issues/592
+[#593]: https://github.com/kmuto/review/issues/593
+[#594]: https://github.com/kmuto/review/issues/594
+[#597]: https://github.com/kmuto/review/issues/597
+[#598]: https://github.com/kmuto/review/issues/598
+[#599]: https://github.com/kmuto/review/issues/599
+[#601]: https://github.com/kmuto/review/issues/601
+[#604]: https://github.com/kmuto/review/issues/604
+[#609]: https://github.com/kmuto/review/issues/609
+[#610]: https://github.com/kmuto/review/issues/610
+[93691d0e2601eeb5715714b4fb92840bb3b3ff8b]: https://github.com/kmuto/review/commit/93691d0e2601eeb5715714b4fb92840bb3b3ff8b
+[67014a65411e3a3e5e2c57c57e01bee1ad18efc6]: https://github.com/kmuto/review/commit/67014a65411e3a3e5e2c57c57e01bee1ad18efc6
+# Version 1.7.2の主な変更点
+## バグ修正
+* latexbuilderで`//list`がhighlitingなしのときにキャプションが表示されなくなっていたのを修正しました ([#465])
+* markdownbuilderでdefinition listを使うとエラーになるのを修正しました ([#473])
+# Version 1.7.1の主な変更点
+## バグ修正
+* latexbuilderで`//listnum`のキャプションが2重に出力されるバグを修正しました ([#465])
+* review-initで生成される雛形を元にEPUB3のファイルを作成するとepubcheck 4.0.1でエラーになるバグを修正しました ([#456])
+# Version 1.7.0の主な変更点
+## 全般
+* Rubocopの設定の追加とそれに伴うリファクタリングを実施しました
+* 内部の文字コードをUTF-8に統一しました ([#399])
+* Dockerfileを追加しました
+## バグ修正
+* コードハイライト無効時に、htmlbuilderでlistnumおよびemlistnumにおいて行番号が表示されないバグを修正しました ([#449])
+## ビルダーとメーカー
+### epubmaker
+* 綴じ方向を設定する``direction``パラメータをサポートしました ([#435])
+## コードコントリビュータ
+* [@snoozer05](https://github.com/snoozer05)
+[#399]: https://github.com/kmuto/review/pull/399
+[#435]: https://github.com/kmuto/review/pull/435
+[#449]: https://github.com/kmuto/review/issues/449
+# Version 1.6.0の主な変更点
+## 全般
+* Ruby 1.8.7のサポートを終了しました
+* コードハイライトのデフォルト言語を設定できるようにしました ([#403])
+* 見出し参照の際のクォートもI18nを使うようにしました ([#420])
+* ``//source`` 記法でハイライトの設定と使用言語のオプションをサポートしました
+* 設定ファイルに ``toc`` を追加しました
+## バグ修正
+* ``@<hd>`` で子要素を指定できないバグを修正しました ([#400])
+* プロジェクトのパスに空白スペースが含まれているときにEPUBが正しく生成されないバグを修正しました ([#398])
+* ``@<img>``などを付録で使ったときに``appendix_format:alpha``にしておいても``図1.1``のようになってしまうバグを修正しました ([#405])
+* ハイライト時にリスト名が表示されないバグを修正しました ([#418])
+* i18nの設定がうまくマージされないバグを修正しました ([#423])
+* EPUBの表紙画像が厳密にマッチされないバグを修正しました ([#417])
+* EPUBのバージョンが3のときに ``htmlversion`` が正しく設定されないバグを修正しました ([#433])
+## コマンド
+### review-init
+* locale.ymlを生成するオプションを追加しました ([#425])
+## ビルダーとメーカー
+### htmlbuilder
+* 章番号を ``span`` タグでマークアップしました ([#415])
+### latexbuilder
+* ``config["conver"]`` をサポートしました
+### pdfmaker
+* EPUBMakerと同様のファイルの挿入機能をサポートしました
+### epubmaker
+* ``toc`` プロパティをconfig.ymlに追加しました ([#413])
+## コードコントリビュータ
+* [@keiji](https://github.com/keiji)
+* [@orangain](https://github.com/orangain)
+* [@akinomurasame](https://github.com/akinomurasame)
+* [@krororo](https://github.com/krororo)
+* [@masarakki](https://github.com/masarakki)
+[#398]: https://github.com/kmuto/review/issues/398
+[#400]: https://github.com/kmuto/review/issues/400
+[#405]: https://github.com/kmuto/review/issues/405
+[#403]: https://github.com/kmuto/review/issues/403
+[#413]: https://github.com/kmuto/review/issues/413
+[#415]: https://github.com/kmuto/review/issues/415
+[#417]: https://github.com/kmuto/review/issues/417
+[#418]: https://github.com/kmuto/review/issues/418
+[#420]: https://github.com/kmuto/review/issues/420
+[#423]: https://github.com/kmuto/review/issues/423
+[#425]: https://github.com/kmuto/review/issues/425
+[#433]: https://github.com/kmuto/review/issues/433
+# Version 1.5.0の主な変更点
+## 注意
+* 後述するリストハイライト時の言語指定のため、``//list``、``//emlist``等のリストブロック記法をreview-ext.rbで拡張している場合、既存のコードにエラーが出ることがあります。その場合、review-ext.rbを修正する必要があります（review-ext.rbを使っていない場合は影響はありません）。
+## 全般
+* config.ymlに設定項目を追加しました。
+* ``@<hd>``で付録の表記を正しく参照できるようにしました。
+* 浅いレベルのコラムを参照できない問題を修正しました。
+* i18n.ymlの項目を追加しました。
+* ``ReVIEW::Book::Base.load_default``を廃止しました。
+* ``@<imgref>``記法を追加しました。
+* サンプルのRakefileにpdf/epub/cleanタスクを追加しました。
+* ドキュメントのフォーマットをRDocからMarkdownに変更しました。
+* 「Re:VIEW Quick Start Guide」を追加しました。
+* ``@<hd>``でidが一意なターゲットを指定するときに``|``を省略できるようにしました。
+* リストのハイライト表示のときに言語を指定できるようにしました。
+* 「Re:VIEW Format Guide」を追加しました。
+* ハイライトを使うときのconfig.ymlの設定名として``highlight``を追加しました。
+## コマンド
+### review-epubmaker
+* config.ymlの``toc``をサポートしました。
+### review-init
+* ディレクトリが存在しているときでも実行できる``--force``オプションを追加しました。
+### review-vol
+* ``--yaml``オプションを追加しました。
+## Builders and Makers
+### markdownbuilder
+* ``list_header()``と``list_body()``を追加しました。
+### htmlbuilder
+* ``HTMLBuilder#texequation``のMathMLのエラーを修正しました。
+### idgxmlbuilder
+* ``@<ttb>``の``index``タグを廃止しました。
+### latexbuilder
+* ``@<table>``で他の章のテーブルを参照できるようにしました。
+* listings packageによるハイライトをサポートしました。
+### pdfmaker
+* LaTeXツールがないときにエラーを出すようにしました。
+* config.ymlの``toctitle``をサポートしました。
+* すでにPDFファイルが存在しているときに削除するようにしました。
+* config.ymlの``dvicommand``と``dvioptions``をサポートしました。
+* config.ymlの``texoptions``をサポートしました。
+* ``sty/*.fd``や``sty/*.cls``を読み込むようにしました。
+* TeXの処理フックを追加しました。
+* LaTeXコマンドの失敗時に例外を上げて処理が止まるようにしました
+* 一部sedコマンドを利用していた部分を修正し依存しないようにしました。
+### epubmaker
+* MathMLのサポートを改善しました。
+* ダミーの``<li>``要素を見せないようにしました。
+* config.ymlにツリー構造を導入しました。
+* 国際化のリソースとしてEPUBMaker::Resourceの代わりにReVIEW::I18nが使われるようになりました。
+## コードコントリビュータ
+* akinomurasameさん
+* gfxさん
+* krororoさん
+* orangainさん
+# Version 1.4.0の主な変更点
+## 全般
+* bib記法のIDを正規化しました。
+* POSTDEFファイルとcatalog.ymlのPOSTDEFセクションの挙動を合わせました。
+* catalog.ymlにAPPENDIXセクションを追加しました。
+* 暗黙的なprefaces, appendix, postscriptsの指定を削除しました。
+* コードとテストケースをリファクタリングしました。
+* README.rdocにInstallation, Resources, Linksの情報を追加しました。
+## コマンド
+### review-epubmaker
+* debugがtrueのときに、第一階層の一時ディレクトリを保持するようにしました。
+* cover_linearオプションをサポートしました。
+### review-catalog-converter
+* 従来のカタログファイルをcatalog.ymlに変換するコマンドを追加しました。
+## Builders and Makers
+### markdownbuilder
+* GitHub Flavored Markdownとの互換性を向上させました。
+* Headlineの前後にブランクを挿入しました。
+* tt記法を追加しました。
+* footnote記法を追加しました。
+* indepimage記法を追加しました。
+* 表示されていなかった画像のキャプションを表示するようにしました。
+### htmlbuilder
+* 画像ファイルが見つからないときに警告を出すようにしました。
+* レイアウトファイル名を'layout.erb'から'layout.html.erb'に変更しました。
+* emlist/emlistnum/cmdのキャプションをコンパイルするようにしました。
+* title記法をコンパイルするようにしました。
+### idgxmlbuilder
+* 画像ファイルが見つからないときに警告を出すようにしました。
+### latexbuilder
+* レイアウトファイル名を'review.tex.erb'から'layout.tex.erb'に変更しました。
+* 奥付用の項目として'contact'(連絡先)を追加しました。また、発行所と印刷所を両方併記するため、pblを「発行所」として追加し、prtを「印刷所」として両方を記述できるようにしました。
+  ただし、互換性のためにデフォルトではprtは「発行所」になっているため、i18n.ymlで設定を行う必要があります。
+### pdfmaker
+* ロケールファイルを使用できるようにしました。
+* colophon_orderオプションを追加しました。
+### epubmaker
+* EPUB3のときのカバーファイルにepub:type='cover'属性を追加しました。
+* 見出し含まれるHTMLの特殊文字をエスケープしました。
+## コードコントリビュータ
+* suzuki さん
+* vvakame さん
+* eiel さん
+# Version 1.3.0の主な変更点
+## 全般
+* 従来のカタログファイルの代わりにcatalog.ymlを使用できるようにしました。
+* コラムを参照する`@<column>{}`を追加しました。
+* `@<chapref>{}`で部を参照できるようにしました。
+* セーフモード（環境変数`REVIEW_SAFE_MODE`の設定）を追加しました。
+* *.reのファイルは必ずカタログファイルと同じ階層に置くことにしました。
+* config.rbを使った設定を廃止しました。
+* 文書ディレクトリ内にあるlib/review/以下のファイルの読み込み機能を廃止しました。
+* 付録の見出し表記を指定する設定`appendix_format`（arabic, roman, alphaのいずれかを指定）を追加しました。
+## コマンド
+* 同じバージョンのreview-compileを使用するようにしました。
+* バージョン情報を表示する`--version`オプションを追加しました。
+### review-compile
+* カタログファイルを指定する`--catalogfile`オプションを追加しました。
+### review-pdfmaker
+* ビルド用の一時ディレクトリを削除するようにしました。
+* 途中でエラーが発生した場合に動作を停止するようにしました。
+* 途中でエラーが発生しても停止せずに実行し続ける`--ignore-errors`オプションを追加しました。
+* ディレクトリの深い場所にある画像ファイルのebb/bbファイルを作成するようにしました。
+* `debug`オプションを上書きする`--[no-]debug`オプションを追加しました。
+### review-init
+* 出力されるCSSのファイル名を統一しました。
+### review-epubmaker
+* review-empumaker-ngから名称を変更しました。旧review-epubmakerはreview-epubmaker-legacyに名称を変更しました。
+* EPUBに同梱する画像の指定に関する`verify_target_images`と`force_include_images`オプションを追加しました。
+## Builders
+### htmlbuilder
+* 脚注から参照元の本文に戻れるようにしました。
+* HTMLコメント内でハイフンのエスケープをするようにしました。
+* id属性をHTML規格に合わせて正規化するようにしました。
+* layoutファイルからセクションタイトル一覧（`toc`）を参照できるようにしました。
+* layoutファイルから前後の章のリンク（`prev_chapter`, `next_chapter`）を参照できるようにしました。
+### latexbuilder
+* コラムを目次に含めるようにしました。
+* graph記法で使用する画像の形式をPDFに変更しました。
+## コードコントリビュータ
+* kazutomi さん
+* dmiyakawa さん
+* zunda さん
+# Version 1.2.0の主な変更点
+## 全般
+* 名称が'ReVIEW'から'Re:VIEW'に変更になりました。
+* 画像ファイルが設定ではなくビルダ名などを元にディレクトリ内を探索するようになりました。
+## コマンド
+### review-epubmaker-ng / review-epubmaker
+* フォント埋め込みに対応しました。
+* EPUB3のMathMLに対応しました。
+* OPFファイル内のIDとして'rv-'というプレフィックスをつけるようになりました。
+* config.ymlでpht(Photographer / 撮影者) と csl(Consultant / 監修者)を指定できるようになりました。
+* 目次の各章・節見出し等について、元々の見出しにHTMLの装飾要素がついていた場合、目次ではそれらの要素を落とすようにしました(review-epubmaker)
+### review-pdfmaker
+* config.ymlで"texcommand"を指定できるようになりました。これにより、platexではなくLuaLaTeX等も指定できるようになりました。
+### review-init
+* gemでインストールした場合に動作しないバグを修正しました。
+## Builders
+### HTMLBuilder
+* pygmentsによるhiglightingをconfig.ymlで"pygments: true"と指定した場合のみ有効になるようにしました。
+* EPUB3での脚注について、epub:type="noteref"とepub:type="footnote"が指定されるようになりました。
+### LATEXBuilder
+* //bibpaper の直後で改行するようにしました。
+### MARKDOWNBuilder
+* ``@<em>{}`` (``@<i>``と同様)と``@<strong>{}``(``@<b>``と同様)をサポートしました。
+# Version 1.1の変更点
+## 全般
+* markdownbuilder追加
+* inaobuilder追加
+* jewelerからbundlerに変更
+* review-initコマンドを追加
+* プリプロセスでMIMEと半角カナを保持するよう修正
+* エスケープされるべきところでされないバグを修正(``[...]``内で「``]``」がエスケープできない等)
+* その他多数のバグ修正
+## review-compile
+* --structuredxmlオプション追加(idgxml)
+* --toclevelオプション追加
+* --tabwidthオプション追加
+* --output-fileオプション追加
+## review-epubmakerとreview-pdfmaker共通
+* PARTファイルの中に``foo.re``といったファイル名を書けるよう修正
+* 一時ファイルのファイル名を変更(文書名+"-pdf" or 文書名+"-epub")
+## review-epubmaker
+* epubversion、htmlversion追加(EPUB3は実験的サポート)
+* YAMLファイルにcover_linearオプション追加
+## review-pdfmaker
+* review.tex.erbファイル追加
+* HTMLbuilderのようにlayoutsファイルをサポート
+## review-compile
+* ``//centering``記法追加
+* ``//olnum``記法追加
+* ``//comment``の引数を0..1に変更
+* ``//source``の引数を0..1に変更
+## htmlbuilder
+* HTML5には``<tt>``がないので``<code>``に変更
+* ``@<bou>``を追加
+* pygmentsによるhighlightをサポート
+* ``<title>``内ではReVIEWのタグを無視するよう修正
+## latexbuilder
+* ReVIEW専用マクロを追加(``\reviewindepimagecaption``, ``\reviewth``, ``\reviewem`` and ``\reviewstrong``)
+* ``\reviewbibref``、``\\reviewtableref``、``\reviewimageref``マクロに引数を追加してリンクになるよう修正
+* デフォルトのテンプレートに``\usepackage{amsmath}``を追加
+* ``//box``記法をサポート
+* ``@<ami>``記法をサポート
+* 見出しレベル5と6を追加(paragraph, subparagraph)
+* ダッシュのエスケープを追加
+* ``begin{alltt}..\end{alltt}``は``\reviewemlist``、``\reviewlist``、``\reviewcmd``の各専用マクロ内で指定するよう(自分で再定義できるよう)修正