Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[p5.js - zh] Added contributor guidelines part 1 + 2 zh translations #6881

Merged
merged 4 commits into from
Mar 19, 2024

Conversation

douMax
Copy link
Contributor

@douMax douMax commented Mar 17, 2024

Updates: 添加了 Part 2 部分

Resolves #[Add issue number here]

Changes:

  • Updated zh translations for Contributor guidlelines part 1

Screenshots of the change:

PR Checklist

Copy link

welcome bot commented Mar 17, 2024

🎉 Thanks for opening this pull request! Please check out our contributing guidelines if you haven't already. And be sure to add yourself to the list of contributors on the readme page!

Copy link

@sproutleaf sproutleaf left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

全文上下有许多小错误,包括链接错误,代码输入错误(原来在代码前后加```是对的,改完以后反而错了),以及一些翻译上的小差错。请仔细检查校对,谢谢!


如果您希望在 p5.js 存储库之外做出贡献(编写教程,计划课程,组织活动),请查看其他相关页面。管理员或维护人员可能会发现[管理员指南](./steward_guidelines.md)在审查问题和拉取请求方面更有帮助
欢迎阅览 p5.js 贡者指南!本文档适用于有意为 p5.js 贡献代码的新贡献者、希望复习一些技术步骤的贡献者、以及其他与为 p5.js 贡献代码相关的任何事情

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这里可以保留原来的欢迎来到贡献者指南!。另,请不要把贡献者缩写成贡者。

本文档内容较长而全面,但我们将尽量清晰地说明所有步骤和要点。请利用目录,浏览器的搜索功能(`Ctrl + F`或`Cmd + F`)来查找与您相关的部分。如果某些部分与您计划的贡献无关,可以跳过它们。
如果您希望在 p5.js 代码库之外做出贡献(例如编写教程、规划教学课程、组织活动等),请查看其他相关页面。管理员或维护人员可以通过[管理员指南](./steward_guidelines.md)查阅问题审核与拉取请求相关的内容。

本文档尽管内容较多且覆盖面很广,但我们还是会尽量清晰地注明所有步骤和要点。您可以使用目录查找特定章节。如果文档中的某些章节与您要贡献的内容无关,可以选择跳过。

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这里漏了一句:

If you are a new contributor, you may want to start with the first section, “All about issues.” If you just want a step-by-step setup of the development process, you can look at the “Quick Get Started For Developers” section.

请补上

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

已加上

- [变基和解决冲突](#变基和解决冲突)
- [讨论和修改](#讨论和修改)

- [关于问题](#%E5%85%B3%E4%BA%8E%E9%97%AE%E9%A2%98)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这里所有的乱码都应该转成中文

Issue 是Github 上描述 Issue 的帖子的通用名称。这个"Issue"可以是一个错误报告,一个添加新功能的请求,一个讨论,一个问题,一个公告,或者任何可以作为帖子的内容。任何具有Github账号的人,包括机器人,都可以在每个问题下方添加评论!这是贡献者讨论与项目开发相关主题的地方。
## 所谓“问题”是指什么?

![A cropped screenshot of the p5.js library GitHub repository, only showing contents of the top right corner. A red box is drawn on top of the screenshot surrounding the Issues tab.](images/issues-tab.png)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

中英文文档不在一个文件夹下,所以这里的本地链接要改成 (../images/issues-tab.png)

# 关于Issue

# 关于问题

p5.js 的 Github 存储库(repo)上的大部分活动都发生在问题上,Issue 很可能也是您开始贡献过程的地方。

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

在中文语境下,存储库并没有简写,所以括号里的repo可以删掉。

可以考虑不翻译Issue,因为类似于”大部分活动都发生在问题上“的句子读起来很别扭。如果不翻译Issue的话,请保持全文上下一致。


从你的 p5.js 存储库Fork进行工作是必要的,因为你可能没有直接写入官方 p5.js 存储库的权限,而在Fork上工作可以让你进行更改,然后将其提交回官方存储库。
第一步是 Fork p5.js 存储库。在开源中,Fork 具有特定的含义,但对于我们的目的,它意味着创建存储库的副本并将其存储在您自己的 Github 帐户中。要 Fork 一个存储库,只需点击页面顶部附近的"Fork"按钮,Github 将在您的帐户中创建存储库的副本。

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

全文的Github应改成GitHub


从你的 p5.js 存储库 Fork 进行工作是必要的,因为你可能没有直接写入官方 p5.js 存储库的权限,而在 Fork 上工作可以让你进行更改,然后将其提交回官方存储库。

### 使用 GitHub 桌面版

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这里漏了很多截图和原文翻译,请重新校对,确保没有信息遗漏


此时,你应该对使用命令行、git、node.js 进行工作,并已经设置好本地开发环境有一定的了解。

Fork创建后,转到你的Fork页面,并通过点击绿色的"Code"按钮复制 git URL。它应该类似于 `https://github.com/limzykenneth/p5.js.git`。
### 使用 `git` 命令行界面

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这里也漏了截图

```
git clone [git_url]
```
git clone [git_url]

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

原来的是对的—每行代码前后都要加上```,请修改

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

好的。

如果您打算处理内联文档,请参阅[这里](./inline_documentation.md)。

### 国际化
如果您打算处理p5.js的国际化,请参阅[这里](./internationalization.md)。请注意,这不涉及网站的国际化/翻译,请参阅[网站存储库](https://github.com/processing/p5.js-website)。

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这部分英文文档里已经没有了

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

刚确认了一下,会把国际化部分删除


从你的 p5.js 存储库 Fork 进行工作是必要的,因为你可能没有直接写入官方 p5.js 存储库的权限,而在 Fork 上工作可以让你进行更改,然后将其提交回官方存储库。

### 使用 GitHub 桌面版
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

等 nancy 修改好,其下译文可以整理过来

@douMax douMax changed the title Added contributor guidelines part 1 zh translations [p5.js - zh] Added contributor guidelines part 1 + 2 zh translations Mar 18, 2024
@Qianqianye Qianqianye added the Translation Translation of p5.js documentation label Mar 18, 2024
Copy link

@unicar9 unicar9 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

问题都修改了,很棒!

Copy link

@sproutleaf sproutleaf left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR for the entire contributor_guidelinesfile approved by me and @unicar9.

Tagging @Qianqianye and @limzykenneth for merge. Thank you!

@Qianqianye Qianqianye merged commit 4c1b71f into processing:main Mar 19, 2024
2 checks passed
@Qianqianye
Copy link
Contributor

Looks great, thanks @douMax @unicar9 @sproutleaf 💗
@all-contributors please add @douMax for translation

Copy link
Contributor

@Qianqianye

I've put up a pull request to add @douMax! 🎉

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Translation Translation of p5.js documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants