python-docs-theme 2023.9__py3-none-any.whl → 2024.2__py3-none-any.whl

python_docs_theme/__init__.py

@@ -1,8 +1,10 @@
+from __future__ import annotations
+
 import hashlib
 import os
 from functools import lru_cache
 from pathlib import Path
-from typing import Any, Dict, List
+from typing import Any
 
 import sphinx.application
 from sphinx.builders.html import StandaloneHTMLBuilder
@@ -19,7 +21,7 @@ def _asset_hash(path: str) -> str:
     return f"{path}?digest={digest}"
 
 
-def _add_asset_hashes(static: List[str], add_digest_to: List[str]) -> None:
+def _add_asset_hashes(static: list[str], add_digest_to: list[str]) -> None:
     for asset in add_digest_to:
         index = static.index(asset)
         static[index].filename = _asset_hash(asset)  # type: ignore
@@ -29,7 +31,7 @@ def _html_page_context(
     app: sphinx.application.Sphinx,
     pagename: str,
     templatename: str,
-    context: Dict[str, Any],
+    context: dict[str, Any],
     doctree: Any,
 ) -> None:
     if app.config.html_theme != "python_docs_theme":

python_docs_theme/layout.html

@@ -14,7 +14,7 @@
           </li>
           {%- endfor %}
           {%- block rootrellink %}
-          <li><img src="{{ pathto('_static/py.svg', 1) }}" alt="python logo" style="vertical-align: middle; margin-top: -1px"/></li>
+          <li><img src="{{ pathto('_static/' ~ theme_root_icon, 1) }}" alt="{{ theme_root_icon_alt_text }}" style="vertical-align: middle; margin-top: -1px"/></li>
           <li><a href="{{theme_root_url}}">{{theme_root_name}}</a>{{ reldelim1 }}</li>
           <li class="switchers">
             <div class="language_switcher_placeholder"></div>
@@ -71,7 +71,7 @@
 
 {%- block extrahead -%}
     <link rel="stylesheet" href="{{ pathto('_static/pydoctheme_dark.css', 1) }}" media="(prefers-color-scheme: dark)" id="pydoctheme_dark_css">
-    <link rel="shortcut icon" type="image/png" href="{{ pathto('_static/' + theme_root_icon, 1) }}" />
+    <link rel="shortcut icon" type="image/png" href="{{ pathto('_static/' ~ theme_root_icon, 1) }}" />
     {%- if builder != "htmlhelp" %}
         {%- if not embedded %}
             <script type="text/javascript" src="{{ pathto('_static/copybutton.js', 1) }}"></script>
@@ -100,7 +100,7 @@
         </label>
         <span class="nav-items-wrapper">
             <a href="{{ theme_root_url }}" class="nav-logo">
-                <img src="{{ pathto('_static/py.svg', 1) }}" alt="Logo"/>
+                <img src="{{ pathto('_static/' ~ theme_root_icon, 1) }}" alt="{{ theme_root_icon_alt_text }}"/>
             </a>
             <span class="version_switcher_placeholder"></span>
             {%- if pagename != "search" and builder != "singlehtml" %}
@@ -121,7 +121,7 @@
             {%- if logo %}
             <p class="logo">
                 <a href="{{ pathto('index') }}">
-                <img class="logo" src="{{ pathto('_static/' + logo, 1)|e }}" alt="Logo"/>
+                <img class="logo" src="{{ pathto('_static/' ~ logo, 1)|e }}" alt="Logo"/>
                 </a>
             </p>
             {%- endif %}
@@ -143,6 +143,7 @@
     {% trans %}Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.{% endtrans %}
     <br />
     {% if theme_license_url %}{% trans license_file=theme_license_url %}See <a href="{{ license_file }}">History and License</a> for more information.{% endtrans %}<br />{% endif %}
+    {% if theme_hosted_on %}{% trans hosted_on=theme_hosted_on %}Hosted on {{ hosted_on }}.{% endtrans %}<br />{% endif %}
     <br />
 
     {% include "footerdonate.html" %}

python_docs_theme/static/menu.js

@@ -54,4 +54,4 @@ document.addEventListener("DOMContentLoaded", function () {
             closeMenu()
         }
     })
-})
+})

python_docs_theme/static/pydoctheme.css

@@ -29,6 +29,42 @@ pre {
     color: inherit;
 }
 
+/* Add underlines to links */
+a[href] {
+    text-decoration: underline 1px;
+}
+
+/* Increase the underline offset for code to avoid obscuring underscores */
+a[href]:has(> code) {
+    text-underline-offset: 0.25em;
+}
+
+/* No underline for navigation */
+a.headerlink,
+div.genindex-jumpbox a,
+div.modindex-jumpbox a,
+div#search-results a,
+div.sphinxsidebar a,
+div.toctree-wrapper a,
+div[role=navigation] a,
+table.contentstable a,
+table.indextable a {
+    text-decoration: none;
+}
+
+/* Except when hovered */
+div.genindex-jumpbox a:hover,
+div.modindex-jumpbox a:hover,
+div#search-results a:hover,
+div.sphinxsidebar a:hover,
+div.toctree-wrapper a:hover,
+div[role=navigation] a:hover,
+table.contentstable a:hover,
+table.indextable a:hover {
+    text-decoration: underline;
+    text-underline-offset: auto;
+}
+
 body {
     margin-left: 1em;
     margin-right: 1em;
@@ -177,7 +213,7 @@ div.body {
 
 div.body p, div.body dd, div.body li, div.body blockquote {
     text-align: left;
-    line-height: 1.4;
+    line-height: 1.6;
 }
 div.body h1, div.body h2, div.body h3, div.body h4, div.body h5, div.body h6 {
     margin: 0;
@@ -279,6 +315,10 @@ div.footer {
     margin-right: 10px;
 }
 
+div.footer a {
+    text-underline-offset: auto;
+}
+
 div.footer a:hover {
     color: #0095c4;
 }

python_docs_theme/static/pydoctheme_dark.css

@@ -60,6 +60,10 @@ span.highlighted {
     background-color: #616161;
 }
 
+.footnote:target {
+    background-color: #2c3e50;
+}
+
 /* Below for most things in text */
 
 dl.field-list > dt {

python_docs_theme/theme.conf

@@ -26,10 +26,12 @@ headlinkcolor = #aaaaaa
 codebgcolor = #eeffcc
 codetextcolor = #333333
 
+hosted_on =
 issues_url =
 license_url =
 root_name = Python
 root_url = https://www.python.org/
 root_icon = py.svg
+root_icon_alt_text = Python logo
 root_include_title = True
 copyright_url =

{python_docs_theme-2023.9.dist-info → python_docs_theme-2024.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-docs-theme
-Version: 2023.9
+Version: 2024.2
 Summary: The Sphinx theme for the CPython docs and related projects
 Author-email: PyPA <distutils-sig@python.org>
 Requires-Python: >=3.8
@@ -10,16 +10,16 @@ Classifier: Framework :: Sphinx :: Theme
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Python Software Foundation License
 Classifier: Operating System :: OS Independent
-Classifier: Topic :: Documentation
-Classifier: Topic :: Software Development :: Documentation
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Documentation
+Classifier: Topic :: Software Development :: Documentation
 Project-URL: Code, https://github.com/python/python-docs-theme
 Project-URL: Download, https://pypi.org/project/python-docs-theme/
 Project-URL: Homepage, https://github.com/python/python-docs-theme/
@@ -37,7 +37,7 @@ projects if you so choose, but please keep in mind that in doing so you're also
 choosing to accept some of the responsibility for maintaining that collective
 trust.
 
-To use the theme, install it into your docs build environment via ``pip`` 
+To use the theme, install it into your docs build environment via ``pip``
 (preferably in a virtual environment).
 
 
@@ -48,5 +48,12 @@ To use this theme, add the following to ``conf.py``:
 
 - ``html_theme = 'python_docs_theme'``
 
-- ``html_sidebars``, defaults taken from http://www.sphinx-doc.org/en/stable/config.html#confval-html_sidebars
+- ``html_sidebars``, defaults taken from https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_sidebars
+
+Preview
+-------
+
+See a demo of the CPython docs using this theme:
+
+- https://python-docs-theme-previews.readthedocs.io
 

python_docs_theme-2024.2.dist-info/RECORD

@@ -0,0 +1,18 @@
+python_docs_theme/__init__.py,sha256=lohzhV2LTSRLhxi0G8Emc_TkccarW1O4aYXvFGU1HR8,1814
+python_docs_theme/footerdonate.html,sha256=SVxLBvbrliqOzjau4SdhhtkRGXxX5ZrZN6Yr6luRhIQ,184
+python_docs_theme/layout.html,sha256=BiJLOd6L5GsmI81SPfOe2NfG1kB503eCxAylsk07trI,7775
+python_docs_theme/theme.conf,sha256=z6-gO0B0Lu7gdAW4RrNfUQCutmL8pHlZoQzjFZa5zAA,822
+python_docs_theme/static/copybutton.js,sha256=LSeNL29gDNKg3fv4rfcb8t-8xkH6HozpCbJXI9FuO6U,3508
+python_docs_theme/static/menu.js,sha256=JmrKD08_6CiCgQH32As9AgiSiV-th1fZInVrmTCihzA,2137
+python_docs_theme/static/py.png,sha256=rhc9xIQjUfwcilUa-9tYyyspVJB4ITDapPNZpqgNclY,695
+python_docs_theme/static/py.svg,sha256=WGW-i8wK-IhZSQPqARL2yNkjxXJsQIHoyFYRDMcznO8,2041
+python_docs_theme/static/pydoctheme.css,sha256=R1O74BqxlbtsxLYD7cElEKe3or2MRArqJVylcGLla1A,12050
+python_docs_theme/static/pydoctheme_dark.css,sha256=R_FU5JN8Jcx_0fOkSJlp2rWrd6GoGLyXHhULFyqdXno,2214
+python_docs_theme/static/search-focus.js,sha256=DwWV71ssKvrzagPenP7yLvFQCdyqFJirbBk1PFRvVoA,559
+python_docs_theme/static/sidebar.js_t,sha256=swTyAoy6dNGm6Ro0_iRl_9ujRrIz5nq207tMIqNnYgs,3350
+python_docs_theme/static/themetoggle.js,sha256=6D1LE0wg8DjPP776_KxPCxXdIk-gGJJX5DYpHFLG1Uw,779
+python_docs_theme-2024.2.dist-info/entry_points.txt,sha256=VqpxCWQkYo2DkZVV2D2vA9LKmexR1Yhicqsrff4JAag,58
+python_docs_theme-2024.2.dist-info/LICENSE,sha256=lx_9CsorlYBu9cw97FX-A1VnHHmrwk-H-jydZBJlWmY,2460
+python_docs_theme-2024.2.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+python_docs_theme-2024.2.dist-info/METADATA,sha256=X3HPbI1TNK8dTZ_KcbjzOp8qmiLCS1QSXUrZdT169vw,2265
+python_docs_theme-2024.2.dist-info/RECORD,,

python_docs_theme-2023.9.dist-info/RECORD

@@ -1,18 +0,0 @@
-python_docs_theme/__init__.py,sha256=rcPPT37dRpTSU2-k0p_wLP5yb29mG9zyyZ1AJmX6uO4,1790
-python_docs_theme/footerdonate.html,sha256=SVxLBvbrliqOzjau4SdhhtkRGXxX5ZrZN6Yr6luRhIQ,184
-python_docs_theme/layout.html,sha256=XgamCw_NhPPhbTqqmvkaMspYdtU7-PTYZcLnuXg6log,7583
-python_docs_theme/theme.conf,sha256=aWs-01gZecIovY1zNsGUNv7Z8fxjP9-GgiAlp5_rUhw,777
-python_docs_theme/static/copybutton.js,sha256=LSeNL29gDNKg3fv4rfcb8t-8xkH6HozpCbJXI9FuO6U,3508
-python_docs_theme/static/menu.js,sha256=jJvLLkbdnWWv4sUBZHNKf5-qck72pF-GDXMsVNPH1RY,2136
-python_docs_theme/static/py.png,sha256=rhc9xIQjUfwcilUa-9tYyyspVJB4ITDapPNZpqgNclY,695
-python_docs_theme/static/py.svg,sha256=WGW-i8wK-IhZSQPqARL2yNkjxXJsQIHoyFYRDMcznO8,2041
-python_docs_theme/static/pydoctheme.css,sha256=AlSyGY86UzJV_36GUYORPI6gazIBnLZP2WbzBanffsI,11200
-python_docs_theme/static/pydoctheme_dark.css,sha256=4K8pV4lsysDo2JR1CllPW8bvFG_iawAPGaf6H35rxlo,2161
-python_docs_theme/static/search-focus.js,sha256=DwWV71ssKvrzagPenP7yLvFQCdyqFJirbBk1PFRvVoA,559
-python_docs_theme/static/sidebar.js_t,sha256=swTyAoy6dNGm6Ro0_iRl_9ujRrIz5nq207tMIqNnYgs,3350
-python_docs_theme/static/themetoggle.js,sha256=6D1LE0wg8DjPP776_KxPCxXdIk-gGJJX5DYpHFLG1Uw,779
-python_docs_theme-2023.9.dist-info/entry_points.txt,sha256=VqpxCWQkYo2DkZVV2D2vA9LKmexR1Yhicqsrff4JAag,58
-python_docs_theme-2023.9.dist-info/LICENSE,sha256=lx_9CsorlYBu9cw97FX-A1VnHHmrwk-H-jydZBJlWmY,2460
-python_docs_theme-2023.9.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
-python_docs_theme-2023.9.dist-info/METADATA,sha256=SELD2lI5cX6LUDWw_pajqED9e0WaSsei3E-ZDvnUPaE,2124
-python_docs_theme-2023.9.dist-info/RECORD,,