Merge pull request #179 from bakpaul/25_04_add_header_for_auto_generated_plugin_lists

Add headers for auto generated plugin list

Author: hugtalbot

10_Getting_Started/20_Build/10_Linux.md

@@ -230,13 +230,19 @@ git clone -b master https://github.com/sofa-framework/sofa.git sofa/src
    - choose the build type by setting CMAKE_BUILD_TYPE to "Release" or "RelWithDebInfo" (recommended) or "Debug"   
    - activate or deactivate plugins: see PLUGIN_XXX variables
    - activate or deactivate functionalities: see SOFA_XXX variables
+
+   /// note | What is there to activate ?
+   [Here](../activate-plugins/) is an exhaustive list of plugins that can be activated for an in-tree compilation.
+   ///
 
    Do not forget to **Configure** again to check if your changes are valid.
 
 9. When you are ready, run **Generate**.
 
 
 
+
+
 ## Compile
 
 To compile, open a terminal in your build directory and run `make` or `ninja` depending on the generator you chose during CMake configuration.

10_Getting_Started/20_Build/20_MacOS.md

@@ -195,6 +195,12 @@ git clone -b master https://github.com/sofa-framework/sofa.git sofa/src
    
    Do not forget to **Configure** again to check if your changes are valid.
 
+   /// note | What is there to activate ?
+   [Here](../activate-plugins/) is an exhaustive list of plugins that can be activated for an in-tree compilation.
+   ///
+
+
+
 7. When you are ready, run **Generate**.
 
 

10_Getting_Started/20_Build/30_Windows.md

@@ -156,6 +156,10 @@ git clone -b master https://github.com/sofa-framework/sofa.git sofa/src
 
    Do not forget to **Configure** again to check if your changes are valid.
 
+   /// note | What is there to activate ?
+   [Here](../activate-plugins/) is an exhaustive list of plugins that can be activated for an in-tree compilation.
+   ///
+
 9. 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.
 
 

10_Getting_Started/20_Build/50_Activate_Plugins.md

@@ -0,0 +1,17 @@
+# Activable plugins for in-tree compilation
+
+Multiple extensions can be activated when building the project. They fall into three categories:
+1. Applications: extensions that offer SOFA-based executable applications (e.g. a main for launching SOFA)
+2. Plugins: extensions that enriche the SOFA API by adding new components or providing more support for external libraries (e.g. new constitutive laws, alternative GUIs)
+3. Directories: extensions that contain multiple CMake projects that cannot be described by only one of the above type
+Moreover, these projects are either present in the SOFA sources or they need to be fetched (meaning that they have their own external repository).
+
+This page aims at summarizing those extensions in tables containing:
+- the name + hyperlink to the extension sources either in the SOFA repository or in its own repository
+- a short description
+- activation directives
+
+The activation directives propose two ways of activating those plugins in the build tree:
+1. Through custom CMake flags that [can be added during the CMake call](https://cmake.org/cmake/help/latest/manual/cmake.1.html#cmdoption-cmake-D). All of those plugins can be activated with one or two CMake flags named using their type and name. For example, the plugin SofaPython3 can be activated by activating both flags `SOFA_FETCH_SOFAPYTHON3=ON` and `PLUGIN_SOFAPYTHON3=ON` (because its sources are in a separate repository).
+2. Through preset that can be [specified during the CMake call](https://cmake.org/cmake/help/latest/manual/cmake-presets.7.html#introduction)
+

35_Plugins/45_Suported_Plugins_List.md

@@ -0,0 +1,8 @@
+# Officially supported plugins
+
+This page aims at summarizing all plugins that are officially supported by the SOFA consortium.
+This means that the SOFA consortium commits to:
+1. Including them in our continuous integration pipeline, thus assessing the compilation at every push in the SOFA master branch, at each new pull-request and at each nightly build
+2. Including them in the official bi-annual SOFA binaries 
+3. Providing technical support on these plugins
+