IDGXML: allow caption-omitted //source. Closes: #1447

doc/format.ja.md

@@ -264,11 +264,23 @@ puts "hello world!"
 
 ```review
 //source[/hello/world.rb]{
-puts "hello world!"
+puts "hello world!" # キャプションあり
+//}
+
+//source{
+puts "hello world!" # キャプションなし
+//}
+
+//source[/hello/world.rb][ruby]{
+puts "hello world!" # キャプションあり、ハイライトあり
+//}
+
+//source[][ruby]{
+puts "hello world!" # キャプションなし、ハイライトあり
 //}
 ```
 
-ソースコードの引用は、キャプションを付けた `//emlist` とほぼ同じです。HTML の CSS などでは区別した表現ができます。
+ソースコードの引用は、`//emlist` とほぼ同じです。HTML の CSS などでは区別した表現ができます。
 
 ## 本文中でのソースコード引用
 

lib/review/builder.rb

@@ -151,7 +151,7 @@ def listnum(lines, id, caption, lang = nil)
       listnum_body(lines, lang)
     end
 
-    def source(lines, caption, lang = nil)
+    def source(lines, caption = nil, lang = nil)
       source_header(caption)
       source_body(lines, lang)
     end

lib/review/idgxmlbuilder.rb

@@ -1146,7 +1146,7 @@ def inline_title(id)
       error "unknown chapter: #{id}"
     end
 
-    def source(lines, caption, lang = nil)
+    def source(lines, caption = nil, lang = nil)
       puts '<source>'
       source_header(caption)
       source_body(lines, lang)

samples/syntax-book/ch02.re

@@ -49,9 +49,9 @@ print('hello');
 puts 'Hello'
 //}
 
-#@# //source{
-#@# //}
-#@# FIXME:キャプションなしはLaTeXだとエラーになることがわかった。Re:VIEW側修正予定
+//source{
+puts 'Hello'
+//}
 
 実行例を示すとき用にはcmdを用意しています。いずれにせよ、商業書籍レベルでは必要なので用意しているものの、原稿レベルで書き手が使うコードブロックはほどほどの数に留めておいたほうがいいのではないかと思います。TeX版の紙面ではデフォルトは黒アミ。印刷によってはベタ黒塗りはちょっと怖いかもなので、あまり長々したものには使わないほうがいいですね。
 

test/test_idgxmlbuilder.rb

@@ -460,6 +460,18 @@ def test_source_empty_caption
 <source><pre>foo
 bar
 
+buz
+</pre></source>
+EOS
+    assert_equal expected, actual
+  end
+
+  def test_source_nil_caption
+    actual = compile_block("//source{\nfoo\nbar\n\nbuz\n//}\n")
+    expected = <<-EOS.chomp
+<source><pre>foo
+bar
+
 buz
 </pre></source>
 EOS