doc: Improve vtkext doc #3913
Workflow file for this run
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Generate Website | |
| on: | |
| pull_request: | |
| types: [opened, synchronize, reopened, ready_for_review] | |
| push: | |
| branches: | |
| - master | |
| jobs: | |
| #---------------------------------------------------------------------------- | |
| # webassembly: Build webassembly artifacts | |
| #---------------------------------------------------------------------------- | |
| webassembly: | |
| name: Generate wasm binaries | |
| if: github.event.pull_request.draft == false | |
| strategy: | |
| fail-fast: false | |
| runs-on: ubuntu-latest | |
| container: dockcross/web-wasm:20240529-0dade71 | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| with: | |
| path: 'source' | |
| fetch-depth: 0 | |
| lfs: 'true' | |
| - name: Web Assembly CI | |
| uses: ./source/.github/actions/webassembly-ci | |
| #---------------------------------------------------------------------------- | |
| # generate website | |
| #---------------------------------------------------------------------------- | |
| generate-website: | |
| needs: webassembly | |
| name: Generate Website | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Build Jekyll | |
| uses: actions/jekyll-build-pages@v1 | |
| - name: Install doxygen and build doxygen doc | |
| working-directory: ${{github.workspace}} | |
| run: | | |
| pip install "sphinx==5.3.0" "pydata-sphinx-theme==0.13.1" sphinx-book-theme exhale | |
| sudo apt install doxygen | |
| sphinx-build -M html ./library/doxygen ./library/doxygen/build/ | |
| sudo mv library/doxygen/build/html _site/doc/libf3d/doxygen | |
| sphinx-build -M html ./vtkext/public/doxygen ./vtkext/public/doxygen/build/ | |
| sudo mv vtkext/public/doxygen/build/html _site/doc/libf3d/vtkext_doxygen | |
| - name: Retrieve web assembly binaries | |
| uses: actions/download-artifact@v4 | |
| with: | |
| name: f3d-wasm | |
| path: ./web | |
| - name: Copy web assembly binaries | |
| run: sudo mv web _site/ | |
| - name: Deploy | |
| if: github.ref == 'refs/heads/master' | |
| uses: JamesIves/github-pages-deploy-action@v4 | |
| with: | |
| folder: _site | |
| token: ${{ secrets.GITHUB_TOKEN }} | |
| clean: true |