aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/Documentation/conf.py
diff options
context:
space:
mode:
authorMauro Carvalho Chehab <mchehab+samsung@kernel.org>2019-07-14 07:16:18 -0300
committerMauro Carvalho Chehab <mchehab+samsung@kernel.org>2019-07-17 06:57:51 -0300
commite0de2b59e243c88296fc983e32dd6484365e87a7 (patch)
tree44d820b26de6326c6861ccbb7b8e898eb83ea6b1 /Documentation/conf.py
parentdocs: conf.py: add CJK package needed by translations (diff)
downloadwireguard-linux-e0de2b59e243c88296fc983e32dd6484365e87a7.tar.xz
wireguard-linux-e0de2b59e243c88296fc983e32dd6484365e87a7.zip
docs: conf.py: only use CJK if the font is available
If we try to build a book with asian characters with XeLaTeX and the font is not available, it will produce an error. So, instead, add a logic at conf.py to detect if the proper font is installed. This will avoid an error while building the document, although the result may not be readable. Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Diffstat (limited to 'Documentation/conf.py')
-rw-r--r--Documentation/conf.py13
1 files changed, 11 insertions, 2 deletions
diff --git a/Documentation/conf.py b/Documentation/conf.py
index fa0a42b47e62..a8fe845832bc 100644
--- a/Documentation/conf.py
+++ b/Documentation/conf.py
@@ -16,6 +16,8 @@ import sys
import os
import sphinx
+from subprocess import check_output
+
# Get Sphinx version
major, minor, patch = sphinx.version_info[:3]
@@ -276,13 +278,20 @@ latex_elements = {
\\setsansfont{DejaVu Sans}
\\setromanfont{DejaVu Serif}
\\setmonofont{DejaVu Sans Mono}
+ '''
+}
+# At least one book (translations) may have Asian characters
+# with are only displayed if xeCJK is used
+
+cjk_cmd = check_output(['fc-list', '--format="%{family[0]}\n"']).decode('utf-8', 'ignore')
+if cjk_cmd.find("Noto Sans CJK SC") >= 0:
+ print ("enabling CJK for LaTeX builder")
+ latex_elements['preamble'] += '''
% This is needed for translations
\\usepackage{xeCJK}
\\setCJKmainfont{Noto Sans CJK SC}
-
'''
-}
# Fix reference escape troubles with Sphinx 1.4.x
if major == 1 and minor > 3: