diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 70f503c2..5a48092f 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -48,34 +48,6 @@ jobs: run: php vendor/bin/phan --target-php-version=${{ matrix.php-version }} - build-docs: - name: "Build and publish Docs" - if: github.ref_name == 'main' - runs-on: ubuntu-latest - - steps: - - name: "Checkout sources" - uses: actions/checkout@v4 - - - name: "Install PHP" - uses: shivammathur/setup-php@v2 - with: - php-version: "8.1" - coverage: none - tools: phpDocumentor - extensions: curl, fileinfo, intl, json, mbstring, simplexml, sodium, zlib - - - name: "Build Docs" - run: phpdoc --config=phpdoc.xml.dist - - - name: "Publish Docs to gh-pages" - uses: JamesIves/github-pages-deploy-action@v4 - with: - BRANCH: gh-pages - FOLDER: docs - CLEAN: true - - tests: name: "Unit Tests" needs: static-code-analysis @@ -120,3 +92,65 @@ jobs: with: project-token: ${{ secrets.CODACY_PROJECT_TOKEN }} coverage-reports: .build/coverage/clover.xml + + + build-docs: + name: "Build and publish API docs" + if: github.ref_name == 'main' + runs-on: ubuntu-latest + + steps: + - name: "Checkout sources" + uses: actions/checkout@v4 + + - name: "Install PHP" + uses: shivammathur/setup-php@v2 + with: + php-version: "8.1" + coverage: none + tools: phpDocumentor + extensions: curl, fileinfo, intl, json, mbstring, simplexml, sodium, zlib + + - name: "Build API docs" + run: phpdoc --config=phpdoc.xml.dist + + - name: "Publish API docs to branch gh-pages" + uses: JamesIves/github-pages-deploy-action@v4 + with: + branch: gh-pages + folder: .build/phpdocs + clean: true + + + build-manual: + name: "Build and publish user manual" + if: github.ref_name == 'main' + runs-on: ubuntu-latest + + steps: + - name: "Checkout sources" + uses: actions/checkout@v4 + + - name: "Install PHP" + uses: shivammathur/setup-php@v2 + with: + php-version: "8.1" + coverage: none + + - name: "Install Sphinx" + run: pip install sphinx myst-parser sphinx-rtd-theme + + - name: "Install dependencies with composer" + uses: ramsey/composer-install@v2 + + - name: "Build manual" + run: | + cd docs + make html + + - name: "Publish user manual to branch readthedocs" + uses: JamesIves/github-pages-deploy-action@v4 + with: + branch: readthedocs + folder: .build/sphinx/html + clean: true