summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDan Allen <dan.j.allen@gmail.com>2024-03-25 14:28:49 -0600
committerDan Allen <dan.j.allen@gmail.com>2024-03-25 14:29:13 -0600
commit372d54d2de6f3a6a9f4e6560387d0a91a9090173 (patch)
treef77e0ccc17b34929979ed17bc44625ba59f3f899
parent821afab64d2f4c7ad0fb2ff396e6dfa9ec9573cf (diff)
add hint about setting text-align=left when using a CJK language
-rw-r--r--docs/modules/theme/pages/font-support.adoc5
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/modules/theme/pages/font-support.adoc b/docs/modules/theme/pages/font-support.adoc
index 94eeeec9..39a43fee 100644
--- a/docs/modules/theme/pages/font-support.adoc
+++ b/docs/modules/theme/pages/font-support.adoc
@@ -135,4 +135,9 @@ Notice the `-a scripts=cjk` option.
That's important.
It tells the converter to insert break opportunities between CJK characters so that lines wrap properly when mixing English and a CJK language like Japanese.
+When using a CJK language, you probably don't want text justification either, which is the default behavior.
+You can overridde this setting using the `text-align` document attribute (or a custom theme).
+
+ $ asciidoctor-pdf -a scripts=cjk -a text-align=left --theme default-with-font-fallbacks document.adoc
+
If the built-in theme with the fallback font doesn't go far enough, you'll need to create a xref:cjk.adoc[custom CJK theme].