Mercurial > hgrepos > Python > libs > ConfigMix

annotate docs/_latex/my-doc-style.sty @ 793:46578f03a7cb default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update to latest my-doc-XXX.sty style files for PDF generation
author Franz Glasner <fzglas.hg@dom66.de>
date Wed, 20 May 2026 12:57:36 +0200
parents 5f0ee44825b1
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
776
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
1 % -*- coding: utf-8 -*-
793
46578f03a7cb Update to latest my-doc-XXX.sty style files for PDF generation
Franz Glasner <fzglas.hg@dom66.de>
parents: 786
diff changeset
2 % SPDX-FileCopyrightText: © 2026 Franz Glasner
46578f03a7cb Update to latest my-doc-XXX.sty style files for PDF generation
Franz Glasner <fzglas.hg@dom66.de>
parents: 786
diff changeset
3 % SPDX-License-Identifier: BSD-3-Clause
776
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
4 %
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
5 % Some font hacks for my Sphinx PDF documents
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
6 %
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
7 \NeedsTeXFormat{LaTeX2e}
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
8 \ProvidesPackage{my-doc-style}[%
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
9 2026/05/17 v0.3.1 (Franz Glasner) Some style customizations (title et al.)]
776
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
10 \RequirePackage{xkeyval}
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
11
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
12 % A key compatible with options processing but bool (because DeclareBoolOptionX)
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
13 % If given than the Sphinx standard titlepage is used without changes.
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
14 \define@boolkey{my-doc-style.sty}{stdtitle}[true]{}
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
15
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
16 \ExecuteOptionsX{stdtitle=false}
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
17 \ProcessOptionsX\relax
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
18
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
19 %
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
20 % For the title page: "Last updated on ..."
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
21 %
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
22 \DeclareRobustCommand*\vcsrevision[1]{\gdef\mds@vcs@revision{#1}}
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
23 \DeclareRobustCommand*\builddate[1]{\gdef\mds@builddate{#1}}
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
24 \vcsrevision{}
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
25 \builddate{}
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
26 %
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
27 % If the option "stdtitle" was not enabled augment the titlepage with
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
28 % the documentation build date and the VCS revision id.
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
29 %
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
30 \csname ifKV@my-doc-style.sty@stdtitle\endcsname
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
31 \relax
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
32 \else
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
33 % \sphinxmaketitle calls the macro \@thanks: abuse this
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
34 \gdef\@thanks{%
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
35 \ifx\mds@builddate\@empty\relax%
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
36 \ifx\mds@vcs@revision\@empty\relax%
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
37 \else%
780
47ae57d92ed3 New version of my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 776
diff changeset
38 \hfill\normalsize\textsf{(rev\ \mds@vcs@revision )}%
776
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
39 \fi%
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
40 \else%
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
41 \hfill\normalsize\textsf{Last updated on \mds@builddate%
780
47ae57d92ed3 New version of my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 776
diff changeset
42 \ifx\mds@vcs@revision\@empty\relax\else\enspace(rev\ \mds@vcs@revision )\fi}
776
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
43 \fi%
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
44 }
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
45 \fi
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
46
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
47 %
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
48 % Allow to suppress section numbering for some parts of the document
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
49 % (e.g. in changelog entries).
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
50 %
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
51 % Sphinx employs the "titlesec" package to style its chapter and section
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
52 % headings and uses its \titleformat command with a 0.5em separation
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
53 % (see \titleformat calls in sphinxlatexstyleheadings.sty).
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
54 % So make \the<section> output nothing (e.g. the section number)
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
55 % but just a compensation for this whitespace.
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
56 %
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
57 % Each suppress command suppresses its level and all levels below
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
58 % (compare with the \titleformat calls in sphinxlatexstyleheadings.sty).
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
59 %
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
60 % \EndSuppressNumbering ends exactly one preceding
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
61 % \SuppressSubsectionNumbering or \SuppressSubsubsectionNumbering.
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
62 %
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
63
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
64 %
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
65 % A counter to store the current (Sphinx-set) tocdepth.
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
66 % Needed because counters are global in LaTeX.
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
67 %
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
68 \newcounter{@mds@stored@tocdepth}
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
69
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
70 \def\SuppressSectionNumbering{%
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
71 \begingroup
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
72 \setcounter{@mds@stored@tocdepth}{\value{tocdepth}}
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
73 \addtocontents{toc}{\setcounter{tocdepth}{0}}% No \section in ToC
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
74 \renewcommand\thesection{\hspace{-0.5em}}
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
75 \renewcommand\thesubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
76 \renewcommand\thesubsubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
77 \renewcommand\theparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
78 \renewcommand\thesubparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
79 }
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
80
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
81 \def\SuppressSubsectionNumbering{%
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
82 \begingroup
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
83 \setcounter{@mds@stored@tocdepth}{\value{tocdepth}}
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
84 \addtocontents{toc}{\setcounter{tocdepth}{1}}% Allow \section in ToC
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
85 \renewcommand\thesubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
86 \renewcommand\thesubsubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
87 \renewcommand\theparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
88 \renewcommand\thesubparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
89 }
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
90 \def\SuppressSubsubsectionNumbering{%
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
91 \begingroup
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
92 \setcounter{@mds@stored@tocdepth}{\value{tocdepth}}
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
93 \addtocontents{toc}{\setcounter{tocdepth}{2}}% Allow \subsection in ToC
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
94 \renewcommand\thesubsubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
95 \renewcommand\theparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
96 \renewcommand\thesubparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
97 }
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
98
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
99 \def\EndSuppressNumbering{%
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
100 % Reset the tocdepth to the previous value
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
101 \addtocontents{toc}{\setcounter{tocdepth}{\the@mds@stored@tocdepth}}% Default
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
102 \endgroup
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
103 }
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
104
776
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
105 \endinput