Commit Graph

91 Commits

Author SHA1 Message Date
Adam Turner 7d52bab3ce
Support Sphinx 7.2 in ``pep_sphinx_extensions`` (#3294) 2023-08-17 16:15:55 +00:00
shailshouryya 0ebf5a4390
Lint: Update outdated package dependencies & reformat files (#3291)
* Update `sphinx-lint` package dependency version number → 0.6.8

This new release includes the changes from
https://github.com/sphinx-contrib/sphinx-lint/pull/56/files,
which should address
https://github.com/python/peps/issues/3028. For details
about `sphinx-lint` release 0.6.8, see
https://github.com/sphinx-contrib/sphinx-lint/releases/tag/v0.6.8.

* Update other outdated dependencies

Run the following:

```
python -m pip install pre-commit
pre-commit autoupdate
pre-commit run --all-files
```
2023-08-16 08:07:57 +03:00
Adam Turner 2b53c224d1
Generate ``peps.rss`` via Sphinx (#3274) 2023-08-05 17:22:22 +01:00
Hugo van Kemenade 191de06f27
Infra: Revert "Fix a URL in the PyPA specification banner (#3199)" (#3218) 2023-07-31 22:28:06 +01:00
Uriya Harpeness fee8c3e353
Remove duplicated CSS properties in ``styles.css`` (#3204) 2023-07-16 14:42:59 +01:00
wim glenn 08124264e6
Fix a URL in the PyPA specification banner (#3199) 2023-07-13 03:56:26 +01:00
Hugo van Kemenade ef64ec3cbe
Infra: improve text readability and webpage performance (#3132)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-05-31 11:10:38 +02:00
Hugo van Kemenade 9d6e5b653f
Replace deprecated ``datetime`` functions (#3148)
From Python 3.12, datetime.datetime.utcnow and
datetime.datetime.utcfromtimestamp emit deprecation warnings.
2023-05-18 01:45:51 +01:00
chaojie 6eb6167770
Infra: Make the sticky banner opaque for better readability (#3075)
Make the stick banner opaque for better readability
2023-04-28 12:31:40 -05:00
Roman Solomatin 67712e46d8
Infra: Fix topics links from pep-0000 (#3093) 2023-04-08 17:36:57 -05:00
C.A.M. Gerlach 4b3c9504ed
Infra: Fix hiding of References if it contains invisible SystemMessage (#3083) 2023-04-03 16:05:21 +02:00
Pradyun Gedam 06e5a8a693
Implement support for sticky banners and utilize them (#2992) 2023-03-20 08:42:01 +00:00
Hugo van Kemenade 40f579646e
Infra: Only add Topics index to PEP 0, not topic indices (#3037) 2023-03-04 14:10:39 +02:00
Hugo van Kemenade 9fa3f36d90
Infra: Add index by topic to PEP 0 (#2892)
* Infra: Add index by topic to PEP 0

* Infra: Move intro text

* Simplify wording
2023-03-04 10:22:14 +02:00
C.A.M. Gerlach f292166dba
Lint: Allow per-message Post-History links w/trailing slash (#3005)
* Lint: Only ignore per-message links in Post-History with trailing slash
* PEP 684: Add trailing slash to per-message Post-History link
* Infra: Use clearer term (message, not post) for single Discourse messages
2023-02-06 16:49:00 -06:00
Hugo van Kemenade e92c4d6afa
PEP 1 and 12: Document Topic header (#2995)
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2023-02-03 21:34:17 +02:00
Hugo van Kemenade 5bdec964da
Meta: Add a governance topic (#2993)
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Gregory P. Smith <greg@krypto.org>
Fixes https://github.com/python/peps/issues/2987
2023-02-02 12:50:01 +02:00
Hugo van Kemenade 77bbe7983a
PEP 404: Add Python 2.8 to Release PEPs topic (#2986) 2023-01-31 11:03:08 +02:00
Hugo van Kemenade 15caa8f24b
Infra: Use dark grey instead of dark green for dark theme background (#2977)
* Use #121212 for dark theme bgcolor

* Use #1111111 for dark theme bgcolor

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2023-01-24 07:53:08 +02:00
Hugo van Kemenade 2f277a0a2a
Infra: Fix Replaces/Superseded-By/Requires links for dirhtml (#2981)
After #2972, when building dirhtml,
we need to re-add the initial / for the links to PEPs
in the Replaces/Superseded-By/Requires headers.
2023-01-23 21:26:36 -06:00
Hugo van Kemenade 6fc3a4ddf3
Infra: Use relative links to ease development (#2972) 2023-01-22 12:56:05 +02:00
Hugo van Kemenade 241163786e
Link to the correct location for the RSS feed (#2962) 2023-01-14 17:32:50 +00:00
Philipp A 631ee6ce60
Infra: Only invert image brightness, not hue (#2949)
Since inversion doesn’t just affect brightness, but also hue, there’s a problem: Some background colors have perceptually less contrast with their text when hue rotated. This rotates their hue back, fixing the contrast issue.
2023-01-06 16:33:58 +00:00
Hugo van Kemenade 67512a10ea
Infra: Link status and type headers to descriptions (#2842)
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-11-29 11:48:51 +02:00
Hugo van Kemenade 5731720068
Infra: Include PEP number in API (#2879)
Fixes https://github.com/python/peps/issues/2878
2022-11-10 08:49:09 +02:00
C.A.M. Gerlach 80f41487fe
Meta: Clarify scope of Packaging topic and rm ensurepip PEPs (453/477) (#2826) 2022-11-07 17:57:17 +01:00
Hugo van Kemenade 1a931bf317
Infra: Don't generate broken source link for topic pages (#2843) 2022-10-22 20:42:06 -07:00
Hugo van Kemenade ed92c0697c
Infra: Only emit a category table when it has entries (#2839)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2022-10-22 10:44:36 +03:00
Hugo van Kemenade c0b28dab5b
Infra: Add tooltips to type/status in PEP 0 (#2838)
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2022-10-22 10:43:36 +03:00
C.A.M. Gerlach bf3465d3e3
Packaging PEPs: Update headers & link canonical PyPA specs (#2690)
* Update headers/etc. of older packaging PEPs to reflect replacement PEPs

* Infra: Fix lowercase and tweak plural in text for PyPA spec banner

* Add banner to all relevant PEPs pointing to their canonical PyPA specs

Co-authored-by: Brett Cannon <brett@python.org>
2022-10-07 08:29:13 -07:00
Jelle Zijlstra e46b83661d
Add Topic for release schedule PEPs (#2669)
Release PEPs are a pretty unusual kind of PEP and it's useful to me to have
them all listed together. Happy to adjust the name of the topic if desired.

I took the opportunity to adjust the status of a few release PEPs. Now all
releases for EOL versions are Final (3.5 was previously Active), and all
releases for released versions are Active (3.10 was still draft). 3.11 remains
Draft as 3.11 has not yet been released.

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-10-06 18:01:52 -07:00
Jelle Zijlstra 83b976da18
Add Typing Topic (#2670)
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-10-06 17:36:39 -07:00
Jelle Zijlstra 520cc0bbe7
Topic pages: remove authors table (#2823)
This table is not too useful, and for some reason we're not properly
mangling email addresses in the table. For simplicity, just omit the
table.
2022-10-06 17:36:15 -07:00
Hugo van Kemenade 7fa80c34d7
Infra + many PEPs: Add Sphinx Lint and fix errors (#2816)
* PEP 555, 653: Fix inline literal missing (escaped) space after literal

* Add newline at end of file

* PEP 692: Add newline at end of file

* PEP 633: Fix missing space before role

* Run sphinx-lint in pre-commit

* PEP 639: Remove rogue backticks

* PEP 372: Remove rogue backticks

* PEP 462: Add missing underscore after closing backtick in hyperlink

* PEP 481: Add missing underscore after closing backtick in hyperlinks

* PEP 507: Add missing underscore after closing backtick in hyperlinks

* PEP 453: Add missing underscore after closing backtick in hyperlinks, and convert to links

* PEP 534: Fix inline literal missing (escaped) space after literal

* PEP 372, 453, 462: Redirect BPO to GH
2022-10-06 12:14:32 -07:00
Adam Turner 80c69055a5
Remove ``include_patterns`` monkeypatching (#2810)
This is included in Sphinx core from version 5.1
2022-10-05 18:03:04 +01:00
C.A.M. Gerlach 326e5623a5
Style: Fix zebra stripes and improve table & code presentation (#2805)
* Style: Further lighten table zebra stripes
* Style: Ensure consistent contrast for code blocks in zebra tables
* Style: Add padding around inline code literal BG to not be so tight
* Style: Add horizontal rules and header color to tables
* Style: Remove zebra striping from tables	
* Style: Use more sensible color name for admonition + header color
2022-10-01 19:36:50 -05:00
Hugo van Kemenade 97e3dbde98
Infra: Mute table zebra stripes to de-emphasise different rows (#2740)
* Infra: Mute table zebra stripes to de-emphasise different rows

* Infra: change #eee to #ddd
2022-08-28 22:55:26 +03:00
CAM Gerlach f87de8284c
Infra: Add new directives to point to PEP's canonical content (#2702)
As originally discussed in #2692 , this adds a three new custom directives intended to be used at the top of PEPs:

* `pep-banner`, a generic admonition banner that can be subclassed with an arbitrary message,
* `canonical-docs`, which renders a banner linking to a `Final` PEP's canonical documentation/specification.
* `canonical-pypa-spec`, a banner for packaging interoperability PEPs linking to the canonical PyPA specs.

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2022-08-02 22:48:56 -05:00
CAM Gerlach 0b788056de
Infra: Fix canonical link tag to point to correct PEP URL (#2687)
* Fix canonical link tag to point to correct PEP URL
* Use shorter, standard HTML5 syntax for self-closing tags
* Avoid depr clip prop & use better supported transform prop in CSS
* Use strict mode in the color scheme JS
2022-07-10 15:40:09 -05:00
CAM Gerlach 5d2f8d10ea
Style: Fix colors and style for all admonitions (#2691)
Since the basic admonition admonition styles are just applied to a couple individual admonitions, rather than admonitions in general, those other than "warning" and "note" won't display as admonitions at all. In addition to fixing that, this PR adds appropriate, standard colors for each of the additional admonition types in both light and dark mode.
2022-07-06 13:59:41 -05:00
CAM Gerlach 135e66f311
Infra: Link topic index pages in rendered PEP topic headers (#2689) 2022-06-29 06:03:49 -07:00
Pradyun Gedam fa659f01c8
Infra: Tweak PEP references to work on topic sub-index pages (#2658) 2022-06-20 06:36:01 -07:00
Hugo van Kemenade b4032e7e3d
Infra: Make colour theme cycler button accessible (#2619) 2022-06-18 20:07:06 +02:00
Adam Turner a2f2d6cc5a
Add support for topic indices (#2579)
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2022-06-18 20:04:46 +02:00
Hugo van Kemenade 2d9a9462dd
PEP 0: Remove 'PEP' from table headers (#2635) 2022-06-08 18:49:36 +01:00
Adam Turner e92d085a35
Infra: Refactor `peps.json` logic into PEP class (#2585) 2022-06-08 10:14:36 -07:00
Adam Turner f7c9e62c9f
Infra: Use Docutils' `list-table` syntax for PEP 0 (#2616) 2022-06-08 10:11:14 -07:00
wookie184 278070ac97
Include the PEP index in `peps.json` (#2567) 2022-05-01 16:38:40 +01:00
Philipp A ebff37d5e7
Enable resetting HTML colour scheme preferences
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-04-28 16:49:31 +01:00
Hugo van Kemenade 0b0dd6ddd5
Add tests for `pep_sphinx_extensions` (#2545)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-04-26 20:07:20 +01:00