Awesome

The Swift Programming Language (Simplified Chinese Version by SwiftGG)

English Version | 中文版本

English Version

This repository contains the source for The Swift Programming Language (sometimes abbreviated as TSPL), which is published on docs.swift.org and built using Swift-DocC.

This repository includes the latest version of TSPL, as well as Simplified Chinese translations corresponding to different Swift versions.

Building

Clone this repository and run docc preview swift-6.docc in this repository's root directory.

After running DocC, open the link that docc outputs to display a local preview in your browser.

Current Status

• Latest English version of The Swift Programming Language. Latest commit: 11a2b29
• Corresponding Simplified Chinese translations (in progress and archived):
  • Swift 6 beta (currently in translation)
  • Swift 5.x and earlier versions (available for reading on GitBook)

How to Contribute

1. Fork this repository to your account. Claim a translation task labeled as Swift x translation in the issues. Create a branch in your forked repository corresponding to the issue, setting the source branch to the current Swift version being translated (e.g., swift-6-beta-translation).

2. Install the docc command-line tool by either downloading the toolchain from Swift.org or installing Xcode.

Note:

If you installed DocC by downloading a toolchain from Swift.org, docc is located in usr/bin/, relative to the installation path of the toolchain. Make sure your shell's PATH environment variable includes that directory.

If you installed DocC by downloading Xcode, run xcrun docc preview swift-6.docc instead.

3. Replace the content of the original Markdown file with your Chinese translation, following the terminology table below and the SwiftGG style guide. Submit your translation through a Pull Request. Once verified by SwiftGG members, it will be merged into the current translation branch.

Contributors

We extend our heartfelt thanks to all our contributors. You can find the list of contributors here.

中文版本

本仓库包含 The Swift Programming Language (缩写为 TSPL) 的源代码， 该文档发布在 docs.swift.org 上， 并使用 Swift-DocC 构建。

本仓库包括 TSPL 的最新版本，以及对应不同 Swift 版本的简体中文翻译。

构建

克隆此仓库并在仓库根目录运行 docc preview swift-6.docc。

运行 DocC 后，打开 docc 输出的链接，即可在浏览器中显示本地预览。

当前状态

• The Swift Programming Language 的最新英文版本。[最新提交: fe0121d][https://github.com/swiftlang/swift-book/commit/fe0121d1f2d86d6139c2b424d45a7889b82ff5e2]
• 对应的简体中文翻译 (进行中和已归档)：
  • Swift 6 beta (当前正在翻译)
  • Swift 5.x 及更早版本 (可在 GitBook 上阅读)

如何贡献

1. 首先，将此仓库 fork 到您的账户。在 issues 中认领标记为 Swift x translation 的翻译任务。在您 fork 的仓库中创建与 issue 对应的分支，将源分支设置为当前正在翻译的 Swift 版本 (例如，swift-6-beta-translation)。

2. 通过从 Swift.org 下载 toolchain 或安装 Xcode 来安装 docc 命令行工具。

注意：

如果您通过从 Swift.org 下载 toolchain 安装了 DocC， docc 位于 toolchain 安装路径下的 usr/bin/ 目录中。 确保您的 shell 的 PATH 环境变量包含该目录。

如果您通过下载 Xcode 安装了 DocC， 请运行 xcrun docc preview swift-6.docc。

3. 按照下面的术语表和 SwiftGG 排版指南 将原始 Markdown 文件的内容替换为您的中文翻译。通过 Pull Request 提交您的翻译。经 SwiftGG 成员验证后，将合并到当前的翻译分支。

参与成员

我们衷心感谢所有的参与成员。您可以在这里找到参与成员列表。

Terminology Table（术语表）