Sphinx 8.0.2__py3-none-any.whl → 8.1.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of Sphinx might be problematic. Click here for more details.
- sphinx/__init__.py +6 -3
- sphinx/_cli/__init__.py +40 -20
- sphinx/_cli/util/colour.py +5 -4
- sphinx/_cli/util/errors.py +28 -11
- sphinx/application.py +361 -38
- sphinx/builders/__init__.py +229 -83
- sphinx/builders/_epub_base.py +118 -71
- sphinx/builders/changes.py +39 -21
- sphinx/builders/dirhtml.py +4 -4
- sphinx/builders/dummy.py +2 -5
- sphinx/builders/epub3.py +43 -22
- sphinx/builders/gettext.py +43 -25
- sphinx/builders/html/__init__.py +284 -218
- sphinx/builders/html/_assets.py +62 -26
- sphinx/builders/html/_build_info.py +76 -0
- sphinx/builders/html/transforms.py +11 -9
- sphinx/builders/latex/__init__.py +139 -81
- sphinx/builders/latex/constants.py +7 -7
- sphinx/builders/latex/nodes.py +3 -2
- sphinx/builders/latex/theming.py +7 -5
- sphinx/builders/latex/transforms.py +27 -19
- sphinx/builders/linkcheck.py +146 -72
- sphinx/builders/manpage.py +30 -13
- sphinx/builders/singlehtml.py +22 -14
- sphinx/builders/texinfo.py +67 -37
- sphinx/builders/text.py +5 -5
- sphinx/builders/xml.py +6 -9
- sphinx/cmd/build.py +282 -103
- sphinx/cmd/make_mode.py +106 -63
- sphinx/cmd/quickstart.py +341 -145
- sphinx/config.py +45 -12
- sphinx/deprecation.py +8 -2
- sphinx/directives/__init__.py +28 -19
- sphinx/directives/code.py +86 -56
- sphinx/directives/other.py +50 -36
- sphinx/directives/patches.py +29 -19
- sphinx/domains/__init__.py +20 -120
- sphinx/domains/_domains_container.py +281 -0
- sphinx/domains/_index.py +110 -0
- sphinx/domains/c/__init__.py +3 -3
- sphinx/domains/c/_parser.py +10 -6
- sphinx/domains/changeset.py +5 -3
- sphinx/domains/citation.py +5 -3
- sphinx/domains/cpp/__init__.py +9 -11
- sphinx/domains/cpp/_parser.py +8 -7
- sphinx/domains/index.py +3 -3
- sphinx/domains/javascript.py +12 -7
- sphinx/domains/math.py +2 -2
- sphinx/domains/python/__init__.py +10 -5
- sphinx/domains/python/_object.py +1 -1
- sphinx/domains/rst.py +5 -5
- sphinx/domains/std/__init__.py +16 -11
- sphinx/environment/__init__.py +206 -146
- sphinx/environment/adapters/asset.py +3 -2
- sphinx/environment/adapters/indexentries.py +74 -33
- sphinx/environment/adapters/toctree.py +100 -43
- sphinx/environment/collectors/__init__.py +19 -8
- sphinx/environment/collectors/asset.py +47 -15
- sphinx/environment/collectors/dependencies.py +8 -4
- sphinx/environment/collectors/metadata.py +7 -2
- sphinx/environment/collectors/title.py +7 -2
- sphinx/environment/collectors/toctree.py +54 -22
- sphinx/errors.py +4 -1
- sphinx/events.py +314 -7
- sphinx/ext/apidoc.py +42 -18
- sphinx/ext/autodoc/__init__.py +52 -24
- sphinx/ext/autodoc/importer.py +6 -9
- sphinx/ext/autosectionlabel.py +1 -2
- sphinx/ext/autosummary/__init__.py +3 -1
- sphinx/ext/autosummary/generate.py +28 -14
- sphinx/ext/coverage.py +7 -7
- sphinx/ext/doctest.py +4 -8
- sphinx/ext/duration.py +6 -5
- sphinx/ext/inheritance_diagram.py +1 -1
- sphinx/ext/intersphinx/_cli.py +6 -4
- sphinx/ext/intersphinx/_load.py +77 -32
- sphinx/ext/intersphinx/_resolve.py +173 -79
- sphinx/ext/intersphinx/_shared.py +7 -5
- sphinx/ext/linkcode.py +7 -1
- sphinx/ext/mathjax.py +1 -2
- sphinx/ext/napoleon/__init__.py +37 -24
- sphinx/ext/napoleon/docstring.py +202 -134
- sphinx/ext/todo.py +5 -3
- sphinx/highlighting.py +9 -2
- sphinx/io.py +1 -1
- sphinx/jinja2glue.py +27 -6
- sphinx/locale/__init__.py +6 -2
- sphinx/locale/ar/LC_MESSAGES/sphinx.js +8 -1
- sphinx/locale/ar/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/ar/LC_MESSAGES/sphinx.po +2246 -2288
- sphinx/locale/bg/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/bg/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/bg/LC_MESSAGES/sphinx.po +2113 -2159
- sphinx/locale/bn/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/bn/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/bn/LC_MESSAGES/sphinx.po +2349 -2395
- sphinx/locale/ca/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/ca/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/ca/LC_MESSAGES/sphinx.po +2846 -2892
- sphinx/locale/cak/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/cak/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/cak/LC_MESSAGES/sphinx.po +2213 -2259
- sphinx/locale/cs/LC_MESSAGES/sphinx.js +6 -1
- sphinx/locale/cs/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/cs/LC_MESSAGES/sphinx.po +2225 -2269
- sphinx/locale/cy/LC_MESSAGES/sphinx.js +6 -1
- sphinx/locale/cy/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/cy/LC_MESSAGES/sphinx.po +2403 -2447
- sphinx/locale/da/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/da/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/da/LC_MESSAGES/sphinx.po +2214 -2260
- sphinx/locale/de/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/de/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/de/LC_MESSAGES/sphinx.po +2230 -2276
- sphinx/locale/de_DE/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/de_DE/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/de_DE/LC_MESSAGES/sphinx.po +2113 -2159
- sphinx/locale/el/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/el/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/el/LC_MESSAGES/sphinx.po +2619 -2665
- sphinx/locale/en_DE/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/en_DE/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/en_DE/LC_MESSAGES/sphinx.po +2113 -2159
- sphinx/locale/en_FR/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/en_FR/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/en_FR/LC_MESSAGES/sphinx.po +2113 -2159
- sphinx/locale/en_GB/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/en_GB/LC_MESSAGES/sphinx.po +2519 -2565
- sphinx/locale/en_HK/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/en_HK/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/en_HK/LC_MESSAGES/sphinx.po +2113 -2159
- sphinx/locale/eo/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/eo/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/eo/LC_MESSAGES/sphinx.po +2232 -2278
- sphinx/locale/es/LC_MESSAGES/sphinx.js +5 -1
- sphinx/locale/es/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/es/LC_MESSAGES/sphinx.po +2516 -2561
- sphinx/locale/es_CO/LC_MESSAGES/sphinx.js +5 -1
- sphinx/locale/es_CO/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/es_CO/LC_MESSAGES/sphinx.po +2114 -2159
- sphinx/locale/et/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/et/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/et/LC_MESSAGES/sphinx.po +2317 -2363
- sphinx/locale/eu/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/eu/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/eu/LC_MESSAGES/sphinx.po +2218 -2264
- sphinx/locale/fa/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/fa/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/fa/LC_MESSAGES/sphinx.po +2505 -2551
- sphinx/locale/fi/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/fi/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/fi/LC_MESSAGES/sphinx.po +2303 -2349
- sphinx/locale/fr/LC_MESSAGES/sphinx.js +6 -2
- sphinx/locale/fr/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/fr/LC_MESSAGES/sphinx.po +2863 -2908
- sphinx/locale/fr_FR/LC_MESSAGES/sphinx.js +5 -1
- sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po +2114 -2159
- sphinx/locale/gl/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/gl/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/gl/LC_MESSAGES/sphinx.po +2571 -2617
- sphinx/locale/he/LC_MESSAGES/sphinx.js +5 -1
- sphinx/locale/he/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/he/LC_MESSAGES/sphinx.po +2307 -2352
- sphinx/locale/hi/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/hi/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/hi/LC_MESSAGES/sphinx.po +2580 -2626
- sphinx/locale/hi_IN/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po +2113 -2159
- sphinx/locale/hr/LC_MESSAGES/sphinx.js +5 -1
- sphinx/locale/hr/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/hr/LC_MESSAGES/sphinx.po +2238 -2283
- sphinx/locale/hu/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/hu/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/hu/LC_MESSAGES/sphinx.po +2228 -2274
- sphinx/locale/id/LC_MESSAGES/sphinx.js +3 -1
- sphinx/locale/id/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/id/LC_MESSAGES/sphinx.po +2787 -2834
- sphinx/locale/is/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/is/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/is/LC_MESSAGES/sphinx.po +2224 -2270
- sphinx/locale/it/LC_MESSAGES/sphinx.js +5 -1
- sphinx/locale/it/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/it/LC_MESSAGES/sphinx.po +2231 -2276
- sphinx/locale/ja/LC_MESSAGES/sphinx.js +3 -1
- sphinx/locale/ja/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/ja/LC_MESSAGES/sphinx.po +2507 -2554
- sphinx/locale/ka/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/ka/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/ka/LC_MESSAGES/sphinx.po +2428 -2474
- sphinx/locale/ko/LC_MESSAGES/sphinx.js +3 -1
- sphinx/locale/ko/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/ko/LC_MESSAGES/sphinx.po +2516 -2563
- sphinx/locale/lt/LC_MESSAGES/sphinx.js +6 -1
- sphinx/locale/lt/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/lt/LC_MESSAGES/sphinx.po +2425 -2469
- sphinx/locale/lv/LC_MESSAGES/sphinx.js +5 -1
- sphinx/locale/lv/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/lv/LC_MESSAGES/sphinx.po +2362 -2407
- sphinx/locale/mk/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/mk/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/mk/LC_MESSAGES/sphinx.po +2121 -2167
- sphinx/locale/nb_NO/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po +2220 -2266
- sphinx/locale/ne/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/ne/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/ne/LC_MESSAGES/sphinx.po +2221 -2267
- sphinx/locale/nl/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/nl/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/nl/LC_MESSAGES/sphinx.po +2240 -2286
- sphinx/locale/pl/LC_MESSAGES/sphinx.js +6 -1
- sphinx/locale/pl/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/pl/LC_MESSAGES/sphinx.po +2319 -2363
- sphinx/locale/pt/LC_MESSAGES/sphinx.js +5 -1
- sphinx/locale/pt/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/pt/LC_MESSAGES/sphinx.po +2114 -2159
- sphinx/locale/pt_BR/LC_MESSAGES/sphinx.js +5 -1
- sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po +2854 -2899
- sphinx/locale/pt_PT/LC_MESSAGES/sphinx.js +5 -1
- sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po +2224 -2269
- sphinx/locale/ro/LC_MESSAGES/sphinx.js +5 -1
- sphinx/locale/ro/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/ro/LC_MESSAGES/sphinx.po +2226 -2271
- sphinx/locale/ru/LC_MESSAGES/sphinx.js +8 -3
- sphinx/locale/ru/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/ru/LC_MESSAGES/sphinx.po +2841 -2885
- sphinx/locale/si/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/si/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/si/LC_MESSAGES/sphinx.po +2294 -2340
- sphinx/locale/sk/LC_MESSAGES/sphinx.js +6 -1
- sphinx/locale/sk/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/sk/LC_MESSAGES/sphinx.po +2497 -2541
- sphinx/locale/sl/LC_MESSAGES/sphinx.js +6 -1
- sphinx/locale/sl/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/sl/LC_MESSAGES/sphinx.po +2331 -2375
- sphinx/locale/sphinx.pot +2121 -2167
- sphinx/locale/sq/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/sq/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/sq/LC_MESSAGES/sphinx.po +2855 -2901
- sphinx/locale/sr/LC_MESSAGES/sphinx.js +5 -1
- sphinx/locale/sr/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/sr/LC_MESSAGES/sphinx.po +2203 -2248
- sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/sv/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/sv/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/sv/LC_MESSAGES/sphinx.po +2423 -2469
- sphinx/locale/te/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/te/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/te/LC_MESSAGES/sphinx.po +2113 -2159
- sphinx/locale/tr/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/tr/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/tr/LC_MESSAGES/sphinx.po +2443 -2489
- sphinx/locale/uk_UA/LC_MESSAGES/sphinx.js +6 -1
- sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po +2329 -2373
- sphinx/locale/ur/LC_MESSAGES/sphinx.js +4 -1
- sphinx/locale/ur/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/ur/LC_MESSAGES/sphinx.po +2113 -2159
- sphinx/locale/vi/LC_MESSAGES/sphinx.js +3 -1
- sphinx/locale/vi/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/vi/LC_MESSAGES/sphinx.po +2199 -2246
- sphinx/locale/yue/LC_MESSAGES/sphinx.js +3 -1
- sphinx/locale/yue/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/yue/LC_MESSAGES/sphinx.po +2112 -2159
- sphinx/locale/zh_HK/LC_MESSAGES/sphinx.js +3 -1
- sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po +2112 -2159
- sphinx/locale/zh_TW/LC_MESSAGES/sphinx.js +3 -1
- sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po +2845 -2892
- sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.js +3 -1
- sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo +0 -0
- sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po +2112 -2159
- sphinx/parsers.py +3 -1
- sphinx/project.py +6 -2
- sphinx/pycode/__init__.py +11 -4
- sphinx/pycode/ast.py +58 -58
- sphinx/pycode/parser.py +49 -28
- sphinx/pygments_styles.py +49 -49
- sphinx/registry.py +8 -3
- sphinx/roles.py +133 -13
- sphinx/search/__init__.py +146 -87
- sphinx/search/da.py +2 -4
- sphinx/search/de.py +2 -4
- sphinx/search/en.py +4 -4
- sphinx/search/es.py +2 -4
- sphinx/search/fi.py +2 -4
- sphinx/search/fr.py +2 -4
- sphinx/search/hu.py +2 -4
- sphinx/search/it.py +2 -4
- sphinx/search/ja.py +55 -32
- sphinx/search/nl.py +2 -4
- sphinx/search/no.py +2 -4
- sphinx/search/pt.py +2 -4
- sphinx/search/ro.py +0 -2
- sphinx/search/ru.py +2 -4
- sphinx/search/sv.py +2 -4
- sphinx/search/tr.py +0 -2
- sphinx/search/zh.py +18 -13
- sphinx/templates/graphviz/graphviz.css +0 -7
- sphinx/testing/fixtures.py +6 -5
- sphinx/testing/path.py +7 -5
- sphinx/testing/util.py +63 -29
- sphinx/texinputs/sphinx.sty +107 -39
- sphinx/texinputs/sphinxlatexadmonitions.sty +51 -35
- sphinx/texinputs/sphinxlatexcontainers.sty +1 -1
- sphinx/texinputs/sphinxlatexgraphics.sty +3 -2
- sphinx/texinputs/sphinxlatexindbibtoc.sty +1 -1
- sphinx/texinputs/sphinxlatexlists.sty +1 -1
- sphinx/texinputs/sphinxlatexliterals.sty +4 -1
- sphinx/texinputs/sphinxlatexnumfig.sty +22 -9
- sphinx/texinputs/sphinxlatexobjects.sty +1 -1
- sphinx/texinputs/sphinxlatexshadowbox.sty +72 -10
- sphinx/texinputs/sphinxlatexstyleheadings.sty +7 -2
- sphinx/texinputs/sphinxlatexstylepage.sty +2 -8
- sphinx/texinputs/sphinxlatexstyletext.sty +2 -4
- sphinx/texinputs/sphinxlatextables.sty +1 -1
- sphinx/texinputs/sphinxoptionsgeometry.sty +1 -1
- sphinx/texinputs/sphinxoptionshyperref.sty +1 -1
- sphinx/themes/agogo/layout.html +1 -10
- sphinx/themes/agogo/static/agogo.css.jinja +0 -7
- sphinx/themes/basic/defindex.html +1 -8
- sphinx/themes/basic/domainindex.html +1 -9
- sphinx/themes/basic/genindex-single.html +1 -9
- sphinx/themes/basic/genindex-split.html +1 -9
- sphinx/themes/basic/genindex.html +1 -9
- sphinx/themes/basic/globaltoc.html +1 -9
- sphinx/themes/basic/layout.html +1 -9
- sphinx/themes/basic/localtoc.html +1 -9
- sphinx/themes/basic/page.html +1 -9
- sphinx/themes/basic/relations.html +1 -9
- sphinx/themes/basic/search.html +1 -9
- sphinx/themes/basic/searchbox.html +1 -9
- sphinx/themes/basic/searchfield.html +4 -10
- sphinx/themes/basic/sourcelink.html +1 -9
- sphinx/themes/basic/static/basic.css.jinja +2 -13
- sphinx/themes/basic/static/doctools.js +0 -7
- sphinx/themes/basic/static/language_data.js.jinja +0 -7
- sphinx/themes/basic/static/searchtools.js +25 -13
- sphinx/themes/bizstyle/layout.html +1 -9
- sphinx/themes/bizstyle/static/bizstyle.css.jinja +0 -7
- sphinx/themes/bizstyle/static/bizstyle.js.jinja +5 -11
- sphinx/themes/classic/layout.html +1 -9
- sphinx/themes/classic/static/classic.css.jinja +0 -7
- sphinx/themes/classic/static/sidebar.js.jinja +0 -6
- sphinx/themes/epub/epub-cover.html +1 -9
- sphinx/themes/epub/layout.html +1 -9
- sphinx/themes/epub/static/epub.css.jinja +0 -7
- sphinx/themes/haiku/layout.html +1 -9
- sphinx/themes/haiku/static/haiku.css.jinja +0 -6
- sphinx/themes/nature/static/nature.css.jinja +0 -7
- sphinx/themes/nonav/layout.html +1 -9
- sphinx/themes/nonav/static/nonav.css.jinja +0 -7
- sphinx/themes/pyramid/static/epub.css.jinja +0 -7
- sphinx/themes/pyramid/static/pyramid.css.jinja +0 -7
- sphinx/themes/scrolls/layout.html +1 -10
- sphinx/themes/scrolls/static/scrolls.css.jinja +0 -7
- sphinx/themes/sphinxdoc/static/sphinxdoc.css.jinja +2 -7
- sphinx/themes/traditional/static/traditional.css.jinja +0 -7
- sphinx/theming.py +18 -6
- sphinx/transforms/__init__.py +56 -35
- sphinx/transforms/compact_bullet_list.py +3 -2
- sphinx/transforms/i18n.py +132 -50
- sphinx/transforms/post_transforms/__init__.py +94 -43
- sphinx/transforms/post_transforms/code.py +7 -6
- sphinx/transforms/post_transforms/images.py +71 -54
- sphinx/transforms/references.py +1 -2
- sphinx/util/__init__.py +23 -194
- sphinx/util/_files.py +80 -0
- sphinx/util/_importer.py +27 -0
- sphinx/util/_io.py +1 -2
- sphinx/util/_lines.py +26 -0
- sphinx/util/_pathlib.py +5 -2
- sphinx/util/_serialise.py +53 -0
- sphinx/util/_timestamps.py +2 -1
- sphinx/util/_uri.py +16 -0
- sphinx/util/cfamily.py +48 -25
- sphinx/util/console.py +1 -0
- sphinx/util/display.py +1 -1
- sphinx/util/docfields.py +125 -45
- sphinx/util/docstrings.py +1 -1
- sphinx/util/docutils.py +118 -44
- sphinx/util/exceptions.py +11 -5
- sphinx/util/fileutil.py +53 -32
- sphinx/util/http_date.py +9 -7
- sphinx/util/i18n.py +49 -16
- sphinx/util/images.py +7 -6
- sphinx/util/inspect.py +29 -12
- sphinx/util/inventory.py +47 -29
- sphinx/util/logging.py +58 -85
- sphinx/util/matching.py +3 -3
- sphinx/util/math.py +1 -1
- sphinx/util/nodes.py +176 -108
- sphinx/util/osutil.py +13 -10
- sphinx/util/parallel.py +5 -4
- sphinx/util/parsing.py +5 -3
- sphinx/util/png.py +3 -3
- sphinx/util/requests.py +8 -4
- sphinx/util/rst.py +5 -3
- sphinx/util/tags.py +5 -2
- sphinx/util/template.py +26 -11
- sphinx/util/texescape.py +2 -2
- sphinx/util/typing.py +89 -38
- sphinx/versioning.py +3 -1
- sphinx/writers/html.py +22 -7
- sphinx/writers/html5.py +113 -64
- sphinx/writers/latex.py +408 -221
- sphinx/writers/manpage.py +25 -15
- sphinx/writers/texinfo.py +94 -82
- sphinx/writers/text.py +87 -53
- sphinx/writers/xml.py +5 -4
- sphinx-8.1.0.dist-info/LICENSE.rst +31 -0
- {sphinx-8.0.2.dist-info → sphinx-8.1.0.dist-info}/METADATA +13 -11
- sphinx-8.1.0.dist-info/RECORD +598 -0
- sphinx-8.0.2.dist-info/LICENSE.rst +0 -67
- sphinx-8.0.2.dist-info/RECORD +0 -590
- {sphinx-8.0.2.dist-info → sphinx-8.1.0.dist-info}/WHEEL +0 -0
- {sphinx-8.0.2.dist-info → sphinx-8.1.0.dist-info}/entry_points.txt +0 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
%% GRAPHICS
|
|
2
2
|
%
|
|
3
3
|
% change this info string if making any custom modification
|
|
4
|
-
\
|
|
4
|
+
\ProvidesPackage{sphinxlatexgraphics}[2024/08/13 v8.1.0 graphics]
|
|
5
5
|
|
|
6
6
|
% Provides support for this output mark-up from Sphinx latex writer:
|
|
7
7
|
%
|
|
@@ -84,7 +84,8 @@
|
|
|
84
84
|
\ifin@
|
|
85
85
|
\setbox\spx@image@box
|
|
86
86
|
\hbox{\includegraphics
|
|
87
|
-
[
|
|
87
|
+
[#1,% contains only width and/or height which are overruled next
|
|
88
|
+
% but in future may contain page=N hence must be kept
|
|
88
89
|
width=\spx@image@requiredwidth,height=\spx@image@requiredheight]%
|
|
89
90
|
{#2}}%
|
|
90
91
|
% \includegraphics does not set box dimensions to the exactly
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
%% INDEX, BIBLIOGRAPHY, APPENDIX, TABLE OF CONTENTS
|
|
2
2
|
%
|
|
3
3
|
% change this info string if making any custom modification
|
|
4
|
-
\
|
|
4
|
+
\ProvidesPackage{sphinxlatexindbibtoc}[2021/01/27 index, bib., toc]
|
|
5
5
|
|
|
6
6
|
% Provides support for this output mark-up from Sphinx latex writer:
|
|
7
7
|
%
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
%% ALPHANUMERIC LIST ITEMS
|
|
2
2
|
%
|
|
3
3
|
% change this info string if making any custom modification
|
|
4
|
-
\
|
|
4
|
+
\ProvidesPackage{sphinxlatexlists}[2021/12/20 lists]
|
|
5
5
|
|
|
6
6
|
% Provides support for this output mark-up from Sphinx latex writer:
|
|
7
7
|
% - \sphinxsetlistlabels
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
%% LITERAL BLOCKS
|
|
2
2
|
%
|
|
3
3
|
% change this info string if making any custom modification
|
|
4
|
-
\
|
|
4
|
+
\ProvidesPackage{sphinxlatexliterals}[2024/07/01 v7.4.0 code-blocks and parsed literals]
|
|
5
5
|
|
|
6
6
|
% Provides support for this output mark-up from Sphinx latex writer:
|
|
7
7
|
%
|
|
@@ -512,6 +512,9 @@
|
|
|
512
512
|
\setbox\spx@tempboxa
|
|
513
513
|
\vtop{\raggedright\hyphenpenalty\z@\exhyphenpenalty\z@
|
|
514
514
|
\doublehyphendemerits\z@\finalhyphendemerits\z@
|
|
515
|
+
% Avoid TeX reporting Overfull \hbox'es during this measuring phase. Setting
|
|
516
|
+
% \hbadness to \@M to avoid Underfull reports is unneeded due to \raggedright.
|
|
517
|
+
\hfuzz\maxdimen
|
|
515
518
|
\spx@everypar{}\noindent\strut\FV@Line\strut\spx@par
|
|
516
519
|
\spx@verb@getwidths}%
|
|
517
520
|
\ifdim\spx@verb@maxwidth>
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
%% NUMBERING OF FIGURES, TABLES, AND LITERAL BLOCKS
|
|
2
2
|
%
|
|
3
3
|
% change this info string if making any custom modification
|
|
4
|
-
\
|
|
4
|
+
\ProvidesPackage{sphinxlatexnumfig}[2024/07/31 v8.1.0 numbering]
|
|
5
5
|
|
|
6
6
|
% Requires: remreset (old LaTeX only)
|
|
7
7
|
% relates to numfig and numfig_secnum_depth configuration variables
|
|
@@ -37,7 +37,11 @@
|
|
|
37
37
|
\def\theequation{\arabic{equation}}%
|
|
38
38
|
\fi
|
|
39
39
|
\else
|
|
40
|
-
|
|
40
|
+
% See apologetic comments on TeX wizardry at bottom of file.
|
|
41
|
+
% The reason for this one is to catch case where there will be only
|
|
42
|
+
% the number with no prefix from enclosing sectioning (can happen
|
|
43
|
+
% with latex_toplevel_sectioning='part').
|
|
44
|
+
\def\spx@preAthefigure{\expandafter\spx@magicsep@s\romannumeral-`0}
|
|
41
45
|
\let\spx@preBthefigure\@empty
|
|
42
46
|
% \ifspx@opt@usespart % <-- LaTeX writer could pass such a 'usespart' boolean
|
|
43
47
|
% % as sphinx.sty package option
|
|
@@ -51,7 +55,7 @@
|
|
|
51
55
|
\ifnum\spx@opt@numfigreset>0
|
|
52
56
|
\ltx@ifundefined{c@chapter}
|
|
53
57
|
{}
|
|
54
|
-
{\g@addto@macro\spx@preAthefigure{\ifnum\c@chapter>\z@\arabic{chapter}
|
|
58
|
+
{\g@addto@macro\spx@preAthefigure{\ifnum\c@chapter>\z@\arabic{chapter}\spx@magicsep}%
|
|
55
59
|
\g@addto@macro\spx@preBthefigure{\fi}}%
|
|
56
60
|
\fi
|
|
57
61
|
\ifnum\spx@opt@numfigreset>1
|
|
@@ -61,7 +65,7 @@
|
|
|
61
65
|
\ifspx@opt@mathnumfig
|
|
62
66
|
\@addtoreset{equation}{section}%
|
|
63
67
|
\fi%
|
|
64
|
-
\g@addto@macro\spx@preAthefigure{\ifnum\c@section>\z@\arabic{section}
|
|
68
|
+
\g@addto@macro\spx@preAthefigure{\ifnum\c@section>\z@\arabic{section}\spx@magicsep}%
|
|
65
69
|
\g@addto@macro\spx@preBthefigure{\fi}%
|
|
66
70
|
\fi
|
|
67
71
|
\ifnum\spx@opt@numfigreset>2
|
|
@@ -71,7 +75,7 @@
|
|
|
71
75
|
\ifspx@opt@mathnumfig
|
|
72
76
|
\@addtoreset{equation}{subsection}%
|
|
73
77
|
\fi%
|
|
74
|
-
\g@addto@macro\spx@preAthefigure{\ifnum\c@subsection>\z@\arabic{subsection}
|
|
78
|
+
\g@addto@macro\spx@preAthefigure{\ifnum\c@subsection>\z@\arabic{subsection}\spx@magicsep}%
|
|
75
79
|
\g@addto@macro\spx@preBthefigure{\fi}%
|
|
76
80
|
\fi
|
|
77
81
|
\ifnum\spx@opt@numfigreset>3
|
|
@@ -81,7 +85,7 @@
|
|
|
81
85
|
\ifspx@opt@mathnumfig
|
|
82
86
|
\@addtoreset{equation}{subsubsection}%
|
|
83
87
|
\fi%
|
|
84
|
-
\g@addto@macro\spx@preAthefigure{\ifnum\c@subsubsection>\z@\arabic{subsubsection}
|
|
88
|
+
\g@addto@macro\spx@preAthefigure{\ifnum\c@subsubsection>\z@\arabic{subsubsection}\spx@magicsep}%
|
|
85
89
|
\g@addto@macro\spx@preBthefigure{\fi}%
|
|
86
90
|
\fi
|
|
87
91
|
\ifnum\spx@opt@numfigreset>4
|
|
@@ -91,7 +95,7 @@
|
|
|
91
95
|
\ifspx@opt@mathnumfig
|
|
92
96
|
\@addtoreset{equation}{paragraph}%
|
|
93
97
|
\fi%
|
|
94
|
-
\g@addto@macro\spx@preAthefigure{\ifnum\c@subparagraph>\z@\arabic{subparagraph}
|
|
98
|
+
\g@addto@macro\spx@preAthefigure{\ifnum\c@subparagraph>\z@\arabic{subparagraph}\spx@magicsep}%
|
|
95
99
|
\g@addto@macro\spx@preBthefigure{\fi}%
|
|
96
100
|
\fi
|
|
97
101
|
\ifnum\spx@opt@numfigreset>5
|
|
@@ -101,7 +105,7 @@
|
|
|
101
105
|
\ifspx@opt@mathnumfig
|
|
102
106
|
\@addtoreset{equation}{subparagraph}%
|
|
103
107
|
\fi%
|
|
104
|
-
\g@addto@macro\spx@preAthefigure{\ifnum\c@subsubparagraph>\z@\arabic{subsubparagraph}
|
|
108
|
+
\g@addto@macro\spx@preAthefigure{\ifnum\c@subsubparagraph>\z@\arabic{subsubparagraph}\spx@magicsep}%
|
|
105
109
|
\g@addto@macro\spx@preBthefigure{\fi}%
|
|
106
110
|
\fi
|
|
107
111
|
\expandafter\g@addto@macro
|
|
@@ -114,9 +118,18 @@
|
|
|
114
118
|
\g@addto@macro\theliteralblock{\arabic{literalblock}}%
|
|
115
119
|
\ifspx@opt@mathnumfig
|
|
116
120
|
\let\theequation\spx@preAthefigure
|
|
117
|
-
\g@addto@macro\theequation{
|
|
121
|
+
\g@addto@macro\theequation{E}%
|
|
118
122
|
\fi
|
|
119
123
|
\fi
|
|
120
124
|
}% end of big \AtBeginDocument
|
|
121
125
|
|
|
126
|
+
% Sorry for TeX wizardry here. We need to keep expandability. Explaining
|
|
127
|
+
% the mechanism is not really feasible to non TeX-experts, but the idea
|
|
128
|
+
% is to force next `\ifnum` conditional so we can check what comes next.
|
|
129
|
+
% All cases are accounted for (i.e. not an equation, or an equation at top
|
|
130
|
+
% level, or an equation in some section at some depth).
|
|
131
|
+
\def\spx@magicsep{\expandafter\spx@magicsep@i\romannumeral-`0}
|
|
132
|
+
\def\spx@magicsep@i#1{\if#1E\spx@opt@mathnumsep\arabic{equation}\else.#1\fi}
|
|
133
|
+
%
|
|
134
|
+
\def\spx@magicsep@s#1{\if#1E\arabic{equation}\else#1\fi}
|
|
122
135
|
\endinput
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
%% MODULE RELEASE DATA AND OBJECT DESCRIPTIONS
|
|
2
2
|
%
|
|
3
3
|
% change this info string if making any custom modification
|
|
4
|
-
\
|
|
4
|
+
\ProvidesPackage{sphinxlatexobjects}[2023/07/23 documentation environments]
|
|
5
5
|
|
|
6
6
|
% Provides support for this output mark-up from Sphinx latex writer:
|
|
7
7
|
%
|
|
@@ -1,21 +1,37 @@
|
|
|
1
1
|
%% TOPIC AND CONTENTS BOXES
|
|
2
2
|
%
|
|
3
3
|
% change this info string if making any custom modification
|
|
4
|
-
\
|
|
4
|
+
\ProvidesPackage{sphinxlatexshadowbox}[2024/07/28 v8.1.0 sphinxShadowBox]
|
|
5
5
|
|
|
6
6
|
% Provides support for this output mark-up from Sphinx latex writer:
|
|
7
7
|
%
|
|
8
|
-
% -
|
|
8
|
+
% - Environments: sphinxtopic, sphinxcontents, and sphinxsidebar.
|
|
9
|
+
%
|
|
10
|
+
% These wrappers replace at 8.1.0 former direct use of sphinxShadowBox
|
|
11
|
+
% environment which did not allow separate styling.
|
|
12
|
+
%
|
|
13
|
+
% - Commands: \sphinxstyletopictitle, \sphinxstylecontentstitle, and
|
|
14
|
+
% \sphinxstylesidebartitle.
|
|
15
|
+
%
|
|
16
|
+
% At 8.1.0 they default to use \sphinxdotitlerow whose definiion is done in
|
|
17
|
+
% sphinxlatexadmonitions.sty. There is also \sphinxstylesidebarsubtitle
|
|
18
|
+
% which does not use \sphinxdotitlerow.
|
|
9
19
|
%
|
|
10
20
|
% Dependencies (they do not need to be defined at time of loading):
|
|
11
21
|
%
|
|
12
22
|
% - of course the various colour and dimension options handled via sphinx.sty
|
|
13
23
|
% - dimension register \spx@image@maxheight from sphinxlatexgraphics.sty
|
|
14
|
-
% - \savenotes/\spewnotes from sphinxpackagefootnote
|
|
24
|
+
% - \savenotes/\spewnotes from sphinxpackagefootnote.sty
|
|
15
25
|
% - \ifspx@inframed defined in sphinx.sty
|
|
26
|
+
% - \sphinxdotitlerow from sphinxlatexadmonitions.sty
|
|
27
|
+
% - \spx@boxes@fcolorbox@setup from sphinxpackageboxes.sty
|
|
16
28
|
%
|
|
17
|
-
% Requires:
|
|
18
29
|
\RequirePackage{framed}
|
|
30
|
+
% Those are required either before or after by sphinx.sty anyhow, but for
|
|
31
|
+
% clarity we list them here:
|
|
32
|
+
\RequirePackage{sphinxlatexgraphics}
|
|
33
|
+
\RequirePackage{sphinxpackagefootnote}
|
|
34
|
+
\RequirePackage{sphinxlatexadmonitions}
|
|
19
35
|
\RequirePackage{sphinxpackageboxes}
|
|
20
36
|
|
|
21
37
|
% At 5.1.0 the code formerly here in a definition of \spx@ShadowFBox has been
|
|
@@ -45,9 +61,28 @@
|
|
|
45
61
|
% in contrast with the framing used for literal blocks, also based, but in a
|
|
46
62
|
% more sophisticated way on usage of \MakeFramed/\endMakeFramed, and
|
|
47
63
|
% adjusting to current text indentation.
|
|
48
|
-
|
|
64
|
+
%
|
|
65
|
+
% At 8.1.0, sphinxShadowBox takes an optional argument #1 and uses it as
|
|
66
|
+
% \spx@boxes@fcolorbox@setup{#1} rather than \spx@boxes@fcolorbox@setup{topic}.
|
|
67
|
+
% Some hesitation whether to move this line to newly added sphinxtopic,
|
|
68
|
+
% sphinxcontents and sphinxsidebar environmments. But anyhow the environment
|
|
69
|
+
% also requires later knowing a few more things: sphinx<type>TextColor and
|
|
70
|
+
% spx@<type>@texextras.
|
|
71
|
+
%
|
|
72
|
+
% The #1 defaulting to topic must be such that all parameters expected by
|
|
73
|
+
% \spx@boxes@fcolorbox@setup actually do exist, see CSS options in sphinx.sty
|
|
74
|
+
% which is what defines them for contents, topic, and sidebar.
|
|
75
|
+
%
|
|
76
|
+
% Fortunately the #1 is not needed in \end{sphinxShadowBox} so we don't have
|
|
77
|
+
% to work around a LaTeX conception bug that such #1 can not be used as is in
|
|
78
|
+
% the definition of the \end part of an environment.
|
|
79
|
+
%
|
|
80
|
+
% MEMO: the "shadow" is not really drawn directly by this environment but
|
|
81
|
+
% indirectly via the configuration which is passed over to \spx@boxes@fcolorbox,
|
|
82
|
+
% which is the macro creating frame and (perhaps but not necessarily) a shadow.
|
|
83
|
+
\newenvironment{sphinxShadowBox}[1][topic]%
|
|
49
84
|
{%
|
|
50
|
-
\spx@boxes@fcolorbox@setup{
|
|
85
|
+
\spx@boxes@fcolorbox@setup{#1}%
|
|
51
86
|
% we will use the dimen registers from sphinxpackageboxes.sty which now hold
|
|
52
87
|
% the values from options related to topic/contents
|
|
53
88
|
% MEMO: \spx@boxes@fcolorbox creates an \hbox but does not quit vertical
|
|
@@ -56,7 +91,7 @@
|
|
|
56
91
|
\def\FrameCommand {\spx@boxes@fcolorbox}%
|
|
57
92
|
% 6.2.0 adds support for div.topic_box-decoration-break=slice.
|
|
58
93
|
% (it is yet undecided if slice style should inhibit a bottom shadow)
|
|
59
|
-
|
|
94
|
+
\@nameuse{ifspx@#1@border@open}%
|
|
60
95
|
\def\FirstFrameCommand
|
|
61
96
|
{\spx@boxes@fcolorbox@setup@openbottom\FrameCommand}%
|
|
62
97
|
\def\MidFrameCommand
|
|
@@ -97,10 +132,10 @@
|
|
|
97
132
|
\@setminipage
|
|
98
133
|
}%
|
|
99
134
|
\color@begingroup % workaround upstream framed.sty bug
|
|
100
|
-
|
|
101
|
-
\color{
|
|
135
|
+
\@nameuse{ifspx@#1@withtextcolor}%
|
|
136
|
+
\color{sphinx#1TextColor}%
|
|
102
137
|
\fi
|
|
103
|
-
|
|
138
|
+
\@nameuse{spx@#1@TeXextras}%
|
|
104
139
|
}%
|
|
105
140
|
{% insert the "endminipage" code
|
|
106
141
|
\par\unskip
|
|
@@ -113,4 +148,31 @@
|
|
|
113
148
|
\spewnotes
|
|
114
149
|
}
|
|
115
150
|
|
|
151
|
+
% 8.1.0
|
|
152
|
+
\newenvironment{sphinxtopic}
|
|
153
|
+
{\begin{sphinxShadowBox}[topic]}{\end{sphinxShadowBox}}
|
|
154
|
+
\newenvironment{sphinxcontents}
|
|
155
|
+
{\begin{sphinxShadowBox}[contents]}{\end{sphinxShadowBox}}
|
|
156
|
+
% Arguably sphinxsidebar should rather use a wrapfig or similar environment
|
|
157
|
+
% but this is so dysfunctional in LaTeX (except for self-written documents)
|
|
158
|
+
% so we prefer to not venture into such a potential quagmire and keep the
|
|
159
|
+
% legacy rendering using a full width display.
|
|
160
|
+
\newenvironment{sphinxsidebar}
|
|
161
|
+
{\begin{sphinxShadowBox}[sidebar]}{\end{sphinxShadowBox}}
|
|
162
|
+
|
|
163
|
+
% TODO: decide if this should be in sphinxlatexstyletext.sty rather
|
|
164
|
+
%
|
|
165
|
+
% 8.1.0 styles topic/contents/sidebar with a title row, too.
|
|
166
|
+
% Prior to 8.1.0, definitions use \protected\def but there does not seem
|
|
167
|
+
% to be any reason so back to \newcommand.
|
|
168
|
+
\newcommand*\sphinxstyletopictitle[1]{\sphinxdotitlerow{topic}{#1}}
|
|
169
|
+
\newcommand*\sphinxstylecontentstitle[1]{\sphinxdotitlerow{contents}{#1}}
|
|
170
|
+
\newcommand*\sphinxstylesidebartitle[1]{\sphinxdotitlerow{sidebar}{#1}}
|
|
171
|
+
% No default color background for subtitle. The contents next are injected by
|
|
172
|
+
% LaTeX writer after a blank line in source hence will start a new paragrpah.
|
|
173
|
+
% The \sphinxAtStartPar here is only for coherence with other text paragraphs,
|
|
174
|
+
% but does not have serious necessity (its general role is to allow hyphenation
|
|
175
|
+
% for first word in narrow table cells).
|
|
176
|
+
\newcommand*\sphinxstylesidebarsubtitle[1]{\sphinxAtStartPar\textbf{#1}}
|
|
177
|
+
|
|
116
178
|
\endinput
|
|
@@ -1,9 +1,15 @@
|
|
|
1
1
|
%% TITLES
|
|
2
2
|
%
|
|
3
3
|
% change this info string if making any custom modification
|
|
4
|
-
\
|
|
4
|
+
\ProvidesPackage{sphinxlatexstyleheadings}[2023/02/11 headings]
|
|
5
5
|
|
|
6
6
|
\RequirePackage[nobottomtitles*]{titlesec}
|
|
7
|
+
% tests showed that this setting guarantees \section title has
|
|
8
|
+
% 3 lines of text following it on same page if near bottom.
|
|
9
|
+
\renewcommand\bottomtitlespace{6\baselineskip}
|
|
10
|
+
% the default setting of 0.2\textheight is about 11\baselineskip
|
|
11
|
+
% (for 10pt letterpaper documents) and may create large voids.
|
|
12
|
+
|
|
7
13
|
\@ifpackagelater{titlesec}{2016/03/15}%
|
|
8
14
|
{\@ifpackagelater{titlesec}{2016/03/21}%
|
|
9
15
|
{}%
|
|
@@ -47,7 +53,6 @@
|
|
|
47
53
|
\titleformat{\subparagraph}{\normalsize\py@HeaderFamily}%
|
|
48
54
|
{\py@TitleColor\thesubparagraph}{0.5em}{\py@TitleColor}
|
|
49
55
|
|
|
50
|
-
|
|
51
56
|
% Since Sphinx 1.5, users should use HeaderFamily key to 'sphinxsetup' rather
|
|
52
57
|
% than defining their own \py@HeaderFamily command (which is still possible).
|
|
53
58
|
% Memo: \py@HeaderFamily is also used by \maketitle as defined in
|
|
@@ -1,16 +1,10 @@
|
|
|
1
1
|
%% PAGE STYLING
|
|
2
2
|
%
|
|
3
3
|
% change this info string if making any custom modification
|
|
4
|
-
\
|
|
4
|
+
\ProvidesPackage{sphinxlatexstylepage}[2021/01/27 page styling]
|
|
5
5
|
|
|
6
6
|
% Separate paragraphs by space by default.
|
|
7
|
-
\
|
|
8
|
-
% new parskip.sty, but let it rollback to old one.
|
|
9
|
-
% hopefully TeX installation not broken and LaTeX kernel not too old
|
|
10
|
-
{\RequirePackage{parskip}[=v1]}
|
|
11
|
-
% standard one from 1989. Admittedly \section of article/book gives possibly
|
|
12
|
-
% anomalous spacing, but we can't require September 2018 release for some time.
|
|
13
|
-
{\RequirePackage{parskip}}
|
|
7
|
+
\RequirePackage{parskip}
|
|
14
8
|
|
|
15
9
|
% Style parameters and macros used by most documents here
|
|
16
10
|
\raggedbottom
|
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
%% TEXT STYLING
|
|
2
2
|
%
|
|
3
3
|
% change this info string if making any custom modification
|
|
4
|
-
\
|
|
4
|
+
\ProvidesPackage{sphinxlatexstyletext}[2024/07/28 v8.1.0 text styling]
|
|
5
5
|
|
|
6
6
|
% 7.4.0 has moved all that is related to admonitions to sphinxlatexadmonitions.sty
|
|
7
|
+
% 8.1.0 has moved topic/contents/sidebar to sphinxlatexshadowbox.sty
|
|
7
8
|
% Most everything left here consists of macros which are part of the latex markup
|
|
8
9
|
% produced by the Sphinx LaTeX writer.
|
|
9
10
|
|
|
@@ -39,10 +40,7 @@
|
|
|
39
40
|
{{\Large\sffamily#1}\nopagebreak\vspace{1mm}}
|
|
40
41
|
\def\sphinxstyleindexlettergroupDefault #1%
|
|
41
42
|
{{\Large\sffamily\sphinxnonalphabeticalgroupname}\nopagebreak\vspace{1mm}}
|
|
42
|
-
\protected\def\sphinxstyletopictitle #1{\textbf{#1}\par\medskip}
|
|
43
|
-
\let\sphinxstylesidebartitle\sphinxstyletopictitle
|
|
44
43
|
\protected\def\sphinxstyleothertitle #1{\textbf{#1}}
|
|
45
|
-
\protected\def\sphinxstylesidebarsubtitle #1{~\\\textbf{#1} \smallskip}
|
|
46
44
|
% \text.. commands do not allow multiple paragraphs
|
|
47
45
|
% attention, this one is not self-delimiting
|
|
48
46
|
\protected\def\sphinxstyletheadfamily {\sffamily}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
%% TABLES (WITH SUPPORT FOR MERGED CELLS OF GENERAL CONTENTS)
|
|
2
2
|
%
|
|
3
3
|
% change this info string if making any custom modification
|
|
4
|
-
\
|
|
4
|
+
\ProvidesPackage{sphinxlatextables}[2024/07/01 v7.4.0 tables]%
|
|
5
5
|
|
|
6
6
|
% Provides support for this output mark-up from Sphinx latex writer
|
|
7
7
|
% and table templates:
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
%% Bookmarks and hyperlinks
|
|
2
2
|
%
|
|
3
3
|
% change this info string if making any custom modification
|
|
4
|
-
\
|
|
4
|
+
\ProvidesPackage{sphinxoptionshyperref}[2021/01/27 hyperref]
|
|
5
5
|
|
|
6
6
|
% to make pdf with correct encoded bookmarks in Japanese
|
|
7
7
|
% this should precede the hyperref package
|
sphinx/themes/agogo/layout.html
CHANGED
|
@@ -1,13 +1,4 @@
|
|
|
1
|
-
{#
|
|
2
|
-
agogo/layout.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Sphinx layout template for the agogo theme, originally written
|
|
6
|
-
by Andi Albrecht.
|
|
7
|
-
|
|
8
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
9
|
-
:license: BSD, see LICENSE for details.
|
|
10
|
-
#}
|
|
1
|
+
{# Sphinx layout template for the agogo theme. #}
|
|
11
2
|
{%- extends "basic/layout.html" %}
|
|
12
3
|
|
|
13
4
|
{% block header %}
|
|
@@ -1,11 +1,4 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/defindex.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Default template for the "index" page.
|
|
6
|
-
|
|
7
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
:license: BSD, see LICENSE for details.
|
|
1
|
+
{# Default template for the "index" page.
|
|
9
2
|
#}{{ warn('Now base template defindex.html is deprecated.') }}
|
|
10
3
|
{%- extends "layout.html" %}
|
|
11
4
|
{% set title = _('Overview') %}
|
|
@@ -1,12 +1,4 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/domainindex.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Template for domain indices (module index, ...).
|
|
6
|
-
|
|
7
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
:license: BSD, see LICENSE for details.
|
|
9
|
-
#}
|
|
1
|
+
{# Template for domain indices (module index, ...). #}
|
|
10
2
|
{%- extends "layout.html" %}
|
|
11
3
|
{% set title = indextitle %}
|
|
12
4
|
{% block extrahead %}
|
|
@@ -1,12 +1,4 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/genindex-single.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Template for a "single" page of a split index.
|
|
6
|
-
|
|
7
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
:license: BSD, see LICENSE for details.
|
|
9
|
-
#}
|
|
1
|
+
{# Template for a "single" page of a split index. #}
|
|
10
2
|
{% macro indexentries(firstname, links) %}
|
|
11
3
|
{%- if links -%}
|
|
12
4
|
<a href="{{ links[0][1] }}">
|
|
@@ -1,12 +1,4 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/genindex-split.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Template for a "split" index overview page.
|
|
6
|
-
|
|
7
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
:license: BSD, see LICENSE for details.
|
|
9
|
-
#}
|
|
1
|
+
{# Template for a "split" index overview page. #}
|
|
10
2
|
{%- extends "layout.html" %}
|
|
11
3
|
{% set title = _('Index') %}
|
|
12
4
|
{% block body %}
|
|
@@ -1,12 +1,4 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/genindex.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Template for an "all-in-one" index.
|
|
6
|
-
|
|
7
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
:license: BSD, see LICENSE for details.
|
|
9
|
-
#}
|
|
1
|
+
{# Template for an "all-in-one" index. #}
|
|
10
2
|
{%- extends "layout.html" %}
|
|
11
3
|
{% set title = _('Index') %}
|
|
12
4
|
|
|
@@ -1,11 +1,3 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/globaltoc.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Sphinx sidebar template: global table of contents.
|
|
6
|
-
|
|
7
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
:license: BSD, see LICENSE for details.
|
|
9
|
-
#}
|
|
1
|
+
{# Sphinx sidebar template: global table of contents. #}
|
|
10
2
|
<h3><a href="{{ pathto(root_doc)|e }}">{{ _('Table of Contents') }}</a></h3>
|
|
11
3
|
{{ toctree(includehidden=theme_globaltoc_includehidden, collapse=theme_globaltoc_collapse, maxdepth=theme_globaltoc_maxdepth) }}
|
sphinx/themes/basic/layout.html
CHANGED
|
@@ -1,12 +1,4 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/layout.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Master layout template for Sphinx themes.
|
|
6
|
-
|
|
7
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
:license: BSD, see LICENSE for details.
|
|
9
|
-
#}
|
|
1
|
+
{# Master layout template for Sphinx themes. #}
|
|
10
2
|
{%- block doctype -%}
|
|
11
3
|
<!DOCTYPE html>
|
|
12
4
|
{%- endblock %}
|
|
@@ -1,12 +1,4 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/localtoc.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Sphinx sidebar template: local table of contents.
|
|
6
|
-
|
|
7
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
:license: BSD, see LICENSE for details.
|
|
9
|
-
#}
|
|
1
|
+
{# Sphinx sidebar template: local table of contents. #}
|
|
10
2
|
{%- if display_toc %}
|
|
11
3
|
<div>
|
|
12
4
|
<h3><a href="{{ pathto(root_doc)|e }}">{{ _('Table of Contents') }}</a></h3>
|
sphinx/themes/basic/page.html
CHANGED
|
@@ -1,12 +1,4 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/page.html
|
|
3
|
-
~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Master template for simple pages.
|
|
6
|
-
|
|
7
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
:license: BSD, see LICENSE for details.
|
|
9
|
-
#}
|
|
1
|
+
{# Master template for simple pages. #}
|
|
10
2
|
{%- extends "layout.html" %}
|
|
11
3
|
{% block body %}
|
|
12
4
|
{{ body }}
|
|
@@ -1,12 +1,4 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/relations.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Sphinx sidebar template: relation links.
|
|
6
|
-
|
|
7
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
:license: BSD, see LICENSE for details.
|
|
9
|
-
#}
|
|
1
|
+
{# Sphinx sidebar template: relation links. #}
|
|
10
2
|
{%- if prev %}
|
|
11
3
|
<div>
|
|
12
4
|
<h4>{{ _('Previous topic') }}</h4>
|
sphinx/themes/basic/search.html
CHANGED
|
@@ -1,12 +1,4 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/search.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Template for the search page.
|
|
6
|
-
|
|
7
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
:license: BSD, see LICENSE for details.
|
|
9
|
-
#}
|
|
1
|
+
{# Template for the search page. #}
|
|
10
2
|
{%- extends "layout.html" %}
|
|
11
3
|
{% set title = _('Search') %}
|
|
12
4
|
{%- block scripts %}
|
|
@@ -1,12 +1,4 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/searchbox.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Sphinx sidebar template: quick search box.
|
|
6
|
-
|
|
7
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
:license: BSD, see LICENSE for details.
|
|
9
|
-
#}
|
|
1
|
+
{# Sphinx sidebar template: quick search box. #}
|
|
10
2
|
{%- if pagename != "search" and builder != "singlehtml" %}
|
|
11
3
|
<search id="searchbox" style="display: none" role="search">
|
|
12
4
|
<h3 id="searchlabel">{{ _('Quick search') }}</h3>
|
|
@@ -1,14 +1,8 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/searchfield.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~~~~~~
|
|
1
|
+
{# Sphinx sidebar template: search field.
|
|
4
2
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
in the search field.
|
|
9
|
-
|
|
10
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
11
|
-
:license: BSD, see LICENSE for details.
|
|
3
|
+
This component is similar to searchbox.html but does not include an
|
|
4
|
+
extra heading ("Quick search"). Instead, it uses a placeholder text
|
|
5
|
+
in the search field.
|
|
12
6
|
#}
|
|
13
7
|
{%- if pagename != "search" and builder != "singlehtml" %}
|
|
14
8
|
<search id="searchbox" style="display: none" role="search">
|
|
@@ -1,12 +1,4 @@
|
|
|
1
|
-
{#
|
|
2
|
-
basic/sourcelink.html
|
|
3
|
-
~~~~~~~~~~~~~~~~~~~~~
|
|
4
|
-
|
|
5
|
-
Sphinx sidebar template: "show source" link.
|
|
6
|
-
|
|
7
|
-
:copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
:license: BSD, see LICENSE for details.
|
|
9
|
-
#}
|
|
1
|
+
{# Sphinx sidebar template: "show source" link. #}
|
|
10
2
|
{%- if show_source and has_source and sourcename %}
|
|
11
3
|
<div role="note" aria-label="source link">
|
|
12
4
|
<h3>{{ _('This Page') }}</h3>
|
|
@@ -1,12 +1,5 @@
|
|
|
1
1
|
/*
|
|
2
|
-
* basic.css
|
|
3
|
-
* ~~~~~~~~~
|
|
4
|
-
*
|
|
5
2
|
* Sphinx stylesheet -- basic theme.
|
|
6
|
-
*
|
|
7
|
-
* :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
|
|
8
|
-
* :license: BSD, see LICENSE for details.
|
|
9
|
-
*
|
|
10
3
|
*/
|
|
11
4
|
|
|
12
5
|
/* -- main layout ----------------------------------------------------------- */
|
|
@@ -115,15 +108,11 @@ img {
|
|
|
115
108
|
/* -- search page ----------------------------------------------------------- */
|
|
116
109
|
|
|
117
110
|
ul.search {
|
|
118
|
-
margin: 10px
|
|
119
|
-
padding: 0;
|
|
111
|
+
margin-top: 10px;
|
|
120
112
|
}
|
|
121
113
|
|
|
122
114
|
ul.search li {
|
|
123
|
-
padding: 5px 0
|
|
124
|
-
background-image: url(file.png);
|
|
125
|
-
background-repeat: no-repeat;
|
|
126
|
-
background-position: 0 7px;
|
|
115
|
+
padding: 5px 0;
|
|
127
116
|
}
|
|
128
117
|
|
|
129
118
|
ul.search li a {
|