Merge branch 'main' into upstream-sync

Author: SamYin Kim

.github/workflows/jekyll.yml

@@ -0,0 +1,64 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+# Sample workflow for building and deploying a Jekyll site to GitHub Pages
+name: Deploy Jekyll site to Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@8575951200e472d5f2d95c625da0c7bec8217c42 # v1.161.0
+        with:
+          ruby-version: '3.1' # Not needed with a .ruby-version file
+          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+          cache-version: 0 # Increment this number if you need to re-download cached gems
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v5
+      - name: Build with Jekyll
+        # Outputs to the './_site' directory by default
+        run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
+        env:
+          JEKYLL_ENV: production
+      - name: Upload artifact
+        # Automatically uploads an artifact from the './_site' directory by default
+        uses: actions/upload-pages-artifact@v3
+
+  # Deployment job
+  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

404.md

@@ -1,12 +1,12 @@
 ---
 layout: new-layouts/base
-title: Internal Server Error
+title: 页面未找到
 permalink: /404.html
 ---
 
 <section id="exception">
     <div class="content">
-        <h1>Not Found</h1>
-        <p>The page you're looking for can’t be found.</p>
+        <h1>页面未找到</h1>
+        <p>抱歉，您访问的页面不存在。</p>
     </div>
 </section>

500.md

@@ -1,10 +1,10 @@
 ---
 layout: new-layouts/base
-title: Internal Server Error
+title: 服务器内部错误
 permalink: /500.html
 ---
 
 <section class="section">
-    <h1>Internal Server Error</h1>
-    The server encountered an error and was unable to complete your request.
+    <h1>服务器内部错误</h1>
+    服务器遇到错误，无法完成您的请求。
 </section>

CNAME

@@ -0,0 +1 @@
+swift.swiftgg.team

Gemfile.lock

@@ -7,7 +7,7 @@ GEM
     bigdecimal (3.1.8)
     colorator (1.1.0)
     concurrent-ruby (1.3.4)
-    csv (3.3.0)
+    csv (3.3.2)
     em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)
@@ -58,15 +58,15 @@ GEM
     rb-fsevent (0.11.2)
     rb-inotify (0.11.1)
       ffi (~> 1.0)
-    rexml (3.3.9)
+    rexml (3.4.0)
     rouge (4.5.1)
     safe_yaml (1.0.5)
     sass-embedded (1.81.0-arm64-darwin)
       google-protobuf (~> 4.28)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
     unicode-display_width (2.6.0)
-    webrick (1.9.0)
+    webrick (1.9.1)
 
 PLATFORMS
   arm64-darwin

README.md

@@ -1,39 +1,41 @@
-# Swift.org Website
+# Swift.org 官方网站
 
-## Overview
+> 本项目由 [SwiftGG 翻译组](https://swiftgg.team)负责翻译维护。
 
-Swift.org website goals include:
 
-1. Welcome the curious about the Swift programming language.
-2. Share knowledge with the Swift users community and prospective users, including instructions for getting started with Swift as easily as possible, user guides, best practices, API documentation and feature announcements.
-3. Share knowledge with the Swift contributors community and prospective contributors, including contribution guides, technical details that assist contributions, project governance and legal information.
-4. Highlight community driven initiatives and technical work that have broad applicability to Swift users in all or some of its core usage domains.
+## 概述
 
-See [website overview](/website) for more information about the Swift.org website goals, content governance and contribution guidelines.
+Swift.org 网站的目标包括：
 
-## Technical
+1. 欢迎对 Swift 编程语言感兴趣的人。
+2. 与 Swift 用户社区和潜在用户分享知识，包括尽可能简单的 Swift 入门指南、用户指南、最佳实践、API 文档和功能公告。
+3. 与 Swift 贡献者社区和潜在贡献者分享知识，包括贡献指南、辅助贡献的技术细节、项目治理和法律信息。
+4. 突出展示社区驱动的计划和技术工作，这些工作适用于 Swift 在其所有或部分核心使用领域的用户。
 
-Swift.org uses [Jekyll](https://jekyllrb.com), a blog-aware, static site generator in Ruby.
+有关 Swift.org 网站目标、内容治理和贡献指南的更多信息，请参阅[网站概述](/website)。
 
-### Running locally
+## 技术细节
 
-Requirements
+Swift.org 使用 [Jekyll](https://jekyllrb.com)，这是一个用 Ruby 编写的支持博客的静态站点生成器。
+
+### 本地运行
+
+要求：
 - Git
-- Ruby 3.3 or higher
-  _(a Ruby installation manager, such as
-  [rbenv](https://github.com/sstephenson/rbenv) or
-  [RVM](https://rvm.io) is recommended, but not required)_
+- Ruby 3.3 或更高版本
+  _(推荐使用 Ruby 安装管理器，如
+  [rbenv](https://github.com/sstephenson/rbenv) 或
+  [RVM](https://rvm.io)，但不是必需的)_
 - [Bundler](https://bundler.io/)
 
-To run the site locally, enter the following commands into a terminal window:
+要在本地运行网站，请在终端窗口中输入以下命令：
 
 ```shell
 git clone https://github.com/swiftlang/swift-org-website.git
 cd swift-org-website
 bundle install
 LC_ALL=en_us.UTF-8 bundle exec jekyll serve --config _config.yml,_config_dev.yml
 open "http://localhost:4000"
-```
 
 If you’d like to contribute to this project, please run Prettier before submitting your pull request to ensure consistent code style across the project.
 
@@ -48,18 +50,18 @@ npm install
 npm run prettify
 ```
 
-### Running in Docker
+### 在 Docker 中运行
 
-First build the site with Docker Compose:
+首先使用 Docker Compose 构建站点：
 
 ```bash
 docker compose run build
 ```
 
-Then you can run the site:
+然后你可以运行站点：
 
 ```bash
 docker compose up website
 ```
 
-The website will be available on `http://localhost:4000`
+网站将在 `http://localhost:4000` 上可用