feat(cherryecat): add cherryecat demo #24
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 Documentation | |
| on: | |
| push: | |
| branches: | |
| - master | |
| - main | |
| paths: | |
| - 'docs/**' | |
| - '.github/versions.json' | |
| - 'projects/**' | |
| pull_request: | |
| paths: | |
| - 'docs/**' | |
| - '.github/versions.json' | |
| - 'projects/**' | |
| workflow_dispatch: | |
| jobs: | |
| validate-versions: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout code | |
| uses: actions/checkout@v4 | |
| with: | |
| fetch-depth: 0 | |
| - name: Set up Python | |
| uses: actions/setup-python@v5 | |
| with: | |
| python-version: '3.11' | |
| - name: Install dependencies | |
| run: | | |
| cd docs/source | |
| pip install -r requirements.txt | |
| - name: Validate version configuration | |
| run: | | |
| cd docs/source | |
| python utils/version_utils.py --validate | |
| build-docs: | |
| needs: validate-versions | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout code | |
| uses: actions/checkout@v4 | |
| with: | |
| fetch-depth: 0 | |
| - name: Set up Python | |
| uses: actions/setup-python@v5 | |
| with: | |
| python-version: '3.11' | |
| - name: Install dependencies | |
| run: | | |
| cd docs/source | |
| pip install -r requirements.txt | |
| - name: Setup Google Chrome for headless PDF | |
| uses: browser-actions/setup-chrome@v1 | |
| - name: Install fonts and locale support | |
| env: | |
| DEBIAN_FRONTEND: noninteractive | |
| run: | | |
| sudo apt-get update | |
| sudo apt-get install -y --no-install-recommends \ | |
| fonts-noto-cjk fonts-wqy-zenhei fonts-wqy-microhei \ | |
| fonts-arphic-uming fonts-arphic-ukai \ | |
| locales | |
| # 生成中英文locale | |
| sudo locale-gen zh_CN.UTF-8 | |
| sudo locale-gen zh_CN.GBK | |
| sudo locale-gen en_US.UTF-8 | |
| sudo locale-gen en_GB.UTF-8 | |
| sudo fc-cache -f -v || true | |
| - name: Verify locale support | |
| run: | | |
| echo "=== 验证locale支持 ===" | |
| echo "可用的locale列表:" | |
| locale -a | grep -E "(zh|en)" || echo "警告: 未找到中英文locale" | |
| echo "当前LANG: $LANG" | |
| echo "当前LC_ALL: $LC_ALL" | |
| echo "=== 测试中文locale ===" | |
| export LANG=zh_CN.UTF-8 | |
| export LC_ALL=zh_CN.UTF-8 | |
| echo "中文LANG: $LANG" | |
| echo "中文LC_ALL: $LC_ALL" | |
| python3 -c "import locale; print('中文Python locale:', locale.getlocale())" | |
| echo "=== 测试英文locale ===" | |
| export LANG=en_US.UTF-8 | |
| export LC_ALL=en_US.UTF-8 | |
| echo "英文LANG: $LANG" | |
| echo "英文LC_ALL: $LC_ALL" | |
| python3 -c "import locale; print('英文Python locale:', locale.getlocale())" | |
| - name: List version configurations | |
| run: | | |
| cd docs/source | |
| echo "=== 版本配置列表 ===" | |
| python utils/version_utils.py --list | |
| - name: Build all versions | |
| env: | |
| CHROME_PATH: ${{ env.CHROME_PATH }} | |
| run: | | |
| cd docs/source | |
| echo "=== 构建环境信息 ===" | |
| echo "LANG: $LANG" | |
| echo "LC_ALL: $LC_ALL" | |
| echo "LC_CTYPE: $LC_CTYPE" | |
| echo "可用的locale:" | |
| locale -a | grep -E "(zh|en)" | head -10 | |
| python3 -c "import locale; print('Python locale:', locale.getlocale())" | |
| echo "=== 开始构建 ===" | |
| echo "注意: 构建管理器将分别为中英文设置正确的locale环境变量" | |
| # 不设置全局locale，让构建管理器自己控制 | |
| python build_manager.py --clean | |
| - name: Upload build artifacts | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: docs-build | |
| path: docs/source/source_build/html | |
| retention-days: 30 | |
| deploy-docs: | |
| needs: build-docs | |
| runs-on: ubuntu-latest | |
| if: github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main' | |
| steps: | |
| - name: Download documentation artifacts | |
| uses: actions/download-artifact@v4 | |
| with: | |
| name: docs-build | |
| path: docs/source/source_build/html | |
| - name: Deploy to GitHub Pages | |
| uses: peaceiris/actions-gh-pages@v4 | |
| with: | |
| github_token: ${{ secrets.GITHUB_TOKEN }} | |
| publish_dir: docs/source/source_build/html | |
| force_orphan: true | |
| user_name: 'github-actions[bot]' | |
| user_email: '41898282+github-actions[bot]@users.noreply.github.com' |