Clarify that the Drupal API isn't completely unavailable (#6151) #1160
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: Build docs site | |
| on: | |
| push: | |
| branches: [11.x, 12.x, 13.x] | |
| tags: ["11.*", "12.*", "13.*"] | |
| jobs: | |
| build: | |
| permissions: | |
| contents: write # for git push | |
| name: Build docs and push | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v2 | |
| with: | |
| fetch-depth: 0 | |
| - name: Setup Git | |
| run: | | |
| git config --local user.email "[email protected]" | |
| git config --local user.name "Drush Documentation Bot" | |
| - name: Set up Python 3.8 | |
| uses: actions/setup-python@v2 | |
| with: | |
| python-version: '3.8' | |
| - name: Install Python dependencies | |
| run: | | |
| python -m pip install --upgrade pip | |
| pip install mkdocs==1.4.3 mkdocs-material mike mkdocs-git-authors-plugin mkdocs-redirects mkdocs-git-revision-date-localized-plugin pymdown-extensions git+https://gitlab.com/blacs30/mkdocs-edit-url.git | |
| - name: Setup PHP | |
| uses: shivammathur/setup-php@v2 | |
| with: | |
| php-version: 8.3 | |
| extensions: dom, curl, gd, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite | |
| coverage: none | |
| tools: composer:v2 | |
| - name: Install Composer dependencies | |
| run: composer install --prefer-dist --no-interaction | |
| - name: Install Drupal | |
| run: composer sut:si | |
| env: | |
| UNISH_DB_URL: sqlite://sites/default/files/.ht.sqlite | |
| - name: Drush status | |
| run: ./drush --uri=dev st | |
| - name: Drush mk:docs | |
| run: composer mk:docs | |
| - name: Mike alias | |
| run: mike alias 13.x latest --update-aliases | |
| - name: Mike set-default | |
| run: mike set-default latest | |
| # See https://github.com/jimporter/mike?tab=readme-ov-file#building-your-docs | |
| - name: Mike deploy | |
| run: mike deploy --push ${GITHUB_REF_NAME} | |
| # Build Doctum to gh-pages/api in the gh-pages branch. | |
| - name: Checkout gh-pages branch | |
| uses: actions/checkout@v2 | |
| with: | |
| ref: gh-pages | |
| path: gh-pages | |
| fetch-depth: 0 | |
| - name: Git pull | |
| run: cd gh-pages && git pull | |
| - name: Install Doctum | |
| run: composer doctum-install | |
| - name: Doctum build | |
| run: | | |
| rm -rf gh-pages/latest/api | |
| composer api -- --only-version=${GITHUB_REF_NAME} | |
| - uses: stefanzweifel/git-auto-commit-action@v4 | |
| with: | |
| commit_message: "[CI] Add Doctum build" | |
| repository: gh-pages | |
| commit_user_name: "Drush Documentation Bot" | |
| commit_user_email: "[email protected]" |