Rewrite guide that explains how to create a CJK theme

asciidoctor / asciidoctor-pdf

:page_with_curl: Asciidoctor PDF: A native PDF converter for AsciiDoc based on Asciidoctor and Prawn, written entirely in Ruby.

https://docs.asciidoctor.org/pdf-converter/latest/

MIT License

1.14k stars 500 forks source link

Rewrite guide that explains how to create a CJK theme #2063

Closed mojavelinux closed 2 years ago

mojavelinux commented 2 years ago

The current guide for creating a CJK theme relies on the now deprecated asciidoctor-pdf-cjk-kai_gen_gothic gem which conflicts with Asciidoctor PDF 2. Since the guide was written, the noto-cjk project started publishing TTF fonts for the CJK languages. Rewrite the guide to explain how to use these fonts to create a custom theme.

mojavelinux commented 2 years ago

Be sure to emphasize that TTF fonts are required. In my tests, CJK fonts that are created as OTF fonts do not work with Asciidoctor PDF. (In fact, OTF support in general is quite unreliable).