mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-24 01:41:39 +00:00
![Akira Yokosawa](/assets/img/avatar_default.png)
On distros whose texlive packaging is fine-grained, texlive-xecjk
can be installed/removed independently of other texlive packages.
Conditionally loading xeCJK depending only on the existence of the
"Noto Sans CJK SC" font might end up in xelatex error of
"xeCJK.sty not found!".
Improve the situation by testing existence of xeCJK.sty before
loading it.
This is useful on RHEL 9 and its clone distros where texlive-xecjk
doesn't work at the moment due to a missing dependency [1].
"make pdfdocs" for non-CJK contents should work after removing
texlive-xecjk.
Link: [1] https://bugzilla.redhat.com/show_bug.cgi?id=2086254
Fixes: 398f7abdcb
("docs: pdfdocs: Pull LaTeX preamble part out of conf.py")
Cc: stable@vger.kernel.org # v5.18+
Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
Acked-by: Mauro Carvalho Chehab <mchehab@kernel.org>
Link: https://lore.kernel.org/r/c24c2a87-70b2-5342-bcc9-de467940466e@gmail.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
236 lines
9.4 KiB
TeX
236 lines
9.4 KiB
TeX
% -*- coding: utf-8 -*-
|
||
% SPDX-License-Identifier: GPL-2.0
|
||
%
|
||
% LaTeX preamble for "make latexdocs" or "make pdfdocs" including:
|
||
% - TOC width settings
|
||
% - Setting of tabulary (\tymin)
|
||
% - Headheight setting for fancyhdr
|
||
% - Fontfamily settings for CJK (Chinese, Japanese, and Korean) translations
|
||
%
|
||
% Note on the suffix of .sty:
|
||
% This is not implemented as a LaTeX style file, but as a file containing
|
||
% plain LaTeX code to be included into preamble.
|
||
% ".sty" is chosen because ".tex" would cause the build scripts to confuse
|
||
% this file with a LaTeX main file.
|
||
%
|
||
% Copyright (C) 2022 Akira Yokosawa
|
||
|
||
% Custom width parameters for TOC
|
||
% - Redefine low-level commands defined in report.cls.
|
||
% - Indent of 2 chars is preserved for ease of comparison.
|
||
% Summary of changes from default params:
|
||
% Width of page number (\@pnumwidth): 1.55em -> 2.7em
|
||
% Width of chapter number: 1.5em -> 2.4em
|
||
% Indent of section number: 1.5em -> 2.4em
|
||
% Width of section number: 2.6em -> 3.2em
|
||
% Indent of subsection number: 4.1em -> 5.6em
|
||
% Width of subsection number: 3.5em -> 4.3em
|
||
%
|
||
% These params can have 4 digit page counts, 3 digit chapter counts,
|
||
% section counts of 4 digits + 1 period (e.g., 18.10), and subsection counts
|
||
% of 5 digits + 2 periods (e.g., 18.7.13).
|
||
\makeatletter
|
||
%% Redefine \@pnumwidth (page number width)
|
||
\renewcommand*\@pnumwidth{2.7em}
|
||
%% Redefine \l@chapter (chapter list entry)
|
||
\renewcommand*\l@chapter[2]{%
|
||
\ifnum \c@tocdepth >\m@ne
|
||
\addpenalty{-\@highpenalty}%
|
||
\vskip 1.0em \@plus\p@
|
||
\setlength\@tempdima{2.4em}%
|
||
\begingroup
|
||
\parindent \z@ \rightskip \@pnumwidth
|
||
\parfillskip -\@pnumwidth
|
||
\leavevmode \bfseries
|
||
\advance\leftskip\@tempdima
|
||
\hskip -\leftskip
|
||
#1\nobreak\hfil
|
||
\nobreak\hb@xt@\@pnumwidth{\hss #2%
|
||
\kern-\p@\kern\p@}\par
|
||
\penalty\@highpenalty
|
||
\endgroup
|
||
\fi}
|
||
%% Redefine \l@section and \l@subsection
|
||
\renewcommand*\l@section{\@dottedtocline{1}{2.4em}{3.2em}}
|
||
\renewcommand*\l@subsection{\@dottedtocline{2}{5.6em}{4.3em}}
|
||
\makeatother
|
||
%% Sphinx < 1.8 doesn't have \sphinxtableofcontentshook
|
||
\providecommand{\sphinxtableofcontentshook}{}
|
||
%% Undefine it for compatibility with Sphinx 1.7.9
|
||
\renewcommand{\sphinxtableofcontentshook}{} % Empty the hook
|
||
|
||
% Prevent column squeezing of tabulary. \tymin is set by Sphinx as:
|
||
% \setlength{\tymin}{3\fontcharwd\font`0 }
|
||
% , which is too short.
|
||
\setlength{\tymin}{20em}
|
||
|
||
% Adjust \headheight for fancyhdr
|
||
\addtolength{\headheight}{1.6pt}
|
||
\addtolength{\topmargin}{-1.6pt}
|
||
|
||
% Translations have Asian (CJK) characters which are only displayed if
|
||
% xeCJK is used
|
||
\usepackage{ifthen}
|
||
\newboolean{enablecjk}
|
||
\setboolean{enablecjk}{false}
|
||
\IfFontExistsTF{Noto Sans CJK SC}{
|
||
\IfFileExists{xeCJK.sty}{
|
||
\setboolean{enablecjk}{true}
|
||
}{}
|
||
}{}
|
||
\ifthenelse{\boolean{enablecjk}}{
|
||
% Load xeCJK when both the Noto Sans CJK font and xeCJK.sty are available.
|
||
\usepackage{xeCJK}
|
||
% Noto CJK fonts don't provide slant shape. [AutoFakeSlant] permits
|
||
% its emulation.
|
||
% Select KR variant at the beginning of each document so that quotation
|
||
% and apostorph symbols of half-width is used in TOC of Latin documents.
|
||
\IfFontExistsTF{Noto Serif CJK KR}{
|
||
\setCJKmainfont{Noto Serif CJK KR}[AutoFakeSlant]
|
||
}{
|
||
\setCJKmainfont{Noto Sans CJK KR}[AutoFakeSlant]
|
||
}
|
||
\setCJKsansfont{Noto Sans CJK KR}[AutoFakeSlant]
|
||
\setCJKmonofont{Noto Sans Mono CJK KR}[AutoFakeSlant]
|
||
% Teach xeCJK of half-width symbols
|
||
\xeCJKDeclareCharClass{HalfLeft}{`“,`‘}
|
||
\xeCJKDeclareCharClass{HalfRight}{`”,`’}
|
||
% CJK Language-specific font choices
|
||
%% for Simplified Chinese
|
||
\IfFontExistsTF{Noto Serif CJK SC}{
|
||
\newCJKfontfamily[SCmain]\scmain{Noto Serif CJK SC}[AutoFakeSlant]
|
||
\newCJKfontfamily[SCserif]\scserif{Noto Serif CJK SC}[AutoFakeSlant]
|
||
}{
|
||
\newCJKfontfamily[SCmain]\scmain{Noto Sans CJK SC}[AutoFakeSlant]
|
||
\newCJKfontfamily[SCserif]\scserif{Noto Sans CJK SC}[AutoFakeSlant]
|
||
}
|
||
\newCJKfontfamily[SCsans]\scsans{Noto Sans CJK SC}[AutoFakeSlant]
|
||
\newCJKfontfamily[SCmono]\scmono{Noto Sans Mono CJK SC}[AutoFakeSlant]
|
||
%% for Traditional Chinese
|
||
\IfFontExistsTF{Noto Serif CJK TC}{
|
||
\newCJKfontfamily[TCmain]\tcmain{Noto Serif CJK TC}[AutoFakeSlant]
|
||
\newCJKfontfamily[TCserif]\tcserif{Noto Serif CJK TC}[AutoFakeSlant]
|
||
}{
|
||
\newCJKfontfamily[TCmain]\tcmain{Noto Sans CJK TC}[AutoFakeSlant]
|
||
\newCJKfontfamily[TCserif]\tcserif{Noto Sans CJK TC}[AutoFakeSlant]
|
||
}
|
||
\newCJKfontfamily[TCsans]\tcsans{Noto Sans CJK TC}[AutoFakeSlant]
|
||
\newCJKfontfamily[TCmono]\tcmono{Noto Sans Mono CJK TC}[AutoFakeSlant]
|
||
%% for Korean
|
||
\IfFontExistsTF{Noto Serif CJK KR}{
|
||
\newCJKfontfamily[KRmain]\krmain{Noto Serif CJK KR}[AutoFakeSlant]
|
||
\newCJKfontfamily[KRserif]\krserif{Noto Serif CJK KR}[AutoFakeSlant]
|
||
}{
|
||
\newCJKfontfamily[KRmain]\krmain{Noto Sans CJK KR}[AutoFakeSlant]
|
||
\newCJKfontfamily[KRserif]\krserif{Noto Sans CJK KR}[AutoFakeSlant]
|
||
}
|
||
\newCJKfontfamily[KRsans]\krsans{Noto Sans CJK KR}[AutoFakeSlant]
|
||
\newCJKfontfamily[KRmono]\krmono{Noto Sans Mono CJK KR}[AutoFakeSlant]
|
||
%% for Japanese
|
||
\IfFontExistsTF{Noto Serif CJK JP}{
|
||
\newCJKfontfamily[JPmain]\jpmain{Noto Serif CJK JP}[AutoFakeSlant]
|
||
\newCJKfontfamily[JPserif]\jpserif{Noto Serif CJK JP}[AutoFakeSlant]
|
||
}{
|
||
\newCJKfontfamily[JPmain]\jpmain{Noto Sans CJK JP}[AutoFakeSlant]
|
||
\newCJKfontfamily[JPserif]\jpserif{Noto Sans CJK JP}[AutoFakeSlant]
|
||
}
|
||
\newCJKfontfamily[JPsans]\jpsans{Noto Sans CJK JP}[AutoFakeSlant]
|
||
\newCJKfontfamily[JPmono]\jpmono{Noto Sans Mono CJK JP}[AutoFakeSlant]
|
||
% Dummy commands for Sphinx < 2.3 (no 'extrapackages' support)
|
||
\providecommand{\onehalfspacing}{}
|
||
\providecommand{\singlespacing}{}
|
||
% Define custom macros to on/off CJK
|
||
%% One and half spacing for CJK contents
|
||
\newcommand{\kerneldocCJKon}{\makexeCJKactive\onehalfspacing}
|
||
\newcommand{\kerneldocCJKoff}{\makexeCJKinactive\singlespacing}
|
||
% Define custom macros for switching CJK font setting
|
||
%% for Simplified Chinese
|
||
\newcommand{\kerneldocBeginSC}{%
|
||
\begingroup%
|
||
\scmain%
|
||
\xeCJKDeclareCharClass{FullLeft}{`“,`‘}% Full-width in SC
|
||
\xeCJKDeclareCharClass{FullRight}{`”,`’}% Full-width in SC
|
||
\renewcommand{\CJKrmdefault}{SCserif}%
|
||
\renewcommand{\CJKsfdefault}{SCsans}%
|
||
\renewcommand{\CJKttdefault}{SCmono}%
|
||
\xeCJKsetup{CJKspace = false}% gobble white spaces by ' '
|
||
% For CJK ascii-art alignment
|
||
\setmonofont{Noto Sans Mono CJK SC}[AutoFakeSlant]%
|
||
}
|
||
\newcommand{\kerneldocEndSC}{\endgroup}
|
||
%% for Traditional Chinese
|
||
\newcommand{\kerneldocBeginTC}{%
|
||
\begingroup%
|
||
\tcmain%
|
||
\xeCJKDeclareCharClass{FullLeft}{`“,`‘}% Full-width in TC
|
||
\xeCJKDeclareCharClass{FullRight}{`”,`’}% Full-width in TC
|
||
\renewcommand{\CJKrmdefault}{TCserif}%
|
||
\renewcommand{\CJKsfdefault}{TCsans}%
|
||
\renewcommand{\CJKttdefault}{TCmono}%
|
||
\xeCJKsetup{CJKspace = false}% gobble white spaces by ' '
|
||
% For CJK ascii-art alignment
|
||
\setmonofont{Noto Sans Mono CJK TC}[AutoFakeSlant]%
|
||
}
|
||
\newcommand{\kerneldocEndTC}{\endgroup}
|
||
%% for Korean
|
||
\newcommand{\kerneldocBeginKR}{%
|
||
\begingroup%
|
||
\krmain%
|
||
\renewcommand{\CJKrmdefault}{KRserif}%
|
||
\renewcommand{\CJKsfdefault}{KRsans}%
|
||
\renewcommand{\CJKttdefault}{KRmono}%
|
||
% \xeCJKsetup{CJKspace = true} % true by default
|
||
% For CJK ascii-art alignment (still misaligned for Hangul)
|
||
\setmonofont{Noto Sans Mono CJK KR}[AutoFakeSlant]%
|
||
}
|
||
\newcommand{\kerneldocEndKR}{\endgroup}
|
||
%% for Japanese
|
||
\newcommand{\kerneldocBeginJP}{%
|
||
\begingroup%
|
||
\jpmain%
|
||
\renewcommand{\CJKrmdefault}{JPserif}%
|
||
\renewcommand{\CJKsfdefault}{JPsans}%
|
||
\renewcommand{\CJKttdefault}{JPmono}%
|
||
\xeCJKsetup{CJKspace = false}% gobble white space by ' '
|
||
% For CJK ascii-art alignment
|
||
\setmonofont{Noto Sans Mono CJK JP}[AutoFakeSlant]%
|
||
}
|
||
\newcommand{\kerneldocEndJP}{\endgroup}
|
||
|
||
% Single spacing in literal blocks
|
||
\fvset{baselinestretch=1}
|
||
% To customize \sphinxtableofcontents
|
||
\usepackage{etoolbox}
|
||
% Inactivate CJK after tableofcontents
|
||
\apptocmd{\sphinxtableofcontents}{\kerneldocCJKoff}{}{}
|
||
\xeCJKsetup{CJKspace = true}% For inter-phrase space of Korean TOC
|
||
}{ % Don't enable CJK
|
||
% Custom macros to on/off CJK and switch CJK fonts (Dummy)
|
||
\newcommand{\kerneldocCJKon}{}
|
||
\newcommand{\kerneldocCJKoff}{}
|
||
%% By defining \kerneldocBegin(SC|TC|KR|JP) as commands with an argument
|
||
%% and ignore the argument (#1) in their definitions, whole contents of
|
||
%% CJK chapters can be ignored.
|
||
\newcommand{\kerneldocBeginSC}[1]{%
|
||
%% Put a note on missing CJK fonts or the xecjk package in place of
|
||
%% zh_CN translation.
|
||
\begin{sphinxadmonition}{note}{Note on missing fonts and a package:}
|
||
Translations of Simplified Chinese (zh\_CN), Traditional Chinese
|
||
(zh\_TW), Korean (ko\_KR), and Japanese (ja\_JP) were skipped
|
||
due to the lack of suitable font families and/or the texlive-xecjk
|
||
package.
|
||
|
||
If you want them, please install ``Noto Sans CJK'' font families
|
||
along with the texlive-xecjk package by following instructions from
|
||
\sphinxcode{./scripts/sphinx-pre-install}.
|
||
Having optional ``Noto Serif CJK'' font families will improve
|
||
the looks of those translations.
|
||
\end{sphinxadmonition}}
|
||
\newcommand{\kerneldocEndSC}{}
|
||
\newcommand{\kerneldocBeginTC}[1]{}
|
||
\newcommand{\kerneldocEndTC}{}
|
||
\newcommand{\kerneldocBeginKR}[1]{}
|
||
\newcommand{\kerneldocEndKR}{}
|
||
\newcommand{\kerneldocBeginJP}[1]{}
|
||
\newcommand{\kerneldocEndJP}{}
|
||
}
|