python-docs-theme 2026.4__py3-none-any.whl → 2026.9__py3-none-any.whl

python_docs_theme/__init__.py

@@ -11,7 +11,7 @@ if TYPE_CHECKING:
     from sphinx.application import Sphinx
     from sphinx.util.typing import ExtensionMetadata
 
-__version__ = "2026.4"
+__version__ = "2026.9"
 
 THEME_PATH = Path(__file__).resolve().parent
 LOCALE_DIR = THEME_PATH / "locale"

python_docs_theme/layout.html

@@ -6,7 +6,7 @@
       <h3>{{ _('Navigation') }}</h3>
       <ul>
           {%- for rellink in rellinks %}
-          <li class="right" {% if loop.first %}style="margin-right: 10px"{% endif %}>
+          <li class="right" {% if loop.first %}style="margin-inline-end: 10px"{% endif %}>
               <a href="{{ pathto(rellink[0])|e }}" title="{{ rellink[1]|striptags|e }}"
                  {{ accesskey(rellink[2]) }}>{{ rellink[3] }}
               </a>
@@ -14,7 +14,7 @@
           </li>
           {%- endfor %}
           {%- block rootrellink %}
-          <li><img src="{{ pathto('_static/' ~ theme_root_icon, 1) }}" alt="{{ theme_root_icon_alt_text }}" style="vertical-align: middle; margin-top: -1px"></li>
+          <li class="root-icon"><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>
@@ -89,7 +89,7 @@
 {%- endblock -%}
 
 {%- block body_tag %}
-{{ super() }}
+<body{% if theme_is_rtl|tobool %} dir="rtl"{% endif %}>
 {%- if builder != 'htmlhelp' %}
 <div class="mobile-nav">
     <input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation"

python_docs_theme/static/pydoctheme.css

@@ -108,7 +108,7 @@ div.related a:hover {
 }
 
 .switchers > div {
-    margin-right: 5px;
+    margin-inline-end: 5px;
 }
 
 div.related ul::after {
@@ -117,6 +117,17 @@ div.related ul::after {
     display: block;
 }
 
+div.related ul {
+    padding: 0;
+    padding-inline-start: 10px;
+}
+
+body[dir='rtl'] div.related ul li.right {
+    float: left;
+    margin-right: 0;
+    margin-left: 5px;
+}
+
 .inline-search,
 form.inline-search input {
     display: inline;
@@ -142,6 +153,9 @@ span.pre {
 div.sphinxsidebar {
     display: flex;
     width: min(25vw, 350px);
+    flex-shrink: 0;
+    margin: 0;
+    order: 0;
     float: none;
     position: sticky;
     top: 0;
@@ -158,8 +172,14 @@ div.sphinxsidebar h4 {
     margin-top: 1.5em;
 }
 
-div.bodywrapper {
-    margin-left: min(25vw, 350px);
+div.document div.bodywrapper {
+    margin: 0;
+}
+
+div.documentwrapper {
+    flex: 1;
+    min-width: 0;
+    order: 1;
 }
 
 div.sphinxsidebarwrapper {
@@ -179,6 +199,11 @@ div.sphinxsidebarwrapper > ul > li > ul > li {
     margin-bottom: 0.4em;
 }
 
+div.sphinxsidebar ul ul {
+    margin-left: 0;
+    margin-inline-start: 20px;
+}
+
 div.sphinxsidebar a:hover {
     color: #0095c4;
 }
@@ -206,16 +231,23 @@ div.sphinxsidebar input[type='text'] {
     border-left: none;
 }
 
+body[dir='rtl'] #sidebarbutton {
+    border-radius: 5px 0 0 5px;
+    border-right: none;
+    border-left: none;
+}
+
 #sidebarbutton:hover {
     background-color: #AAAAAA;
 }
 
 div.body {
-    padding: 0 0 0 1.2em;
+    padding: 0;
+    padding-inline-start: 1.2em;
 }
 
 div.body p, div.body dd, div.body li, div.body blockquote {
-    text-align: left;
+    text-align: start;
     line-height: 1.6;
 }
 div.body h1, div.body h2, div.body h3, div.body h4, div.body h5, div.body h6 {
@@ -225,6 +257,10 @@ div.body h1, div.body h2, div.body h3, div.body h4, div.body h5, div.body h6 {
 }
 div.body dl.field-list > dt {
     line-height: 1.6;
+    padding-left: 0;
+    padding-right: 0;
+    padding-inline-start: 0.5em;
+    padding-inline-end: 5px;
 }
 
 div.body hr {
@@ -233,6 +269,22 @@ div.body hr {
     height: 1px;
 }
 
+body[dir='rtl'] {
+    & pre,
+    & code,
+    & div.highlight,
+    & dl > dt span ~ em,
+    & .sig,
+    & .sig-param {
+        direction: ltr;
+        unicode-bidi: isolate;
+    }
+}
+
+body[dir='rtl'] .sig {
+    text-align: right;
+}
+
 div.body pre {
     border-radius: 3px;
     border: 1px solid #ac9;
@@ -402,7 +454,7 @@ table.docutils th {
 
 table p,
 table li {
-    text-align: left !important;
+    text-align: start !important;
 }
 
 table.docutils th {
@@ -414,11 +466,37 @@ table.footnote td {
     border: 0 !important;
 }
 
+body[dir='rtl'] div#search-results,
+body[dir='rtl'] div#search-results ul.search li {
+    direction: rtl;
+    text-align: right;
+    unicode-bidi: isolate;
+}
+
+body[dir='rtl'] div#search-results ul.search li p {
+    text-align: right;
+}
+
+body[dir='rtl'] div.citation > span {
+    float: right;
+}
+
+body[dir='rtl'] aside.footnote > span {
+    float: right;
+    padding-right: 0;
+    padding-left: 0.5rem;
+}
+
+body[dir='rtl'] aside.footnote > p {
+    margin-left: 0;
+    margin-right: 2rem;
+}
+
 div.footer {
     line-height: 150%;
-    text-align: right;
+    text-align: end;
     width: auto;
-    margin-right: 10px;
+    margin-inline-end: 10px;
 }
 
 div.footer a {
@@ -476,18 +554,17 @@ div.footer a:hover {
     color: var(--threadsafety-atomic);
 }
 
-
 dl > dt span ~ em,
 .sig {
     font-family: Menlo, Consolas, Monaco, Liberation Mono, Lucida Console, monospace;
 }
 
 .toctree-wrapper ul {
-    padding-left: 20px;
+    padding-inline-start: 20px;
 }
 
 .theme-selector {
-    margin-left: .5em;
+    margin-inline-start: .5em;
 }
 
 div.genindex-jumpbox,
@@ -506,17 +583,17 @@ div.genindex-jumpbox a {
     cursor: pointer;
     position: absolute;
     top: 0;
-    right: 0;
+    right: 0; /* physical right; always, even in RTL, since code is LTR */
     font-family: Menlo, Consolas, Monaco, Liberation Mono, Lucida Console, monospace;
     font-size: 80%;
     padding-left: .5em;
     padding-right: .5em;
     height: 100%;
     max-height: min(100%, 2.4em);
-    border-radius: 0 3px 0 0;
+    border-radius: 0 3px 0 0; /* physical — top-right corner, always */
     color: #000;
     background-color: #fff;
-    border: 1px solid #ac9; /* follows div.body pre */
+    border: 1px solid #ac9;
     display: none;
 }
 
@@ -564,10 +641,16 @@ div.genindex-jumpbox a {
         margin-inline-start: 1rem;
         margin-inline-end: 0;
     }
-    /* Remove sidebar and top related bar */
-    div.related, div.sphinxsidebar {
+    /* Remove sidebar and desktop-only related controls */
+    div.related li.right, div.related li.switchers, div.sphinxsidebar {
+        display: none;
+    }
+    div.related .root-icon, div.related .root-icon + li {
         display: none;
     }
+    div.related {
+        line-height: 1.3;
+    }
     /* Anchorlinks are not hidden by fixed-positioned navbar when scrolled to */
     html {
         scroll-padding-top: 40px;
@@ -583,7 +666,7 @@ div.genindex-jumpbox a {
         width: 100%;
         position: fixed;
         top: 0;
-        left: 0;
+        inset-inline-start: 0;
         box-shadow: rgba(0, 0, 0, 0.25) 0 0 2px 0;
         z-index: 1;
     }
@@ -605,7 +688,7 @@ div.genindex-jumpbox a {
         align-items: stretch;
     }
     .nav-logo {
-        margin-right: 1rem;
+        margin-inline-end: 1rem;
         flex-shrink: 0;
         align-self: center;
     }
@@ -614,7 +697,7 @@ div.genindex-jumpbox a {
         width: 20px;
     }
     .version_switcher_placeholder {
-        margin-right: 1rem;
+        margin-inline-end: 1rem;
     }
     .version_switcher_placeholder > select {
         height: 100%;
@@ -624,10 +707,11 @@ div.genindex-jumpbox a {
         flex: auto;
         border: 1px solid #a9a9a9;
         align-items: stretch;
+        position: relative;
     }
     .nav-content .search input[type=search] {
         border: 0;
-        padding-left: 24px;
+        padding-inline-start: 24px;
         width: 100%;
         flex: 1;
     }
@@ -635,14 +719,15 @@ div.genindex-jumpbox a {
         height: 100%;
         box-shadow: none;
         border: 0;
-        border-left: 1px solid #a9a9a9;
+        border-inline-start: 1px solid #a9a9a9;
         cursor: pointer;
-        margin-right: 0;
+        margin-inline-end: 0;
     }
     .nav-content .search svg {
         position: absolute;
-        align-self: center;
-        padding-left: 4px;
+        top: 50%;
+        transform: translateY(-50%);
+        inset-inline-start: 4px;
     }
     .toggler__input {
         display: none;
@@ -674,7 +759,7 @@ div.genindex-jumpbox a {
         width: 100%;
         background: inherit;
         position: absolute;
-        left: 0;
+        inset-inline-start: 0;
         top: -8px;
     }
     .toggler__label > span::after {
@@ -695,7 +780,7 @@ div.genindex-jumpbox a {
     }
     .toggler__input:checked ~ .menu-wrapper {
         visibility: visible;
-        left: 0;
+        transform: translateX(0);
     }
 
     /* Sliding side menu */
@@ -703,8 +788,9 @@ div.genindex-jumpbox a {
         display: block;
         position: fixed;
         top: 0;
-        transition: left 400ms ease;
-        left: -310px;
+        inset-inline-start: 0;
+        transition: transform 400ms ease;
+        transform: translateX(calc(-100% - 10px));
         width: 300px;
         height: 100%;
         background-color: #eee;
@@ -712,12 +798,18 @@ div.genindex-jumpbox a {
         box-shadow: 0 0 10px rgba(0, 0, 0, 0.2);
         overflow-y: auto;
     }
+    body[dir='rtl'] .menu-wrapper {
+        transform: translateX(100%);
+    }
     .menu-wrapper.open {
         visibility: visible;
-        left: 0;
+        transform: translateX(0);
     }
     .menu {
-        padding: 40px 10px 30px 20px;
+        padding-block-start: 40px;
+        padding-inline-end: 10px;
+        padding-block-end: 30px;
+        padding-inline-start: 20px;
     }
     .menu-wrapper h3,
     .menu-wrapper h4 {
@@ -742,10 +834,10 @@ div.genindex-jumpbox a {
         list-style: none;
         line-height: 1.4;
         overflow-wrap: break-word;
-        padding-left: 0;
+        padding-inline-start: 0;
     }
     .menu ul ul {
-        margin-left: 20px;
+        margin-inline-start: 20px;
         list-style: square;
     }
     .menu ul li {
@@ -801,26 +893,26 @@ div.versionadded,
 div.versionchanged,
 div.deprecated,
 div.deprecated-removed {
-    border-left: 3px solid;
+    border-inline-start: 3px solid;
     padding: 0 1rem;
 }
 
 div.versionadded {
-    border-left-color: var(--versionadded-border);
+    border-inline-start-color: var(--versionadded-border);
 }
 
 div.versionchanged {
-    border-left-color: var(--versionchanged-border);
+    border-inline-start-color: var(--versionchanged-border);
 }
 
 div.deprecated,
 div.deprecated-removed,
 div.versionremoved {
-    border-left-color: var(--deprecated-border);
+    border-inline-start-color: var(--deprecated-border);
 }
 
 div.soft-deprecated {
-    border-left-color: var(--soft-deprecated-border);
+    border-inline-start-color: var(--soft-deprecated-border);
 }
 
 div.versionadded .versionmodified {

python_docs_theme/static/pydoctheme_dark.css

@@ -49,7 +49,7 @@ div.body a {
 }
 
 div.body a:visited {
-    color: #09e;
+    color: #bf95f9;
 }
 
 a.headerlink:hover {

python_docs_theme/theme.toml

@@ -27,6 +27,7 @@ headbgcolor = "white"
 headlinkcolor = "#aaaaaa"
 codebgcolor = "#eeffcc"
 codetextcolor = "#333333"
+is_rtl = "false"
 
 hosted_on = ""
 issues_url = ""

{python_docs_theme-2026.4.dist-info → python_docs_theme-2026.9.dist-info}/METADATA

@@ -1,11 +1,14 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: python-docs-theme
-Version: 2026.4
+Version: 2026.9
 Summary: The Sphinx theme for the CPython docs and related projects
+Project-URL: Issue tracker, https://github.com/python/python-docs-theme/issues
+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/
 Author: Python Docs Sphinx Theme maintainers
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
 License-Expression: PSF-2.0
+License-File: LICENSE
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Framework :: Sphinx :: Theme
 Classifier: Intended Audience :: Developers
@@ -18,12 +21,9 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Documentation
 Classifier: Topic :: Software Development :: Documentation
-License-File: LICENSE
+Requires-Python: >=3.12
 Requires-Dist: sphinx>=7.3
-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/
-Project-URL: Issue tracker, https://github.com/python/python-docs-theme/issues
+Description-Content-Type: text/markdown
 
 # Python Docs Sphinx Theme
 
@@ -49,6 +49,8 @@ To use this theme, add the following to `conf.py`:
 
 - `html_sidebars`, defaults taken from https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_sidebars
 
+- To lay pages out right-to-left for languages such as Persian, Arabic, or Hebrew,
+  set `html_theme_options = {"is_rtl": True}`. Defaults to `false`.
 
 ## Translation
 
@@ -65,4 +67,3 @@ See a demo of the CPython docs using this theme:
 The kitchen sink is a showcase of every Sphinx feature:
 
 - https://sphinx-themes.org/sample-sites/python-docs-theme/kitchen-sink/
-

python_docs_theme-2026.9.dist-info/RECORD

@@ -0,0 +1,36 @@
+python_docs_theme/__init__.py,sha256=kIzoCeuTl6CAmVzpATjcSlZs2R01UpQeVJH1lhXXDHo,1326
+python_docs_theme/footerdonate.html,sha256=-FO52fS7x4iqjtMD9un5b--rPED2BPlcug9gkUMW2Uk,182
+python_docs_theme/layout.html,sha256=dmipCz6BRLV44wtej6tiSAVBq5iyJ_3Qrpla3L6Ra9o,7932
+python_docs_theme/theme.toml,sha256=mx4MnUZ9Pdqu-SzLd87nCj9PuJKztrT9b3XNu0lPQZA,1156
+python_docs_theme/locale/ar/LC_MESSAGES/python-docs-theme.mo,sha256=c_k3YW3inWCIF__WWNMYimYSw_CP16FwXnsHxYUKM7Y,2567
+python_docs_theme/locale/de/LC_MESSAGES/python-docs-theme.mo,sha256=9Q1Iy5JFDYRFHbuJrIk9sNKZ2RgnQqzylnLc-e7rK9k,2188
+python_docs_theme/locale/el/LC_MESSAGES/python-docs-theme.mo,sha256=ORoaqG_pJti8YPMoIVA8g9ch5BNGaYabuwgKj5fo8XE,2704
+python_docs_theme/locale/es/LC_MESSAGES/python-docs-theme.mo,sha256=B6zSMsN_E7CZ98ZFWIMktiwQEEipSANYGuJpYBh8X9A,2221
+python_docs_theme/locale/fa/LC_MESSAGES/python-docs-theme.mo,sha256=f-aiyBCL2ALVBHTKlnMVQpoPmbcdPZRpUEjkv7gG8E8,2479
+python_docs_theme/locale/fr/LC_MESSAGES/python-docs-theme.mo,sha256=mrMmUdxXgZ9MORb30-WXkhDs2dLkta0HPeq9K4AKDv8,2199
+python_docs_theme/locale/id/LC_MESSAGES/python-docs-theme.mo,sha256=QrIphqs76GNfsuNZlQ9HTk04qwWtFK-zrwx4Ml2D5hA,2161
+python_docs_theme/locale/ja/LC_MESSAGES/python-docs-theme.mo,sha256=-juCRDY-2V12ek14AFFW23ZQ-Ybm8YMuENmwavlZhw0,2359
+python_docs_theme/locale/ko/LC_MESSAGES/python-docs-theme.mo,sha256=BmsubzJAc343mKBrmU1EIcjs7Dpf_ECjpsQQOVqYS9w,2451
+python_docs_theme/locale/pl/LC_MESSAGES/python-docs-theme.mo,sha256=d68WBu3wOABlfIKWrfSpfH3HJPEKK828I9uPr6tIILY,2321
+python_docs_theme/locale/pt/LC_MESSAGES/python-docs-theme.mo,sha256=Seb0DXDl84oti1HRRWdwyLL25JIkL3LkcxyvcDbGYxE,2316
+python_docs_theme/locale/pt_BR/LC_MESSAGES/python-docs-theme.mo,sha256=t-EK0qUq-OeDqOR7-V0V7v8UREeuoHkzkWdlNSzmTUI,2345
+python_docs_theme/locale/ro/LC_MESSAGES/python-docs-theme.mo,sha256=NRCuM3hLVtrJNeCsgM71YP0RL1aVRgtkIiTS4funhDA,2409
+python_docs_theme/locale/ru/LC_MESSAGES/python-docs-theme.mo,sha256=4RjT31dBscizf4IHZmWv9PuoaKWfzHWKmlBsw_b80Uw,2706
+python_docs_theme/locale/sv/LC_MESSAGES/python-docs-theme.mo,sha256=wMtfsR9EUPSb919JaqAhSDTVMnirvZ0UeuM-IPGq5Gg,2109
+python_docs_theme/locale/ta/LC_MESSAGES/python-docs-theme.mo,sha256=bpjuW5SkRP0PcYRH7eyzQUxyAneD3u5tEGgoswP-mWQ,3099
+python_docs_theme/locale/tr/LC_MESSAGES/python-docs-theme.mo,sha256=vyjYbb83kUnPN8FE8V--1QdTO4R8hahn5OYe5XGaPh0,2238
+python_docs_theme/locale/vi/LC_MESSAGES/python-docs-theme.mo,sha256=HVD-7EII2apqTPHm9jonKKn3sBYQSLVQLjAGR4wncp4,2327
+python_docs_theme/locale/zh_CN/LC_MESSAGES/python-docs-theme.mo,sha256=FmRfTlxCeA-ZN0XcZlzkjaTFe4OmMdLJCdDzGVR5OKM,2146
+python_docs_theme/locale/zh_TW/LC_MESSAGES/python-docs-theme.mo,sha256=QxGiKPBnRjEyoxgA3PsY8PjZFdaO1ix-RfVWvKjAtUg,2144
+python_docs_theme/static/copybutton.js,sha256=Fg9_Xc0kpFuFilfWpBQa7cDmXEsybvrmnawdf3Gskyo,3055
+python_docs_theme/static/menu.js,sha256=JmrKD08_6CiCgQH32As9AgiSiV-th1fZInVrmTCihzA,2137
+python_docs_theme/static/py.svg,sha256=WGW-i8wK-IhZSQPqARL2yNkjxXJsQIHoyFYRDMcznO8,2041
+python_docs_theme/static/pydoctheme.css,sha256=aU4ahVqcnIJdqlWQyIfGxkHNxVPyIGtLMa7UL7bnEsw,19116
+python_docs_theme/static/pydoctheme_dark.css,sha256=k4Rf3aGG6HjceEVludr-VkOjTgzKxog3htAbasfKV9A,3669
+python_docs_theme/static/search-focus.js,sha256=DwWV71ssKvrzagPenP7yLvFQCdyqFJirbBk1PFRvVoA,559
+python_docs_theme/static/themetoggle.js,sha256=6D1LE0wg8DjPP776_KxPCxXdIk-gGJJX5DYpHFLG1Uw,779
+python_docs_theme-2026.9.dist-info/METADATA,sha256=skDizUEkdefk77Ohnw3cOaO1-FTAAw-rTbMlcPdFzMc,2681
+python_docs_theme-2026.9.dist-info/WHEEL,sha256=THafob7ofN-NsuMN7Mg4qZyHaQI7KkD-QlcQatYhXPo,87
+python_docs_theme-2026.9.dist-info/entry_points.txt,sha256=7oxZn4fKx-vAoSyXWoJuJp3XYwgjqv61YQzNqgnD_oE,59
+python_docs_theme-2026.9.dist-info/licenses/LICENSE,sha256=lx_9CsorlYBu9cw97FX-A1VnHHmrwk-H-jydZBJlWmY,2460
+python_docs_theme-2026.9.dist-info/RECORD,,

{python_docs_theme-2026.4.dist-info → python_docs_theme-2026.9.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: flit 3.12.0
+Generator: hatchling 1.32.3
 Root-Is-Purelib: true
 Tag: py3-none-any

python_docs_theme-2026.9.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[sphinx.html_themes]
+python_docs_theme = python_docs_theme