deploy doxygen code documentation (#711)

* deploy doxygen code documentation

* add tests to doc page

* tmp deploy with this branch

* update project name

* update exclude dir

* disable jekyll

* exclude dirs

* try darkmode

* reset link

* fix link

* add doxygen link in README

* set develop as deployer

* set README.md as main page

* tmp

* add .md docs

* try latex

* update OG

* update doc

* remove unwanted character

* develop as the only deployer

.github/workflows/doxygen.yml

@@ -0,0 +1,44 @@
+name: GitHub Pages
+
+on:
+  push:
+    branches:
+      - develop  # Set a branch name to trigger deployment
+
+jobs:
+  deploy:
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: write
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.ref }}
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          submodules: true  # Fetch Hugo themes (true OR recursive)
+          fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod
+
+      - name: theme
+        run: |
+             git clone https://github.com/jothepro/doxygen-awesome-css.git
+             cd doxygen-awesome-css
+             git checkout v2.2.1
+             git apply ../docs/antares-xpansion.patch
+             
+      - name: Doxygen
+        uses: mattnotmitt/doxygen-action@1.9.5
+        with:
+          doxyfile-path:  docs/Doxyfile
+
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        # If you're changing the branch from main,
+        # also change the `main` in `refs/heads/main`
+        # below accordingly.
+        if: github.ref == 'refs/heads/develop'
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./html
+
+
+

README.md

@@ -11,6 +11,9 @@ The [Antares-Xpansion][xpansion-github] package, works along with RTE's adequacy
 
 Please see the [Antares-Xpansion Documentation][readthedocs] for an introductory tutorial,
 and a full user guide.
+
+For developers: [here][xpansion-doxygen] you can find doxygen code documentation.
+
 Check out the [Antares-Simulator documentation][readthedocs-antares] for more insights on Antares. 
 
 Antares-Xpansion optimizes the investments on new capacities and transmission lines for an Antares study. Typical uses of Antares-Xpansion are for example:
@@ -133,6 +136,7 @@ For build instructions, please visit the [developer guide][developer-guide].
 [antares_xpansion_release_url]: https://github.com/AntaresSimulatorTeam/antares-xpansion/releases
 
 [xpansion-github]: https://github.com/AntaresSimulatorTeam/antares-xpansion
+[xpansion-doxygen]: https://antaressimulatorteam.github.io/antares-xpansion
 [antares-github]: https://github.com/AntaresSimulatorTeam/Antares_Simulator
 [readthedocs]: https://antares-xpansion.readthedocs.io/
 [readthedocs-antares]: https://antares-doc.readthedocs.io/