Youen
1 year ago
8 changed files with 123 additions and 9 deletions
@ -0,0 +1,18 @@ |
|||||||
|
{% extends "!page.html" %} |
||||||
|
{% block body %} |
||||||
|
{% if current_version and latest_version and current_version != latest_version %} |
||||||
|
<div class="warning admonition"> |
||||||
|
<p class="admonition-title">Attention</p> |
||||||
|
<p> |
||||||
|
{% if current_version.is_released %} |
||||||
|
Ceci est une ancienne version de la documentation. |
||||||
|
La dernière version est la <a href="{{ vpathto(latest_version.name) }}">{{latest_version.name}}</a>. |
||||||
|
{% else %} |
||||||
|
Ceci est une version en cours de développement. |
||||||
|
La dernière version stable est la <a href="{{ vpathto(latest_version.name) }}">{{latest_version.name}}</a>. |
||||||
|
{% endif %} |
||||||
|
</p> |
||||||
|
</div> |
||||||
|
{% endif %} |
||||||
|
{{ super() }} |
||||||
|
{% endblock %} |
@ -0,0 +1,33 @@ |
|||||||
|
{%- if current_version %} |
||||||
|
<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions"> |
||||||
|
<span class="rst-current-version" data-toggle="rst-current-version"> |
||||||
|
<span class="fa fa-book"> Autres versions</span> |
||||||
|
{{ current_version.name }} |
||||||
|
<span class="fa fa-caret-down"></span> |
||||||
|
</span> |
||||||
|
<div class="rst-other-versions"> |
||||||
|
{%- if versions.tags %} |
||||||
|
<dl> |
||||||
|
<dt>Versions</dt> |
||||||
|
{%- for item in versions.tags %} |
||||||
|
<dd><a href="{{ item.url }}">{{ item.name }}</a></dd> |
||||||
|
{%- endfor %} |
||||||
|
</dl> |
||||||
|
{%- endif %} |
||||||
|
{%- if versions.branches %} |
||||||
|
<dl> |
||||||
|
<dt>Branches</dt> |
||||||
|
{%- for item in versions.branches %} |
||||||
|
<dd><a href="{{ item.url }}">{{ item.name }}</a></dd> |
||||||
|
{%- endfor %} |
||||||
|
</dl> |
||||||
|
{%- endif %} |
||||||
|
</div> |
||||||
|
|
||||||
|
{%- if current_version_data.pdf_url %} |
||||||
|
<div class="rst-downloads"> |
||||||
|
<a href="{{current_version_data.pdf_url}}"><span class="fa fa-download"> Télécharger au format PDF</a></span> |
||||||
|
</div> |
||||||
|
{% endif %} |
||||||
|
</div> |
||||||
|
{%- endif %} |
@ -0,0 +1,14 @@ |
|||||||
|
# This tiny sphinx extension will simply copy the current_version (generated by sphinx_multiversion) to the 'version' entry in html_context, so that it is correctly displayed by the ReadTheDocs template |
||||||
|
# You need to have the sphinx_multiversion extension as well |
||||||
|
|
||||||
|
def setup(app): |
||||||
|
app.connect('config-inited', config_inited) |
||||||
|
|
||||||
|
def config_inited(app, config): |
||||||
|
app.connect('html-page-context', html_page_context) |
||||||
|
|
||||||
|
def html_page_context(app, pagename, templatename, context, doctree): |
||||||
|
try: |
||||||
|
context['version'] = context['current_version'].name |
||||||
|
except: |
||||||
|
context['version'] = 'no_version_found' |
@ -0,0 +1,21 @@ |
|||||||
|
# This module can read data from a python file in the source folder. This will read data from the version being built (as opposed to standard sphinx-multiversion behavior that executes python from the working copy) |
||||||
|
# All global variables defined in file current_version_data.py will be put in html_context['current_version_data'] which allows to use them in HTML templates. |
||||||
|
|
||||||
|
import sys |
||||||
|
|
||||||
|
current_version_data = {} |
||||||
|
|
||||||
|
def setup(app): |
||||||
|
app.add_config_value("version_sourcedir", '', "html") |
||||||
|
app.connect('config-inited', config_inited) |
||||||
|
|
||||||
|
def config_inited(app, config): |
||||||
|
app.connect('html-page-context', html_page_context) |
||||||
|
try: |
||||||
|
exec(open(app.config.version_sourcedir + '/current_version_data.py').read(), globals(), current_version_data) |
||||||
|
except: |
||||||
|
print('No file current_version_data.py found') |
||||||
|
pass |
||||||
|
|
||||||
|
def html_page_context(app, pagename, templatename, context, doctree): |
||||||
|
context['current_version_data'] = current_version_data |
Loading…
Reference in new issue