Publish docs on demand - DEV #2
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: "Publish docs on demand - DEV" | |
| on: workflow_dispatch | |
| jobs: | |
| generate-docs-test: | |
| name: Generate latest library 📚 documentation 📄 | |
| runs-on: ubuntu-latest | |
| permissions: | |
| contents: write | |
| env: | |
| MKDOCS_EXECUTE_JUPYTER: false # execution is done before rendering documentation | |
| MKDOCS_DEV: true | |
| steps: | |
| - uses: actions/checkout@v3 | |
| with: | |
| token: ${{ secrets.DOCS_PAT }} | |
| - name: Setup Python | |
| uses: actions/setup-python@v4 | |
| with: | |
| python-version: "3.10" | |
| - uses: actions/cache@v3 | |
| with: | |
| path: ~/.cache/pip | |
| key: ${{ runner.os }}-pip-dev-${{ hashFiles('**/pdm.lock') }} | |
| restore-keys: | | |
| ${{ runner.os }}-pip-dev- | |
| - name: Install pdm | |
| run: pip install pdm | |
| - name: Regenerate lock with environment markers | |
| run: pdm lock --update-reuse --strategy inherit_metadata | |
| - name: Generate requirements.txt | |
| run: pdm export --no-default -dG docs -dG visualization -f requirements -o requirements.txt | |
| - name: Install dependencies | |
| run: pip install --no-deps -r requirements.txt | |
| - name: Install nbconvert dependency | |
| run: pip install jupyter nbconvert nbformat black | |
| - name: Install srai | |
| run: | | |
| pdm build -v -d dist | |
| pip install 'srai[all] @ file://'"$(pwd)/$(find dist -name '*.whl')" | |
| - name: Configure Git user | |
| run: | | |
| git config --local user.email "github-actions[bot]@users.noreply.github.com" | |
| git config --local user.name "github-actions[bot]" | |
| - name: Cache Overpass data | |
| uses: actions/cache@v3 | |
| with: | |
| path: "**/cache" | |
| key: mkdocs-overpass-dev-cache-${{ runner.os }} | |
| - name: Execute jupyter notebooks | |
| run: | | |
| jupyter nbconvert --to notebook --inplace --execute $(find examples/ -type f -name "*.ipynb") --ExecutePreprocessor.kernel_name='python3' | |
| - uses: jannekem/run-python-script-action@v1 | |
| name: Replace copyright date | |
| with: | |
| script: | | |
| import time | |
| file_name = "mkdocs.yml" | |
| with open(file_name) as f: | |
| data = f.read().replace('{current_year}', time.strftime("%Y")) | |
| with open(file_name, "w") as f: | |
| f.write(data) | |
| - name: Create remote for srai-docs repository | |
| run: git remote add origin-srai-docs https://github.com/kraina-ai/srai-docs | |
| - name: Fetch gh-pages branch | |
| run: git fetch origin-srai-docs gh-pages --depth=1 | |
| - name: Publish dev documentation | |
| run: mike deploy --remote origin-srai-docs --rebase --push dev | |
| deploy-docs-test: | |
| name: Deploy documentation 📄 to Github Pages 🌐 | |
| needs: [generate-docs-test] | |
| runs-on: ubuntu-latest | |
| permissions: | |
| contents: write | |
| pages: write | |
| id-token: write | |
| steps: | |
| - uses: actions/checkout@v3 | |
| with: | |
| repository: 'kraina-ai/srai-docs' | |
| ref: 'gh-pages' | |
| token: ${{ secrets.CICD_PAT_TOKEN }} | |
| - name: Upload artifact | |
| uses: actions/upload-pages-artifact@v2 | |
| with: | |
| # Upload entire repository | |
| path: '.' | |
| - name: Deploy to GitHub Pages | |
| id: deployment | |
| uses: actions/deploy-pages@v2 |