review 2.0.0 → 2.1.0

data/doc/customize_epub.md

@@ -0,0 +1,47 @@
+# Supporting local rules of EPUB files
+
+EPUB files that generated by Re:VIEW (review-epubmaker) should be valid in eubcheck in IDPF.
+
+But some e-book stores have their own rules, so they reject EPUB files by Re:VIEW.  To pass their rules, you can customize OPF file with config.yml.
+
+## EBPAJ EPUB 3 File Creation Guide
+
+* http://ebpaj.jp/counsel/guide
+
+EBPAJ, the Electronic Book Publishers Association of Japan, releases the guide for publishers to create EPUB files that make nothing of trouble in major EPUB readers.
+
+To pass their guide, you can add some settings into config.yml:
+
+```yaml
+opf_prefix: {ebpaj: "http://www.ebpaj.jp/"}
+opf_meta: {"ebpaj:guide-version": "1.1.3"}
+```
+
+With this settings, Re:VIEW generates OPF files with epbaj attributes:
+
+```xml
+<package ... prefix="ebpaj: http://www.ebpaj.jp/">
+  ...
+    <meta property="ebpaj:guide-version">1.1.3</meta>
+```
+
+But EPUB files that Re:VIEW generates are not the same of name and structure to EBPAJ guide.
+
+
+## iBookStore
+
+Without special setting, iBooks has a margin between right page and left page in double-page spread.
+
+To remove it, you can add some settings in config.yml.
+
+```yaml
+opf_prefix: {ibooks: "http://vocabulary.itunes.apple.com/rdf/ibooks/vocabulary-extensions-1.0/"}
+opf_meta: {"ibooks:binding": "false"}
+```
+
+If you have already some settings, merge them:
+
+```yaml
+opf_prefix: {ebpaj: "http://www.ebpaj.jp/", ibooks: "http://vocabulary.itunes.apple.com/rdf/ibooks/vocabulary-extensions-1.0/"}
+opf_meta: {"ebpaj:guide-version": "1.1.3", "ibooks:binding": "false"}
+```

data/doc/preproc.ja.md

@@ -0,0 +1,153 @@
+# review-preproc ユーザガイド
+
+Re:VIEWではソースコードなどを本文中に埋め込むことができます。
+
+## `#@mapfile`
+
+以下は`scripts/hello.rb`のソースを本文内に埋め込んでいます。
+
+```review
+//list[hello.rb][hello.rb]{
+#@mapfile(scripts/hello.rb)
+#!/usr/bin/env ruby
+
+class Hello
+  def hello(name)
+    print "hello, #{name}!\n"
+  end
+end
+
+if __FILE__ == $0
+  Hello.new.hello("world")
+end
+#@end
+//}
+```
+「`#@mapfile(ファイル名)`」から「`#@end`」は、指定したファイル名のファイル全体を本文中に埋め込むための記法です。埋め込む際には、`review-preproc`コマンドを実行します。
+
+まず、以下のように、引用したい部分に「`#@mapfile()`」と「`#@end`」だけを書きます。ここでは`//list`ブロック内にこの２行だけを記述しています。
+
+```review
+//list[hello.rb.1][hello.re]{
+#@mapfile(scripts/hello.rb)
+#@end
+//}
+```
+このソースに対して、`review-preproc`コマンドを実行します。すると、変換結果の*.reファイルを標準出力に出力します。
+
+```shell-session
+$ review-preproc hello.re
+```
+`--replace`オプションをつければ、ファイルそのものを置き換えるようになります。
+
+```shell-session
+$ review-preproc --replace hello.re
+```
+
+なお、rakeを使ってビルドしている場合、Rakefileに以下のような記述を追加すると、このコマンドを実行するtaskが定義されます。
+
+```rake
+desc 'preproc all'
+task :preproc do
+  Dir.glob("*.re").each do |file|
+    sh "review-preproc --replace #{file}"
+  end
+end
+```
+
+以下のように実行すれば、コマンドが実行されます。
+
+```shell-session
+$ rake preproc
+```
+
+## `#@maprange`
+
+対象ファイルの一部だけ抜粋することもできます。こちらは「`#@maprange`」という記法を使います。
+
+対象ファイルの抜粋したい部分の前後に、「`#@range_begin(ID)`」と「`#@range_end`」という記法を埋め込んでおきます。`#@range_begin`の引数には、その断片を抽出する際に使用するIDを指定します。以下の例では「sample」というIDにしています。
+
+```ruby
+#!/usr/bin/env ruby
+
+class Hello
+#@range_begin(sample)
+  def hello(name)
+    print "hello, #{name}!\n"
+  end
+#@range_end(sample)
+end
+
+if __FILE__ == $0
+  Hello.new.hello("world")
+end
+```
+*.reファイルの方には、「`#@mapfile(ファイル名)`」ではなく「`#@maprange(ファイル名,ID)`」を記述します。
+
+```review
+//list[range.rb][range.rb(抜粋)]{
+#@maprange(scripts/range.rb,sample)
+#@end
+//}
+```
+
+あとは、先ほど同様、`review-preproc`コマンドか`rake preproc`コマンドを実行します。そうすると、`scripts/range.rb`の一部が抽出されて埋め込まれます。
+
+```review
+//list[range.rb][range.rb(抜粋)]{
+#@maprange(scripts/range.rb,sample)
+  def hello(name)
+    print "hello, #{name}!\n"
+  end
+#@end
+//}
+```
+
+## `#@@maprange`
+
+もっとも、Ruby以外では「`#@range_begin`」などがコメントと解釈されないこともあります。そのような場合、その言語のコメントの中に「`#@@range_begin`」と「`#@@range_end`」とを記述します。
+
+Cのソースを例にします。対象となるrange.cは以下です。
+
+```c
+#include <stdio.h>
+
+/* #@@range_begin(sample)  */
+void
+put_hello(char *name)
+{
+  printf("hello, %s!\n", name);
+}
+/* #@@range_end(sample) */
+
+int main()
+{
+  put_hello("world");
+}
+```
+
+put_hello関数の定義の前後で「`#@@range_begin`」と「`#@@range_end`」が使われています。
+
+これに対し、*.reファイルでは`#@maprange(scripts/range.c,sample)`と`#@end`を記述します。
+
+```
+//list[range.c][range.c(抜粋)]{
+#@maprange(scripts/range.c,sample)
+#@end
+//}
+```
+
+変換した結果、以下のようになります。
+
+```
+//list[range.c][range.c(抜粋)]{
+#@maprange(scripts/range.c,sample)
+void
+put_hello(char *name)
+{
+  printf("hello, %s!\n", name);
+}
+#@end
+//}
+```
+このようにすると、Cなどの言語のファイルに対しても、ソースの一部を抽出して埋め込むことができます。

data/doc/preproc.md

@@ -0,0 +1,160 @@
+# `review-preproc` User Guide
+
+Re:VIEW has a preprocessor, `review-preproc`.  It can embed a (part of) file into *.re files.
+
+## `#@mapfile`
+
+The code below is a sample of embedding code from `scripts/hello.rb`.
+
+```review
+//list[hello.rb][hello.rb]{
+#@mapfile(scripts/hello.rb)
+#!/usr/bin/env ruby
+
+class Hello
+  def hello(name)
+    print "hello, #{name}!\n"
+  end
+end
+
+if __FILE__ == $0
+  Hello.new.hello("world")
+end
+#@end
+ //}
+```
+
+`#@mapfile(filename)` and `#@end` are markers for preprocessor.  You can embed and update the content of the file `filename` into Re:VIEW file with `review-preproc` command.
+
+First, add `#@mapfile()` and `#@end` on the document.
+
+```review
+//list[hello.rb.1][hello.re]{
+#@mapfile(scripts/hello.rb)
+#@end
+//}
+```
+
+Then execute `review-preproc` command.  The command display the result on stdout.
+
+```shell-session
+$ review-preproc hello.re
+```
+
+With `--replace` option, `review-preproc` replaces the Re:VIEW file.
+
+```shell-session
+$ review-preproc --replace hello.re
+```
+
+If you use `rake` to build Re:VIEW document, you can add the code to Rakefile to define a task of `review-preproc`.
+
+```rake
+desc 'preproc all'
+task :preproc do
+  Dir.glob("*.re").each do |file|
+    sh "review-preproc --replace #{file}"
+  end
+end
+```
+
+Then, you can execute preprocessor with `rake`.
+
+```shell-session
+$ rake preproc
+```
+
+## `#@maprange`
+
+You also can embed a part of the target file with `#@maprange` marker.
+
+Add `#@range_begin(ID)` and `#@range_end` in the target file you want to embed.
+In `#@range_begin(ID)`, you must add ID as parameger to identify the part.
+
+In the code below, `sample` is the ID of the range to embed.
+
+```ruby
+#!/usr/bin/env ruby
+
+class Hello
+#@range_begin(sample)
+  def hello(name)
+    print "hello, #{name}!\n"
+  end
+#@range_end(sample)
+end
+
+if __FILE__ == $0
+  Hello.new.hello("world")
+end
+```
+
+In *.re file, add `#@maprange(filename,ID)`, instead of `#@mapfile(filename)`, and `#@end`.
+
+```review
+//list[range.rb][range.rb(partial)]{
+#@maprange(scripts/range.rb,sample)
+#@end
+//}
+```
+
+After that, execute `review-preproc` or `rake preproc`, and you get the *.re files embedded the `hello` method in `scripts/range.rb`.
+
+```review
+//list[range.rb][range.rb(partial)]{
+#@maprange(scripts/range.rb,sample)
+  def hello(name)
+    print "hello, #{name}!\n"
+  end
+#@end
+ //}
+```
+
+## `#@@maprange`
+
+But in some language, a line `#@range_begin` is not a comment.  If you want to embed some code of such languages, you can use new markers `#@@range_begin` and `#@@range_end` into a comment in the target document.
+
+Let's explain how to do.  A target file `range.c` is below:
+
+```c
+#include <stdio.h>
+
+/* #@@range_begin(sample)  */
+void
+put_hello(char *name)
+{
+  printf("hello, %s!\n", name);
+}
+/* #@@range_end(sample) */
+
+int main()
+{
+  put_hello("world");
+}
+```
+
+There are markers `#@@range_begin` and `#@@range_end` around `put_hello` method.
+
+In `*.re`, add `#@maprange(scripts/range.c,sample)` and `#@end`.
+
+
+```
+//list[range.c][range.c(抜粋)]{
+#@maprange(scripts/range.c,sample)
+#@end
+//}
+```
+
+With `review-preproc`, we get the result of conversion like below:
+
+```
+//list[range.c][range.c(抜粋)]{
+#@maprange(scripts/range.c,sample)
+void
+put_hello(char *name)
+{
+  printf("hello, %s!\n", name);
+}
+#@end
+//}
+```

data/lib/epubmaker/producer.rb

@@ -11,7 +11,6 @@
 require 'tmpdir'
 require 'fileutils'
 require 'review/yamlloader'
-require 'securerandom'
 require 'epubmaker/content'
 require 'epubmaker/epubv2'
 require 'epubmaker/epubv3'
@@ -215,7 +214,6 @@ module EPUBMaker
         "language" => "ja",
         "date" => Time.now.strftime("%Y-%m-%d"),
         "modified" => Time.now.strftime("%Y-%02m-%02dT%02H:%02M:%02SZ"),
-        "urnid" => "urn:uid:#{SecureRandom.uuid}",
         "isbn" => nil,
         "toclevel" => 2,
         "stylesheet" => [],
@@ -297,7 +295,12 @@ module EPUBMaker
         raise "Key #{k} must have a value. Abort." unless @params[k]
       end
       # array
-      %w[subject aut a-adp a-ann a-arr a-art a-asn a-aqt a-aft a-aui a-ant a-bkp a-clb a-cmm a-dsr a-edt a-ill a-lyr a-mdc a-mus a-nrt a-oth a-pht a-prt a-red a-rev a-spn a-ths a-trc a-trl adp ann arr art asn aut aqt aft aui ant bkp clb cmm dsr edt ill lyr mdc mus nrt oth pht pbl prt red rev spn ths trc trl stylesheet rights].each do |item|
+      %w[subject aut
+         a-adp a-ann a-arr a-art a-asn a-aqt a-aft a-aui a-ant a-bkp a-clb a-cmm a-dsr a-edt
+         a-ill a-lyr a-mdc a-mus a-nrt a-oth a-pht a-prt a-red a-rev a-spn a-ths a-trc a-trl
+         adp ann arr art asn aut aqt aft aui ant bkp clb cmm dsr edt
+         ill lyr mdc mus nrt oth pht pbl prt red rev spn ths trc trl
+         stylesheet rights].each do |item|
         next unless @params[item]
         @params[item] = [@params[item]] if @params[item].kind_of?(String)
       end

data/lib/lineinput.rb

@@ -34,7 +34,7 @@ class LineInput
       @lineno += 1
       return @buf.pop
     end
-    return nil if @eof_p   # to avoid ARGF blocking.
+    return nil if @eof_p # to avoid ARGF blocking.
     line = @input.gets
     @eof_p = true unless line
     @lineno += 1
@@ -113,7 +113,7 @@ class LineInput
     buf
   end
 
-  alias_method :span, :getlines_while   # from Haskell
+  alias_method :span, :getlines_while # from Haskell
 
   def until_match(re)
     while line = gets()
@@ -134,11 +134,11 @@ class LineInput
     buf
   end
 
-  alias_method :break, :getlines_until   # from Haskell
+  alias_method :break, :getlines_until # from Haskell
 
   def until_terminator(re)
     while line = gets()
-      return if re =~ line   # discard terminal line
+      return if re =~ line # discard terminal line
       yield line
     end
     nil

data/lib/review/book/base.rb

@@ -40,6 +40,10 @@ module ReVIEW
         @basedir_seen[dir] = true
       end
 
+      def self.clear_rubyenv
+        @basedir_seen = {}
+      end
+
       def initialize(basedir)
         @basedir = basedir
         @parts = nil

data/lib/review/book/compilable.rb

@@ -109,9 +109,9 @@ module ReVIEW
       end
 
       def image(id)
-        return image_index()[id] if image_index().has_key?(id)
-        return icon_index()[id] if icon_index().has_key?(id)
-        return numberless_image_index()[id] if numberless_image_index().has_key?(id)
+        return image_index()[id] if image_index().key?(id)
+        return icon_index()[id] if icon_index().key?(id)
+        return numberless_image_index()[id] if numberless_image_index().key?(id)
         indepimage_index()[id]
       end