Skip to content

Commit 7fa0254

Browse files
committed
Doc: exclude outreach directory from LaTeX builds and update French translation for presentation details
1 parent c3069f9 commit 7fa0254

3 files changed

Lines changed: 31 additions & 22 deletions

File tree

doc/conf.py

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,21 @@ def setup(app):
6363
app.connect("builder-inited", copy_changelog)
6464
app.connect("build-finished", cleanup_changelog)
6565

66+
# Exclude outreach directory from LaTeX/PDF builds
67+
def exclude_outreach_from_latex(app):
68+
"""Exclude outreach directory from LaTeX builds to keep it HTML-only."""
69+
if app.builder.format == "latex":
70+
# Exclude the entire outreach directory for PDF builds
71+
patterns_to_exclude = ["outreach/*"]
72+
for pattern in patterns_to_exclude:
73+
if pattern not in app.config.exclude_patterns:
74+
app.config.exclude_patterns.append(pattern)
75+
# Suppress warnings about excluded outreach documents during latex builds
76+
warnings_to_suppress = ["toc.excluded", "ref.doc"]
77+
for warning_type in warnings_to_suppress:
78+
if warning_type not in app.config.suppress_warnings:
79+
app.config.suppress_warnings.append(warning_type)
80+
6681
# Exclude detailed API documentation from gettext extraction, but keep api/index.rst
6782
def exclude_api_from_gettext(app):
6883
if app.builder.name == "gettext":
@@ -89,6 +104,7 @@ def exclude_api_from_gettext(app):
89104
# Suppress warnings about excluded API documents during gettext builds
90105
app.config.suppress_warnings.extend(["toc.excluded", "ref.doc"])
91106

107+
app.connect("builder-inited", exclude_outreach_from_latex)
92108
app.connect("builder-inited", exclude_api_from_gettext)
93109

94110

doc/index.rst

Lines changed: 14 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -96,18 +96,6 @@ DataLab has been funded, chronologically, by the following stakeholders:
9696
:target: https://nlnet.nl
9797
:class: dark-light no-scaled-link
9898

99-
.. only:: html and not latex
100-
101-
.. toctree::
102-
:maxdepth: 2
103-
:hidden:
104-
105-
intro/index
106-
features/index
107-
outreach/index
108-
contributing/index
109-
changelog
110-
11199
.. figure:: _static/plotpy-stack-powered.png
112100
:align: center
113101
:width: 300 px
@@ -116,16 +104,23 @@ DataLab has been funded, chronologically, by the following stakeholders:
116104
DataLab is powered by `PlotPyStack <https://github.com/PlotPyStack>`_,
117105
the scientific Python-Qt visualization and graphical user interface stack.
118106

119-
.. only:: latex and not html
107+
.. toctree::
108+
:maxdepth: 2
109+
:hidden:
110+
111+
intro/index
112+
features/index
113+
contributing/index
114+
changelog
115+
116+
.. only:: html and not latex
120117

121118
.. toctree::
122-
:maxdepth: 2
123-
:caption: Contents
119+
:hidden:
124120

125-
intro/index
126-
features/index
127-
contributing/index
128-
changelog
121+
outreach/index
122+
123+
.. only:: latex and not html
129124

130125
.. note:: DataLab was created by `CODRA`_/`Pierre Raybaut`_ in 2023. It is
131126
developed and maintained by DataLab Platform Developers.

doc/locale/fr/LC_MESSAGES/outreach/pydata2024.po

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,9 +40,8 @@ msgstr "Présentation de DataLab"
4040
msgid "**Talk Title:** *DataLab: Bridging Scientific and Industrial Worlds for Advanced Signal and Image Processing*"
4141
msgstr "**Titre de la présentation :** *DataLab : Unir les mondes scientifique et industriel pour un traitement avancé des signaux et des images*"
4242

43-
#, fuzzy
4443
msgid "**Presenter:** Pierre Raybaut (Executive VP, Engineering, CODRA)"
45-
msgstr "**Orateur :** Pierre Raybaut (CODRA/Plateforme DataLab)"
44+
msgstr "**Orateur :** Pierre Raybaut (Directeur Général Ingénierie, CODRA)"
4645

4746
msgid "This presentation offered a comprehensive look at DataLab's capabilities through practical demonstrations and use cases relevant to both scientific research and industrial applications."
4847
msgstr "Cette présentation a offert un aperçu complet des capacités de DataLab à travers des démonstrations pratiques et des cas d'utilisation pertinents tant pour la recherche scientifique que pour les applications industrielles."
@@ -204,4 +203,3 @@ msgstr "Accent accru sur le positionnement en tant qu'outil compagnon"
204203

205204
msgid "Debugged issues with Conda package installation"
206205
msgstr "Résolution des problèmes d'installation des packages Conda"
207-

0 commit comments

Comments
 (0)