Enhance XML and Markdown Documentation Rendering

- Updated XSLT files to apply templates for parameter descriptions in HTML output, improving the rendering of complex descriptions.
- Introduced a new template for rendering inline links in both HTML and Markdown formats, enhancing navigation within documentation.
- Added emoji icons to various text labels in the Markdown output for better visual appeal and clarity.
- Improved test scripts to skip tests if XML documentation is missing, ensuring robustness in test execution.
- Created a new script to check XML documentation integrity across modules, enhancing documentation quality assurance.
- Refactored existing XML documentation files for consistency and clarity, including translations and formatting adjustments.

Author: Nelson-numerical-software

.github/workflows/codeql-analysis-cpp.yml

@@ -38,7 +38,7 @@ jobs:
       - name: Install dependencies
         run: |
           sudo apt-get update
-          sudo apt -y install apt-transport-https ca-certificates gnupg software-properties-common wget ninja-build xvfb libopenmpi-dev autotools-dev libtool automake openmpi-bin gettext pkg-config libffi-dev libicu-dev libxml2-dev liblapack-dev liblapacke-dev fftw3 fftw3-dev libasound-dev portaudio19-dev libsndfile1-dev libtag1-dev alsa-utils libsqlite3-dev libgl-dev hdf5-tools zlib1g-dev libcurl4-openssl-dev libgit2-dev libboost-all-dev libeigen3-dev libhdf5-dev libmatio-dev qt6-base-dev libqt6svg6-dev qt6-declarative-dev qt6-documentation-tools qml6-module-qtquick qml6-module-qtquick-templates qml6-module-qtquick-controls qml6-module-qtquick-window qml6-module-qtquick-dialogs qml6-module-qtqml-workerscript qml6-module-qtquick-layouts assistant-qt6 qt6-tools-dev libgif-dev
+          sudo apt -y install apt-transport-https ca-certificates gnupg software-properties-common wget ninja-build xvfb libopenmpi-dev autotools-dev libtool automake openmpi-bin gettext pkg-config libffi-dev libicu-dev libxml2-dev libxslt1-dev liblapack-dev liblapacke-dev fftw3 fftw3-dev libasound-dev portaudio19-dev libsndfile1-dev libtag1-dev alsa-utils libsqlite3-dev libgl-dev hdf5-tools zlib1g-dev libcurl4-openssl-dev libgit2-dev libboost-all-dev libeigen3-dev libhdf5-dev libmatio-dev qt6-base-dev libqt6svg6-dev qt6-declarative-dev qt6-documentation-tools qml6-module-qtquick qml6-module-qtquick-templates qml6-module-qtquick-controls qml6-module-qtquick-window qml6-module-qtquick-dialogs qml6-module-qtqml-workerscript qml6-module-qtquick-layouts assistant-qt6 qt6-tools-dev libgif-dev
 
       # Build the bit of source code that we want to see analysed
       - name: Build

ROADMAP.md

@@ -1,74 +1,95 @@
 # Roadmap
 
-The roadmap is a living document, and it is likely that priorities will change, but the list below should give some indication of our plans for the next major release, and for the future.
+The roadmap is a living document. Priorities will change, but the list below gives an indication of planned work for the next major release and beyond.
 
-Please feel free to file issues on this repository if you have questions, concerns, or suggestions.
+Please file issues on this repository if you have questions, concerns, or suggestions.
+
+## Table of Contents
+
+- [Nelson 2.0.0](#nelson-200)
+  - [Core Improvements](#core-improvements)
+  - [Documentation & Format rework](#documentation--format-rework)
+  - [Modules and Extensions](#modules-and-extensions)
+  - [User Interface (GUI)](#user-interface-gui)
+  - [Plotting Features](#plotting-features)
+  - [Data Handling and Compatibility](#data-handling-and-compatibility)
+- [How Can You Contribute?](#how-can-you-contribute)
+- [Contributing to the Roadmap](#contributing-to-the-roadmap)
+- [Previous roadmap](#previous-roadmap)
 
 ## Nelson 2.0.0
 
 ### Core Improvements
 
-- Bug resolution and ongoing maintenance,
-- Native package development/support:
-  - ArchLinux (DONE v1.3.0),
-  - macOs,
-  - Fedora (DONE v1.14.0),
-  - NixOS (DONE v1.11.0),
-  - Ubuntu 24.04 ARM64 (DONE v1.11.0),
-  - etc ...
-- Integration of Windows ARM64 support,
-- Performance optimization for increased speed,
-- Code factorization for improved maintainability,
-- Expansion of compatible functions,
-- Comprehensive support for sparse operations.
+- Bug resolution and ongoing maintenance
+- Native package development/support
+  - ArchLinux (DONE v1.3.0)
+  - macOS
+  - Fedora (DONE v1.14.0)
+  - NixOS (DONE v1.11.0)
+  - Ubuntu 24.04 ARM64 (DONE v1.11.0)
+  - etc.
+- Integration of Windows ARM64 support
+- Performance optimization for increased speed
+- Code factorization for improved maintainability
+- Expansion of compatible functions
+- Comprehensive support for sparse operations
+
+### Documentation
+
+- Rework help_tools into a searchable, context‑aware help system (Markdown sources) (DONE v1.15.0)
+- Provide multi‑format export (LaTeX/Pandoc → PDF/HTML/DOCX) (DONE v1.15.0)
+- Publish a versioned online docs site with autogenerated API reference and search (DONE v1.15.0)
+- Add contributor tooling (DONE v1.15.0)
+- Localization (French) (DONE v1.15.0)
 
 ### Modules and Extensions
 
-- Julia interface (DONE v1.12.0),
-- Compatible python interface (DONE v1.5.0),
-- Incorporate an Image Processing module,
-- Optimization of code execution using NPU/GPU arrays,
-- Integrate additional numerical methods,
-- xlsx reader/writer on all platforms,
-- NetCDF reader/writer,
-- Nelson as an FMU engine (LGPL v3),
-- FMI import support,
-- LLMs features,
-- Extend compatibility with WebAssembly (wasm),
-- Commands and functionalities related to debugging and code editing,
-- VS Code server,
-- Jupyter kernel.
+- Julia interface (DONE v1.12.0)
+- Compatible python interface (DONE v1.5.0)
+- Incorporate an Image Processing module
+- Optimization of code execution using NPU/GPU arrays
+- Integrate additional numerical methods
+- xlsx reader/writer on all platforms
+- NetCDF reader/writer
+- Nelson as an FMU engine (LGPL v3)
+- FMI import support
+- LLMs features
+- Extend compatibility with WebAssembly (wasm)
+- Commands and functionalities related to debugging and code editing
+- VS Code server
+- Jupyter kernel
 
 ### User Interface (GUI)
 
-- History browser (DONE v1.1),
-- File browser (DONE v1.1),
-- Workspace browser (DONE v1.1),
-- Variable browser (DONE v1.15),
-- RSS viewer,
-- Demo viewer,
-- Include a Webview for enhanced web interaction.
+- History browser (DONE v1.1)
+- File browser (DONE v1.1)
+- Workspace browser (DONE v1.1)
+- Variable browser (DONE v1.15)
+- RSS viewer
+- Demo viewer
+- Include a Webview for enhanced web interaction
 
 ### Plotting Features
 
-- Introduction of uicontrol (v1.7.0),
-- Implementation of contour plots (DONE v1.3.0),
-- Enhancement of plot interaction features (e.g., zoom functionality, etc.) (DONE v1.2.0).
+- Introduction of uicontrol (v1.7.0)
+- Implementation of contour plots (DONE v1.3.0)
+- Enhancement of plot interaction features (e.g., zoom) (DONE v1.2.0)
 
 ### Data Handling and Compatibility
 
-- Development of Table, Timeseries, and Dictionary-compatible objects,
+- Development of Table, Timeseries, and Dictionary-compatible objects
   - dictionary (DONE v1.5.0)
   - table (DONE v1.8.0)
 - Rework and extend the interpreter for enhanced compatibility
 
 ## How Can You Contribute?
 
-Our short-term objectives are outlined above, with the aim of distributing the workload to encourage community involvement. If you wish to contribute, please comment on relevant issues to avoid duplication of effort. If a maintainer is already assigned to an issue you're interested in, reach out to them on GitHub to offer your assistance.
+Our short-term objectives are outlined above to encourage community involvement. If you wish to contribute, comment on relevant issues to avoid duplication. If a maintainer is already assigned to an issue, reach out on GitHub to offer assistance.
 
 ## Contributing to the Roadmap
 
-The roadmap process reflecting our commitment to transparency. As we continue to structure and document project objectives, we encourage collaboration with the community to focus our efforts on prioritized topics. Feel free to propose additions or adjustments to the roadmap as needed.
+The roadmap process reflects our commitment to transparency. As we structure and document project objectives, we encourage community collaboration to focus efforts on prioritized topics. Propose additions or adjustments to the roadmap as needed.
 
 ## Previous roadmap
 

modules/audio/help/en_US/xml/soundsc.xml

@@ -35,7 +35,7 @@
     <description>
         <p>
             <b>soundsc</b> scales the values of audio signal <b
-      >y </b>to fit in the range from <b>–1.0</b> to <b
+      >y </b> to fit in the range from <b>–1.0</b> to <b
       >1.0</b> and play as sound.
 	</p>
         </description>

modules/audio/help/fr_FR/xml/soundsc.xml

@@ -36,7 +36,7 @@
     <description>
         <p>
             <b>soundsc</b> met à l'échelle les valeurs du signal audio <b
-      >y </b>pour s'adapter à la plage de <b>–1.0</b> à <b
+      >y </b> pour s'adapter à la plage de <b>–1.0</b> à <b
       >1.0</b> et joue comme son.
 	</p>
         </description>

modules/control_system/help/fr_FR/xml/balreal.xml

@@ -38,8 +38,8 @@
     </param_output>
     <description>
         <p>
-            <b>balreal(sys)</b> calculates a balanced realization, denoted as <b
-      >sysb</b>, for the stable segment of the linear time-invariant (LTI) model <b
+            <b>balreal(sys)</b> calcule une réalisation équilibrée, notée <b
+      >sysb</b>, pour la partie stable du modèle linéaire invariant dans le temps (LTI) <b
       >sys</b>.</p>
             <p
     >Ce processus s'applique aussi bien aux systèmes continus que discrets. Si <b

modules/control_system/help/fr_FR/xml/bdschur.xml

@@ -23,7 +23,7 @@
     <param_output>
         <param_output_item>
             <param_name>T</param_name>
-            <param_description>Transformation matrix.</param_description>
+            <param_description>Matrice de transformation.</param_description>
         </param_output_item>
         <param_output_item>
             <param_name>B</param_name>
@@ -34,9 +34,9 @@
     <description>
         <p>
             <b
-      >[T, B] = bdschur(A, CONDMAX)</b> calculates a transformation matrix <b
-      >T</b>, where <b
-      >B = T \ A * T</b> results in a block diagonal matrix with each block being a quasi upper-triangular Schur matrix, ensuring the diagonalization of matrix A while preserving certain structural properties.</p>
+      >[T, B] = bdschur(A, CONDMAX)</b> calcule une matrice de transformation <b
+      >T</b>, où <b
+      >B = T \ A * T</b> donne une matrice diagonale par blocs, chaque bloc étant une matrice de Schur quasi triangulaire supérieure, assurant la diagonalisation de la matrice A tout en préservant certaines propriétés structurelles.</p>
         </description>
         <used_function>MB03RD</used_function>
         <bibliography

modules/control_system/help/fr_FR/xml/bode.xml

@@ -21,19 +21,19 @@
         <param_input_item>
             <param_name>wIn</param_name>
             <param_description
-      >a cell {wmin, wmax} or a vector [wmin:wmax].</param_description>
+      >une cellule {wmin, wmax} ou un vecteur [wmin:wmax].</param_description>
         </param_input_item>
         <param_input_item>
             <param_name>lineSpec</param_name>
             <param_description
-      >Line style, marker, and color.</param_description>
+      >Style de ligne, marqueur et couleur.</param_description>
         </param_input_item>
     </param_input>
     <param_output>
         <param_output_item>
             <param_name>magnitude</param_name>
             <param_description
-      >Magnitude: size 1 x 1 x k (SISO).</param_description>
+      >Amplitude : taille 1 x 1 x k (SISO).</param_description>
         </param_output_item>
         <param_output_item>
             <param_name>phase</param_name>

modules/control_system/help/fr_FR/xml/c2d.xml

@@ -20,16 +20,17 @@
         <param_input_item>
             <param_name>B</param_name>
             <param_description
-      >Input-to-state matrix: Nx-by-Nu matrix.</param_description>
+      >Matrice entrée-état : matrice Nx-par-Nu.</param_description>
         </param_input_item>
         <param_input_item>
             <param_name>Ts</param_name>
-            <param_description>Sample time: positive scalar.</param_description>
+            <param_description
+      >Temps d'échantillonnage : scalaire positif.</param_description>
         </param_input_item>
         <param_input_item>
             <param_name>sysc</param_name>
             <param_description
-      >Continuous-time dynamic system: LTI model.</param_description>
+      >Système dynamique en temps continu : modèle LTI.</param_description>
         </param_input_item>
         <param_input_item>
             <param_name>method</param_name>
@@ -38,30 +39,32 @@
         </param_input_item>
         <param_input_item>
             <param_name>w0</param_name>
-            <param_description>prewarp frequency.</param_description>
+            <param_description>fréquence de pré-distorsion.</param_description>
         </param_input_item>
     </param_input>
     <param_output>
         <param_output_item>
             <param_name>P</param_name>
-            <param_description>phi</param_description>
+            <param_description
+      >Matrice de transition d'état (phi)</param_description>
         </param_output_item>
         <param_output_item>
             <param_name>G</param_name>
-            <param_description>gamma</param_description>
+            <param_description
+      >gamma (matrice de commande discrète)</param_description>
         </param_output_item>
         <param_output_item>
             <param_name>sysd</param_name>
-            <param_description>Discrete-time model</param_description>
+            <param_description>Modèle en temps discret</param_description>
         </param_output_item>
     </param_output>
     <description>
-        <p>The function <b
-      >sysd = c2d(sysc, Ts)</b> discretizes the continuous-time dynamic system model <b
-      >sysc</b> using a zero-order hold on the inputs with a sample time of <b
+        <p>La fonction <b
+      >sysd = c2d(sysc, Ts)</b> discrétise le modèle dynamique en temps continu <b
+      >sysc</b> en utilisant un maintien d'ordre zéro sur les entrées avec un temps d'échantillonnage de <b
       >Ts</b>.</p>
-        <p>For instance, you can use <b
-      >sysd = c2d(sysc, Ts, method)</b> to explicitly specify the discretization method.</p>
+        <p>Par exemple, vous pouvez utiliser <b
+      >sysd = c2d(sysc, Ts, method)</b> pour spécifier explicitement la méthode de discrétisation.</p>
     </description>
     <examples>
         <example_item>

modules/control_system/help/fr_FR/xml/compreal.xml

@@ -49,10 +49,11 @@
         <p>
             <b
       >[A, B, C, D, E] = compreal(numerator, denominator)</b> calcule une réalisation d'espace d'état représentée par les matrices A, B, C, D et E.</p>
-            <p>The <b
-      >E</b> matrix is an empty matrix (identity matrix) when there are at least as many poles as zeros.</p>
-            <p>However, if there are more zeros than poles, the <b
-      >E</b> matrix becomes singular.</p>
+            <p>La matrice <b
+      >E</b> est une matrice vide (matrice identité) lorsqu'il y a au moins autant de pôles que de zéros.</p>
+            <p
+    >Cependant, si le nombre de zéros dépasse celui des pôles, la matrice <b
+      >E</b> devient singulière.</p>
         </description>
         <examples>
             <example_item>

modules/control_system/help/fr_FR/xml/freqresp.xml

@@ -11,17 +11,18 @@
     <param_input>
         <param_input_item>
             <param_name>sys</param_name>
-            <param_description>LTI model</param_description>
+            <param_description>modèle LTI</param_description>
         </param_input_item>
         <param_input_item>
             <param_name>w</param_name>
-            <param_description>Frequencies: vector</param_description>
+            <param_description>Fréquences : vecteur.</param_description>
         </param_input_item>
     </param_input>
     <param_output>
         <param_output_item>
             <param_name>H</param_name>
-            <param_description>Frequency response values</param_description>
+            <param_description
+      >Valeurs de réponse en fréquence</param_description>
         </param_output_item>
         <param_output_item>
             <param_name>wout</param_name>