diff options
| -rw-r--r-- | .gitlab/os-linux.yml | 1 | ||||
| -rw-r--r-- | Utilities/Sphinx/CMakeLists.txt | 4 | ||||
| -rw-r--r-- | Utilities/Sphinx/static/cmake.css | 12 | ||||
| -rw-r--r-- | Utilities/Sphinx/templates/layout.html | 13 |
4 files changed, 30 insertions, 0 deletions
diff --git a/.gitlab/os-linux.yml b/.gitlab/os-linux.yml index 48d4279daa..4a87b21522 100644 --- a/.gitlab/os-linux.yml +++ b/.gitlab/os-linux.yml @@ -492,4 +492,5 @@ - cd build/ - cmake ../Utilities/Sphinx -GNinja -DSPHINX_HTML=ON -DCMake_SPHINX_CMAKE_ORG=ON + -DCMake_SPHINX_CMAKE_ORG_OUTDATED=$CMAKE_CI_SPHINX_OUTDATED - ninja diff --git a/Utilities/Sphinx/CMakeLists.txt b/Utilities/Sphinx/CMakeLists.txt index 65760367ea..dd70ce6852 100644 --- a/Utilities/Sphinx/CMakeLists.txt +++ b/Utilities/Sphinx/CMakeLists.txt @@ -141,6 +141,10 @@ if(CMake_SPHINX_CMAKE_ORG) -A googleanalytics=1 -A versionswitch=1 ) + + if(CMake_SPHINX_CMAKE_ORG_OUTDATED) + list(APPEND doc_html_opts -A outdated=1) + endif() endif() set(doc_format_outputs "") diff --git a/Utilities/Sphinx/static/cmake.css b/Utilities/Sphinx/static/cmake.css index 029eb1b2fc..4539cf96f6 100644 --- a/Utilities/Sphinx/static/cmake.css +++ b/Utilities/Sphinx/static/cmake.css @@ -22,3 +22,15 @@ div.sphinxsidebarwrapper { dd > :first-child > p { margin-top: 0px; } + +div.outdated { + background-color: #f0f0c0; + color: black; + font-size: 90%; + padding-bottom: 5px; + padding-left: 2px; + padding-right: 2px; + padding-top: 5px; + text-align: center; + width: 100%; +} diff --git a/Utilities/Sphinx/templates/layout.html b/Utilities/Sphinx/templates/layout.html index 0cc5c26afe..d02b44d9e3 100644 --- a/Utilities/Sphinx/templates/layout.html +++ b/Utilities/Sphinx/templates/layout.html @@ -17,6 +17,19 @@ </li> {% endblock %} +{%- block relbar1 %} +{{ super() }} +{%- if outdated is defined %} + <div class="outdated"> + This documents an old version of CMake. + <a href="https://cmake.org/cmake/help/latest/{{ pagename }}.html"> + Click here to see the latest release. + </a> + <span class="version_switch_note"></span> + </div> +{%- endif %} +{%- endblock %} + {% block extrahead %} {%- if versionswitch is defined %} <script type="text/javascript" src="{{ pathto('../version_switch.js', 1) }}"></script> |