name: docs on: push: branches: [ main ] tags: ["*.*.*"] pull_request: branches: [ main ] concurrency: group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.run_id }} cancel-in-progress: ${{ github.event_name == 'pull_request' }} permissions: contents: read jobs: docs: runs-on: ubuntu-24.04 steps: - name: Checkout uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 - name: Setup Ccache id: compiler-cache uses: ./.github/actions/compiler-cache with: key: ${{ github.workflow }}-${{ runner.os }}-${{ runner.arch }} - name: Install Dependencies run: | sudo rm -f /etc/apt/sources.list.d/google-chrome.list sudo rm -f /etc/apt/sources.list.d/microsoft-prod.list sudo apt-get update sudo apt-get install \ gcc \ gobject-introspection \ gtk-doc-tools \ libcairo2-dev \ libfreetype6-dev \ libgirepository1.0-dev \ libglib2.0-dev \ libgraphite2-dev \ libicu-dev \ libpng-dev \ pkg-config \ zlib1g-dev \ help2man - name: Setup Emscripten uses: mymindstorm/setup-emsdk@4528d102f7230f0e7b276855c01ea1159be0e984 # v16 with: version: latest - name: Setup Python uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0 with: python-version: '3.12' - name: Install Python Dependencies run: pip3 install -r .ci/requirements.txt --require-hashes - name: Build HarfBuzz run: | ccache --version meson setup build \ -Dauto_features=enabled \ -Doptimization=2 \ -Ddoc_tests=true \ -Dgpu_demo=disabled \ -Dchafa=disabled meson compile -Cbuild - name: Generate Documentation run: ninja -Cbuild harfbuzz-doc - name: Run Doc Tests run: meson test -Cbuild --print-errorlogs harfbuzz-doc-check - name: Build Web Demos run: | bash util/gpu/web/build.sh bash util/gpu/web/build-webgpu.sh cp util/gpu/web/dom.html util/gpu/web/out/ - name: Stage for deployment run: | mkdir -p build/docs/html/hb-gpu-demo cp util/gpu/web/out/* build/docs/html/hb-gpu-demo/ - name: Deploy if: github.ref_type == 'tag' run: .ci/deploy-docs.sh env: GH_TOKEN: ${{ secrets.DOCS_PUSH_TOKEN }} REVISION: ${{ github.sha }} - name: Save Compiler Cache if: ${{ !cancelled() && steps.compiler-cache.outcome == 'success' }} uses: ./.github/actions/save-compiler-cache with: key: ${{ steps.compiler-cache.outputs.key }} variant: ${{ steps.compiler-cache.outputs.variant }} start: ${{ steps.compiler-cache.outputs.start }}