Mercurial > hgrepos > Python > libs > ConfigMix

comparison docs/conf.py @ 776:48deafc1fd2f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Use the new implementations of my-doc-fonts.sty and my-doc-style.sty. Changed titlepage to contain build date the VCS revision. Needed some conf.py variable changes: today is now the logical date (revision date) and today is the build date.
author Franz Glasner <fzglas.hg@dom66.de>
date Sat, 16 May 2026 01:52:49 +0200
parents 0c3507865bca
children 236a1d00b8a6
comparison
equal deleted inserted replaced
775:ac7e98fe3e14 776:48deafc1fd2f
32 32
33 # The short X.Y version 33 # The short X.Y version
34 version = '.'.join(configmix.__version__.split('.')[:2]) 34 version = '.'.join(configmix.__version__.split('.')[:2])
35 # The full version, including alpha/beta/rc tags 35 # The full version, including alpha/beta/rc tags
36 release = configmix.__version__ 36 release = configmix.__version__
37 release_date = configmix.__date__ 37 release_date = today = configmix.__date__
38 38
39 today = datetime.date.today().isoformat() 39 current_date = datetime.date.today().isoformat()
40 40
41 41
42 # -- General configuration --------------------------------------------------- 42 # -- General configuration ---------------------------------------------------
43 43
44 # If your documentation needs a minimal Sphinx version, state it here. 44 # If your documentation needs a minimal Sphinx version, state it here.
94 # 94 #
95 #html_theme = 'alabaster' 95 #html_theme = 'alabaster'
96 html_theme = 'haiku' 96 html_theme = 'haiku'
97 # for the Haiku title 97 # for the Haiku title
98 html_short_title = u("%s %s") % (project, release) 98 html_short_title = u("%s %s") % (project, release)
99 html_last_updated_fmt = "%s (rev %s)" % (today, configmix.__revision__) 99 html_last_updated_fmt = "%s (rev %s)" % (current_date, configmix.__revision__)
100 100
101 # Theme options are theme-specific and customize the look and feel of a theme 101 # Theme options are theme-specific and customize the look and feel of a theme
102 # further. For a list of options available for each theme, see the 102 # further. For a list of options available for each theme, see the
103 # documentation. 103 # documentation.
104 # 104 #
142 # The font size ('10pt', '11pt' or '12pt'). 142 # The font size ('10pt', '11pt' or '12pt').
143 # 143 #
144 'pointsize': '11pt', 144 'pointsize': '11pt',
145 145
146 'babel': r'\usepackage{babel}', 146 'babel': r'\usepackage{babel}',
147 'fontpkg': r'\usepackage[charter]{my-doc-fonts}', 147 'preamble': r'\usepackage[stdtitle=false]{my-doc-style}',
148 'maketitle': r'\builddate{%s}\vcsrevision{%s}\sphinxmaketitle' \
149 % (current_date, configmix.__revision__),
150 'fontpkg': r'\usepackage[fonts=charter]{my-doc-fonts}',
148 151
149 # Latex figure (float) alignment 152 # Latex figure (float) alignment
150 # 153 #
151 # 'figure_align': 'htbp', 154 # 'figure_align': 'htbp',
152 # Use "Version" instead of "Release" on the title 155 # Use "Version" instead of "Release" on the title
154 157
155 'fncychap': r'\usepackage[Sonny]{fncychap}', 158 'fncychap': r'\usepackage[Sonny]{fncychap}',
156 } 159 }
157 latex_additional_files = [ 160 latex_additional_files = [
158 "_latex/my-doc-fonts.sty", 161 "_latex/my-doc-fonts.sty",
162 "_latex/my-doc-style.sty",
159 ] 163 ]
160 164
161 # Grouping the document tree into LaTeX files. List of tuples 165 # Grouping the document tree into LaTeX files. List of tuples
162 # (source start file, target name, title, 166 # (source start file, target name, title,
163 # author, documentclass [howto, manual, or own class]). 167 # author, documentclass [howto, manual, or own class]).