Weilin Du
0b62523959
gh-101100: Fix Sphinx warnings in library/email.compat32-message.rst ( #136323 )
2025-07-07 19:28:44 +03:00
sobolevn
0a33221594
gh-101100: Fix sphinx warnings in whatsnew/3.9
( #136163 )
2025-07-07 13:41:11 +03:00
Adam Turner
b265a7ddeb
GH-134848: Use a set to store `AuditEvents.sources
` ( #134849 )
2025-05-28 17:30:53 +01:00
Hugo van Kemenade
bb244fd33d
Consistent sentence case in docs template files ( #134412 )
2025-05-22 12:51:02 +03:00
Yuki Kobayashi
f3acbb72ff
gh-101100: Fix Sphinx warnings in library/decimal.rst
( #134303 )
2025-05-20 17:46:13 +03:00
Maciej Olko
0afbd4e42a
Docs: remove link elements in builders other than HTML ( #133720 )
...
Fixes epub build
2025-05-14 10:03:07 -04:00
Hugo van Kemenade
942673ed19
Finishing touches to update main
branch for 3.15 ( #133588 )
2025-05-07 20:46:41 +03:00
Hugo van Kemenade
5f01b00dea
Python 3.14.0b1
2025-05-06 18:32:57 +03:00
Ee Durbin
1d529cbc89
Docs: Migrate entirely to PSF hosted plausible for analytics ( #132648 )
2025-04-17 22:42:40 +03:00
Adam Turner
4f10b93d1b
Docs: Synchronise `indexsidebar.html
` with docsbuild-scripts ( #132567 )
2025-04-15 23:27:01 +01:00
Yuki Kobayashi
fc7e4e7bbd
gh-101100: Fix sphinx warnings in library/plistlib.rst
( #132422 )
2025-04-13 18:35:26 +00:00
Ee Durbin
40844164b1
Add psfhosted Plausible instance to analytics ( #132252 )
2025-04-08 10:37:42 +03:00
Stan Ulbrych
f5639d87f5
gh-130521: Add Open Graph meta tags to template pages ( #130523 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-04-07 21:58:50 +01:00
Hugo van Kemenade
ce724571b3
Docs HTML: Remove self-closing tags ( #132220 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-04-07 18:21:13 +03:00
Adam Turner
443c0cd17c
gh-127833: Use productionlist
nodes to implement the grammar-snippet
directive ( #130376 )
...
Co-authored-by: Petr Viktorin <encukou@gmail.com>
Co-authored-by: Blaise Pabon <blaise@gmail.com>
2025-03-20 15:35:20 +00:00
Adam Turner
c1a02f9101
GH-121970: Extract pydoc_topics
into a new extension ( #131256 )
2025-03-19 18:35:11 +00:00
Hugo van Kemenade
ca1bedc9a4
gh-121970: Revert "GH-121970: Extract `pydoc_topics
` into a new extension ( #129116 )" ( #131245 )
...
Revert "GH-121970: Extract ``pydoc_topics`` into a new extension (#129116 )"
This reverts commit 01bcf13a1c
.
2025-03-14 16:25:56 +02:00
Yuki Kobayashi
7cc99a54b7
gh-101100: Fix sphinx warnings in library/asyncio-subprocess.rst
( #130994 )
2025-03-10 12:38:08 +00:00
Yuki Kobayashi
a105f99019
gh-101100: Fix sphinx warnings in library/email.errors.rst
( #130774 )
2025-03-03 11:56:45 +02:00
Victorien
373eb1b47a
gh-101100: Fix Sphinx documentation warnings in collections.rst
( #130629 )
2025-03-03 11:46:38 +02:00
Adam Turner
043ab3af9a
GH-121970: Extract `issue_role
` into a new extension ( #130615 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2025-02-27 19:06:13 +00:00
Adam Turner
3f3e1c4095
Doc: Strip trailing whitespace in `pydoc_topics
` ( #130492 )
2025-02-26 20:10:55 +00:00
sobolevn
5ec4bf86b7
gh-121970: Replace .. coroutine{method,function}
with :async:
( #130448 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-02-22 17:54:43 +00:00
Adam Turner
30e892473e
GH-121970: Replace custom abstract method directive with the `:abstract:
` option ( #129311 )
2025-02-22 01:53:57 +00:00
Yuki Kobayashi
3bda821a83
gh-101100: Fix sphinx warnings in readline.rst
( #130300 )
2025-02-20 14:56:27 +02:00
Yuki Kobayashi
1da412e574
gh-101100: Docs: Fix some typos in the document ( #129988 )
...
Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
2025-02-11 13:06:32 +02:00
Adam Turner
4d56c40440
GH-121970: Extract `implementation_detail
` into a new extension ( #129663 )
2025-02-06 16:53:27 +00:00
Petr Viktorin
58a4357e29
gh-127833: Docs: Add a grammar-snippet
directive & replace productionlist
(GH-127835)
...
As a first step toward aligning the grammar documentation with Python's actual
grammar, this overrides the ReST `productionlist` directive to:
- use `:` instead of the `::=` symbol
- add syntax highlighting for strings (using a Pygments highlighting class)
All links and link targets should be preserved. (Unfortunately, this reaches
into some Sphinx internals; I don't see a better way to do exactly what
Sphinx does.)
This also adds a new directive, `grammar-snippet`, which formats the snippet
almost exactly like what's in the source, modulo syntax highlighting and
keeping the backtick character to mark links to other rules.
This will allow formatting the snippets as in the grammar file
(file:///home/encukou/dev/cpython/Doc/build/html/reference/grammar.html).
The new directive is applied to two simple rules in toplevel_components.rst
---------
Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: William Ferreira <wqferr@gmail.com>
Co-authored-by: bswck <bartoszpiotrslawecki@gmail.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-02-05 16:12:23 +01:00
Adam Turner
ae4788809d
GH-121970: Extract `misc_news
` into a new extension ( #129577 )
2025-02-02 16:17:02 +00:00
Adam Turner
0612a89ffc
gh-126609: Allow translating the `availability
` directive ( #129549 )
2025-02-02 16:12:01 +00:00
Adam Turner
0ef8d470b7
GH-121970: Remove pyspecific `PyDecoratorMixin
` patches ( #129306 )
2025-01-26 03:43:23 +00:00
Adam Turner
d40692db06
GH-125722: Remove Sphinx patches ( #129277 )
2025-01-25 03:47:55 +00:00
Adam Turner
01bcf13a1c
GH-121970: Extract `pydoc_topics
` into a new extension ( #129116 )
2025-01-21 23:28:32 +00:00
Adam Turner
e54ac3b69e
GH-121970: Extract `changes
` into a new extension ( #129105 )
2025-01-20 23:53:08 +00:00
nikalinov
e1fa2fcc7c
gh-129044: Update glossary entry for 'loader' to reflect current import system ( #129073 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-01-20 15:46:09 +00:00
Adam Turner
d46b577ec0
GH-125722: Increase minimum supported Sphinx to 8.1.3 ( #128922 )
2025-01-20 00:26:24 +00:00
Yuki Kobayashi
3b231be8f0
Docs: fix MessageDefect
references in email.policy docs ( #128468 )
2025-01-05 22:58:31 +01:00
Hugo van Kemenade
c9d2bc6d7f
Revert "Doc: Show object descriptions in the table of contents ( #125757 )" ( #128406 )
2025-01-02 14:35:00 +00:00
Yuki Kobayashi
8dbdbad6e0
gh-101100: Fix sphinx warnings in whatsnew/3.0.rst
( #127662 )
2024-12-10 12:22:37 +02:00
Yuki Kobayashi
3e812253ab
gh-101100: Fix Sphinx warnings about list methods ( #127054 )
2024-12-02 15:51:35 +02:00
Yuki Kobayashi
733fe59206
gh-101100: Fix sphinx warnings in howto/*
( #127084 )
2024-11-26 10:17:54 +02:00
Kerim Kabirov
1306f33c84
gh-125933: Add ARIA labels to select elements in the version switcher ( #125934 )
...
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-10-24 23:52:21 +03:00
partev
5003ad5c5e
gh-125909: Avoid a redirect when linking to the devguide ( #125826 )
2024-10-24 17:41:01 +01:00
Adam Turner
91ddde4af0
Doc: Show object descriptions in the table of contents ( #125757 )
2024-10-22 14:07:09 +01:00
Adam Turner
cbfd392479
GH-121970: Extract `availability
` into a new extension ( #125082 )
2024-10-09 21:50:03 +01:00
Emily Morehouse
447a15190d
gh-125072: Add label for assignment expressions; update tracked section for assignment expression topic ( #125074 )
2024-10-07 22:51:14 +00:00
Adam Turner
91e64be731
Doc: Fix archive filenames for standard builds ( #124826 )
2024-10-01 10:43:55 +01:00
Petr Viktorin
e349f73a5a
gh-121277: Raise nice error on next
as second argument to deprecated-removed (GH-124623)
2024-09-27 19:38:40 +02:00
Adam Turner
2c472d36b7
Doc: Use the short version for daily downloads ( #124602 )
2024-09-26 16:44:25 +01:00
Petr Viktorin
7d24ea9db3
gh-121277: Allow .. versionadded:: next
in docs (GH-121278)
...
Make `versionchanged:: next`` expand to current (unreleased) version.
When a new CPython release is cut, the release manager will replace
all such occurences of "next" with the just-released version.
(See the issue for release-tools and devguide PRs.)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-09-25 23:30:40 +02:00