227 lines
9.1 KiB
TeX
227 lines
9.1 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
|
||
\IfFontExistsTF{Noto Sans CJK SC}{
|
||
% Load xeCJK when CJK font is 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
|
||
}{ % No CJK font found
|
||
% 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 in place of zh_CN translation.
|
||
\begin{sphinxadmonition}{note}{Note on missing fonts:}
|
||
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.
|
||
|
||
If you want them, please install ``Noto Sans CJK'' font families
|
||
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}{}
|
||
}
|