Build and archive documentation from development branches #9006
This file contains hidden or 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 and archive documentation from development branches | |
| on: | |
| push: | |
| branches: | |
| - 'master' | |
| # Future: uncomment when backports are ready | |
| # - 'manager-5.2' | |
| # - 'manager-5.1' | |
| # - 'manager-5.0' | |
| # - 'manager-4.3' | |
| workflow_run: | |
| workflows: ["Update translation files"] # This workflow creates commits, so we need to run after a successful run | |
| types: | |
| - completed | |
| jobs: | |
| # ── Uyuni HTML ───────────────────────────────────────────────────────────── | |
| uyuni-html: | |
| runs-on: ubuntu-latest | |
| container: | |
| image: ghcr.io/uyuni-project/uyuni-docs-builder:latest | |
| steps: | |
| - name: Checkout repository | |
| uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 #v4 | |
| - name: Build toolchain binary and generate configs | |
| run: task setup && task gen | |
| - name: Build Uyuni HTML documentation | |
| run: task publish:uyuni | |
| - name: Archive Uyuni HTML documentation | |
| uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a #v7.0.1 | |
| with: | |
| name: documentation-uyuni-${{ github.ref_name }} | |
| path: build/en/ | |
| # ── MLM HTML ─────────────────────────────────────────────────────────────── | |
| mlm-html: | |
| runs-on: ubuntu-latest | |
| container: | |
| image: ghcr.io/uyuni-project/uyuni-docs-builder:latest | |
| steps: | |
| - name: Checkout repository | |
| uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 #v4 | |
| - name: Build toolchain binary and generate configs | |
| run: task setup && task gen | |
| - name: Build SUSE Multi-Linux Manager HTML documentation | |
| run: task publish:dsc | |
| - name: Archive SUSE Multi-Linux Manager HTML documentation | |
| uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a #v7.0.1 | |
| with: | |
| name: documentation-suse-multi-linux-manager-${{ github.ref_name }} | |
| path: build/en/ | |
| # ── PDFs — English only (for translator review) ──────────────────────────── | |
| pdfs: | |
| runs-on: ubuntu-latest | |
| container: | |
| image: ghcr.io/uyuni-project/uyuni-docs-builder:latest | |
| steps: | |
| - name: Checkout repository | |
| uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 #v4 | |
| - name: Build toolchain binary and generate configs | |
| run: task setup && task gen | |
| - name: Build Uyuni PDFs (English) | |
| run: task pdf:uyuni LANGUAGES=en | |
| - name: Collect Uyuni PDFs | |
| run: task pdf-collect:uyuni LANGUAGES=en | |
| - name: Archive Uyuni PDFs (English) | |
| uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a #v7.0.1 | |
| with: | |
| name: documentation-uyuni-pdf-en-${{ github.ref_name }} | |
| path: build/pdf/en/ | |
| - name: Clean PDF output before MLM build | |
| run: rm -rf build/pdf/en/ | |
| - name: Build SUSE Multi-Linux Manager PDFs (English) | |
| run: task pdf:mlm LANGUAGES=en | |
| - name: Collect MLM PDFs | |
| run: task pdf-collect:mlm LANGUAGES=en | |
| - name: Archive SUSE Multi-Linux Manager PDFs (English) | |
| uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a #v7.0.1 | |
| with: | |
| name: documentation-suse-multi-linux-manager-pdf-en-${{ github.ref_name }} | |
| path: build/pdf/en/ |