Skip to content

Latest commit

 

History

History
92 lines (64 loc) · 5.73 KB

README.md

File metadata and controls

92 lines (64 loc) · 5.73 KB
Raw

apple-dev-doc-translation

简体中文

The apple-dev-doc-translation repository is used to store translation files for the swiftgg-trans-plugin. We aggregate and sort the original text, translations, and hint information from Apple's official documents, aiming to provide developers with a high-quality Chinese and other languages tutorial.

The translation mapping files are stored in the yaml file format. The following is a specific introduction to the storage rules and storage format:

  1. The translation content is based on individual web pages. Each web page corresponds to a translation file. For example, for the tutorial "Creating And Combining Views" whose url is https://developer.apple.com/tutorials/swiftui/creating-and-combining-views, its translation file storage path should be project/swiftui/creating-and-combining-views;
  2. The basic structure of the translation file is a one-dimensional array, each element of which is composed of three parts: "content", "hint", and "translation".
    • "Content": the original content of the relevant documents, in English, provided by the SwiftGG project team;
    • "Hint": additional information that can be added to help developers quickly understand the current content;
    • "Translation": the main content that needs to be translated and proofread, which is the core part of our collaboration with the community.

Data structure example:

- 内容: 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.
  提示: ''
  翻译: ''
  1. After community members submit PRs and they are approved by peer reviewers, the updated content will be published the next day. If you need an urgent update, please contact the SwiftGG administrators.

Contributing

If you want to contribute, you can:

  • Participate in translation
  • Help proofread, spotting typos and grammatical errors, etc.
  • Make modification suggestions
  • Offer terminological translation advice

FAQs

How to submit a translation?

We warmly welcome you to contribute to this project! If you need to submit a translation, find the corresponding yaml file in the project repository, fill in the non-English translation and hint information in the corresponding fields, then submit a Pull Request for modification. When submitting a Pull Request, please briefly explain the changes made and the reasons, so we can better understand your contribution.

Formatting guidelines and process instructions:

How to correct or modify the translated content?

You can find the corresponding yaml translation file in the project repository, correct the translation, and then submit a Pull Request for modification. If you are unfamiliar with GitHub operations, you can also provide feedback via GitHub Issues, and we will handle it as soon as possible.

Related Links

About Us

SwiftGG is a community dedicated to providing high-quality Chinese technical articles for Swift language and iOS developers. We are passionate about sharing technical knowledge and experience, and we hope that through this plugin and other community activities and projects, we can help more developers learn and understand Swift and iOS development better.

If you are interested in our project, or want to know more about SwiftGG, please visit our official website: https://swift.gg. You can also follow us through the following ways:

You can also follow us through the following ways:

Development Team

License

Consistent with Apple's official documentation agreement: Creative Commons Attribution 4.0 International (CC BY 4.0) License.