linux/Documentation/translations/conf.py

# -*- coding: utf-8 -*-
# SPDX-License-Identifier: GPL-2.0

# -- Additinal options for LaTeX output ----------------------------------
# font config for ascii-art alignment

latex_elements['preamble']  += '''
    \\IfFontExistsTF{Noto Sans CJK SC}{
	% For CJK ascii-art alignment
	\\setmonofont{Noto Sans Mono CJK SC}[AutoFakeSlant]
    }{}
'''
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> 2021-08-09 01:21:29 +00:00			`# -- coding: utf-8 --`
			`# SPDX-License-Identifier: GPL-2.0`

			`# -- Additinal options for LaTeX output ----------------------------------`
			`# font config for ascii-art alignment`

			`latex_elements['preamble'] += '''`
			`\\IfFontExistsTF{Noto Sans CJK SC}{`
			`% For CJK ascii-art alignment`
docs: pdfdocs: Permit AutoFakeSlant for CJK fonts Noto CJK fonts don't provide italic shapes. The AutoFakeSlant option of fontspec and xeCJK packages can be used as a workaround. Signed-off-by: Akira Yokosawa <akiyks@gmail.com> Link: https://lore.kernel.org/r/502335cc-9a95-3c2a-7744-6cc56ecaf628@gmail.com Signed-off-by: Jonathan Corbet <corbet@lwn.net> 2021-08-09 01:25:25 +00:00			`\\setmonofont{Noto Sans Mono CJK SC}[AutoFakeSlant]`
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> 2021-08-09 01:21:29 +00:00			`}{}`
			`'''`