seb5g · Oct 30, 2026 · Oct 30, 2026 · Oct 30, 2026 · Oct 30, 2026 · Oct 30, 2026
diff --git a/docs/src/_static/css/layout.css b/docs/src/_static/css/layout.css
@@ -0,0 +1,61 @@
+/* Let the page content use the whole browser width instead of the
+   theme's fixed 800px column. */
+.wy-nav-content {
+    max-width: none;
+}
+
+/* Table cells wrap their text instead of pushing the table out of the page. */
+.rst-content table.docutils td,
+.rst-content table.docutils th,
+.wy-table-responsive table td,
+.wy-table-responsive table th {
+    white-space: normal;
+}
+
+/* Button showing/hiding the navigation sidebar (see sidebar_toggle.js). */
+.pmq-sidebar-toggle {
+    position: fixed;
+    top: 8px;
+    left: 308px;
+    z-index: 300;
+    width: 32px;
+    height: 32px;
+    padding: 0;
+    border: 1px solid #c9c9c9;
+    border-radius: 4px;
+    background: #fcfcfc;
+    color: #404040;
+    font-size: 18px;
+    line-height: 30px;
+    text-align: center;
+    cursor: pointer;
+    opacity: 0.8;
+}
+.pmq-sidebar-toggle:hover {
+    opacity: 1;
+    background: #e7f2fa;
+}
+
+body.pmq-sidebar-hidden .wy-nav-side {
+    display: none;
+}
+body.pmq-sidebar-hidden .wy-nav-content-wrap {
+    margin-left: 0;
+}
+body.pmq-sidebar-hidden .pmq-sidebar-toggle {
+    left: 8px;
+}
+
+/* On small screens the theme already has its own menu button. */
+@media screen and (max-width: 768px) {
+    .pmq-sidebar-toggle {
+        display: none;
+    }
+}
+
+/* Keep the breadcrumbs clear of the toggle button. */
+@media screen and (min-width: 769px) {
+    .wy-breadcrumbs {
+        padding-left: 36px;
+    }
+}
diff --git a/docs/src/_static/css/overflow.css b/docs/src/_static/css/overflow.css
@@ -0,0 +1,11 @@
+.rst-content img {
+  max-width: none !important;
+  height: auto;
+}
+.wy-table-responsive {
+    overflow: visible;
+}
+
+.dataTables_wrapper {
+    overflow: auto;
+}
diff --git a/docs/src/_static/js/sidebar_toggle.js b/docs/src/_static/js/sidebar_toggle.js
@@ -0,0 +1,44 @@
+// Adds a button to show/hide the navigation sidebar of the Read the Docs theme.
+// The choice is remembered between pages.
+(function () {
+    var KEY = "beamshaping-docs-sidebar-hidden";
+
+    function stored() {
+        try {
+            return window.localStorage.getItem(KEY) === "1";
+        } catch (e) {
+            return false;
+        }
+    }
+
+    function store(hidden) {
+        try {
+            window.localStorage.setItem(KEY, hidden ? "1" : "0");
+        } catch (e) {
+            // storage unavailable: the choice only lasts for this page
+        }
+    }
+
+    document.addEventListener("DOMContentLoaded", function () {
+        var button = document.createElement("button");
+        button.type = "button";
+        button.className = "pmq-sidebar-toggle";
+
+        function apply(hidden) {
+            document.body.classList.toggle("pmq-sidebar-hidden", hidden);
+            button.innerHTML = hidden ? "&#9776;" : "&laquo;";
+            button.title = hidden ? "Show the navigation sidebar" : "Hide the navigation sidebar";
+            button.setAttribute("aria-label", button.title);
+            button.setAttribute("aria-expanded", hidden ? "false" : "true");
+        }
+
+        button.addEventListener("click", function () {
+            var hidden = !document.body.classList.contains("pmq-sidebar-hidden");
+            apply(hidden);
+            store(hidden);
+        });
+
+        apply(stored());
+        document.body.appendChild(button);
+    });
+})();
diff --git a/docs/src/acknowledgments.rst b/docs/src/acknowledgments.rst
@@ -41,7 +41,7 @@ Main Sources
      - `GitHub: pymodaq_plugins_beam_shaping <https://github.com/PyMoDAQ/pymodaq_plugins_beam_shaping>`_
    * - **Scientific Article**
      - Full manuscript (PDF/LaTeX) provided by the authors (Rollo, Arbouet, Weber)
-     - `To be cited <>`_
+     - To be cited
    * - **PyMoDAQ Documentation**
      - Official guide for extensions and documentation style
      - `pymodaq.cnrs.fr <https://pymodaq.cnrs.fr/en/latest/>`_
@@ -54,10 +54,10 @@ Main Sources
 
 
 Tools Used
----------
+----------
 - **Sphinx** (with ``sphinx-rtd-theme``) for documentation generation.
 - **reStructuredText** (``.rst``) for writing.
-- **LaTeX** for mathematical equations (integrated via ``sphinx.ext.imgmath``).
+- **LaTeX** syntax for mathematical equations (rendered in the browser by MathJax via ``sphinx.ext.mathjax``).
 - **HDF5** for describing the structure of ``.h5beam`` files.
 
 

diff --git a/docs/src/bibtex.bib b/docs/src/bibtex.bib
@@ -208,6 +208,7 @@ @Article{gerchberg_practical_1972
   year     = {1972},
   pages    = {237},
   volume   = {35},
+  url      = {https://web.archive.org/web/20160328053000/http://www.u.arizona.edu/~ppoon/GerchbergandSaxton1972.pdf},
   abstract = {An algorithm is presented for the rapid solution of the phase of the complete wave function whose intensity in the diﬀraction and imaging planes of an imaging system are known. A proof is given showing that a deﬁned error between the estimated function and the correct function must decrease as the algorithm iterates. The problem of uniqueness is discussed and results are presented demonstrating the power of the method.},
   groups   = {pulse shaping},
 }

diff --git a/docs/src/conf.py b/docs/src/conf.py
@@ -33,7 +33,7 @@
     "sphinx_autodoc_typehints",
     'sphinx.ext.doctest',
     'sphinx.ext.coverage',
-    'sphinx.ext.imgmath',
+    'sphinx.ext.mathjax',  # equations rendered in the browser, no LaTeX needed on the build machine (Read the Docs)
     'sphinx.ext.githubpages',
     'sphinx.ext.autosummary',
     'releases',
@@ -53,19 +53,9 @@
     'section': 'Section %s',
 }
 
-html_css_files = [
-    'https://fonts.googleapis.com/icon?family=Material+Icons',
-    'css/custom.css',  # Pour styliser les icônes
-]
-
 bibtex_bibfiles = ['bibtex.bib']  # Chemin relatif à docs/
 bibtex_reference_style = 'author_year'  # Style de citation (ex: "Weber 2021")
 
-# Configuration pour imgmath (équations LaTeX)
-imgmath_image_format = 'png'  # ou 'svg'
-imgmath_font_size = 14
-imgmath_dpi = 150
-
 # -- Options for autodocumentation ---------------------------------------------
 autodoc_member_order = "groupwise"
 autoclass_content = "class"
@@ -120,7 +110,12 @@
 }
 
 html_css_files = [
+    'https://fonts.googleapis.com/icon?family=Material+Icons',
     'css/overflow.css',
+    'css/layout.css',  # full-width content, tables kept within it
+]
+html_js_files = [
+    'js/sidebar_toggle.js',  # button to hide the navigation sidebar
 ]
 
 html_static_path = ["_static", "_images"]  # NOUVEAU: Ajout de "_images"
@@ -134,6 +129,10 @@
     'paging': True,
 }
 
+# -- Options for rediraffe -----------------------------------------------------
+# Redirections of the pages that are renamed or removed, one "old_page new_page" per line (without the extension)
+rediraffe_redirects = 'redirects.txt'
+
 # -- Options for intersphinx ---------------------------------------------------
 intersphinx_mapping = {
     'python': ('https://docs.python.org/3', None),

diff --git a/docs/src/introduction.rst b/docs/src/introduction.rst
@@ -37,6 +37,7 @@ Applications
      - Wavefront correction (aberration compensation).
 
 .. _FIG-schema:
+
 .. figure:: /_images/layout.png
    :alt: General Beam-Shaping Problem
    :width: 90%

diff --git a/docs/src/quick_start.rst b/docs/src/quick_start.rst
@@ -7,7 +7,7 @@ Quick Start
    :alt: Save
    :align: middle
 
-.. |file_open| image:: /_static/icons/folder_open.png
+.. |file_open| image:: /_static/icons/file_open.png
    :height: 20pt
    :alt: Load
    :align: middle
@@ -22,7 +22,7 @@ Quick Start
    :alt: Input
    :align: middle
 
-.. |deblur| image:: /_static/icons/tune.png
+.. |deblur| image:: /_static/icons/deblur.png
    :height: 20pt
    :alt: Corrections
    :align: middle
@@ -128,6 +128,7 @@ Follow these steps to perform your first beam shaping:
 For more details on the interface, see :numref:`FIG-quick-start`.
 
 .. _FIG-quick-start:
+
 .. figure:: /_images/main_app.png
    :alt: BeamShaping User Interface
    :width: 100%

diff --git a/docs/src/redirects.txt b/docs/src/redirects.txt
@@ -0,0 +1 @@
+# "old_page new_page" for each page that is renamed or removed (paths relative to docs/src, without extension)
diff --git a/docs/src/references.rst b/docs/src/references.rst
@@ -1,45 +1,22 @@
 References
-=========
+==========
 
 PyMoDAQ Documentation
 ---------------------
+- To cite PyMoDAQ: :cite:p:`Weber2021`
 - `PyMoDAQ Official Documentation <https://pymodaq.cnrs.fr/en/latest/>`_
 - `Extension Plugins Guide <https://pymodaq.cnrs.fr/en/latest/developer_folder/extension_plugins.html>`_
 - `Plugin Template Repository <https://github.com/PyMoDAQ/pymodaq_plugins_template>`_
 
 Beam Shaping Literature
-----------------------
-.. [Gerchberg1972]
-   Gerchberg, R. W., & Saxton, W. O. (1972).
-   *A practical algorithm for the determination of the phase from image and diffraction plane pictures*.
-   **Optik**, *35*, 237–246.
-   `DOI:10.1088/0030-3946/35/1/002 <https://doi.org/10.1088/0030-3946/35/1/002>`_
+-----------------------
+The articles cited in this documentation:
 
-.. [Pasienski2008]
-   Pasienski, M., & DeMarco, B. (2008).
-   *High-accuracy modal beam shaping*.
-   **Optics Letters**, *33*(15), 1719–1721.
-   `DOI:10.1364/OL.33.001719 <https://doi.org/10.1364/OL.33.001719>`_
-
-.. [Wu2021]
-   Wu, Y., et al. (2021).
-   *Adaptive beam shaping with weighted Gerchberg-Saxton algorithm*.
-   **Optics Express**, *29*(12), 18345–18356.
-   `DOI:10.1364/OE.424917 <https://doi.org/10.1364/OE.424917>`_
-
-.. [MendozaYero2014]
-   Mendoza-Yero, O., et al. (2014).
-   *Encoding amplitude and phase information in a single phase-only spatial light modulator*.
-   **Optics Express**, *22*(13), 16336–16347.
-   `DOI:10.1364/OE.22.016336 <https://doi.org/10.1364/OE.22.016336>`_
-
-.. [Weber2021]
-   Weber, S., et al. (2021).
-   *PyMoDAQ: An open-source, Python-based software for modular data acquisition*.
-   **Journal of Open Source Software**, *6*(60), 2940.
-   `DOI:10.21105/joss.02940 <https://doi.org/10.21105/joss.02940>`_
+.. bibliography::
+   :cited:
+   :style: plain
 
 Plugin Repository
-----------------
+-----------------
 - `PyMoDAQ-BeamShaping GitHub <https://github.com/PyMoDAQ/pymodaq_plugins_beam_shaping>`_
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		# "old_page new_page" for each page that is renamed or removed (paths relative to docs/src, without extension)