Mercurial > hgrepos > Python > libs > ConfigMix

annotate docs/_latex/my-doc-style.sty @ 785:42f7caa89253

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update to recent my-doc-style.sty
author Franz Glasner <fzglas.hg@dom66.de>
date Sun, 17 May 2026 11:42:40 +0200
parents 47ae57d92ed3
children 5f0ee44825b1
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}[%
785
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
7 2026/05/17 v0.3 (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 %
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
61 \def\SuppressSectionNumbering{%
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
62 \begingroup
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
63 \renewcommand\thesection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
64 \renewcommand\thesubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
65 \renewcommand\thesubsubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
66 \renewcommand\theparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
67 \renewcommand\thesubparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
68 }
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
69 \def\SuppressSubsectionNumbering{%
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
70 \begingroup
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
71 \renewcommand\thesubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
72 \renewcommand\thesubsubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
73 \renewcommand\theparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
74 \renewcommand\thesubparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
75 }
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
76 \def\SuppressSubsubsectionNumbering{%
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
77 \begingroup
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
78 \renewcommand\thesubsubsection{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
79 \renewcommand\theparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
80 \renewcommand\thesubparagraph{\hspace{-0.5em}}
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
81 }
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
82 \def\EndSuppressNumbering{%
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
83 \endgroup
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
84 }
42f7caa89253 Update to recent my-doc-style.sty
Franz Glasner <fzglas.hg@dom66.de>
parents: 780
diff changeset
85
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
86 \endinput