asciidoctor-pdfを用いてasciidoc形式をPDFで出力することができ,何かと便利なんですが,タイトルページとしてカスタマイズできる要素が著者,バージョン情報,背景やロゴの画像といった具合で思ったよりも少なかった.1

タイトルページだけ背景画像として,別のソフトなどで作成する手もありますが,どうせならasciidoctor-pdfで完結させたい.(タイトルだけ別で作成すると,見た目の統一が何かと面倒)

何か手立てはないかと思い公式のドキュメントを漁っていると方法自体2はあるようで,そもそもasciidoctor-pdfは裏でPrawnというライブラリを用いてPDF出力をしており.このコンバーターを拡張してどこに何を描画するかを利用者自身で決めることができるみたいだった.

そのためにはRubyをゴリゴリに書く必要がありそうなのが(私はRubyの経験が全くないため)難点に感じますが,どうもこれしか方法がなさそうです.

上で書いたとおり,Prawnを用いているので,カスタムコンバーターもPrawnが用いるメソッドをオーバーライドしながら使うみたいです.Prawn自体の使い方は公式マニュアル3があるのでそちらを参照するとします.

そんで適当に作ってみた表紙がコレ カスタムタイトル

公式マニュアルやPrawnについて言及している記事とか読むと,もっと込み入った事が出来そうけど,サンプルのカスタムコンバーターやAsciidoctor-pdfのソースコードを呼んだ感じだと,もっと行儀の良い書き方がありそうな予感.

一旦ここまでにします.


  1. Title Page | Asciidoctor Docs ↩︎

  2. Extend the PDF Converter | Asciidoctor Docs ↩︎

  3. manual.pdf ↩︎