1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
|
# Changelog
## [2026.3](https://github.com/python/python-docs-theme/releases/tag/2026.3)
* Add colors for new thread-safety levels by @lysnikolaou in https://github.com/python/python-docs-theme/pull/299
## [2026.2](https://github.com/python/python-docs-theme/releases/tag/2026.2)
* Style codeblock `:caption:` by @StanFromIreland in https://github.com/python/python-docs-theme/pull/288
* Enable copy button for shell sessions and consoles by @hugovk in https://github.com/python/python-docs-theme/pull/295
* Add colors for thread safety annotations by @lysnikolaou in https://github.com/python/python-docs-theme/pull/297
## [2025.12](https://github.com/python/python-docs-theme/releases/tag/2025.12)
* Add support for green, red and yellow side borders for code examples by @hugovk in https://github.com/python/python-docs-theme/pull/285
* Add Portuguese translation by @NyaPuma in https://github.com/python/python-docs-theme/pull/281
* Add support for Python 3.15 by @hugovk in https://github.com/python/python-docs-theme/pull/282
* Convert CHANGELOG and CONTRIBUTING from .rst to .md by @hugovk in https://github.com/python/python-docs-theme/pull/277
* Add zizmor to CI and fix findings by @hugovk in https://github.com/python/python-docs-theme/pull/283
## [2025.10](https://github.com/python/python-docs-theme/releases/tag/2025.10)
* Add Romanian translation by @octaG-M in https://github.com/python/python-docs-theme/pull/272
* Add Arabic and Russian translations by @StanFromIreland in https://github.com/python/python-docs-theme/pull/274
* Add French translation by @JulienPalard in https://github.com/python/python-docs-theme/pull/275
* Update authors in `pyproject.toml` by @StanFromIreland in https://github.com/python/python-docs-theme/pull/271
* Add link to devguide in README by @StanFromIreland in https://github.com/python/python-docs-theme/pull/266
## [2025.9.2](https://github.com/python/python-docs-theme/releases/tag/2025.9.2)
* Add Korean and Indonesian translations from Transifex in https://github.com/python/python-docs-theme/pull/264
* Add German translation by @cmaureir in https://github.com/python/python-docs-theme/pull/262
* Fix compilation of translations and loading of translations on pages with html
source in https://github.com/python/python-docs-theme/pull/263
* Fix search button cutting off long translations in https://github.com/python/python-docs-theme/pull/268
* Fix `Copy` button copying line numbers by @StanFromIreland in https://github.com/python/python-docs-theme/pull/270
## [2025.9.1](https://github.com/python/python-docs-theme/releases/tag/2025.9.1)
* Add Japanese, Turkish and Spanish translations from Transifex in https://github.com/python/python-docs-theme/pull/259
## [2025.9](https://github.com/python/python-docs-theme/releases/tag/2025.9)
* Enable theme translation and add Polish by @StanFromIreland in https://github.com/python/python-docs-theme/pull/246
* Add Greek translation by @lysnikolaou and @skpanagiotis in https://github.com/python/python-docs-theme/pull/256 and https://github.com/python/python-docs-theme/pull/257
* Add Swedish translation by @yeager in https://github.com/python/python-docs-theme/pull/250
* Add Brazilian Portuguese, Simplified Chinese and Traditional Chinese translations from [Transifex](https://explore.transifex.com/python-doc/python-docs-theme/) in https://github.com/python/python-docs-theme/pull/253
## [2025.5](https://github.com/python/python-docs-theme/releases/tag/2025.5)
* Make the copy button only appear when hovered over or clicked on by @kevteg in https://github.com/python/python-docs-theme/pull/243
## [2025.4.1](https://github.com/python/python-docs-theme/releases/tag/2025.4.1)
* Fix copy button with multiple tracebacks by @tomasr8 in https://github.com/python/python-docs-theme/pull/240
## [2025.4](https://github.com/python/python-docs-theme/releases/tag/2025.4)
* Require Sphinx 7.3 by @AA-Turner in https://github.com/python/python-docs-theme/pull/221
* Add support for Python 3.14 by @hugovk https://github.com/python/python-docs-theme/pull/236
* Drop support for Python 3.10 and 3.11 by @hugovk in https://github.com/python/python-docs-theme/pull/234
* Add a copy button to code samples by @tomasr8 in https://github.com/python/python-docs-theme/pull/231
* Add missing i18n for copy button titles by @tomasr8 in https://github.com/python/python-docs-theme/pull/225
* Use consistent line-height for light & dark theme by @tomasr8 in https://github.com/python/python-docs-theme/pull/227
* Remove self-closing tags by @hugovk in https://github.com/python/python-docs-theme/pull/226
* Replace deprecated classifier with licence expression (PEP 639) by @hugovk in https://github.com/python/python-docs-theme/pull/237
## [2025.2](https://github.com/python/python-docs-theme/releases/tag/2025.2)
- Note minimum requirements for Sphinx (#216)
Contributed by Adam Turner
- Horizontally centre the sidebar collapse button (#219)
Contributed by Tomas Roun
- Make sidebar width more flexible (#218)
Contributed by Tomas Roun
- Set `__version__` in the runtime package (#222)
Contributed by Adam Turner
## [2024.12](https://github.com/python/python-docs-theme/releases/tag/2024.12)
- Hide header and search bar when printing (#204)
Contributed by Hugo van Kemenade
## [2024.10](https://github.com/python/python-docs-theme/releases/tag/2024.10)
- Add support for Python 3.13 (#196)
Contributed by Hugo van Kemenade
- Drop support for Python 3.8 (#197)
Contributed by Hugo van Kemenade
- Add script for handling translations (#195)
Contributed by Rafael Fontenelle
- Generate digital attestations for PyPI (PEP 740) (#198)
Contributed by Hugo van Kemenade
## [2024.6](https://github.com/python/python-docs-theme/releases/tag/2024.6)
- Add backgrounds and borders to admonitions (#190)
Contributed by Hugo van Kemenade
- Use different colour for 'Return value: Borrowed reference' (#188)
Contributed by Hugo van Kemenade
## [2024.4](https://github.com/python/python-docs-theme/releases/tag/2024.4)
- Add colour to version change directives (#185)
Contributed by Hugo van Kemenade
- Only show 'Last updated on ...' when `last_updated` defined (#183)
Contributed by Hugo van Kemenade
- Use system font stack for all code (#186)
Contributed by Hugo van Kemenade
## [2024.3](https://github.com/python/python-docs-theme/releases/tag/2024.3)
- Modernise font: use system font stack to improve text readability and webpage performance (#174)
Contributed by Hugo van Kemenade
- Remove incorrect CSS property (#178)
Contributed by Kerim Kabirov
## [2024.2](https://github.com/python/python-docs-theme/releases/tag/2024.2)
- Do not underline navigation links (#169)
Contributed by Hugo van Kemenade
- Only apply underline offset to code formatting for underline visibility (#171)
Contributed by Hugo van Kemenade
## [2024.1](https://github.com/python/python-docs-theme/releases/tag/2024.1)
- Underline links for readability and a11y (#160, #166)
Contributed by Hugo van Kemenade
- Add `hosted_on` variable for a link in the footer (#165)
Contributed by Hugo van Kemenade
- Consistently reference `theme_root_icon` (#163)
Contributed by Marko Budiselic
- Dark mode: fix contrast of footer highlight (#162)
Contributed by Hugo van Kemenade
## [2023.9](https://github.com/python/python-docs-theme/releases/tag/2023.9)
- Focus search box when pressing slash (#153)
Contributed by Hugo van Kemenade
## [2023.8](https://github.com/python/python-docs-theme/releases/tag/2023.8)
- Add Python 3.12 and 3.13 classifiers (#147)
Contributed by Hugo van Kemenade
- Dark mode: Also give aside.topic a dark background (#150)
Contributed by Hugo van Kemenade
- Restore the menu on mobile devices (inadvertently broken in 2023.7) (#146)
Contributed by Hugo van Kemenade
## [2023.7](https://github.com/python/python-docs-theme/releases/tag/2023.7)
- Fix compatibility with Sphinx 7.1 (#137)
Contributed by Pradyun Gedam
- Enable the slash keypress to focus the search field (#141)
Contributed by Mike Fiedler
- Sphinx 6.2 fix: add `nav.contents` where `div.topic` is used (#138)
Contributed by Hugo van Kemenade
- Dark mode: fix contrast for C++ specific styling (#133)
Contributed by Hugo van Kemenade
- Don't let long code literals extend beyond the right side of the screen (#139)
Contributed by Hugo van Kemenade
- Test with Python 3.12 (#140)
Contributed by Hugo van Kemenade
## [2023.5](https://github.com/python/python-docs-theme/releases/tag/2023.5)
- Add a dark theme. (#44)
Contributed by Nils K
- Fix: Remove searchbox id from form. (fixes #117)
Contributed by Nils K
- Update `python-docs-theme` to work with Sphinx 5 & 6. (#99 & #127)
Contributed by Adam Turner
- Override font for `.sig` for consistency with other code blocks. (#121)
Contributed by Chris Warrick
- Dark mode: add class to invert image brightness. (#128)
Contributed by Hugo van Kemenade
## [2023.3.1](https://github.com/python/python-docs-theme/releases/tag/2023.3.1)
- Skip cache-busting for old Sphinx #113
## [2023.3](https://github.com/python/python-docs-theme/releases/tag/2023.3)
- Fix problem with monospace rendering in Vivaldi #104
- Fix mobile nav obstructing content #96
- Reduce footer margin only for desktop #106
- Append a hash ?digest to CSS files for cache-busting #108
## [2022.1](https://github.com/python/python-docs-theme/releases/tag/2022.1)
- Add a configuration for license URL. (#90)
- Exclude the floating navbar from CHM help. (#84)
- Make sidebar scrollable and sticky (on modern browsers) (#91)
## [2021.11.1](https://github.com/python/python-docs-theme/releases/tag/2021.11.1)
- Fix monospace again, on buggy Google Chrome (#87)
Contributed by Tushar Sadhwani
## [2021.11](https://github.com/python/python-docs-theme/releases/tag/2021.11)
- Fix monospace on buggy Google Chrome (#85)
Contributed by Tushar Sadhwani
## [2021.8](https://github.com/python/python-docs-theme/releases/tag/2021.8)
- Add the copyright_url variable in the theme (#67)
Contributed by jablonskidev
- Improve readability (#79)
Contributed by Olga Bulat
- Remove #searchbox on mobile to fix a layout bug (#76)
Contributed by Olga Bulat
- Fix the appearance of version/language selects (#74)
Contributed by Olga Bulat
## [2021.5](https://github.com/python/python-docs-theme/releases/tag/2021.5)
- Make the theme responsive (#46)
Contributed by Olga Bulat.
- Use Python 3.8 for the Github Actions (#71)
Contributed by Stéphane Wirtel.
- Use default pygments theme (#68)
Contributed by Aaron Carlisle.
- Test Github action to validate the theme against docsbuild scripts. (#69)
Contributed by Julien Palard.
- Add the copy button to pycon3 highlighted code blocks. (#64)
Contributed by Julien Palard.
## [2020.12](https://github.com/python/python-docs-theme/releases/tag/v2020.12)
- Updated the readme, to remind user to install the package in a virtual environment. (#41)
Contributed by Mariatta.
- Updated the package url, using the GitHub repository instead of docs.python.org (#49)
Contributed by Pradyun Gedam.
- Added license information to the footer of the doc (#36)
Contributed by Todd.
- Fixed typo in the footer (#52)
Contributed by Dominic Davis-Foster.
- Added information on how to use the package (#32)
Contributed by Tapasweni Pathak.
- Fixed code formatting (#53).
Contributed by Hugo van Kemenade.
- Fixed code bgcolor and codetextcolor for Sphinx 3.1.0+ (#57)
Contributed by Zhiming Wang.
## 2018.7
Corresponds to [44a8f30](https://github.com/python/python-docs-theme/commit/44a8f306db9ec86d277a8a687538d5d51e415130)
## [2018.2](https://github.com/python/python-docs-theme/releases/tag/2018.2)
Initial release.
|
