]> git.baikalelectronics.ru Git - kernel.git/commit
docs: pdfdocs: Add conf.py local to translations for ascii-art alignment
authorAkira Yokosawa <akiyks@gmail.com>
Mon, 9 Aug 2021 01:21:29 +0000 (10:21 +0900)
committerJonathan Corbet <corbet@lwn.net>
Thu, 12 Aug 2021 15:13:32 +0000 (09:13 -0600)
commit578f3c7c7365d9d3c3400da77edfbffe81187b8f
tree47f4418b83510fb6e6fa12befd47acfe1f933400
parentb94fcd8c79be040f46080eb30b8487cbc4d4353f
docs: pdfdocs: Add conf.py local to translations for ascii-art alignment

Globally choosing "Noto Sans Mono CJK SC" would result in sub-optimal look
of literal blocks in Latin documents.
Therefore, localize the font choice to translations by adding conf.py under
Documentation/translations/.

The local conf.py is enabled when the command:

    make SPHINXDIRS=translations pdfdocs

is used to build the PDF.
Resulting translations.pdf (under Documentation/output/translations/pdf)
will have properly aligned ascii-art figures.

NOTE: There remain mis-aligned ascii-art figures in Korean translations.
This is due to the font designer's decision to assign slightly narrower
widths (920) to Hangul characters in "Noto Sans Mono CJK KR" than those
of Hanja (Hanzi/Kanji) characters (1000) [1].

[1]: https://github.com/googlefonts/noto-cjk/issues/17

Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
Link: https://lore.kernel.org/r/79a876fc-a552-f972-4a1b-c6df4cbb36dd@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/translations/conf.py [new file with mode: 0644]