[Python-checkins] [3.5] Doc: Add an optional obsolete header. (GH-13638). (#13658)
larryhastings
webhook-mailer at python.org
Sat Jul 13 10:47:00 EDT 2019
https://github.com/python/cpython/commit/84867166ec13d75c07809813588344054095d128
commit: 84867166ec13d75c07809813588344054095d128
branch: 3.5
author: Julien Palard <julien at palard.fr>
committer: larryhastings <larry at hastings.org>
date: 2019-07-13T16:46:56+02:00
summary:
[3.5] Doc: Add an optional obsolete header. (GH-13638). (#13658)
* [3.5] Doc: Add an optional obsolete header. (GH-13638).
(cherry picked from commit 46ed90dd014010703c7a3b2a61c4927644fa8210)
Co-authored-by: Julien Palard <julien at palard.fr>
files:
M Doc/README.txt
M Doc/tools/templates/layout.html
diff --git a/Doc/README.txt b/Doc/README.txt
index 4f8e9f8f1417..f245d6164f5b 100644
--- a/Doc/README.txt
+++ b/Doc/README.txt
@@ -104,6 +104,15 @@ Then, from the ``Doc`` directory, run ::
where ``<builder>`` is one of html, text, latex, or htmlhelp (for explanations
see the make targets above).
+Deprecation header
+==================
+
+You can define the ``outdated`` variable in ``html_context`` to show a
+red banner on each page redirecting to the "latest" version.
+
+The link points to the same page on ``/3/``, sadly for the moment the
+language is lost during the process.
+
Contributing
============
diff --git a/Doc/tools/templates/layout.html b/Doc/tools/templates/layout.html
index c2106678ac60..7a7feb52e1a3 100644
--- a/Doc/tools/templates/layout.html
+++ b/Doc/tools/templates/layout.html
@@ -1,4 +1,15 @@
{% extends "!layout.html" %}
+
+{% block header %}
+{%- if outdated %}
+<div id="outdated-warning" style="padding: .5em; text-align: center; background-color: #FFBABA; color: #6A0E0E;">
+ {% trans %}This document is for an old version of Python that is no longer supported.
+ You should upgrade, and read the {% endtrans %}
+ <a href="/3/{{ pagename }}{{ file_suffix }}">{% trans %} Python documentation for the current stable release{% endtrans %}</a>.
+</div>
+{%- endif %}
+{% endblock %}
+
{% block rootrellink %}
<li><img src="{{ pathto('_static/py.png', 1) }}" alt=""
style="vertical-align: middle; margin-top: -1px"/></li>
More information about the Python-checkins
mailing list