# Based on https://gist.github.com/domenic/ec8b0fc8ab45f39403dd name: Build Docs on: pull_request: branches: - main push: branches: - main jobs: build: name: Build docs runs-on: ubuntu-latest steps: - name: Checkout uses: actions/checkout@v3 - name: Setup Lua uses: leafo/gh-actions-lua@v8 with: luaVersion: 5.4 - name: Setup Lua Rocks uses: leafo/gh-actions-luarocks@v4 - name: Setup dependencies run: luarocks install ldoc - name: Build docs run: | echo "Current directory contents:" ls -la echo "Creating output directory..." mkdir -p out echo "Running LDoc..." ldoc -c $(pwd)/config.ld $(pwd)/src --verbose --ext md echo "Output directory contents:" ls -la out/ # Fail if no files were generated if [ -z "$(ls -A out/)" ]; then echo "Error: No documentation files were generated!" exit 1 fi - name: Deploy if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }} uses: peaceiris/actions-gh-pages@v3 with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_dir: ./out force_orphan: true # Start with a fresh branch each time commit_message: "docs: update documentation [skip ci]"