apple-dev-doc-translation 仓库用于存放 swiftgg-trans-plugin 插件的翻译文件。我们将 Apple 官方文档的原文,翻译和提示信息进行归拢整理,旨在为广大开发者提供一个高质量的中文教程。
翻译的映射文件是以 yaml 文件格式进行存储的,以下是存储规则和存储格式的具体介绍:
- 翻译内容以单独的网页为基本单位,每个网页对应一个翻译文件,例如 Creating And Combining Views 这篇教程,它的 url 是
https://developer.apple.com/tutorials/swiftui/creating-and-combining-views
,那么它的翻译文件存储路径就应当为project/swiftui/creating-and-combining-views
; - 翻译文件的基本结构是一个一维数组,每个数组元素由三部分组成,“内容”,“提示”,“翻译”。
- “内容”:相关文档的原始内容,为英文,由 SwiftGG 项目组提供;
- “提示”:可以增加的额外信息,帮助开发者快速理解当前内容的小提示;
- “翻译”:需要翻译和校对的主要内容,是我们与社区小伙伴共建的核心部分。
数组结构示例:
- 内容: Familiarize yourself with the new views. They work together to display the hike
data loaded into your model.
提示: ''
翻译: ''
- 内容: Familiarize yourself with the new views. They work together to display the hike
data loaded into your model.
提示: ''
翻译: 熟悉新视图。它们一起工作,显示加载到您的模型中的徒步旅行数据。
- 内容: SwiftUI includes basic animations with predefined or custom easing, as well
as spring and fluid animations. You can adjust an animation’s speed, set a delay
before an animation starts, or specify that an animation repeats.
提示: ''
翻译: SwiftUI 包括具有预定义或自定义缓动的基本动画,以及弹簧和流体动画。你可以调整动画的速度,为动画设置开始前的延迟,或指定动画重复次数。
- 内容: Create a new Swift file called Hike.swift in your project’s Model group using
the menu item File > New > File.
提示: ''
翻译: ''
- 社区小伙伴提交PR且由社区校对工作同学approve后,更新内容会在第二天进行发布,如果需要加急,请联系SwiftGG管理员。
如果想做出贡献的话,你可以:
- 参与翻译
- 帮忙校对,挑错别字、病句等等
- 提出修改建议
- 提出术语翻译建议
我们非常欢迎你为本项目做出贡献!如果需要提交翻译,在项目仓库中找到对应的 yaml 文件,将中文翻译,提示信息填写在对应的字段中,然后提交 Pull Request 进行修改。在提交 Pull Request 时,请简要说明所做的修改和原因,以让我们更好地理解你的贡献。
排版格式和流程说明:
- 翻译排版格式要求参考 SwiftGG 排版指南
- Pull Request 发起方式参考 SwiftGG Pull Request 说明
可以在项目仓库中找到对应的 yaml 翻译文件,对翻译进行更正之后,提交 Pull Request 进行修改。若你不熟悉 GitHub 操作,也可以通过 GitHub Issues 向我们反馈,我们会尽快进行处理。
- swiftgg-trans-plugin:本项目的浏览器插件源码仓库。
SwiftGG 是一个致力于为 Swift 语言和 iOS 开发者提供高质量中文技术文章的社区。我们热衷于分享技术知识和经验,我们希望通过这个插件,以及社区的其他活动和项目,帮助更多的开发者更好地学习和了解 Swift 和 iOS 开发。 如果你对我们的项目感兴趣,或者想要了解更多关于 SwiftGG 的信息,请访问我们的官方网站:https://swiftgg.com。 你也可以通过以下方式关注我们:
和 苹果官方文档 协议一致:Creative Commons Attribution 4.0 International (CC BY 4.0) License。