Doxygen->Breathe->Sphinx MLL docs

.github/workflows/publish.yml

@@ -11,6 +11,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install doxygen
 
       - name: "Checkout"
         uses: actions/[email protected]
@@ -25,24 +29,31 @@ jobs:
       - name: "Install python dependencies"
         run: |
           pip3 install setuptools six
-          pip3 install sphinx sphinx-rtd-theme
-          pip3 install guzzle_sphinx_theme
           pip3 install sphinx-fortran
-          # pip3 install sphinx-mathjax-offline
+          pip3 install sphinx_sitemap
+          pip3 install numpy
+          pip3 install breathe
+          pip3 install sphinx-book-theme
+          pip3 install linkchecker
 
       - name: "Build sphinx doc"
         run: |
           cd CGNS-ReST-site
-          chmod +x build.sh
-          ./build.sh
+          make html
         shell: bash
-
+
+      - name: "Check for broken links"
+        run: |
+          cd CGNS-ReST-site/docs/html/
+          linkchecker --check-extern ./index.html
+        continue-on-error: true
+
       - name: "Deploy"
         run: |
           cd CGNS-ReST-site
-          git clone -b gh-pages --single-branch https://github.com/CGNS/cgns-modern.github.io.git docs/_build/deploy
-          rsync -q -av --checksum --progress docs/_build/html/ docs/_build/deploy
-          cd docs/_build/deploy
+          git clone -b gh-pages --single-branch https://github.com/CGNS/cgns-modern.github.io.git docs/deploy
+          rsync -q -av --checksum --progress docs/html/ docs/deploy
+          cd docs/deploy
           git config --global user.name 'autopages'
           git config --global user.email '[email protected]'
           git add --all .

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "CGNS"]
+	path = CGNS
+	url = https://github.com/CGNS/CGNS.git

CGNS-ReST-site/Makefile

@@ -0,0 +1,26 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = ./docs/html
+CURRENT_DIR   = $(shell pwd)
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	git submodule update --remote --merge
+	if [ ! -d $(BUILDDIR) ]; then mkdir -p $(BUILDDIR); fi
+	cp -r ./images "$(BUILDDIR)"
+	@$(SPHINXBUILD) -E -n -c . -b html source "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+#@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

CGNS-ReST-site/_static/css/custom.css

@@ -0,0 +1,10 @@
+/*Disables Dark Mode*/
+button.theme-switch-button {
+    display: none !important;
+}
+/*
+html[data-theme="light"] {
+  --pst-color-link: #56bb92;
+  --pst-color-text-base: #2f3645;
+}
+*/

CGNS-ReST-site/build.sh

@@ -9,6 +9,11 @@
 # this is doc generation for a UNIX host
 # generation is made in a separate directory, change its path here:
 
+CURRENT_DIR=$PWD
+cd ..
+git submodule update --remote --merge
+cd $CURRENT_DIR
+
 export build_dir=./docs/_build/html
 
 cp -r ./images ${build_dir}/