Commit Graph

1306 Commits

Author SHA1 Message Date
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
Adam Turner 6318ffcba2 Doc: Use `major.minor` for documentation distribution archive filenames (#124489) 2024-09-25 20:06:54 +01:00
Alex Waygood 8a2baedc4b Bump Ruff to 0.6.7 (#124384) 2024-09-23 22:19:35 +00:00
Adam Turner 0060486862 Doc: Add `make dist-no-html` (#124383)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-09-23 23:11:34 +01:00
Hugo van Kemenade f5597dbd0e Docs: Drop letter PDF (#123912) 2024-09-12 13:49:19 +03:00
Adam Turner 95f5c89b54 GH-121970: Fix `gettext` for audit events (#122651) 2024-08-03 17:41:26 +01:00
Rafael Fontenelle 58ffc4cf4a gh-122384: Mark strings from Download page for translation (#122385)
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-08-01 12:25:16 +03:00
Adam Turner 11ad731f4f GH-121970: Extract `audit_events` into a new extension (#122325) 2024-07-30 03:49:00 +00:00