From 8c89a7b1e9ba57a8f379213e30f6710eab845627 Mon Sep 17 00:00:00 2001 From: James Frost Date: Thu, 30 May 2024 12:06:37 +0100 Subject: [PATCH] Add html_baseurl to sphinx conf.py (#12364) (#12393) This is used to set the tag that points to the canonical version of the webpage. Including this indicates to search engines which version to include in their indexes, and should prevent older versions showing up. Fixes #12363 --- AUTHORS | 1 + changelog/12363.doc.rst | 1 + doc/en/conf.py | 3 +++ 3 files changed, 5 insertions(+) create mode 100644 changelog/12363.doc.rst diff --git a/AUTHORS b/AUTHORS index cfd848da8..6b6939a6d 100644 --- a/AUTHORS +++ b/AUTHORS @@ -164,6 +164,7 @@ Jaap Broekhuizen Jakob van Santen Jakub Mitoraj James Bourbeau +James Frost Jan Balster Janne Vanhala Jason R. Coombs diff --git a/changelog/12363.doc.rst b/changelog/12363.doc.rst new file mode 100644 index 000000000..c657281ba --- /dev/null +++ b/changelog/12363.doc.rst @@ -0,0 +1 @@ +The documentation webpages now links to a canonical version to reduce outdated documentation in search engine results. diff --git a/doc/en/conf.py b/doc/en/conf.py index 5184ee7b1..aa6a2691c 100644 --- a/doc/en/conf.py +++ b/doc/en/conf.py @@ -273,6 +273,9 @@ html_show_sourcelink = False # Output file base name for HTML help builder. htmlhelp_basename = "pytestdoc" +# The base URL which points to the root of the HTML documentation. It is used +# to indicate the location of document using the canonical link relation (#12363). +html_baseurl = "https://docs.pytest.org/en/stable/" # -- Options for LaTeX output --------------------------------------------------