2015-07-01気軽にドキュメントを書くシリーズです。asciidocで書き、asciidoctor-pdfでさくっとPDFにするというソリューションがあるようなので試行錯誤を繰り返した結果、この.adocをこのPDFに変換できるようになりました。使い方ではまった箇所をメモしておきます。インストールgithubのREADMEに書いてある通り、gemでインストールするだけ。asciidoctor-pdfデフォルトのテーマでPDFに変換するasciidoctor-pdfコマンドを利用します。Guideに記載されている通り、自分なりのテーマを作ることができます。テーマを自作するにあたっては、デフォルトテーマの記載内容が参考になります。今回はbasic-theme.ymlを作りました。ファイルはresources/themes配下に配置されています。header-img-10mm.png自作テーマを利用するためには、asciidoctor-pdfコマンドの-aオプションで、pdf-stylesdirとpdf-styleを指定します。README.adocページ番号を振るヘッダーとフッターにページ番号を振ることができます。今回は、.adocに:pagenums:を設定した上で、テーマファイルにページ番号の具体的なスタイルを記載します。はじめに今回はフッターの真ん中にページ番号を表示してみましょう。{page-count}'このようにフッターにページ番号が表示されます。今回はフッターにページ番号を付与しましたが、ヘッダーに付与することも可能です。ヘッダーやフッターに画像を追加するヘッダーやフッターに画像を追加することが可能です。追加したい画像をテーマと同じディレクトリに配置します。header-img-10mm.pngそして、以下の様に設定します。今回はrecto_content_rightに画像を表示します。'{document-title}'ヘッダの右に画像が表示されました。verso_content_rightにはimageを指定していないので、右ページには画像が出ますが、左ページには画像が出ません。フォントを指定するデフォルトでは以下3種類のフォントが利用可能です。これら以外のフォントを利用することも可能です。boldがないので、migmix-1pを利用してみましょう。今回はresources/fonts配下にフォントを配置します。header-img-10mm.pngテーマファイルでmigmixを使うことを宣言します。migmixasciidoctor-pdfコマンドの-aオプションでpdf-fontsdirを指定します。README.adoc所感PDFは綺麗に描画された。描画に至るまでの準備が簡単テーマのスタイルファイルは独自形式なので、CSSでの装飾と比べると自由度は狭い。現在の私の力では、テーブルの横幅を縮めることができない。