Merge pull request #1426 from SwiftGGTeam/chenranj-patch-2

Chenranj patch 2

Author: chenranj

.github/workflows/jekyll-gh-pages.yml

@@ -0,0 +1,54 @@
+#! /bin/bash
+
+# Swift 中文版文档发布脚本 - 发布到 GitHub Pages
+# 基于 swiftlang/swift-book 的 update-book-preview 脚本修改
+
+set -eux
+
+REMOTE=${1:-origin}
+CURRENT_COMMIT_HASH="$(git rev-parse --short HEAD)"
+
+# 进入仓库根目录
+cd "$(git rev-parse --show-toplevel)"
+
+# 检出 gh-pages 分支到子目录
+git worktree add --checkout gh-pages "$REMOTE"/gh-pages
+
+# 美化 DocC JSON 输出，便于对比和版本控制
+export DOCC_JSON_PRETTYPRINT="YES"
+
+# 使用 header.html（如果需要不同版本可以先复制）
+# cp -n swift-6.docc/header-publish.html swift-6.docc/header.html
+
+# 构建文档，输出到 gh-pages/docs 子目录
+xcrun docc convert \
+    --experimental-enable-custom-templates \
+    --hosting-base-path the-swift-programming-language-in-chinese-1 \
+    --output-path "./gh-pages/docs" \
+    swift-6.docc
+
+# 如果复制了临时 header，清理掉
+# rm swift-6.docc/header.html
+
+# 提交并推送更改到 gh-pages 分支
+pushd gh-pages
+git add docs
+
+if [[ -n "$(git status --porcelain)" ]]
+then
+    echo "发现文档更新。"
+    echo "正在提交更改到 'gh-pages' 分支并推送到 $REMOTE。"
+    git commit -m "更新 GitHub Pages 文档站点到提交 '$CURRENT_COMMIT_HASH'"
+    echo
+    git push "$REMOTE" HEAD:gh-pages
+else
+    echo "没有发现文档更改。"
+fi
+
+popd
+
+git worktree remove gh-pages
+
+echo "发布完成！"
+echo "GitHub Pages 地址应该是："
+echo "https://你的用户名.github.io/the-swift-programming-language-in-chinese-1/"

.github/workflows/test-publish

@@ -0,0 +1,69 @@
+name: Deploy to GitHub Pages
+
+on:
+  # 在推送到 Swift-6.1 分支时触发
+  push:
+    branches:
+      - Swift-6.1
+  
+  # 允许手动触发
+  workflow_dispatch:
+
+# 设置 GITHUB_TOKEN 的权限以允许部署到 GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# 只允许一个并发部署，跳过正在进行的运行和最新排队的运行之间的运行
+# 但是，不要取消正在进行的运行，因为我们希望允许这些生产部署完成
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # 构建作业
+  build:
+    runs-on: macos-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+      
+      - name: Select Xcode
+        run: sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
+      
+      - name: Build with DocC
+        run: |
+          # 使用 xcrun docc 构建文档
+          xcrun docc convert TSPL.docc \
+            --fallback-display-name "Swift 编程语言" \
+            --fallback-bundle-identifier "org.swift.tspl" \
+            --fallback-bundle-version 6.1 \
+            --additional-symbol-graph-dir . \
+            --output-path ./_site
+      
+      - name: Add custom header and footer
+        run: |
+          # 将自定义的 header 和 footer 应用到生成的页面
+          if [ -f "TSPL.docc/header-publish.html" ] && [ -f "TSPL.docc/footer.html" ]; then
+            find ./_site -name "*.html" -type f -exec sed -i '' '/<\/head>/e cat TSPL.docc/header-publish.html' {} \;
+            find ./_site -name "*.html" -type f -exec sed -i '' '/<\/body>/e cat TSPL.docc/footer.html' {} \;
+          fi
+      
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+
+  # 部署作业
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4