Files
Luong NGUYEN 3885943071 fix(release): address review feedback — subtitle wiring, zh guard, empty-dist guard
- Wire language-specific subtitle through EPUBConfig.subtitle field so
  create_cover_image renders the correct cover text per --lang instead
  of always using the hardcoded English defaults
- Add continue-on-error for zh matrix leg (zh/ content not yet populated)
  and explicit permissions: contents: read on the build job
- Add 'Check artifacts exist' guard step before Create Release so an
  all-languages-fail scenario produces a clear failure rather than
  confusing softprops errors; make 'List built artifacts' tolerant of
  an empty dist/
2026-04-07 09:03:22 +02:00

99 lines
2.8 KiB
YAML

name: Build and Release EPUB
on:
push:
tags:
- 'v*'
jobs:
build:
name: Build EPUB (${{ matrix.lang }})
runs-on: ubuntu-latest
continue-on-error: ${{ matrix.continue-on-error == true }}
permissions:
contents: read
strategy:
# Don't cancel other languages if one fails — we still want to release
# whichever languages built successfully.
fail-fast: false
matrix:
lang: [en, vi, zh]
include:
# zh/ content is scaffolded but not yet populated; allow this leg
# to fail without blocking the release of en/vi EPUBs.
- lang: zh
continue-on-error: true
steps:
- uses: actions/checkout@v4
- name: Install uv
uses: astral-sh/setup-uv@v4
- name: Install Node.js
uses: actions/setup-node@v4
with:
node-version: '20'
- name: Install Mermaid CLI
run: npm install -g @mermaid-js/mermaid-cli
- name: Install Python dependencies
run: |
uv venv
uv pip install -r scripts/requirements-dev.txt
- name: Build EPUB
run: |
echo '{"args":["--no-sandbox","--disable-setuid-sandbox"]}' > /tmp/puppeteer-ci.json
uv run scripts/build_epub.py \
--lang ${{ matrix.lang }} \
--puppeteer-config /tmp/puppeteer-ci.json
- name: Upload EPUB artifact
uses: actions/upload-artifact@v4
with:
name: epub-${{ matrix.lang }}
path: claude-howto-guide*.epub
if-no-files-found: error
retention-days: 7
release:
name: Publish GitHub Release
needs: build
# Release even if some language builds failed — we still publish the
# artifacts that did build. `needs.build.result != 'cancelled'` guards
# against manually cancelled runs.
if: ${{ always() && needs.build.result != 'cancelled' }}
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- name: Download all EPUB artifacts
uses: actions/download-artifact@v4
with:
path: dist
pattern: epub-*
merge-multiple: true
- name: List built artifacts
run: ls -lh dist/ 2>/dev/null || echo "dist/ is empty or does not exist"
- name: Check artifacts exist
id: check_artifacts
run: |
count=$(ls dist/*.epub 2>/dev/null | wc -l)
echo "count=$count" >> $GITHUB_OUTPUT
if [ "$count" -eq 0 ]; then
echo "No EPUB artifacts were built — skipping release."
exit 1
fi
- name: Create Release
uses: softprops/action-gh-release@v2
with:
files: dist/*.epub
generate_release_notes: true
fail_on_unmatched_files: true