review 2.4.0 → 2.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 639a13776cef44b59eb3464cff41726186d37bb1
-  data.tar.gz: f285c0fb10f02260f16797a412d65287fb035fda
+SHA256:
+  metadata.gz: 3908a824bcb0197ea94ec2c8f88be8b4bef238ceb37c6b9616eab435ef8a3670
+  data.tar.gz: f80a98194a5be2f5493e631eaed6e271d4f130b64085b93e3507cff1314748cc
 SHA512:
-  metadata.gz: 157a8ad3ee0078e7c2a3e3c2bc3fc18f9a2f7f56474384884f750b5ff4d13acdb4514d89777d4d418e315b25e909c3eb52f89a0e8b2411ea2fc23bea6a0091b9
-  data.tar.gz: 4112950e237224284a1d04efb1b391f427acb043ab121040bfe11e0055a32c7a4a57b8c349755d693da7ea62a80709e9f1d7bf1a7666e194a5011bff13fccb67
+  metadata.gz: 7a482cd982b4afdca790bdf3ed47372c476d4e9eff104c85ed533b27ca3f385179df3cabd087c09b627a0f55c472d795e165d102dc998b3e9732acac9c177ace
+  data.tar.gz: d48dcfbc1dadd2d3ac9eb0c65165ea84202fe3b3aa5a49000af54834596f82d0ca9034368c4e9e88af825c02d47b8ff20f4fa92b309a9c3d32a242545888708b

data/.rubocop.yml

@@ -28,8 +28,8 @@ Lint/AssignmentInCondition:
 Lint/ParenthesesAsGroupedExpression:
   Enabled: true
 
-Lint/RescueWithoutErrorClass:
-  Enabled: false
+#Lint/RescueWithoutErrorClass:
+#  Enabled: false
 
 Lint/UnderscorePrefixedVariableName:
   Enabled: true
@@ -113,10 +113,16 @@ Style/Encoding:
 Style/EmptyElse:
   Enabled: true
 
+Style/EvalWithLocation:
+  Enabled: false
+
 Style/FormatString:
   EnforcedStyle: sprintf
   Enabled: true
 
+Style/FormatStringToken:
+  Enabled: false
+
 Style/GuardClause:
   Enabled: false
 
@@ -124,7 +130,7 @@ Style/IfInsideElse:
   Enabled: false
 
 Style/IfUnlessModifier:
-  Enabled: true
+  Enabled: false
 
 Style/MutableConstant:
   Enabled: false
@@ -184,6 +190,9 @@ Style/LineEndConcatenation:
 Style/MethodCallWithoutArgsParentheses:
   Enabled: true
 
+Style/MixinUsage:
+  Enabled: false
+
 Style/MultilineBlockChain:
   Enabled: true
 
@@ -228,6 +237,9 @@ Style/RedundantSelf:
 Style/RegexpLiteral:
   Enabled: true
 
+Style/RescueStandardError:
+  Enabled: false
+
 Style/Semicolon:
   Enabled: true
 
@@ -262,7 +274,7 @@ Style/UnneededPercentQ:
   Enabled: false
 
 Style/WhileUntilModifier:
-  Enabled: true
+  Enabled: false
 
 #Style/YodaCondition:
 #  Enabled: true
@@ -338,7 +350,7 @@ Layout/SpaceAroundOperators:
   Enabled: true
 
 Layout/SpaceBeforeBlockBraces:
-  Enabled: true
+  Enabled: false
 
 Layout/SpaceBeforeComma:
   Enabled: true
@@ -349,6 +361,9 @@ Layout/SpaceInsideBlockBraces:
 Layout/SpaceInsideHashLiteralBraces:
   Enabled: true
 
+Layout/SpaceInsideArrayLiteralBrackets:
+  Enabled: true
+
 Layout/SpaceInsideStringInterpolation:
   EnforcedStyle: no_space
   Enabled: true

data/.travis.yml

@@ -6,11 +6,12 @@ before_install:
   - gem update bundler
 
 rvm:
-  - 2.0
+##  - 2.0
   - 2.1
   - 2.2
   - 2.3.3
   - 2.4.1
+  - 2.5.0
 ##  - ruby-head
 
 branches:

data/NEWS.ja.md

@@ -1,3 +1,96 @@
+# Version 3.x (未リリース)
+
+TODO:lib/review/version.rbとreview.gemspecの更新をすること
+
+以下は未マージ・開発中。なるべく入れたいが…
+
+* 非互換の変更：LaTeX の `@<m>` によるインラインの数式の前後にスペースを入れるのを止めました ([#943])
+* 機能追加：LaTeX から生成する PDF の圧縮レベルオプション指定 (`-z 9`、最大圧縮) を config.yml のサンプルに記載しました ([#935])
+* 非互換の変更：`@<chapref>`、`@<column>` の展開文字列を locale.yml で変更しやすいようにしました ([#886])
+* 非互換の変更：LaTeX の表紙 (`cover` パラメータ) と大扉 (`titlepage` パラメータ) は独立した設定となりました ([#848])
+* 非互換の変更：インライン文字装飾の LaTeX への変換結果を `\textbf` ではなく `\reviewbold` のように抽象化した名前にしました ([#792])
+* 非互換の変更：LaTeX でルビを表現できるよう pxrubrica パッケージを読み込むようにしました ([#655])
+* 非互換の変更：LaTeX のコードリスト環境を jlisting から plistings パッケージに変更しました ([#635])
+* 非互換の変更：LaTeX のハイパーリンクの枠線のデフォルトをなしにしました ([#808])
+* 非互換の変更：LaTeX のコードリストを reviewlistblock 環境で囲むようにしました ([#916])
+* 非互換の変更：LaTeX で geometry.sty を使うのを止めました ([#912])
+* 非互換の変更・新機能：
+* 機能追加：表のセル内で `@<br>{}` による改行ができるようにしました ([#668])
+* 非互換の変更・新機能：複数の LaTeX レイアウトファイルから選択できるようにしました ([#812])
+
+非互換になるところはもう少し詳しく説明が必要そう
+
+# Version 2.5.0
+
+## 新機能
+* プレインテキストを出力する review-textmaker コマンドを用意しました ([#926])
+* LaTeX 向けに、図版の BoudingBox の採取手段を変更する `pdfmaker/bbox` パラメータを追加しました ([#947])
+* 新機能：空行を入れる命令 `//blankline` を追加しました ([#942])
+
+## 非互換の変更
+* `//include` 命令は不完全でユーザーの混乱を招くため、削除しました ([#887])
+* LaTeX において、見出しや図表キャプション内にある脚注は `\footnotemark` を暗黙に使うようにしました ([#841])
+* EPUB および WebMaker の大扉では、印刷所 (prt) の代わりに出版社 (pbl) を記載するようにしました ([#927])
+
+## バグ修正
+* column の終了が正しく動作しないのを修正しました ([#894])
+* `@<hd>` 命令の使用時に内部エラーが出ることがあるのを修正しました ([#896])
+* LaTeX において、キャプションが空のときに空行が入ってしまうのを修正しました ([#922])
+* `//graph` 命令内で gnuplot を使用したときにエラーが発生するのを修正しました ([#931])
+* Windows で review コマンドがエラーになるのを修正しました ([#940])
+* Windows で EPUB 生成時に一時作業ファイルの削除エラーが発生するのを修正しました ([#946])
+
+## 機能強化
+* `//note` などの囲み要素内で末尾に空行があるときに不要な空の段落が作成されるのを修正しました ([#882])
+* `@<chap>` などで catalog.yml に存在しない ID を指定したときのエラーメッセージをわかりやすいものにしました ([#891])
+* catalog.yml に UTF-8 BOM ヘッダがあっても正常に動作するようにしました ([#899])
+* LaTeX の奥付の罫線の長さを固定幅ではなく紙面幅にしました ([#907])
+* texstyle パラメータで配列による複数の TeX スタイルファイルの読み込みを許可するようにしました ([#908])
+* 独自の Rakefile を利用するための `lib/tasks` フォルダを `review-init` コマンドで作成するようにしました ([#921])
+* `review-init` コマンド実行時に、`doc` フォルダにドキュメントをコピーするようにしました ([#918])
+* `review` コマンドのヘルプメッセージを追加しました ([#933])
+* 存在しないあるいは壊れている YAML ファイルを読み込もうとしたときに妥当なエラーメッセージを出すようにしました ([#958])
+* `@<img>` や `@<table>` などのインライン命令で存在しない ID を指定したときのエラーメッセージをわかりやすいものに統一しました ([#954])
+* catalog.yml に存在しないファイルをコンパイルしようとしたときのエラーメッセージをわかりやすいものにしました ([#953])
+* LaTeX において、table, imgtable, image, indepimage から変換した TeX ソースコードにコメントで ID を記述するようにしました（`\begin{reviewimage}%%sampleimg` など）。フック処理での書き換えを簡易化するための修正であり、通常のLaTeX(PDF)の出力には影響ありませんが、独自のフック処理を使用していたプロジェクトでは修正が必要になるかもしれません ([#937])
+
+## ドキュメント
+* 画像ファイルの拡張子の探索順序を文書化しました ([#939])
+* review-textmaker の説明を追加しました ([#944])
+
+## コントリビューターのみなさん
+* [@kauplan](https://github.com/kauplan)
+* [@krororo](https://github.com/krororo)
+* [@mhidaka](https://github.com/mhidaka)
+* [@Pegasus204](https://github.com/Pegasus204)
+
+[#841]: https://github.com/kmuto/review/issues/841
+[#882]: https://github.com/kmuto/review/issues/882
+[#887]: https://github.com/kmuto/review/issues/887
+[#891]: https://github.com/kmuto/review/issues/891
+[#894]: https://github.com/kmuto/review/pull/894
+[#896]: https://github.com/kmuto/review/issues/896
+[#899]: https://github.com/kmuto/review/issues/899
+[#907]: https://github.com/kmuto/review/pull/907
+[#908]: https://github.com/kmuto/review/pull/908
+[#918]: https://github.com/kmuto/review/issues/918
+[#921]: https://github.com/kmuto/review/issues/921
+[#922]: https://github.com/kmuto/review/pull/922
+[#926]: https://github.com/kmuto/review/issues/926
+[#927]: https://github.com/kmuto/review/pull/927
+[#931]: https://github.com/kmuto/review/pull/931
+[#933]: https://github.com/kmuto/review/issues/933
+[#937]: https://github.com/kmuto/review/pull/937
+[#939]: https://github.com/kmuto/review/pull/939
+[#940]: https://github.com/kmuto/review/issues/940
+[#942]: https://github.com/kmuto/review/issues/942
+[#944]: https://github.com/kmuto/review/pull/944
+[#946]: https://github.com/kmuto/review/issues/946
+[#947]: https://github.com/kmuto/review/pull/947
+[#953]: https://github.com/kmuto/review/issues/953
+[#954]: https://github.com/kmuto/review/issues/954
+[#958]: https://github.com/kmuto/review/issues/958
+
 # Version 2.4.0
 
 ## 新機能

data/NEWS.md

@@ -1,3 +1,80 @@
+# Version 2.5.0
+
+## New Features
+
+* add a new maker command `review-textmaker` to output plain text files ([#926])
+* LATEXBuilder: add a new parameter `pdfmaker/bbox` for settings of BoudingBox ([#947])
+* add a new command `//blankline` ([#942])
+
+## Breaking Changes
+
+* remove (incomplete) command `//include` ([#887])
+* LATEXBuilder: use `\footnotemark` implicitly for captions and headings ([#841])
+* EPUBMaker, WEBMaker: use `pbl` (publisher) instead of `prt` (printer) in titlepage ([#927])
+
+## Bug Fixes
+
+* fix column closing ([#894])
+* fix internal errors in `@<hd>` ([#896])
+* LATEXBuilder: fix to ignore empty caption ([#922])
+* fix invalid commmand errors in `//graph` when using gnuplot ([#931])
+* fix errors of `review` command in Windows ([#940])
+* EPUBMaker: fix error of removing temporary files in Windows ([#946])
+
+## Enhancements
+
+* remove tailing empty lines in block (captionblocks) such as `//note`. ([#882])
+* fix error messages when using non-existent ID of catalog.yml in inline commands such as `@<chap>` ([#891])
+* ignore UTF-8 BOM in catalog.yml ([#899])
+* LATEXBuilder: fix a length of horizontal line in colophon ([#907])
+* allow to use multiple parameters of `texstyle` in config.yml ([#908])
+* review-init: create `lib/tasks` folder to use original Rake commands ([#921])
+* review-init: copy `doc` folder into the target project ([#918])
+* add a help message of `review` ([#933])
+* show appropriate error messages when using invalid or non-existent YAML files ([#958])
+* show better error messages when using unknown ID in inline commands such as `@<img>` and `@<table>` ([#954])
+* show better error messages when compiling a file not included in catalog.yml ([#953])
+* LATEXBuilder: add IDs of `table`, `imgtable`, `image` and `indepimage` as comments (ex. `\begin{reviewimage}%%sampleimg`) ([#937])
+
+## Docs
+
+* add the rule of searching image files with extension ([#939])
+* add description of `review-textmaker` ([#944])
+
+## Contributors
+
+* [@kauplan](https://github.com/kauplan)
+* [@krororo](https://github.com/krororo)
+* [@mhidaka](https://github.com/mhidaka)
+* [@Pegasus204](https://github.com/Pegasus204)
+
+[#841]: https://github.com/kmuto/review/issues/841
+[#882]: https://github.com/kmuto/review/issues/882
+[#887]: https://github.com/kmuto/review/issues/887
+[#891]: https://github.com/kmuto/review/issues/891
+[#894]: https://github.com/kmuto/review/pull/894
+[#896]: https://github.com/kmuto/review/issues/896
+[#899]: https://github.com/kmuto/review/issues/899
+[#907]: https://github.com/kmuto/review/pull/907
+[#908]: https://github.com/kmuto/review/pull/908
+[#918]: https://github.com/kmuto/review/issues/918
+[#921]: https://github.com/kmuto/review/issues/921
+[#922]: https://github.com/kmuto/review/pull/922
+[#926]: https://github.com/kmuto/review/issues/926
+[#927]: https://github.com/kmuto/review/pull/927
+[#931]: https://github.com/kmuto/review/pull/931
+[#933]: https://github.com/kmuto/review/issues/933
+[#937]: https://github.com/kmuto/review/pull/937
+[#939]: https://github.com/kmuto/review/pull/939
+[#940]: https://github.com/kmuto/review/issues/940
+[#942]: https://github.com/kmuto/review/issues/942
+[#944]: https://github.com/kmuto/review/pull/944
+[#946]: https://github.com/kmuto/review/issues/946
+[#947]: https://github.com/kmuto/review/pull/947
+[#953]: https://github.com/kmuto/review/issues/953
+[#954]: https://github.com/kmuto/review/issues/954
+[#958]: https://github.com/kmuto/review/issues/958
+
 # Version 2.4.0
 
 ## New Features

data/README.md

@@ -99,4 +99,4 @@ LGPL. See [COPYING](https://github.com/kmuto/review/blob/master/COPYING) file.
 
 ## Copyright
 
-Copyright (c) 2006-2017 Minero Aoki, Kenshi Muto, Masayoshi Takahashi, Masanori Kado.
+Copyright (c) 2006-2018 Minero Aoki, Kenshi Muto, Masayoshi Takahashi, Masanori Kado.

data/bin/review

@@ -6,29 +6,48 @@
 #    review epubmaker config.yml
 #      -> call `review-epubmaker config.yml`
 #
+# Copyright (c) 2017-2018 Kenshi Muto, Masayoshi Takahashi
+#
+# 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'
 
 def usage
   message = <<-EOB
 usage: review <command> [<args>]
 
-ReVIEW commands are:
-  init
-  preproc
-  compile
-  epubmaker
-  pdfmaker
-  vol
-  check
-  index
-  validate
+Re:VIEW commands are:
+  init      : generate Re:VIEW project directory.
+  preproc   : preprocess Re:VIEW document file.
+  compile   : convert Re:VIEW document file.
+  epubmaker : build EPUB.
+  webmaker  : build web pages.
+  pdfmaker  : build PDF with LaTeX.
+  textmaker : build text files.
+  vol       : show volume of Re:VIEW document.
+  check     : check there are no REJECT words in the document.
+  index     : show heading list.
+  validate  : validate Re:VIEW document files.
+  version   : show Re:VIEW version.
+  --help    : show this message.
 EOB
   print message
   exit 1
 end
 
-usage if ARGV.length == 0
+usage if ARGV.length == 0 || ARGV[0] == '--help'
+
+if ARGV[0] == 'version'
+  puts ReVIEW::VERSION
+  exit
+end
 
 command = "review-#{ARGV.shift}"
 bindir = Pathname.new(__FILE__).realpath.dirname
@@ -39,4 +58,11 @@ unless File.exist?(command_path)
   usage
 end
 
-exec(command_path, *ARGV)
+if RUBY_PLATFORM =~ /mswin|bccwin|mingw/
+  cmd = File.join(RbConfig::CONFIG['bindir'],
+                  RbConfig::CONFIG['ruby_install_name'])
+  cmd << RbConfig::CONFIG['EXEEXT']
+  exec(cmd, command_path, *ARGV)
+else
+  exec(command_path, *ARGV)
+end

data/bin/review-compile

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 #
-# Copyright (c) 2008-2017 Kenshi Muto, Masayoshi Takahashi, KADO Masanori, Minero Aoki
+# Copyright (c) 2008-2018 Kenshi Muto, Masayoshi Takahashi, KADO Masanori, Minero Aoki
 # Copyright (c) 1999-2007 Minero Aoki
 #
 # This program is free software.
@@ -33,133 +33,151 @@ end
 
 def _main
   @logger = ReVIEW.logger
-  mode = :files
-  basedir = nil
+  @mode = :files
+  @basedir = nil
   if /\Areview2/ =~ File.basename($PROGRAM_NAME)
-    target = File.basename($PROGRAM_NAME, '.rb').sub('review2', '')
+    @target = File.basename($PROGRAM_NAME, '.rb').sub('review2', '')
   else
-    target = nil
+    @target = nil
   end
-  check_only = false
-  output_filename = nil
+  @check_only = false
+  @output_filename = nil
 
-  config = ReVIEW::Configure.values
+  @config = ReVIEW::Configure.values
 
-  opts = OptionParser.new
-  opts.version = ReVIEW::VERSION
-  opts.banner = "Usage: #{File.basename($PROGRAM_NAME)} [--target=FMT]"
-  opts.on('--yaml=YAML', 'Read configurations from YAML file.') { |yaml| config['yaml'] = yaml }
-  opts.on('-c', '--check', 'Check manuscript') { check_only = true }
-  opts.on('--level=LVL', 'Section level to append number.') { |lvl| config['secnolevel'] = lvl.to_i }
-  opts.on('--toclevel=LVL', 'Section level to append number.') { |lvl| config['toclevel'] = lvl.to_i }
-  opts.on('--structuredxml', 'Produce XML with structured sections. (idgxml)') { config['structuredxml'] = true }
-  opts.on('--table=WIDTH', 'Default table width. (idgxml)') { |tbl| config['tableopt'] = tbl }
-  opts.on('--listinfo', 'Append listinfo tag to lists to indicate begin/end. (idgxml)') { config['listinfo'] = true }
-  opts.on('--chapref="before,middle,after"', 'Chapref decoration. (idgxml)') { |cdec| config['chapref'] = cdec }
-  opts.on('--chapterlink', 'make chapref hyperlink') { config['chapterlink'] = true }
-  opts.on('--stylesheet=file', 'Stylesheet file for HTML (comma separated)') { |files| config['stylesheet'] = files.split(/\s*,\s*/) }
-  opts.on('--mathml', 'Use MathML for TeX equation in HTML') { config['mathml'] = true }
-  opts.on('--htmlversion=VERSION', 'HTML version.') do |v|
-    v = v.to_i
-    config['htmlversion'] = v if [4, 5].include?(v)
-  end
-  opts.on('--epubversion=VERSION', 'EPUB version.') do |v|
-    v = v.to_i
-    config['epubversion'] = v if [2, 3].include?(v)
-  end
-  opts.on('--target=FMT', 'Target format.') { |fmt| target = fmt } unless target
-  opts.on('--footnotetext',
-          'Use footnotetext and footnotemark instead of footnote (latex)') { config['footnotetext'] = true }
-  opts.on('--draft', 'use draft mode(inline comment)') { config['draft'] = true }
-  opts.on('--directory=DIR', 'Compile all chapters in DIR.') do |path|
-    mode = :dir
-    basedir = path
-  end
-  opts.on('--output-file=FILENAME', 'Write all results into file instead of stdout.') { |filename| output_filename = filename }
-  opts.on('--tabwidth=WIDTH', 'tab width') { |width| config['tabwidth'] = width.to_i }
-  opts.on('--catalogfile=FILENAME', 'Set catalog file') { |catalogfile| config['catalogfile'] = catalogfile }
-  opts.on('--help', 'Prints this message and quit.') do
-    puts opts.help
-    exit 0
-  end
-  begin
-    opts.parse!
-
-    unless target
-      if check_only
-        target = 'html'
-      else
-        raise OptionParser::ParseError, 'no target given'
-      end
-    end
-  rescue OptionParser::ParseError => err
-    @logger.error(err.message)
-    $stderr.puts opts.help
-    exit 1
-  end
+  parse_opts
 
   begin
     loader = ReVIEW::YAMLLoader.new
-    if config['yaml']
-      config.deep_merge!(loader.load_file(config['yaml']))
+    if @config['yaml']
+      error "#{config['yaml']} not found." unless File.exist?(@config['yaml'])
+      begin
+        @config.deep_merge!(loader.load_file(@config['yaml']))
+      rescue => e
+        error "yaml error #{e.message}"
+      end
     elsif File.exist?(DEFAULT_CONFIG_FILENAME)
-      config.deep_merge!(loader.load_file(DEFAULT_CONFIG_FILENAME))
+      begin
+        @config.deep_merge!(loader.load_file(DEFAULT_CONFIG_FILENAME))
+      rescue => e
+        error "yaml error #{e.message}"
+      end
     end
 
-    config['builder'] = target
-    ReVIEW::I18n.setup(config['language'])
+    @config['builder'] = @target
+    ReVIEW::I18n.setup(@config['language'])
     begin
-      config.check_version(ReVIEW::VERSION)
+      @config.check_version(ReVIEW::VERSION)
     rescue ReVIEW::ConfigError => e
-      @logger.warn e.message
+      warn e.message
     end
 
-    mode = :dir if ARGV.blank?
+    @mode = :dir if ARGV.blank?
 
-    case mode
+    case @mode
     when :files
-      if ARGV.empty?
-        @logger.error('no input')
-        exit 1
-      end
+      error('no input') if ARGV.empty?
 
-      basedir = File.dirname(ARGV[0])
-      book = ReVIEW::Book::Base.load(basedir)
-      book.config = config # needs only at the first time
+      @basedir = File.dirname(ARGV[0])
+      book = ReVIEW::Book::Base.load(@basedir)
+      book.config = @config # needs only at the first time
       ARGV.each do |item|
+        error("file not found: #{item}") unless File.exist?(item)
         chap_name = File.basename(item, '.*')
         chap = book.chapter(chap_name)
-        compiler = ReVIEW::Compiler.new(load_strategy_class(target, check_only))
+        compiler = ReVIEW::Compiler.new(load_strategy_class(@target, @check_only))
         result = compiler.compile(chap)
-        if output_filename
-          write output_filename, result
+        if @output_filename
+          write @output_filename, result
         else
-          puts result unless check_only
+          puts result unless @check_only
         end
       end
     when :dir
-      book = basedir ? ReVIEW::Book.load(basedir) : ReVIEW::Book::Base.load
-      book.config = config
-      compiler = ReVIEW::Compiler.new(load_strategy_class(target, check_only))
+      book = @basedir ? ReVIEW::Book.load(@basedir) : ReVIEW::Book::Base.load
+      book.config = @config
+      compiler = ReVIEW::Compiler.new(load_strategy_class(@target, @check_only))
       book.chapters.each do |chap|
         str = compiler.compile(chap)
-        write "#{chap.name}#{compiler.strategy.extname}", str unless check_only
+        write "#{chap.name}#{compiler.strategy.extname}", str unless @check_only
       end
       # PART
       book.parts_in_file.each do |part|
         str = compiler.compile(part)
-        write "#{part.name}#{compiler.strategy.extname}", str unless check_only
+        write "#{part.name}#{compiler.strategy.extname}", str unless @check_only
       end
     else
-      raise "must not happen: #{mode}"
+      raise "must not happen: #{@mode}"
     end
   rescue ReVIEW::ApplicationError => err
-    raise if $DEBUG
-    @logger.error(err.message)
+    error(err.message)
+  end
+end
+
+def parse_opts
+  opts = OptionParser.new
+  opts.version = ReVIEW::VERSION
+  opts.banner = "Usage: #{File.basename($PROGRAM_NAME)} [--target=FMT]"
+  opts.on('--yaml=YAML', 'Read configurations from YAML file.') { |yaml| @config['yaml'] = yaml }
+  opts.on('-c', '--check', 'Check manuscript') { @check_only = true }
+  opts.on('--level=LVL', 'Section level to append number.') { |lvl| @config['secnolevel'] = lvl.to_i }
+  opts.on('--toclevel=LVL', 'Section level to append number.') { |lvl| @config['toclevel'] = lvl.to_i }
+  opts.on('--structuredxml', 'Produce XML with structured sections. (idgxml)') { @config['structuredxml'] = true }
+  opts.on('--table=WIDTH', 'Default table width. (idgxml)') { |tbl| @config['tableopt'] = tbl }
+  opts.on('--listinfo', 'Append listinfo tag to lists to indicate begin/end. (idgxml)') { @config['listinfo'] = true }
+  opts.on('--chapref="before,middle,after"', 'Chapref decoration. (idgxml)') { |cdec| @config['chapref'] = cdec }
+  opts.on('--chapterlink', 'make chapref hyperlink') { @config['chapterlink'] = true }
+  opts.on('--stylesheet=file', 'Stylesheet file for HTML (comma separated)') { |files| @config['stylesheet'] = files.split(/\s*,\s*/) }
+  opts.on('--mathml', 'Use MathML for TeX equation in HTML') { @config['mathml'] = true }
+  opts.on('--htmlversion=VERSION', 'HTML version.') do |v|
+    v = v.to_i
+    @config['htmlversion'] = v if [4, 5].include?(v)
+  end
+  opts.on('--epubversion=VERSION', 'EPUB version.') do |v|
+    v = v.to_i
+    @config['epubversion'] = v if [2, 3].include?(v)
+  end
+  opts.on('--target=FMT', 'Target format.') { |fmt| @target = fmt } unless @target
+  opts.on('--footnotetext',
+          'Use footnotetext and footnotemark instead of footnote (latex)') { @config['footnotetext'] = true }
+  opts.on('--draft', 'use draft mode(inline comment)') { @config['draft'] = true }
+  opts.on('--directory=DIR', 'Compile all chapters in DIR.') do |path|
+    @mode = :dir
+    @basedir = path
+  end
+  opts.on('--output-file=FILENAME', 'Write all results into file instead of stdout.') { |filename| @output_filename = filename }
+  opts.on('--tabwidth=WIDTH', 'tab width') { |width| @config['tabwidth'] = width.to_i }
+  opts.on('--catalogfile=FILENAME', 'Set catalog file') { |catalogfile| @config['catalogfile'] = catalogfile }
+  opts.on('--help', 'Prints this message and quit.') do
+    puts opts.help
+    exit 0
+  end
+  begin
+    opts.parse!
+
+    unless @target
+      if @check_only
+        @target = 'html'
+      else
+        raise OptionParser::ParseError, 'no target given'
+      end
+    end
+  rescue OptionParser::ParseError => err
+    warn(err.message)
+    $stderr.puts opts.help
     exit 1
   end
 end
 
+def error(msg)
+  @logger.error "#{File.basename($PROGRAM_NAME, '.*')}: #{msg}"
+  exit 1
+end
+
+def warn(msg)
+  @logger.warn "#{File.basename($PROGRAM_NAME, '.*')}: #{msg}"
+end
+
 def load_strategy_class(target, strict)
   require "review/#{target}builder"
   ReVIEW.const_get("#{target.upcase}Builder").new(strict)