Replace custom roles with styled extlinks (#1351)

Author: hugovk

.editorconfig

@@ -11,5 +11,5 @@ indent_size = 4
 [*.rst]
 indent_size = 3
 
-[*.yml]
+[*.{css,yml}]
 indent_size = 2

_extensions/custom_roles.py

@@ -38,7 +38,7 @@
 
 .release-cycle-chart .release-cycle-blob {
     stroke-width: 1.6px;
-    /* default colours, overriden below for individual statuses */
+    /* default colours, overridden below for individual statuses */
     fill: var(--color-background-primary);
     stroke: var(--color-foreground-primary);
 }
@@ -85,3 +85,12 @@
 .bad pre {
   border-left: 3px solid rgb(244, 76, 78);
 }
+
+.extlink-cpy-file,
+.extlink-gh-label {
+  border: 1px solid var(--color-background-border);
+  border-radius: .2em;
+  font-family: var(--font-stack--monospace);
+  font-size: var(--font-size--small--2);
+  padding: .1em .2em;
+}

_static/devguide_overrides.css

@@ -1,12 +1,6 @@
-import os
-import sys
 import time
 
-# Location of custom extensions.
-sys.path.insert(0, os.path.abspath(".") + "/_extensions")
-
 extensions = [
-    'custom_roles',
     'notfound.extension',
     'sphinx.ext.extlinks',
     'sphinx.ext.intersphinx',
@@ -176,7 +170,10 @@
 # This config is a dictionary of external sites,
 # mapping unique short aliases to a base URL and a prefix.
 # https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html
+_repo = "https://github.com/python/cpython"
 extlinks = {
+    "cpy-file": (f"{_repo}/blob/main/%s", "%s"),
+    "gh-label": (f"{_repo}/labels/%s", "%s"),
     "github": ("https://github.com/%s", "%s"),
     "github-user": ("https://github.com/%s", "@%s"),
     "pypi": ("https://pypi.org/project/%s/", "%s"),

conf.py

@@ -537,7 +537,7 @@ parser (the one used by the interpreter) just execute: ::
 
     make regen-pegen
 
-using the :cpy-file:`!Makefile` in the main directory.  If you are on Windows you can
+using the ``Makefile`` in the main directory.  If you are on Windows you can
 use the Visual Studio project files to regenerate the parser or to execute: ::
 
     ./PCbuild/build.bat --regen

internals/parser.rst

@@ -7,4 +7,4 @@ sphinx-notfound-page>=1.0.0
 sphinx_copybutton>=0.3.3
 sphinxext-opengraph>=0.7.1
 sphinxext-rediraffe
-Sphinx~=7.3.7
+Sphinx~=7.4.0