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
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
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
135e66f311
Infra: Link topic index pages in rendered PEP topic headers ( #2689 )
2022-06-29 06:03:49 -07:00
fa659f01c8
Infra: Tweak PEP references to work on topic sub-index pages ( #2658 )
2022-06-20 06:36:01 -07:00
b4032e7e3d
Infra: Make colour theme cycler button accessible ( #2619 )
2022-06-18 20:07:06 +02:00
a2f2d6cc5a
Add support for topic indices ( #2579 )
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2022-06-18 20:04:46 +02:00
2d9a9462dd
PEP 0: Remove 'PEP' from table headers ( #2635 )
2022-06-08 18:49:36 +01:00
e92d085a35
Infra: Refactor `peps.json` logic into PEP class ( #2585 )
2022-06-08 10:14:36 -07:00
f7c9e62c9f
Infra: Use Docutils' `list-table` syntax for PEP 0 ( #2616 )
2022-06-08 10:11:14 -07:00
278070ac97
Include the PEP index in `peps.json` ( #2567 )
2022-05-01 16:38:40 +01:00
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
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
e0d4ae5855
Style: Retitle inline 'Contents' to 'Table of Contents' for clarity ( #2541 )
2022-04-20 04:54:38 -05:00
53d6d5987b
Infra: remove two of the five instances of title at top of pages ( #2532 )
...
* Infra: remove one of the four instances of title at top of pages
* Infra: remove another of the five instances of title at top of pages
* Infra: but keep PEP number in the breadcrumbs
2022-04-19 02:28:45 -05:00
efeae28e9e
Infra: Improve email and link processing and rendering in headers ( #2467 )
...
* Infra: Include mailing list link type in text for clarity, & refactor
* Infra: Support mailing list info pages as well as archives
* Infra: Pretty-format Discourse categories/threads in headers as well
* Infra: Show friendly-name of target in Post-History link hover text
* Infra: Automatically link list addresses to list pages in Discussions-To
* Infra: Use simpler check for title in Discourse URL header processing
* Infra: Automatically trim trailing commas & whitespace in header values
2022-04-19 09:27:27 +03:00
4a5751f0d3
Style: Reduce space consumed by headers and improve alignment ( #2533 )
2022-04-19 09:24:27 +03:00
3f6aec0937
Infra: Restore PEPs RSS feed in <head> ( #2509 )
2022-04-15 00:18:57 +03:00
642ad67260
Infra: don't wrap PEP numbers in PEP 0 tables ( #2524 )
...
Fixes #2520
2022-04-13 08:01:43 -07:00
75cc6853e1
Infra: Remove pre-wrap CSS rule that breaks multi-line inline literals ( #2512 )
...
As written up in detail at https://github.com/python/peps/issues/2511 , this rule breaks the rendering of 199 inline literals across all the PEPs, and appears to have no reason to exist. I therefore propose to remove it.
2022-04-11 12:09:26 -07:00
67fe49b322
Fix colour scheme toggling when switching from default dark mode ( #2494 )
...
* Fix colour scheme toggling when switching from default dark mode
* Add workaround for Chrome bug where disabling element doesn't cause rerender
2022-04-02 09:05:13 +03:00
fe2d145d5a
Infra: generate machine-readable PEP index ( #2475 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2022-04-01 23:07:39 +03:00
dae03bb7ec
Style: Fix unbounded max width causing very wide spans to overflow ( #2478 )
2022-03-30 23:42:33 -05:00
75235028b7
PEP 0: Make PEP titles in table clickable links ( #2429 )
2022-03-24 15:08:07 -05:00
55bed7dca5
Style: Scroll code blocks instead of wrapping them ( #2463 )
2022-03-24 15:03:39 -05:00
f30bc4caa8
Style: Reduce size of code font and improve responsiveness at narrow screen widths ( #2439 )
2022-03-22 23:14:36 +02:00
41086f5258
Style: Fix vertical margins of def lists w/o <p>s to match those with ( #2427 )
...
* Style: Fix vertical margins of def lists w/o <p>s to match those with
* Style: Specify line-height without rem
2022-03-16 20:06:15 -05:00
9900fa894c
Accessibility: Add aria-label to clearly describe the dark mode button ( #2426 )
2022-03-15 16:03:35 +02:00
13aa4b16fb
Make the table of contents collapsed by default ( #2364 )
2022-03-14 01:49:03 +00:00
4c76e963f2
Styling: Remove field block highlights and restore definition list indent ( #2425 )
2022-03-14 01:46:48 +00:00
0bd513148a
Explicitly list files to render in `conf.py` ( #2415 )
2022-03-14 01:44:36 +00:00
ce2ef0473e
Meta: Classify Accepted Process PEPs as current; PEP 8001: Mark as Final ( #2385 )
2022-03-12 16:04:54 +00:00
5d0ebd014a
Dark mode: Invert some images ( #2409 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2022-03-11 20:41:57 +00:00
1a79345130
PRS: Enable preview rendering on pull requests ( #2023 )
2022-03-11 15:34:31 +00:00
4bdabc6000
The PEP Rendering System is dead; long live the PEP Rendering System ( #2399 )
2022-03-10 10:27:31 +02:00
08e37f7c23
PEP 0: Fix 'Page Source (GitHub)' ( #2401 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2022-03-09 23:15:24 +00:00
563de32559
PRS: Add CNAME generation and `rel="canonical"`
2022-03-09 19:00:38 +00:00
358854aac9
PRS: Remove country language tag in page template
2022-03-01 00:03:40 +00:00
b76fe4351e
Use PEP titles and sections as title text for `:pep:` references ( #2366 )
2022-02-27 22:58:15 +00:00
42f88f1ce2
Display list names in Resolution and Discussions-To headers ( #2361 )
2022-02-27 14:46:36 -08:00
94225885de
PEP 676: Use `docutils.nodes.Node.findall` ( #2363 )
2022-02-25 18:38:24 +00:00
7efe7fb433
PEP 676: Display mailing list names for thread links in Discussions-To ( #2351 )
2022-02-21 21:04:55 +00:00
8e33abd30f
PEP 12: Recommend reST hyperlinks over footnotes ( #2302 )
2022-02-17 17:26:37 +00:00
5c62d9d2de
Fail the Sphinx render workflow on warnings from Docutils ( #2288 )
2022-01-28 23:24:08 +00:00
113e490701
Several PEPs: Use explicit `:pep:` and `:rfc:` roles ( #2209 )
2022-01-21 11:03:51 +00:00
50e5de2d28
PEP 676: 'dark mode', documentation, spec update, implementation update ( #2239 )
...
Co-authored-by: C.A.M. Gerlach <cam.gerlach@gerlach.cam>
2022-01-16 14:33:05 -08:00
57c9a36dca
Fix refs section removal breaking external links on Sphinx build too ( #2229 )
2022-01-11 18:37:31 -08:00
3d60b84e35
PEP 676: Implementation updates ( #2208 )
2022-01-09 10:07:03 -08:00
f82973df46
Don't auto-add inline links to ref section & rm if empty, per #2130 ( #2155 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2021-12-18 15:23:14 -08:00
e47f9242f8
Rename master to main ( #2178 )
2021-12-03 06:59:24 -08:00
CAM Gerlach
Pradyun Gedam
Hugo van Kemenade
Adam Turner
wookie184
Philipp A
Mark Amery