review 3.0.0.preview1 → 3.0.0.preview2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c379da1ca7400f142cf42b8ebb3bd9196b22c86184dad2a8b61c0fac95b5d3f6
-  data.tar.gz: c5570b188a143204d0fff2b5300ef51a6871e564704543dd8412d9c46a8cfcde
+  metadata.gz: 0e6427ee4da1631d65d87c3dbed0f7baa22c0b5fe87567db48dcc7f8634d8dba
+  data.tar.gz: f841605f6d137462bc72a8693c28bd29dbb466b3e17209384d2316f337ab8391
 SHA512:
-  metadata.gz: 9f1fca511ff7d85f498db78f7efa61b2a50ef2048f7e6ac0962119fe22347a1a859296b0379cbfa6b4a3e2addeb72b36f6a9eb8da98c9a7526160cff56ba720b
-  data.tar.gz: e0f005fb46be742ee79a29454b063db9194879fbf81f4aa35834bea4b62970f4c730c37c8f15febab55eae6a1068903365704fa86963f8ede6035104803b79d4
+  metadata.gz: 1dce795a98d0049b5453ca396428012366d72b69e8a3eb81f0cd71607d0fce535a118b613bdf27060049c3b5a2e9005f6d31bed634c5a0a0a662a45d018045cb
+  data.tar.gz: 4f3afb3e2acf13cd6549044a01aabda05271b35ad8c704333942dfc97661ec03b8e6109e6cd18854b61ffd30c8ec9ce01c56ee827cfb0bb012d79552c4691f79

data/NEWS.ja.md

@@ -1,3 +1,56 @@
+# Version 3.0.0 preview 2
+
+## 新機能
+* CSS 組版向けに EPUB ファイルを単一 HTML ファイルに変換する `review-epub2html` コマンドを追加しました ([#1098])
+
+## 非互換の変更
+* PDFMaker: `texcommand`、`dvicommmand`、`makeindex_command` に空白文字入りのパスを指定できるようにしました。これに伴い、これらのパラメータはコマンドオプションを取ることはできなくなりました。コマンドオプションは本来の `texoptions`、`dvioptions`、`makeindex_options` のパラメータに指定してください ([#1091])
+* PDFMaker: book.re というファイルで生じるビルドの失敗を修正しました。これまではベースファイルとして `book.tex` という名前のファイルを内部で作成していましたが、`__REVIEW_BOOK__.tex` という名前に変更しました ([#1081])
+* PDFMaker: jsbook ベーススタイルにおいて、geometry を読み込まないようにしました ([#912])
+* PDFMaker: jsbook ベーススタイルにおいて、ページ番号を見開きの左右に振るようにしました ([#1032])
+* `@<chapref>`、`@<hd>`、`@<column>` 命令の展開文字列をビルダ間で統一するとともに、`locale.yml` ファイルで変更できるようにしました。`@<chapref>` はデフォルトでは `第1章「FOO」` のようになります（`chapter_quote`、`chapter_quote_without_number` で変更可）。`chapter_quote` メッセージは2つの `%s` を取るようになりました。`@<hd>` は `「2.1 BAR」` のようになります（`hd_quote`、`hd_quote_without_number` で変更可）。`@<column>` は `コラム「BAZ」` のようになります（`column` で変更可） ([#886])
+
+## バグ修正
+* EPUBMaker: OPF ファイルの modified の時刻の表記を正しい UTC 値にしました ([#1094])
+* `contentdir` パラメータでサブフォルダを使用しているときに、参考文献ファイルがそのフォルダから読まれない問題を修正しました ([#1103])
+* PDFMaker: 索引辞書の読み込みなど、パラメータで指定したファイルのパスが解決されない問題を修正しました ([#1086])
+* preview 1 でのフェンス記法内のエスケープの不具合を修正しました ([#1083])
+* サンプル CSS 内の不要なタブ文字を除去しました ([#1084])
+
+## 機能強化
+* PDFMaker: tableとfigureでのフロート設定をマクロ `\floatplacement` で定義できるようにしました ([#1095])
+* EPUBMaker: エラーと警告の出力に logger 機能を利用するようにしました ([#1077])
+* PDFMaker: `dvicommand` パラメータが null の場合は、dvipdfmx などの変換コマンドを呼び出さないようにしました ([#1065])
+
+## ドキュメント
+* サンプルドキュメントを samples フォルダに移動しました ([#1073])
+* `config.yml.sample` に索引関連のフックおよびパラメータのコメントを追加しました ([#1097])
+* quickstart.md のタイプミスを修正しました ([#1079])
+
+## コントリビューターのみなさん
+* [@aiya000](https://github.com/aiya000)
+* [@sho-h](https://github.com/sho-h)
+* [@kateinoigakukun](https://github.com/kateinoigakukun)
+
+[#886]: https://github.com/kmuto/review/issues/886
+[#912]: https://github.com/kmuto/review/issues/912
+[#1032]: https://github.com/kmuto/review/issues/1032
+[#1065]: https://github.com/kmuto/review/pull/1065
+[#1073]: https://github.com/kmuto/review/issues/1073
+[#1077]: https://github.com/kmuto/review/pull/1077
+[#1079]: https://github.com/kmuto/review/pull/1079
+[#1080]: https://github.com/kmuto/review/issues/1080
+[#1081]: https://github.com/kmuto/review/pull/1081
+[#1083]: https://github.com/kmuto/review/issues/1083
+[#1084]: https://github.com/kmuto/review/pull/1084
+[#1086]: https://github.com/kmuto/review/issues/1086
+[#1091]: https://github.com/kmuto/review/pull/1091
+[#1094]: https://github.com/kmuto/review/pull/1094
+[#1095]: https://github.com/kmuto/review/pull/1095
+[#1097]: https://github.com/kmuto/review/pull/1097
+[#1098]: https://github.com/kmuto/review/pull/1098
+[#1103]: https://github.com/kmuto/review/pull/1103
+
 # Version 3.0.0 preview 1
 
 ## 新機能
@@ -79,6 +132,7 @@
 [#1006]: https://github.com/kmuto/review/issues/1006
 [#1007]: https://github.com/kmuto/review/issues/1007
 [#1008]: https://github.com/kmuto/review/pull/1008
+[#1010]: https://github.com/kmuto/review/pull/1010
 [#1016]: https://github.com/kmuto/review/issues/1016
 [#1022]: https://github.com/kmuto/review/issues/1022
 [#1027]: https://github.com/kmuto/review/issues/1027
@@ -302,6 +356,7 @@
 [#785]: https://github.com/kmuto/review/issues/785
 [#787]: https://github.com/kmuto/review/issues/787
 [#788]: https://github.com/kmuto/review/issues/788
+[#794]: https://github.com/kmuto/review/issues/794
 [#795]: https://github.com/kmuto/review/issues/795
 
 
@@ -535,7 +590,7 @@
     * locale.yaml -> locale.yml
     * PageMetric.a5 -> PageMetric::A5
     * locale.yaml や layout.erb を使っているとエラーになります
-    * `prt` は `発行所` ではなく `印刷所` になります. `発行所` は `pbl` です.([#562, #593])
+    * `prt` は `発行所` ではなく `印刷所` になります. `発行所` は `pbl` です.([#562], [#593])
 * `appendix_format` を廃止しました ([#609])
 * inaobuilder を廃止しました (アップストリームで修正Markdownを使用することになったため) ([#573])
 * 古い epubmaker を削除しました
@@ -678,12 +733,17 @@
 * latexbuilderで`//list`がhighlitingなしのときにキャプションが表示されなくなっていたのを修正しました ([#465])
 * markdownbuilderでdefinition listを使うとエラーになるのを修正しました ([#473])
 
+[#465]: https://github.com/kmuto/review/issues/465
+[#473]: https://github.com/kmuto/review/issues/473
+
 # Version 1.7.1の主な変更点
 
 ## バグ修正
 * latexbuilderで`//listnum`のキャプションが2重に出力されるバグを修正しました ([#465])
 * review-initで生成される雛形を元にEPUB3のファイルを作成するとepubcheck 4.0.1でエラーになるバグを修正しました ([#456])
 
+[#456]: https://github.com/kmuto/review/issues/473
+
 # Version 1.7.0の主な変更点
 
 ## 全般

data/NEWS.md

@@ -1,3 +1,56 @@
+# Version 3.0.0 preview 2
+
+## New Features
+* add `review-epub2html` to produce single HTML file from EPUB file for CSS typesetting ([#1098])
+
+## Breaking Changes
+* PDFMaker: allow a path with space character on `texcommand`, `dvicommmand`, and `makeindex_command`. Due to this change, these parameters no longer take command options. use `texoptions`, `dvioptions`, and `makeindex_options` to specify  options ([#1091])
+* PDFMaker: the file used internally has been changed from `book.tex` to `__REVIEW_BOOK__.tex` ([#1081])
+* PDFMaker: dropped geometry.sty from jsbook style ([#912])
+* PDFMaker: use twocolumn option for jsbook style ([#1032])
+* unified strings expanded by `@<chapref>`, `@<hd>`, and `@<column>` op between builders. you can customize it with `locale.yml`. `@<chapref>` will be expanded like `Chapter 1 "FOO"` (locale msgid: `chapter_quote` and `chapter_quote_without_number`). `chapter_quote` now takes two `%s`. `@<hd>` will be expanded like `"2.1 BAR"` (locale msgid: `hd_quote` and `hd_quote_without_number`). `@<column>` will be extended like `Column BAZ` (locale msgid: `column`) ([#886])
+
+## Bug Fixes
+* EPUBMaker: `modified` value of OPF file is now correct UTC time ([#1094])
+* fix an issue where bibliography file in `contentdir` could not be read ([#1103])
+* PDFMaker: fix an issue where the file specified by the parameter could not be found ([#1086])
+* fix a bug in the fence escaping that occurred in preview1 ([#1083])
+* remove unwanted tab character from sample CSS ([#1084])
+
+## Enhancements
+* PDFMaker: use `\floatplacement` to configure float settings of table and figure ([#1095])
+* EPUBMaker: use logger function to export error/warning ([#1077])
+* PDFMaker: do not use dvipdfmx when `dvicommand` parameter is null ([#1065])
+
+## Docs
+* Move sample documents to /samples folder ([#1073])
+* Add descriptions abount hooks and parameters of indexing into `config.yml.sample` ([#1097])
+* Fix typo in quickstart.md ([#1079])
+
+## Contributors
+* [@aiya000](https://github.com/aiya000)
+* [@sho-h](https://github.com/sho-h)
+* [@kateinoigakukun](https://github.com/kateinoigakukun)
+
+[#886]: https://github.com/kmuto/review/issues/886
+[#912]: https://github.com/kmuto/review/issues/912
+[#1032]: https://github.com/kmuto/review/issues/1032
+[#1065]: https://github.com/kmuto/review/pull/1065
+[#1073]: https://github.com/kmuto/review/issues/1073
+[#1077]: https://github.com/kmuto/review/pull/1077
+[#1079]: https://github.com/kmuto/review/pull/1079
+[#1081]: https://github.com/kmuto/review/pull/1081
+[#1080]: https://github.com/kmuto/review/issues/1080
+[#1083]: https://github.com/kmuto/review/issues/1083
+[#1084]: https://github.com/kmuto/review/pull/1084
+[#1086]: https://github.com/kmuto/review/issues/1086
+[#1091]: https://github.com/kmuto/review/pull/1091
+[#1094]: https://github.com/kmuto/review/pull/1094
+[#1095]: https://github.com/kmuto/review/pull/1095
+[#1097]: https://github.com/kmuto/review/pull/1097
+[#1098]: https://github.com/kmuto/review/pull/1098
+[#1103]: https://github.com/kmuto/review/pull/1103
+
 # Version 3.0.0 preview 1
 
 ## New Features
@@ -78,6 +131,7 @@
 [#1006]: https://github.com/kmuto/review/issues/1006
 [#1007]: https://github.com/kmuto/review/issues/1007
 [#1008]: https://github.com/kmuto/review/pull/1008
+[#1010]: https://github.com/kmuto/review/pull/1010
 [#1016]: https://github.com/kmuto/review/issues/1016
 [#1022]: https://github.com/kmuto/review/issues/1022
 [#1027]: https://github.com/kmuto/review/issues/1027
@@ -87,6 +141,7 @@
 [#1045]: https://github.com/kmuto/review/issues/1045
 [#1046]: https://github.com/kmuto/review/issues/1046
 [#1059]: https://github.com/kmuto/review/issues/1059
+[#1060]: https://github.com/kmuto/review/issues/1060
 [#1063]: https://github.com/kmuto/review/issues/1063
 
 # Version 2.5.0
@@ -307,6 +362,7 @@
 [#785]: https://github.com/kmuto/review/issues/785
 [#787]: https://github.com/kmuto/review/issues/787
 [#788]: https://github.com/kmuto/review/issues/788
+[#794]: https://github.com/kmuto/review/issues/794
 [#795]: https://github.com/kmuto/review/issues/795
 
 
@@ -541,7 +597,7 @@
     * locale.yaml -> locale.yml
     * PageMetric.a5 -> PageMetric::A5
     * raise error when using locale.yaml and layout.erb
-    * `prt` is printer(`印刷所`), not publisher(`発行所`).  `発行所` is `pbl`.  ([#562, #593])
+    * `prt` is printer(`印刷所`), not publisher(`発行所`).  `発行所` is `pbl`.  ([#562], [#593])
 * Obsolete `appendix_format` ([#609])
 * Remove obsolete inaobuilder. (upstream changed their mind to use modified Markdown) ([#573])
 * Remove obsolete legacy epubmaker
@@ -684,11 +740,15 @@
 * Fix latexbuilder to show caption in `//list` without highliting ([#465])
 * Fix markdownbuilder to use definition list ([#473])
 
+[#465]: https://github.com/kmuto/review/issues/465
+[#473]: https://github.com/kmuto/review/issues/473
+
 # Version 1.7.1
 
 ## Bug Fix
 * Fix latexbuilder to display caption twice in `//listnum` ([#465])
 * Fix review-init to generate non-valid EPUB3 file with epubcheck 4.0.1 ([#456])
+[#456]: https://github.com/kmuto/review/issues/473
 
 # Version 1.7.0
 

data/bin/review-epub2html

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+#
+# Copyright (c) 2018 Kenshi Muto
+#
+# 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/epub2html'
+
+if File.basename($PROGRAM_NAME) == File.basename(__FILE__)
+  ReVIEW::Epub2Html.execute(*ARGV)
+end

data/doc/config.yml.sample

@@ -311,11 +311,19 @@ pdfmaker:
   # 渡される引数1=作業用展開ディレクトリ、引数2=呼び出しを実行したディレクトリ
   # hook_beforetexcompile: null
   #
-  # TeXコンパイル後に実行するプログラム。索引作業をして再度コンパイルしたいときなどに使用する。
+  # 索引処理前に実行するプログラム。idxファイルを加工したいときなどに使用する。
+  # 渡される引数1=作業用展開ディレクトリ、引数2=呼び出しを実行したディレクトリ
+  # hook_beforemakeindex: null
+  #
+  # 索引処理後に実行するプログラム。indファイルを加工したいときなどに使用する。
+  # 渡される引数1=作業用展開ディレクトリ、引数2=呼び出しを実行したディレクトリ
+  # hook_aftermakeindex: null
+  #
+  # ひととおりのコンパイル後に実行するプログラム。目次を加工して再度コンパイルしたいときなどに使用する。
   # 渡される引数1=作業用展開ディレクトリ、引数2=呼び出しを実行したディレクトリ
   # hook_aftertexcompile: null
   #
-  # PDF(book.pdf)作成後に実行するプログラム。PDFに加工を施したいときに使用する。
+  # PDF(__REVIEW_BOOK__.pdf)作成後に実行するプログラム。PDFに加工を施したいときに使用する。
   # 渡される引数1=作業用展開ディレクトリ、引数2=呼び出しを実行したディレクトリ
   # hook_afterdvipdf: null
   #
@@ -327,7 +335,20 @@ pdfmaker:
   # Illustrator CC以降のIllustratorファイルに対してはmediaboxを指定する必要がある
   # bbox: mediabox
   #
+  # 索引を作成するか。trueにすると索引作成が有効になる
+  # makeindex: null
+  # 索引作成コマンド
+  # makeindex_command: mendex
+  # 索引作成コマンドのオプション
+  # makeindex_options: "-f -r -I utf8"
+  # 索引作成コマンドのスタイルファイル
+  # makeindex_sty: null
+  # 索引作成コマンドの辞書ファイル
+  # makeindex_dic: null
+  # MeCabによる索引読み探索を使うか
+  # makeindex_mecab: true
+  # MeCabの読みの取得オプション
+  # makeindex_mecab_opts: "-Oyomi"
   # 奥付を作成するか。trueを指定するとデフォルトの奥付、ファイル名を指定するとそれがcolophon.htmlとしてコピーされる
   colophon: true
   # pdfmaker:階層を使うものはここまで
-

data/doc/quickstart.md

@@ -17,7 +17,7 @@ Re:VIEW is a software in Ruby and worked in Linux/Unix, Mac OS X, and Windows. Y
 
 Note that Re:VIEW format is plain texts with simple markups in UTF-8, so you can write it on any editors and OSes.
 
-### using RubyGmes
+### using RubyGems
 
 Re:VIEW is released as RubyGems.
 

data/lib/epubmaker/producer.rb

@@ -45,6 +45,10 @@ module EPUBMaker
       merge_config(@config.deep_merge(loader.load_file(file)))
     end
 
+    def warn(msg)
+      @logger.warn(msg)
+    end
+
     # Construct producer object.
     # +config+ takes initial parameter hash. This parameters can be overriden by EPUBMaker#load or EPUBMaker#merge_config.
     # +version+ takes EPUB version (default is 2).
@@ -54,6 +58,7 @@ module EPUBMaker
       @epub = nil
       @config['epubversion'] = version unless version.nil?
       @res = ReVIEW::I18n
+      @logger = ReVIEW.logger
 
       merge_config(config) if config
     end
@@ -231,7 +236,7 @@ module EPUBMaker
       defaults = ReVIEW::Configure.new.merge(
         'language' => 'ja',
         'date' => Time.now.strftime('%Y-%m-%d'),
-        'modified' => Time.now.strftime('%Y-%02m-%02dT%02H:%02M:%02SZ'),
+        'modified' => Time.now.utc.strftime('%Y-%02m-%02dT%02H:%02M:%02SZ'),
         'isbn' => nil,
         'toclevel' => 2,
         'stylesheet' => [],

data/lib/review/book/base.rb

@@ -249,11 +249,11 @@ module ReVIEW
       end
 
       def read_bib
-        File.read(File.join(@basedir, bib_file))
+        File.read(File.join(contentdir, bib_file))
       end
 
       def bib_exist?
-        File.exist?(File.join(@basedir, bib_file))
+        File.exist?(File.join(contentdir, bib_file))
       end
 
       def prefaces

data/lib/review/book/index.rb

@@ -108,7 +108,11 @@ module ReVIEW
       end
 
       def display_string(id)
-        "#{number(id)}#{I18n.t('chapter_quote', title(id))}"
+        if number(id)
+          I18n.t('chapter_quote', [number(id), title(id)])
+        else
+          I18n.t('chapter_quote_without_number', title(id))
+        end
       end
     end
 

data/lib/review/book/volume.rb

@@ -15,7 +15,7 @@ module ReVIEW
           next if /\A\#@/ =~ line
           text = line.gsub(/\s+/, '')
           b += text.bytesize
-          c += text.charsize
+          c += text.size
           l += 1
         end
         new(b, c, l)

data/lib/review/builder.rb

@@ -352,7 +352,7 @@ module ReVIEW
     end
 
     def inline_column_chap(chapter, id)
-      chapter.column(id).caption
+      I18n.t('column', chapter.column(id).caption)
     end
 
     def inline_pageref(id)

data/lib/review/compiler.rb

@@ -536,11 +536,19 @@ module ReVIEW
     def replace_fence(str)
       str.gsub(/@<(\w+)>([$|])(.+?)(\2)/) do
         op = $1
-        arg = $3.gsub('@', "\x01").gsub('\\}') { '\\\\}' }.gsub('}') { '\}' }.sub(/(?:\\)+$/) { |m| '\\\\' * m.size }
-        "@<#{op}>{#{arg}}"
+        arg = $3
+        if arg =~ /[\x01\x02\x03\x04]/
+          error "invalid character in '#{str}'"
+        end
+        replaced = arg.gsub('@', "\x01").gsub('\\', "\x02").gsub('{', "\x03").gsub('}', "\x04")
+        "@<#{op}>{#{replaced}}"
       end
     end
 
+    def revert_replace_fence(str)
+      str.gsub("\x01", '@').gsub("\x02", '\\').gsub("\x03", '{').gsub("\x04", '}')
+    end
+
     def text(str)
       return '' if str.empty?
       words = replace_fence(str).split(/(@<\w+>\{(?:[^\}\\]|\\.)*?\})/, -1)
@@ -549,12 +557,12 @@ module ReVIEW
           error "`@<xxx>' seen but is not valid inline op: #{w}"
         end
       end
-      result = @strategy.nofunc_text(words.shift)
+      result = @strategy.nofunc_text(revert_replace_fence(words.shift))
       until words.empty?
-        result << compile_inline(words.shift.gsub(/\\\}/, '}').gsub(/\\\\/, '\\'))
-        result << @strategy.nofunc_text(words.shift)
+        result << compile_inline(revert_replace_fence(words.shift.gsub(/\\\}/, '}').gsub(/\\\\/, '\\')))
+        result << @strategy.nofunc_text(revert_replace_fence(words.shift))
       end
-      result.gsub("\x01", '@')
+      result
     rescue => err
       error err.message
     end

data/lib/review/configure.rb

@@ -77,7 +77,7 @@ module ReVIEW
         'footnotetext' => nil,
         'texcommand' => 'uplatex',
         'texoptions' => '-interaction=nonstopmode -file-line-error',
-        'texdocumentclass' => ['jsbook', 'uplatex,oneside'],
+        'texdocumentclass' => ['jsbook', 'uplatex,twoside'],
         'dvicommand' => 'dvipdfmx',
         'dvioptions' => '-d 5 -z 9',
         # for PDFMaker

data/lib/review/epub2html.rb

@@ -0,0 +1,133 @@
+#
+# Copyright (c) 2018 Kenshi Muto
+#
+# 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 'zip'
+require 'rexml/document'
+require 'cgi'
+
+module ReVIEW
+  class Epub2Html
+    def self.execute(*args)
+      new.execute(*args)
+    end
+
+    def execute(*args)
+      if args[0].nil? || !File.exist?(args[0])
+        STDERR.puts <<EOT
+Usage: #{File.basename($PROGRAM_NAME)} EPUBfile [file_for_head_and_foot] > HTMLfile
+       file_for_head_and_foot: HTML file to extract header and footer area.
+                               This file must be contained in the EPUB.
+                               If omitted, the first found file is used.
+EOT
+        exit 1
+      end
+
+      parse_epub(args[0])
+      puts join_html(args[1])
+    end
+
+    def initialize
+      @opfxml = nil
+      @htmls = {}
+      @head = nil
+      @tail = nil
+    end
+
+    def parse_epub(epubname)
+      Zip::File.open(epubname) do |zio|
+        zio.each do |entry|
+          if entry.name =~ /.+\.opf\Z/
+            opf = entry.get_input_stream.read
+            @opfxml = REXML::Document.new(opf)
+          elsif entry.name =~ /.+\.x?html\Z/
+            @htmls[entry.name.sub('OEBPS/', '')] = entry.get_input_stream.read.force_encoding('utf-8')
+          end
+        end
+      end
+      nil
+    end
+
+    def take_headtail(html)
+      @head = html.sub(/(<body.*?>).*/m, '\1')
+      @tail = html.sub(%r{.*(</body>)}m, '\1')
+    end
+
+    def sanitize(s)
+      s = s.sub(/\.x?html\Z/, '').
+          sub(%r{\A\./}, '')
+      's_' + CGI.escape(s).
+             gsub(/[.,+%]/, '_')
+    end
+
+    def modify_html(fname, html)
+      doc = REXML::Document.new(html)
+      doc.context[:attribute_quote] = :quote
+
+      ids = {}
+
+      doc.each_element('//*[@id]') do |e|
+        sid = "#{sanitize(fname)}_#{sanitize(e.attributes['id'])}"
+        while ids[sid]
+          sid += 'E'
+        end
+        ids[sid] = true
+        e.attributes['id'] = sid
+      end
+
+      doc.each_element('//a[@href]') do |e|
+        href = e.attributes['href']
+        if href.start_with?('http:', 'https:', 'ftp:', 'ftps:', 'mailto:')
+          next
+        end
+
+        file, anc = href.split('#', 2)
+        if anc
+          if file.empty?
+            anc = "#{sanitize(fname)}_#{sanitize(anc)}"
+          else
+            anc = "#{sanitize(file)}_#{sanitize(anc)}"
+          end
+        else
+          anc = sanitize(file)
+        end
+
+        e.attributes['href'] = "##{anc}"
+      end
+
+      doc.to_s.
+        sub(/.*(<body.*?>)/m, %Q(<section id="#{sanitize(fname)}">)).
+        sub(%r{(</body>).*}m, '</section>')
+    end
+
+    def join_html(reffile)
+      body = []
+      make_list.each do |fname|
+        if @head.nil? && (reffile.nil? || reffile == fname)
+          take_headtail(@htmls[fname])
+        end
+
+        body << modify_html(fname, @htmls[fname])
+      end
+      "#{@head}\n#{body.join("\n")}\n#{@tail}"
+    end
+
+    def make_list
+      items = {}
+      @opfxml.each_element("/package/manifest/item[@media-type='application/xhtml+xml']") do |e|
+        items[e.attributes['id']] = e.attributes['href']
+      end
+
+      files = []
+      @opfxml.each_element('/package/spine/itemref') do |e|
+        files.push(items[e.attributes['idref']])
+      end
+
+      files
+    end
+  end
+end