Update build doc using html within the details scope (#223)

* Update build doc using html within the details scope

* Apply suggestions from code review

Co-authored-by: erik pernod <erik.pernod@gmail.com>

---------

Co-authored-by: erik pernod <erik.pernod@gmail.com>

Author: hugtalbot

10_Getting_Started/20_Build/10_Linux.md

@@ -28,9 +28,9 @@ You can download and build SOFA in only three steps without any environment inst
 
 <summary>This installation method is advised for developers. It is STRONGLY advised to read through this entire doc page before getting started.</summary>
 
-### Build tools
+<h3>Build tools</h3>
 
-#### Compiler
+<h4>Compiler</h4>
 
 SOFA requires a [C++17 compatible compiler](https://en.cppreference.com/w/cpp/compiler_support#C.2B.2B17_features).  
 On Linux, we officially support **GCC >= 7** and **Clang >= 5**.  
@@ -41,7 +41,7 @@ First, install the standard compilation toolkit with this command:
 sudo apt install build-essential software-properties-common
 ```
 
-##### GCC
+<h5>GCC</h5>
 
 To know which GCC versions are available for your distribution, run this command:
 ```bash
@@ -53,7 +53,7 @@ Then, install the latest one with the usual command (example with gcc-11):
 sudo apt install gcc-11
 ```
 
-##### Clang
+<h5>Clang</h5>
 Clang is an **alternative to GCC**. It compiles approximately two times faster!  
 We recommend to install **Clang 5 or newer**.
 
@@ -68,14 +68,14 @@ sudo apt install clang-12
 ```
 
 
-#### CMake: Makefile generator
+<h4>CMake: Makefile generator</h4>
 
 CMake will be required to configure the SOFA project before compiling it. Note that SOFA requires at least **CMake 3.22**.
 ```bash
 sudo apt install cmake cmake-gui
 ```
 
-#### [optional] Ninja: build system
+<h4>[optional] Ninja: build system</h4>
 
 Ninja is an alternative to Make. It has a better handling of incremental builds.
 
@@ -84,7 +84,7 @@ sudo apt install ninja-build
 ```
 
 
-#### [optional] CCache: caching system
+<h4>[optional] CCache: caching system</h4>
 
 We advise you to use [ccache](https://ccache.dev/). It is by no means
 mandatory, but it will dramatically improve the compilation time if you
@@ -95,9 +95,9 @@ sudo apt install ccache
 ```
 
 
-### Dependencies
+<h3>Dependencies</h3>
 
-#### Core (required)
+<h4>Core (required)</h4>
 
 SOFA requires some libraries:
 
@@ -137,14 +137,14 @@ SOFA requires some libraries:
     sudo apt install libeigen3-dev
     ```
 
-#### Graphical User Interface
+<h4>Graphical User Interface</h4>
 
 The [SOFAGLFW](https://github.com/sofa-framework/SofaGLFW) project is based on both **GLFW** and **ImGui** libraries. It required the following dependencies to be installed:
 ``` {.bash .optional}
 sudo apt install xorg-dev libgtk-3-dev
 ```
 
-#### Plugins (optional)
+<h4>Plugins (optional)</h4>
 
 SOFA **plugins** depend on libraries that are available in the official repositories.  
 You probably don't need them all, but you might find it convenient to
@@ -162,10 +162,10 @@ This list does not cover all available SOFA plugins, only the ones that are buil
    ```
 
 
-### Build SOFA
+<h3>Build SOFA</h3>
 
 
-#### Setup your source and build directories
+<h4>Setup your source and build directories</h4>
 
 To set up clean repositories, we recommend to arrange the SOFA directories
 as follows:
@@ -192,7 +192,7 @@ git clone -b master https://github.com/sofa-framework/sofa.git sofa/src
 ```
 
 
-#### Generate a Makefile with CMake
+<h4>Generate a Makefile with CMake</h4>
 
 0. Activate your venv `source /path/to/sofa-venv/bin/activate` and tell CMake to look there to find pybind11 `export CMAKE_PREFIX_PATH=/path/to/sofa-venv/lib/python3.12/site-packages`
 
@@ -229,7 +229,7 @@ git clone -b master https://github.com/sofa-framework/sofa.git sofa/src
 
 
 
-#### Compile
+<h4>Compile</h4>
 
 To compile, open a terminal in your build directory and run `make` or `ninja` depending on the generator you chose during CMake configuration.
 If you chose "Unix Makefile" as generator, you can enable parallel compilation by specifying the number of parallel build you want by adding the `-j n` option with `n` being the number of desired parallel jobs. 

10_Getting_Started/20_Build/20_MacOS.md

@@ -24,11 +24,10 @@ You can download and build SOFA in only three steps without any environment inst
 <details>
 
 <summary>This installation method is advised for developers. It is STRONGLY advised to read through this entire doc page before getting started.</summary>
-## Build tools
 
-## Build tools
+<h2>Build tools</h2>
 
-### Compiler
+<h3>Compiler</h3>
 
 SOFA requires a [C++17 compatible compiler](https://en.cppreference.com/w/cpp/compiler_support#C.2B.2B17_features).  
 On MacOS, we officially support **MacOS >= 10.13.2 (High Sierra)** and **AppleClang >= 9.1.0**.  
@@ -64,7 +63,7 @@ If your AppleClang version is too low:
 5. Reboot
 
 
-### CMake: Makefile generator
+<h3>CMake: Makefile generator</h3>
 
 SOFA requires at least **CMake 3.22**.
 
@@ -73,7 +72,7 @@ brew install --cask cmake
 ```
 
 
-### [optional] Ninja: build system
+<h3>[optional] Ninja: build system</h3>
 
 Ninja is an alternative to Make. It has a better handling of incremental builds.
 
@@ -82,7 +81,7 @@ brew install ninja
 ```
 
 
-### [optional] CCache: caching system
+<h3>[optional] CCache: caching system</h3>
 
 We advise you to use [ccache](https://ccache.dev/). It is by no means
 mandatory, but it will dramatically improve the compilation time if you
@@ -93,9 +92,9 @@ brew install ccache
 ```
 
 
-## Dependencies
+<h2>Dependencies</h2>
 
-### Core (required)
+<h3>Core (required)</h3>
 
 SOFA requires some libraries:
 -  **tinyXML2**
@@ -133,7 +132,7 @@ SOFA requires some libraries:
     ```
 
 
-### Plugins (optional)
+<h3>Plugins (optional)</h3>
 
 SOFA **plugins** depend on libraries that are available in the official repositories.  
 You probably don't need them all, but you might find it convenient to
@@ -150,10 +149,10 @@ This list does not cover all available SOFA plugins, only the ones that are buil
    ```
 
 
-## Build SOFA
+<h2>Build SOFA</h2>
 
 
-### Setup your source and build directories
+<h3>Setup your source and build directories</h3>
 
 To set up clean repositories, we recommend to arrange the SOFA directories
 as follows:
@@ -180,7 +179,7 @@ git clone -b master https://github.com/sofa-framework/sofa.git sofa/src
 ```
 
 
-### Generate a Makefile with CMake
+<h3>Generate a Makefile with CMake</h3>
 
 0. Activate your venv `source /path/to/sofa-venv/bin/activate` and tell CMake to look there to find pybind11 `export CMAKE_PREFIX_PATH=/path/to/sofa-venv/lib/python3.12/site-packages`
 
@@ -209,7 +208,7 @@ git clone -b master https://github.com/sofa-framework/sofa.git sofa/src
 7. When you are ready, run **Generate**.
 
 
-### Compile
+<h3>Compile</h3>
 
 To compile, open a terminal in your build directory and run `make` or `ninja` depending on the generator you chose during CMake configuration.  
 Do not forget the `-j` option to use all your CPU cores.

10_Getting_Started/20_Build/30_Windows.md

@@ -24,11 +24,10 @@ You can download and build SOFA in only three steps without any environment inst
 <details>
 
 <summary>This installation method is advised for developers. It is STRONGLY advised to read through this entire doc page before getting started.</summary>
-## Build tools
 
-## Build tools
+<h2>Build tools</h2>
 
-### Compiler
+<h3>Compiler</h3>
 
 SOFA requires a [C++17 compatible compiler](https://en.cppreference.com/w/cpp/compiler_support#C.2B.2B17_features).  
 On Windows, we officially support **Microsoft Visual Studio >= 2017** (version 15.7).  
@@ -48,7 +47,7 @@ In the installer, you must enable:
 
 ![](https://www.sofa-framework.org/wp-content/uploads/2020/03/install_vs_ide.png)
 
-### CMake: Makefile generator
+<h3>CMake: Makefile generator</h3>
 
 SOFA requires at least **CMake 3.22.1**.  
 Install CMake with [the latest official installer](https://github.com/Kitware/CMake/releases/latest).
@@ -58,7 +57,7 @@ Install CMake with [the latest official installer](https://github.com/Kitware/CM
 ![](https://www.sofa-framework.org/wp-content/uploads/2019/03/install-cmake.png)
 
 
-### [optional] Ninja: build system
+<h3>[optional] Ninja: build system</h3>
 
 We strongly advise you to use Ninja if you chose to install the Build Tools only (no IDE).
 
@@ -67,9 +66,9 @@ You can download the latest release from [their GitHub repository](https://githu
 
 **IMPORTANT**: do not forget to **add ninja to your system PATH**.
 
-## Dependencies
+<h2>Dependencies</h2>
 
-### Core (required)
+<h3>Core (required)</h3>
 
 SOFA requires some libraries:
 
@@ -97,16 +96,16 @@ SOFA requires some libraries:
     Download and extract the [latest Eigen sources](https://gitlab.com/libeigen/eigen/-/releases).
 
 
-#### [optional] PATH modification
+<h4>[optional] PATH modification</h4>
 
 You can add Boost to your PATH to ease their detection by CMake.  
 **Boost**: add `your/Boost/path` and `your/Boost/path/libXX-msvc-XX`  
 
 
-## Build SOFA
+<h2>Build SOFA</h2>
 
 
-### Setup your source and build directories
+<h3>Setup your source and build directories</h3>
 
 To set up clean repositories, we recommend to arrange the SOFA directories
 as follows:
@@ -132,7 +131,7 @@ git clone -b v25.12 https://github.com/sofa-framework/sofa.git sofa/src
 git clone -b master https://github.com/sofa-framework/sofa.git sofa/src
 ```
 
-### Generate a VS project (.sln) or a Makefile with CMake
+<h3>Generate a VS project (.sln) or a Makefile with CMake</h3>
 
 1. Create build directories respecting the arrangement above.
 
@@ -170,7 +169,7 @@ git clone -b master https://github.com/sofa-framework/sofa.git sofa/src
 10. When you are ready, run **Generate**. In the build directory, this will create a Visual Studio project (.sln) or a Makefile depending on the generator you chose at step 4.
 
 
-### Compile
+<h3>Compile</h3>
 
 To build SOFA in Visual Studio, simply **open the generated Sofa.sln**. Finally, **build the solution** using the Visual Studio interface as shown in the image below:
 
@@ -188,7 +187,7 @@ Time for a coffee!
 
 
 
-### Setup script
+<h3>Setup script</h3>
 
 To simplify the configuration of our continuous integration machines, we created a complete set of setup scripts.
 
@@ -203,7 +202,7 @@ The two scripts `setup-windows_1.bat` and `setup-windows_2.bat` install the mini
 
 
 
-### Compilation tutorial
+<h3>Compilation tutorial</h3>
 
 See our page presenting [video tutorial for compilation on Windows](../../video-tutorials/how-to-compile-sofa/#windows).