Merge pull request #1427 from SwiftGGTeam/Swift-6.1

Swift 6.1

Author: chenranj

.gitbook.yaml

@@ -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

.github/workflows/test-publish

@@ -4,7 +4,5 @@
 /.build
 /Package.resolved
 /TSPL.docc/header.html
+/TSPL.docc/ReferenceManual/SummaryOfTheGrammar.md
 /swift-book
-node_modules
-package-lock.json
-docs