Mercurial > hgrepos > Python > libs > ConfigMix

annotate docs/_latex/my-doc-style.sty @ 786:5f0ee44825b1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update to my-doc-style.sty v0.3.1. Fixes ToC entry handling of sections with suppressed numbers.
author Franz Glasner <fzglas.hg@dom66.de>
date Sun, 17 May 2026 13:08:45 +0200
parents 42f7caa89253
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 -*-
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
2 %
48deafc1fd2f Use the new implementations of my-doc-fonts.sty and my-doc-style.sty.
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
3 % 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
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 \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
6 \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
7 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
8 \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
9
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 % 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
11 % 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
12 \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
13
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 \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
15 \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
16
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 %
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 % 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
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 \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
21 \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
22 \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
23 \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
24 %
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 % 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
26 % 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
27 %
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 \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
29 \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
30 \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
31 % \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
32 \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
33 \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
34 \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
35 \else%
780
47ae57d92ed3 New version of my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 776
diff changeset
36 \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
37 \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
38 \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
39 \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
40 \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
41 \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
42 }
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
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
45 %
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
46 % 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
47 % (e.g. in changelog entries).
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
48 %
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
49 % 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
50 % 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
51 % (see \titleformat calls in sphinxlatexstyleheadings.sty).
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
52 % 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
53 % 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
54 %
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
55 % 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
56 % (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
57 %
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
58 % \EndSuppressNumbering ends exactly one preceding
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
59 % \SuppressSubsectionNumbering or \SuppressSubsubsectionNumbering.
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
60 %
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
61
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
62 %
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
63 % 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
64 % 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
65 %
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
66 \newcounter{@mds@stored@tocdepth}
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
67
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
68 \def\SuppressSectionNumbering{%
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
69 \begingroup
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
70 \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
71 \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
72 \renewcommand\thesection{\hspace{-0.5em}}
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
73 \renewcommand\thesubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
74 \renewcommand\thesubsubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
75 \renewcommand\theparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
76 \renewcommand\thesubparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
77 }
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
78
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
79 \def\SuppressSubsectionNumbering{%
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
80 \begingroup
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
81 \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
82 \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
83 \renewcommand\thesubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
84 \renewcommand\thesubsubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
85 \renewcommand\theparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
86 \renewcommand\thesubparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
87 }
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
88 \def\SuppressSubsubsectionNumbering{%
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
89 \begingroup
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
90 \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
91 \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
92 \renewcommand\thesubsubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
93 \renewcommand\theparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
94 \renewcommand\thesubparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
95 }
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
96
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
97 \def\EndSuppressNumbering{%
786
5f0ee44825b1 Update to my-doc-style.sty v0.3.1.
Franz Glasner <fzglas.hg@dom66.de>
parents: 785
diff changeset
98 % 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
99 \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
100 \endgroup
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
101 }
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
102
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
103 \endinput