これは何？

Asciidoctor で日本語横書きの資料を作った時の話。

選定

テキストファイルをソースコードとして、PDFをビルドしたいと思った。
多少PNGなんかの図があったりもするが、ほとんどテキスト。
わりと表がたくさんある。表内の表とか、セルの結合とかたくさんある。
ビルドしたPDFはそのまま印刷屋さんに持ち込んで、紙になる。

Re:VIEW を使うか AsciiDoc を使うか迷った。
Re:VIEW の方が全体的には使いやすそうだし、紙にするという文脈にマッチする気がして良かったんだけど、複雑な表を入れるという機能が無いようなので、仕方なく AsciiDoc にした。

処理系には ruby が好きなので Asciidoctor を選んだ。

困ること

しかし、問題点がいくつかあった。

日本語の禁則処理

日本語の禁則処理がちゃんとできない。
asciidoctor-pdf-linewrap-ja を入れると非常によくなるが、残る問題もいくつかあった。

例えば、幅の狭いセルの中に英字日本語混じりの文を書くと行頭に不要な空白が入ってしまう場合がある。
それと、そういう文書を作りたいわけではないので困らないんだけど、image 指令のように見えるがそうではないものを作ると、そこでは禁則処理が無効になるという問題もあった。

非日本語の禁則

例えば空白を挟まずに (foo)(bar) のような文字列で、「(foo」+改行+「)(bar)」となったり「(foo)(」+改行+「bar)」となってしまう場合があった。

「(foo)」+改行+「(bar)」となってほしい。

その他

AsciiDoc の文法の範囲内ではできないレイアウトをしたいことがあったりもした。

それと。PDF のしおりを自動生成してくれるのは大変ありがたいと思うんだけど、しおりの先頭が表紙なのはちょっとやだなと思った。

施策

仕方ないので、 asciidoctor-nabetani という gem を作った。

作戦

禁則処理は、asciidoctor 側でゼロ幅空白を入れるのではなく、 prawn 側のレイアウトロジックに手を入れるという作戦にした。
ついては、 Prawn::Text::Formatted::LineWrap 辺りを書き換えた。

気づいたこと

禁則処理難しい。

「しかし……」の、「しかし」と「……」の間に改行していいかどうか。「…」と「…」の間はどうか。
「三ヶ月」の、「三」と「ヶ月」の間はどうか。
元私立恵比寿中学の「ぁぃぁぃ」さんの名前の途中で改行していいかどうか。
「メメクラゲ」の「メ」と「メクラゲ」の間は改行していいけど「××クラゲ」の「×」と「×クラゲ」の間はどうだろう。

しかし日本語はマシだと思う。
英語等の改行処理を真剣にやるのはとてもつらそうだ。少なくとも辞書をもつ必要があり。しかも単語によってはその単語の品詞を特定しないと改行位置がわからないらしい。さらに、改行で区切ると綴が変わることもあるらしい。
詳しくは Wikipedia - ハイフネーションアルゴリズムと Wikipedia - ソフトハイフンを参照のこと。

ハングル、タイ文字等の禁則処理はどうなってるんだろうと思ったりもしたけど、使う予定がないので対応は全くしていない。

効果

こんなふうに改善する。

下表の cjk は asciidoctor-pdf -r asciidoctor-pdf-cjk -r asciidoctor-pdf-cjk-kai_gen_gothic
linewrap-ja は asciidoctor-pdf -r asciidoctor-pdf-linewrap-ja -r asciidoctor/pdf/cjk/kai_gen_gothic/theme_loader
nabetani は asciidoctor-pdf -r asciidoctor/nabetani
として作ったもの。