2019_09_Asciidocを使っていてせっかくAsciidoctor-PDF環境を構築したのに出力したPDFの日本語が表示されなくて困っている人へ

# 追記
この[記事](https://qiita.com/mitsu48/items/34875bbc8ba00760fe27#%E3%81%95%E3%81%8D%E3%81%AB%E7%B5%90%E8%AB%96%E3%81%84%E3%81%BE%E3%81%BE%E3%81%A7%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%84%E3%81%9F%E6%96%B9%E5%90%91%E3%81%91)によると以下の手順ではうまくいかなくなったようです。

# はじめに
Asciidocで作成した文章はAsciidoctor-PDFを使うことでPDFとして出力できる。
しかし、インターネット上にあるAsciidoctor-PDFの構築手順および利用手順だと「v1.5.0.beta.1」以降のAsciidoctor-PDFでは「Asciidoctor-PDFで出力したPDFで日本語が表示されない」問題に遭遇しうる罠があるためナレッジとして原因の解説と解決策を紹介する。

筆者は「v1.5.0.beta.3」および「v1.5.0.beta.4」で当該問題に遭遇した。

キーワード：asciidoctor-pdf 日本語 表示されない

## 想定の構築手順
```
gem install asciidoctor
gem install asciidoctor-pdf --pre
gem install asciidoctor-pdf-cjk
```
## 想定の利用手順
```
asciidoctor-pdf -r asciidoctor-pdf-cjk exapmle.adoc
```
※デフォルトスタイルでそのままPDFに出力する想定。

# 原因
結論から書くと、
「デフォルトスタイルのフォントに日本語字体が含まれていないこと」と「デフォルトスタイルのフォントフォールバックについての仕様変更」が原因で「Asciidoctor-PDFで出力したPDFを開くと日本語が表示されない」問題が発生する。

なお、「フォントフォールバック」とはフォントに存在しない字体を他のフォントで補うことである。

Asciidoctor-PDFのGitHub上のドキュメントの[記載](https://github.com/asciidoctor/asciidoctor-pdf/blob/master/docs/theming-guide.adoc#fallback-fonts)によると、

>The default theme does not use a fallback font. However, the built-in default-with-fallback-font theme does. Using the fallback font slows down PDF generation slightly because it has to analyze every single character. It’s use is not recommended for large documents. Instead, it’s best to select primary fonts that have all the characters you need. 

デフォルトではAsciidoctor-PDFによるPDFの出力が遅くなるので「フォントフォールバック」を行わない旨の記載がある。

####「デフォルトスタイルのフォントに日本語字体が含まれていないこと」について
一般的に日本語の字体を含むttfファイル形式のフォントは数MBを超える。
しかし、Asciidoctor-PDFのほとんどの同梱フォントのファイルサイズは非常に軽量 (100KB以内)であり「デフォルトスタイルで指定されている同梱フォント」に限らずほとんどの「同梱フォント」について日本語の字体を含んではいない。

一方でAsciidoctor-PDFのの同梱フォントのうち「[mplus1p-regular-fallback](https://github.com/asciidoctor/asciidoctor-pdf/blob/master/data/fonts/mplus1p-regular-fallback.ttf)」については日本語の字体を含んでいる。

####「デフォルトスタイルのフォントフォールバックについての仕様変更」について
Asciidoctor-PDFの[default-theme.yml](https://github.com/asciidoctor/asciidoctor-pdf/tree/master/data/themes/default-theme.yml)上で前述の日本語の字体を含む「[mplus1p-regular-fallback](https://github.com/asciidoctor/asciidoctor-pdf/blob/master/data/fonts/mplus1p-regular-fallback.ttf)」に「フォントフォールバック」する[設定](https://github.com/asciidoctor/asciidoctor-pdf/blob/v1.5.0.alpha.18/data/themes/default-theme.yml#L18-L21)が残っていた最後のバージョンが2019年4月18日にリポジトリに上がっている「v1.5.0.alpha.18」である。

そしてその次のバージョンであり2019年7月8日にリポジトリ上に上がっている「v1.5.0.beta.1」で[削除](https://github.com/asciidoctor/asciidoctor-pdf/commit/7fd3a6e79fad627c61bdf71c8005c71890948bae)されている。

## 結論
つまり、「v1.5.0.beta.1」以降のバージョンかつデフォルトスタイル時においてPDFの日本語が表示されないのは「デフォルト設定で指定されている同梱フォント」が日本語の字体を含まない上に「日本語の字体を含む同梱フォント」への「フォントフォールバック」も行わない設定になっていることが原因である。

# 解決策について
## 解決策1
2019年7月末のQiita記事「[Asciidoctor-PDFをMacOS Mojaveにセットアップする](https://qiita.com/toshimin/items/cb9b0581f557b132ac50)」の「[asciidoctor-pdf-cjk-kai_gen_gothicを追加でインストール](https://qiita.com/toshimin/items/cb9b0581f557b132ac50#asciidoctor-pdf%E3%82%92%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%99%E3%82%8B)」のワークアラウンドについてWindows7/Windows10かつプロキシ環境で期待動作することを確認している。

プロキシ環境での例を示す。

```
gem install -p http://<ProxyServer>:<Port> asciidoctor-pdf-cjk-kai_gen_gothic
set http_proxy=http://<ProxyServer>:<Port>
set https_proxy=http://<ProxyServer>:<Port>
asciidoctor-pdf-cjk-kai_gen_gothic-install
copy <Ruby環境のパス>/gems/2.6.0/gems/asciidoctor-pdf-cjk-kai_gen_gothic-0.1.1/data/themes/KaiGenGothicJP-theme.yml .
asciidoctor-pdf -r asciidoctor-pdf-cjk-kai_gen_gothic example01.adoc -a pdf-style=KaiGenGothicJP-theme.yml -o output.pdf
```

## 解決策2
default-theme.ymlを直接編集するか、自分でtheme.ymlを用意してそちらで日本語字体を含むフォントを指定すれば良い。

同梱フォントの「[mplus1p-regular-fallback](https://github.com/asciidoctor/asciidoctor-pdf/blob/master/data/fonts/mplus1p-regular-fallback.ttf)」フォントを使っても良いし、好みのフォントを使っても良い。

詳細については「公式の[ドキュメント](https://github.com/asciidoctor/asciidoctor-pdf/blob/master/docs/theming-guide.adoc#custom-fonts)」や「[asciidoctor-pdfでかっこいいPDFを作る(1)](https://qiita.com/kuboaki/items/67774c5ebd41467b83e2#%E5%88%A5%E3%81%AE%E6%97%A5%E6%9C%AC%E8%AA%9E%E3%83%95%E3%82%A9%E3%83%B3%E3%83%88%E3%82%92%E5%85%A5%E6%89%8B%E3%81%99%E3%82%8B)」や「[Asciidoctor PDFの日本語フォントを変更する](https://backport.net/blog/2018/03/03/asciidoctor_pdf_font_ja/)」を参照のこと。