[Python-checkins] bpo-37860: re-add netlify.toml to set up deploy previews for docs (#92852)
ewdurbin
webhook-mailer at python.org
Tue Dec 6 08:37:47 EST 2022
https://github.com/python/cpython/commit/85d5a7e8ef472a4a64e5de883cf313c111a8ec77
commit: 85d5a7e8ef472a4a64e5de883cf313c111a8ec77
branch: main
author: Ashwin Ramaswami <aramaswamis at gmail.com>
committer: ewdurbin <ewdurbin at gmail.com>
date: 2022-12-06T08:37:41-05:00
summary:
bpo-37860: re-add netlify.toml to set up deploy previews for docs (#92852)
* Revert "bpo-46184: remove `netlify.toml` (#30272)"
This reverts commit fbaf2e604cd354f1ebc6be029480010c6715a8ca.
* Delete runtime.txt
* Create runtime.txt
* Delete runtime.txt
* Update netlify.toml
* Update netlify.toml
* Add netlify badge
* Update Doc/tools/templates/layout.html
Co-authored-by: Hugo van Kemenade <hugovk at users.noreply.github.com>
* Update layout.html
Co-authored-by: Hugo van Kemenade <hugovk at users.noreply.github.com>
files:
A netlify.toml
M Doc/conf.py
M Doc/tools/templates/layout.html
diff --git a/Doc/conf.py b/Doc/conf.py
index c7d2f43b7a8e..b3da8fa9ec44 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -105,6 +105,14 @@
# Short title used e.g. for <title> HTML tags.
html_short_title = '%s Documentation' % release
+# Deployment preview information, from Netlify
+# (See netlify.toml and https://docs.netlify.com/configure-builds/environment-variables/#git-metadata)
+html_context = {
+ "is_deployment_preview": os.getenv("IS_DEPLOYMENT_PREVIEW"),
+ "repository_url": os.getenv("REPOSITORY_URL"),
+ "pr_id": os.getenv("REVIEW_ID")
+}
+
# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
# using the given strftime format.
html_last_updated_fmt = '%b %d, %Y'
diff --git a/Doc/tools/templates/layout.html b/Doc/tools/templates/layout.html
index 98ccf4224804..460161cd3202 100644
--- a/Doc/tools/templates/layout.html
+++ b/Doc/tools/templates/layout.html
@@ -8,6 +8,19 @@
<a href="/3/{{ pagename }}{{ file_suffix }}">{% trans %} Python documentation for the current stable release{% endtrans %}</a>.
</div>
{%- endif %}
+
+{%- if is_deployment_preview %}
+<div id="deployment-preview-warning" style="padding: .5em; text-align: center; background-color: #fff2ba; color: #6a580e;">
+ <div style="float: right; margin-top: -10px; margin-left: 10px;">
+ <a href="https://www.netlify.com">
+ <img src="https://www.netlify.com/img/global/badges/netlify-color-accent.svg" alt="Deploys by Netlify" />
+ </a>
+ </div>
+ {% trans %}This is a deploy preview created from a <a href="{{ repository_url }}/pull/{{ pr_id }}">pull request</a>.
+ For authoritative documentation, see the {% endtrans %}
+ <a href="https://docs.python.org/3/{{ pagename }}{{ file_suffix }}">{% trans %} the current stable release{% endtrans %}</a>.
+</div>
+{%- endif %}
{% endblock %}
{% block rootrellink %}
diff --git a/netlify.toml b/netlify.toml
new file mode 100644
index 000000000000..52675b3d701e
--- /dev/null
+++ b/netlify.toml
@@ -0,0 +1,8 @@
+[build]
+ base = "Doc/"
+ command = "make html"
+ publish = "build/html"
+
+[build.environment]
+ PYTHON_VERSION = "3.8"
+ IS_DEPLOYMENT_PREVIEW = "true"
\ No newline at end of file
More information about the Python-checkins
mailing list