name: Generate and Deploy Doxygen Documentation with m.css on: push: branches: - master # Replace with your default branch if different jobs: build: runs-on: ubuntu-latest steps: # Step 1: Checkout the repository - name: Checkout Repository uses: actions/checkout@v3 # Step 2: Install Doxygen and Python - name: Install Doxygen and Python run: | sudo apt-get update sudo apt-get install -y doxygen graphviz python3 python3-pip # Step 3: Clone m.css repository - name: Clone m.css run: | mkdir -p docs/m.css git clone --depth 1 https://github.com/mosra/m.css.git docs/m.css # Step 4: Create Doxyfile - name: Create Doxyfile run: | echo "PROJECT_NAME = fbgl" > Doxyfile echo "PROJECT_NUMBER = 0.1.0" >> Doxyfile echo "OUTPUT_DIRECTORY = docs" >> Doxyfile echo "INPUT = fbgl.h README.md" >> Doxyfile echo "USE_MDFILE_AS_MAINPAGE = README.md" >> Doxyfile echo "FILE_PATTERNS = *.h *.md" >> Doxyfile echo "RECURSIVE = NO" >> Doxyfile echo "GENERATE_HTML = YES" >> Doxyfile echo "HTML_OUTPUT = html" >> Doxyfile echo "GENERATE_LATEX = NO" >> Doxyfile echo "GENERATE_MAN = NO" >> Doxyfile echo "GENERATE_RTF = NO" >> Doxyfile echo "QUIET = YES" >> Doxyfile echo "EXTENSION_MAPPING = md=markdown" >> Doxyfile echo "MARKDOWN_SUPPORT = YES" >> Doxyfile echo "HTML_EXTRA_STYLESHEET = docs/m.css/css/m-dark.css" >> Doxyfile echo "HTML_EXTRA_FILES = docs/m.css/js/m.js docs/m.css/js/m-search.js docs/m.css/css/m-components.css docs/m.css/css/m-layout.css docs/m.css/css/m-style.css docs/m.css/css/m-theme.css" >> Doxyfile # Step 5: Run Doxygen to generate raw HTML files - name: Run Doxygen run: doxygen Doxyfile # Step 6: Process HTML with m.css - name: Apply m.css run: | python3 docs/m.css/documentation/doxygen.py Doxyfile # Step 7: Deploy to GitHub Pages - name: Deploy to GitHub Pages uses: peaceiris/actions-gh-pages@v4 with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_dir: docs/html publish_branch: gh-pages