translated to chinese (#18592)
This commit is contained in:
DeViLINSIDE
committed by
mrugesh mohapatra
mrugesh mohapatra
parent
164d900e96
commit
8bf31ddb64
@ -12,6 +12,129 @@
|
|||||||
|
|
||||||
# Contribution Guidelines
|
# Contribution Guidelines
|
||||||
|
|
||||||
Hello 👋 !
|
你好👋！
|
||||||
|
|
||||||
These instructions have not been translated yet. Please check this issue for details: [`#18312`](https://github.com/freeCodeCamp/freeCodeCamp/issues/18312)
|
感谢像你这样的数千名志愿者，freeCodeCamp.org。我们感谢您的贡献，我们很高兴欢迎您的光临。
|
||||||
|
|
||||||
|
我们严格执行[“行为准则”]（https://www.freecodecamp.org/code-of-conduct）。花一点时间阅读它。它只有196个字。
|
||||||
|
|
||||||
|
快乐贡献🎉！
|
||||||
|
|
||||||
|
##这里有一些有趣的方法可以提供帮助
|
||||||
|
|
||||||
|
您可以选择为您感兴趣的任何领域做出贡献：
|
||||||
|
|
||||||
|
1. [有助于这个开源代码库。]（＃contribution-to-this-open-source-codebase）。帮助编辑[指南文章]（https://guide.freecodecamp.org/），[编码挑战]（https://learn.freecodecamp.org/），或修复学习平台上的错误。
|
||||||
|
|
||||||
|
2.在我们的[公共论坛]（https://www.freecodecamp.org/forum/）上帮助营员。 [回答他们的编码问题]（https://www.freecodecamp.org/forum/?max_posts=1）或[给他们反馈他们的编码项目]（https://www.freecodecamp.org/forum/c/project反馈系统开发与？max_posts = 1）
|
||||||
|
|
||||||
|
3.帮助我们为[YouTube频道视频]（https://www.youtube.com/channel/UC8butISFwT-Wl7EV0hUK0BQ/videos）添加字幕。
|
||||||
|
|
||||||
|
##有助于这个开源代码库
|
||||||
|
|
||||||
|
我们有数千个[编码挑战]（https://learn.freecodecamp.org）和[指南文章]（https://guide.freecodecamp.org）的庞大开源代码库。
|
||||||
|
|
||||||
|
你可以帮助我们：
|
||||||
|
|
||||||
|
- [📝研究，编写和更新我们的指南文章]（＃research-write-and-update-our-guide-articles）
|
||||||
|
|
||||||
|
- [💻在我们的编码挑战中创建，更新和修复错误]（＃create-update-and-fix-bugs-in-our-coding-challenges）
|
||||||
|
|
||||||
|
- [🌐翻译指南文章和编码挑战]（＃translate-guide-articles-and-coding-challenges）
|
||||||
|
|
||||||
|
- [🛠帮助我们修复freeCodeCamp.org学习平台中的错误]（＃help-us-fix-bugs-in-freecodecamporgs-learning-platform）
|
||||||
|
|
||||||
|
###研究，编写和更新我们的指南文章
|
||||||
|
|
||||||
|
**什么是指南文章？**
|
||||||
|
|
||||||
|
指南文章可帮助您快速了解技术概念。这些是简短的，简单的英语解释，您可以在继续阅读更深入的资源之前阅读这些解释。
|
||||||
|
|
||||||
|
您可以在这里找到[关于HTML元素的示例文章]（./client/src/pages /html/elements/index.md）。
|
||||||
|
|
||||||
|
**我能写一篇关于什么的文章？**
|
||||||
|
|
||||||
|
我们欢迎您撰写这些文章的帮助。你不必成为一个主题的专家来写它 - 整个指南是开源的，所以即使你犯了错误，另一个贡献者最终会纠正它。
|
||||||
|
|
||||||
|
为了帮助，在我们的[指南网站]（https://www.freecodecamp.org/guide）上找到一个“存根文章”，写下文章，然后打开拉取请求，用您的文章替换存根。 [pull request]（https://help.github.com/articles/about-pull-requests/）是您建议更改的方式。它让其他人了解您的更改，审核并采用它们。
|
||||||
|
|
||||||
|
如果您找不到关于您想要撰写的主题的存根，则可以打开创建存根的PR并包含您的草稿文章。
|
||||||
|
|
||||||
|
如果您想帮助改进指南文章，请参阅[如何处理指南文章]（/ docs / how-to-work-on-guide-articles.md）。
|
||||||
|
|
||||||
|
###在我们的编码挑战中创建，更新和修复错误
|
||||||
|
|
||||||
|
我们所有的编码挑战都由社区策划，从您这样的志愿者那里获取专业知识。
|
||||||
|
|
||||||
|
您可以帮助扩展它们并使其措辞更加清晰。您可以更新用户故事以更好地解释概念，甚至删除多余的概念。您还可以改进挑战测试，使其更准确地测试人员的代码。
|
||||||
|
|
||||||
|
如果您对改进这些编码挑战感兴趣，请参阅[如何处理编码挑战]（/ docs / how-to-work-on-coding-challenges.md）。
|
||||||
|
|
||||||
|
###翻译指南文章和编码挑战
|
||||||
|
|
||||||
|
您可以帮助我们翻译我们的指南文章和您所说语言的编码挑战。目前我们已翻译版本：
|
||||||
|
|
||||||
|
- [中文（中文）]（https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/chinese）
|
||||||
|
- [俄语（русский）]（https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/russian）
|
||||||
|
- [阿拉伯语（عربى）]（https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/arabic）
|
||||||
|
- [西班牙语（西班牙语）]（https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/spanish）
|
||||||
|
- [葡萄牙语（葡萄牙语）]（https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/portuguese）
|
||||||
|
|
||||||
|
我们非常乐意帮助您提高翻译质量。数百万人使用freeCodeCamp.org的英语版本，我们希望还有数百万人使用这些翻译版本。
|
||||||
|
|
||||||
|
###帮助我们修复freeCodeCamp.org学习平台中的错误
|
||||||
|
|
||||||
|
我们的学习平台运行在现代JavaScript堆栈上。它有各种组件，工具和库，包括但不限于Node.js，MongoDB，LoopBack，OAuth 2.0，React，Gatsby，Webpack等。
|
||||||
|
|
||||||
|
宽广地，
|
||||||
|
|
||||||
|
- 我们有一个基于Node.js的API服务器。
|
||||||
|
- 一组基于React的客户端应用程序。
|
||||||
|
- 我们用来评估我们的前端项目的脚本。
|
||||||
|
|
||||||
|
为此做出贡献需要对API，ES6语法和许多好奇心有所了解。
|
||||||
|
|
||||||
|
基本上我们期望某些基本的熟悉程度，以及一些上述技术，工具和库。也就是说，您不需要成为他们的专家。
|
||||||
|
|
||||||
|
请在相关问题主题上随意向我们提问，我们将很乐意澄清。如有疑问，您可以从我们的平台开发处联系Mrugesh Mohapatra [`@isedadead`]（https://github.com/raisedadead）或Stuart Taylor [`@bouncey`]（https://github.com/bouncey）团队为您提供帮助。
|
||||||
|
|
||||||
|
如果您想帮助我们改进代码库，请参阅[如何在本地设置freeCodeCamp]（/ docs / how-to-setup-freecodecamp-locally.md）。
|
||||||
|
|
||||||
|
＃＃ 经常问的问题
|
||||||
|
|
||||||
|
**如何报告不在船上的错误？**
|
||||||
|
|
||||||
|
如果您认为自己发现了错误，请先阅读[“我发现了一个错误的帮助”]（https://forum.freecodecamp.org/t/how-to-report-a-bug/19543）文章并按照其说明进行操作
|
||||||
|
|
||||||
|
如果您确信这是一个新错误，请继续创建一个新的GitHub问题。请务必尽可能多地包含信息，以便我们重现错误。我们有一个预定义的问题模板来帮助您完成此操作。
|
||||||
|
|
||||||
|
请注意，任何寻求编码帮助挑战的问题都将被关闭。问题跟踪器严格用于与代码库相关的问题和讨论。您应该[在论坛上寻求帮助]（https://www.freecodecamp.org/forum），然后在有疑问时进行报告。
|
||||||
|
|
||||||
|
**如何报告安全问题？**
|
||||||
|
|
||||||
|
请不要因安全问题而创建GitHub问题。相反，请发送电子邮件至`security @ freecodecamp.org`，我们会立即调查。
|
||||||
|
|
||||||
|
**我被困在这些文档中没有的东西上。怎么能得到帮助？**
|
||||||
|
|
||||||
|
随意寻求帮助：
|
||||||
|
|
||||||
|
- [“贡献者”类别我们的公共论坛]（https://www.freecodecamp.org/forum/c/contributors）
|
||||||
|
- [我们的公共贡献者在Gitter聊天室]（https://gitter.im/FreeCodeCamp/Contributors）
|
||||||
|
|
||||||
|
我们很高兴能帮助您为您想要处理的任何主题做出贡献。确保在发布新查询之前搜索您的查询。要有礼貌和耐心。我们的社区志愿者和主持人随时为您提供指导。
|
||||||
|
|
||||||
|
**我是GitHub和开源的新手：**
|
||||||
|
|
||||||
|
阅读我们的[如何参与开源指南]（https://github.com/freeCodeCamp/how-to-contribute-to-open-source）。
|
||||||
|
|
||||||
|
**这些不同的标签是什么意思，在问题上被标记？**
|
||||||
|
|
||||||
|
我们的社区版主[分类]（https://en.wikipedia.org/wiki/Software_bug#Bug_management）根据优先级，严重程度和其他因素发出请求。你可以[在这里找到一个完整的含义词汇表]（https://github.com/freecodecamp/freecodecamp/labels）。
|
||||||
|
|
||||||
|
您应该通过**“求助”**或“第一次欢迎”**问题快速查找可供您使用的内容。这些都是可以抓住的，在开始研究之前你不需要继续。
|
||||||
|
|
||||||
|
如果这些问题在需要完成的工作上缺乏明确性，请在评论中随意提问。
|
||||||
|
|
||||||
|
**我发现了一个拼写错误，我应该在提出拉取请求之前报告问题吗？**
|
||||||
|
|
||||||
|
对于拼写错误和其他措辞更改，您可以直接打开请求，而无需先创建问题。问题更多的是讨论与代码相关的更大问题，或者课程的更多结构方面。
|
||||||
@ -10,8 +10,40 @@
|
|||||||
</tr>
|
</tr>
|
||||||
</table>
|
</table>
|
||||||
|
|
||||||
# Documentation Quick Reference
|
|
||||||
|
|
||||||
Hello 👋 !
|
#Documentation快速参考
|
||||||
|
|
||||||
|
你好 👋!
|
||||||
|
|
||||||
|
该目录包含有关贡献 freeCodeCamp.org 的所有文档
|
||||||
|
|
||||||
|
## [如果您已经开始，请先阅读此内容。]（/ CONTRIBUTING.md）
|
||||||
|
---
|
||||||
|
|
||||||
|
##快速参考文章
|
||||||
|
|
||||||
|
1.如何处理指南文章。
|
||||||
|
2.如何处理编码挑战。
|
||||||
|
3.如何在本地设置freeCodeCamp。
|
||||||
|
4.如何在本地捕获外发电子邮件.
|
||||||
|
|
||||||
|
##风格指南
|
||||||
|
|
||||||
|
1.创建指南文章的样式指南。
|
||||||
|
2.创建编码挑战的样式指南。
|
||||||
|
|
||||||
|
##快速命令在本地工作时引用
|
||||||
|
|
||||||
|
在本地工作时快速参考您需要的命令。
|
||||||
|
|
||||||
|
|命令|描述|
|
||||||
|
| ------- | -----------
|
||||||
|
| `npm run bootstrap` |引导不同的服务|
|
||||||
|
| `npm run seed` |解析所有质询标记文件并将其插入MongoDB。 |
|
||||||
|
| `npm run develop` |启动freeCodeCamp API服务器和客户端应用程序|
|
||||||
|
| `npm test` |在系统中运行所有JS测试，包括客户端，服务器，lint和质询测试
|
||||||
|
| `npm run test：client` |运行客户端测试套件|
|
||||||
|
| `npm run test：courses` |运行课程测试套件|
|
||||||
|
| `npm run test：server` |运行服务器测试套件|
|
||||||
|
| `npm run commit` |一个帮助您构建良好提交消息的交互式工具
|
||||||
|
|
||||||
These instructions have not been translated yet. Please check this issue for details: [`#18312`](https://github.com/freeCodeCamp/freeCodeCamp/issues/18312)
|
|
||||||
@ -1,17 +1,99 @@
|
|||||||
<table>
|
＃如何在本地捕获外发电子邮件（用于电子邮件工作流程）
|
||||||
<tr>
|
|
||||||
<td> Read these guidelines in </td>
|
|
||||||
<td><a href="/CONTRIBUTING.md"> English </a></td>
|
|
||||||
<td><a href="/docs/chinese/CONTRIBUTING.md"> 中文 </a></td>
|
|
||||||
<td><a href="/docs/russian/CONTRIBUTING.md"> русский </a></td>
|
|
||||||
<td><a href="/docs/arabic/CONTRIBUTING.md"> عربى </a></td>
|
|
||||||
<td><a href="/docs/spanish/CONTRIBUTING.md"> Español </a></td>
|
|
||||||
<td><a href="/docs/portuguese/CONTRIBUTING.md"> Português </a></td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
# Contribution Guidelines
|
> **注意：**这是**可选**步骤 - 仅在使用电子邮件工作流程时需要
|
||||||
|
|
||||||
Hello 👋 !
|
＃＃ 介绍
|
||||||
|
|
||||||
These instructions have not been translated yet. Please check this issue for details: [`#18312`](https://github.com/freeCodeCamp/freeCodeCamp/issues/18312)
|
某些电子邮件工作流程（如更新用户的电子邮件）需要后端api-server发送电子邮件。在开发过程中，您可以使用工具在本地捕获这些电子邮件，而不必使用电子邮件提供商并发送实际的电子邮件。 MailHog是一种用于开发人员的电子邮件测试工具，可以捕获本地freeCodeCamp实例发送的电子邮件。
|
||||||
|
|
||||||
|
##安装MailHog
|
||||||
|
|
||||||
|
如何安装和运行MailHog取决于您的操作系统
|
||||||
|
|
||||||
|
- [在macOS上安装MailHog]（#instalting-mailhog-on-macos）
|
||||||
|
- [在Windows上安装MailHog]（#instalting-mailhog-on-windows）
|
||||||
|
- [在Linux上安装MailHog]（#instalting-mailhog-on-linux）
|
||||||
|
|
||||||
|
###在macOS上安装MailHog
|
||||||
|
|
||||||
|
以下是如何使用[Homebrew]（https://brew.sh/）在macOS上设置MailHog：
|
||||||
|
|
||||||
|
```庆典
|
||||||
|
brew安装mailhog
|
||||||
|
brew服务启动mailhog
|
||||||
|
```
|
||||||
|
|
||||||
|
这将在后台启动mailhog服务。
|
||||||
|
|
||||||
|
接下来，您可以转到[使用MailHog]（＃using-mailhog）。
|
||||||
|
|
||||||
|
###在Windows上安装MailHog
|
||||||
|
|
||||||
|
从[MailHog的官方存储库]（https://github.com/mailhog/MailHog/releases）下载最新的MailHog版本。单击Windows版本（32或64位）的链接，然后将.exe文件下载到您的计算机。
|
||||||
|
|
||||||
|
完成下载后，单击该文件。您可能会收到Windows防火墙通知，您必须允许访问MailHog。完成后，将打开标准Windows命令行提示符，MailHog已在运行。
|
||||||
|
|
||||||
|
要关闭MailHog，请关闭命令提示符。要再次运行它，请单击相同的.exe文件。您无需下载新的。
|
||||||
|
|
||||||
|
接下来，您可以转到[使用MailHog]（＃using-mailhog）。
|
||||||
|
|
||||||
|
###在Linux上安装MailHog
|
||||||
|
|
||||||
|
首先安装[Go](https://golang.org）。
|
||||||
|
|
||||||
|
对于像Ubuntu和Linux Mint这样的基于Debian的系统，运行：
|
||||||
|
|
||||||
|
```庆典
|
||||||
|
sudo apt-get install golang
|
||||||
|
```
|
||||||
|
|
||||||
|
对于CentOS，Fedora，Red Hat Linux和其他基于RPM的系统，运行：
|
||||||
|
|
||||||
|
```庆典
|
||||||
|
sudo dnf install golang
|
||||||
|
```
|
||||||
|
|
||||||
|
要么：
|
||||||
|
|
||||||
|
```庆典
|
||||||
|
sudo yum install golang
|
||||||
|
```
|
||||||
|
|
||||||
|
设置Go的路径：
|
||||||
|
|
||||||
|
```庆典
|
||||||
|
echo“export GOPATH = $ HOME / go”>>〜/ .profile
|
||||||
|
echo'export PATH = $ PATH：/ usr / local / go / bin：$ GOPATH / bin'>>〜/ .profile
|
||||||
|
来源〜/ .profile
|
||||||
|
```
|
||||||
|
|
||||||
|
然后安装并运行MailHog：
|
||||||
|
|
||||||
|
```庆典
|
||||||
|
去获取github.com/mailhog/MailHog
|
||||||
|
sudo cp / home / $（whoami）/ go / bin / MailHog / usr / local / bin / mailhog
|
||||||
|
mailhog
|
||||||
|
```
|
||||||
|
|
||||||
|
接下来，您可以转到[使用MailHog]（＃using-mailhog）。
|
||||||
|
|
||||||
|
##使用MailHog
|
||||||
|
|
||||||
|
安装MailHog并开始运行后，需要在浏览器中打开MailHog收件箱，打开新选项卡或窗口并导航到[http：// localhost：8025]（http：// localhost：8025）。
|
||||||
|
您现在应该看到如下屏幕：
|
||||||
|
|
||||||
|
![MailHog截屏1]（images / mailhog / 1.jpg）
|
||||||
|
|
||||||
|
当你的freeCodeCamp安装发送电子邮件时，你会看到它出现在这里。如下所示：
|
||||||
|
|
||||||
|
![MailHog截图2]（images / mailhog / 2.jpg）
|
||||||
|
|
||||||
|
打开邮件，您应该看到两个选项卡，您可以在其中查看内容 - 纯文本和源文件。确保您在纯文本选项卡上。
|
||||||
|
|
||||||
|
![MailHog截屏3]（images / mailhog / 3.jpg）
|
||||||
|
|
||||||
|
电子邮件中的任何链接都应该是可点击的。
|
||||||
|
|
||||||
|
##有用的链接
|
||||||
|
|
||||||
|
- 有关MailHog的任何其他问题或有关自定义配置的说明，请查看[MailHog]（https://github.com/mailhog/MailHog）存储库。
|
||||||
@ -1,17 +1,282 @@
|
|||||||
<table>
|
＃在本地设置freeCodeCamp
|
||||||
<tr>
|
|
||||||
<td> Read these guidelines in </td>
|
|
||||||
<td><a href="/CONTRIBUTING.md"> English </a></td>
|
|
||||||
<td><a href="/docs/chinese/CONTRIBUTING.md"> 中文 </a></td>
|
|
||||||
<td><a href="/docs/russian/CONTRIBUTING.md"> русский </a></td>
|
|
||||||
<td><a href="/docs/arabic/CONTRIBUTING.md"> عربى </a></td>
|
|
||||||
<td><a href="/docs/spanish/CONTRIBUTING.md"> Español </a></td>
|
|
||||||
<td><a href="/docs/portuguese/CONTRIBUTING.md"> Português </a></td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
# Contribution Guidelines
|
请遵循以下准则，以便在系统上本地获取freeCodeCamp。如果您想定期参与，强烈建议您这样做。
|
||||||
|
|
||||||
Hello 👋 !
|
一些贡献工作流程，如预览指南页面或编码挑战，调试和修复代码库中的错误，需要您在本地运行freeCodeCamp。
|
||||||
|
|
||||||
These instructions have not been translated yet. Please check this issue for details: [`#18312`](https://github.com/freeCodeCamp/freeCodeCamp/issues/18312)
|
##在GitHub上分叉存储库
|
||||||
|
|
||||||
|
['Forking']（https://help.github.com/articles/about-forks/）是您在GitHub上获得自己的freeCodeCamp主存储库（a.k.a _repo_）副本的步骤。
|
||||||
|
|
||||||
|
这是必不可少的，因为这样您就可以在GitHub上处理freeCodeCamp的副本，或者下载它以便在本地工作。稍后，您将能够通过拉取请求请求将更改拖入主存储库。
|
||||||
|
|
||||||
|
> ** ProTip：**
|
||||||
|
>`https：// github.com / freeCodeCamp / freeCodeCamp`的主存储库通常被称为`upstream`存储库。
|
||||||
|
>您在`https：// github.com / YOUR_USER_NAME / freeCodeCamp`的分支通常被称为`origin`存储库。
|
||||||
|
|
||||||
|
**按照以下步骤分叉`https：// github.com / freeCodeCamp / freeCodeCamp`存储库：**
|
||||||
|
|
||||||
|
1.转到GitHub上的freeCodeCamp存储库：<https://github.com/freeCodeCamp/freeCodeCamp>
|
||||||
|
2.单击界面右上角的“Fork”按钮（[更多详细信息]（https://help.github.com/articles/fork-a-repo/））
|
||||||
|
3.存储库分叉后，您将被带到https：// github.com / YOUR_USER_NAME / freeCodeCamp的freeCodeCamp副本。
|
||||||
|
|
||||||
|
！[GIF - 如何在Github上派生freeCodeCamp]（/ docs / images / github / how-to-fork-freeCodeCamp.gif）
|
||||||
|
|
||||||
|
##准备开发环境
|
||||||
|
|
||||||
|
安装必备组件后，需要为开发环境做好准备。这在许多开发工作流程中很常见，您只需要执行一次。
|
||||||
|
|
||||||
|
**按照以下步骤准备好开发环境：**
|
||||||
|
|
||||||
|
1.如果您还没有安装[Git]（https://git-scm.com/）或您喜欢的Git客户端。更新到最新版本，与您的操作系统捆绑的版本可能已过时。
|
||||||
|
|
||||||
|
2.（可选但建议）为GitHub设置[SSH密钥]（https://help.github.com/articles/generating-an-ssh-key/）。
|
||||||
|
|
||||||
|
3.安装您选择的代码编辑器。
|
||||||
|
|
||||||
|
我们强烈建议使用[VS Code]（https://code.visualstudio.com/）或[Atom]（https://atom.io/）。这些是一些很棒的免费和开源代码编辑器。
|
||||||
|
|
||||||
|
4.为您的代码编辑器设置linting。
|
||||||
|
|
||||||
|
您应该[在您的编辑器中运行[ESLint]（http://eslint.org/docs/user-guide/integrations.html），它将突出显示任何不符合[freeCodeCamp的JavaScript样式指南]的内容（http：/ /forum.freecodecamp.org/t/free-code-camp-javascript-style-guide/19121）。
|
||||||
|
|
||||||
|
>请不要忽略任何掉毛错误。它们旨在帮助您，并确保干净简单的代码库。
|
||||||
|
|
||||||
|
##克隆你的freeCodeCamp副本
|
||||||
|
|
||||||
|
['Cloning']（https://help.github.com/articles/cloning-a-repository/）是一个步骤，您可以**下载**您或其他人拥有的存储库副本一个“远程”位置。在你的情况下，这个远程位置是freeCodeCamp存储库的`fork`，应该可以在`https：// github.com / YOUR_USER_NAME / freeCodeCamp`获得。
|
||||||
|
|
||||||
|
在本地计算机上运行以下命令：
|
||||||
|
|
||||||
|
1.在项目目录中打开终端/命令提示符/ Bash Shell
|
||||||
|
|
||||||
|
_i.e。：`/ yourprojectdirectory /`_
|
||||||
|
|
||||||
|
2.克隆你的freeCodeCamp的fork，用你的GitHub用户名替换'YOUR_USER_NAME`
|
||||||
|
|
||||||
|
```壳
|
||||||
|
git clone https://github.com/YOUR_USER_NAME/freeCodeCamp.git
|
||||||
|
```
|
||||||
|
|
||||||
|
这会将整个freeCodeCamp存储库下载到您的项目目录中。
|
||||||
|
|
||||||
|
##在主存储库中设置`upstream`
|
||||||
|
|
||||||
|
现在你已经下载了fork的副本，你需要设置一个`upstream`。
|
||||||
|
|
||||||
|
如前所述，`https：// github.com / freeCodeCamp / freeCodeCamp`的主存储库通常被称为`upstream`存储库。你在`https：// github.com / YOUR_USER_NAME / freeCodeCamp`的分支通常被称为`origin`信息库。
|
||||||
|
|
||||||
|
除了`origin`之外，你还需要将你的本地克隆指向`upstream`。这样您就可以同步主存储库中的更改。这样您就不必一次又一次地进行分叉和克隆。
|
||||||
|
|
||||||
|
1.将目录更改为新的freeCodeCamp目录：
|
||||||
|
|
||||||
|
```壳
|
||||||
|
cd freeCodeCamp
|
||||||
|
```
|
||||||
|
|
||||||
|
2.将遥控器添加到主freeCodeCamp存储库：
|
||||||
|
|
||||||
|
```壳
|
||||||
|
git remote add upstream https://github.com/freeCodeCamp/freeCodeCamp.git
|
||||||
|
```
|
||||||
|
|
||||||
|
3.检查配置看起来不错：
|
||||||
|
|
||||||
|
```壳
|
||||||
|
git remote -v
|
||||||
|
```
|
||||||
|
|
||||||
|
输出应如下所示：
|
||||||
|
|
||||||
|
```壳
|
||||||
|
来源https://github.com/YOUR_USER_NAME/freeCodeCamp.git（获取）
|
||||||
|
来源https://github.com/YOUR_USER_NAME/freeCodeCamp.git（推）
|
||||||
|
上游https://github.com/freeCodeCamp/freeCodeCamp.git（获取）
|
||||||
|
上游https://github.com/freeCodeCamp/freeCodeCamp.git（推送）
|
||||||
|
```
|
||||||
|
|
||||||
|
##在您的计算机上本地运行freeCodeCamp
|
||||||
|
|
||||||
|
现在您已拥有freeCodeCamp的本地副本，您可以按照这些说明使其在本地运行。这将有助于您：
|
||||||
|
|
||||||
|
- 预览对学习平台上显示的页面的编辑。
|
||||||
|
- 处理与UI相关的问题和增强功能。
|
||||||
|
- 调试和修复应用程序服务器和客户端应用程序中的问题。
|
||||||
|
|
||||||
|
如果您只是编辑文件，执行`rebase`或解决`merge`冲突，您可以跳过本地运行freeCodeCamp。您以后可以随时返回这部分说明。
|
||||||
|
|
||||||
|
[跳过本地运行freeCodeCamp]（＃making-changes-to-your-clone-of-freecodecamp-local）
|
||||||
|
|
||||||
|
###安装先决条件
|
||||||
|
|
||||||
|
首先安装这些必备软件。
|
||||||
|
|
||||||
|
|先决条件|版本|备注|
|
||||||
|
| ------------------------------------------- | ------- | ----- |
|
||||||
|
| [MongoDB社区服务器]（https://docs.mongodb.com/manual/administration/install-community/）| `3.6` | [发布说明]（https://docs.mongodb.com/manual/release-notes/），注意：我们目前在`3.6`，[计划升级]（https://github.com/freeCodeCamp/freeCodeCamp /问题/ 18275）。
|
||||||
|
| [Node.js]（http://nodejs.org）| `8.x` | [LTS Schedule]（https://github.com/nodejs/Release#release-schedule）|
|
||||||
|
| npm（与Node捆绑在一起）| `6.x` |没有LTS版本，我们使用与Node LTS |捆绑在一起的版本
|
||||||
|
|
||||||
|
**重要：**
|
||||||
|
|
||||||
|
我们强烈建议您更新上述最新的稳定版本a.k.a长期支持（LTS）版本。
|
||||||
|
如果您的计算机上已安装Node.js或MongoDB，请运行以下命令以验证版本：
|
||||||
|
|
||||||
|
```壳
|
||||||
|
节点-v
|
||||||
|
mongo --version
|
||||||
|
npm -v
|
||||||
|
```
|
||||||
|
|
||||||
|
>如果您有不同的版本，请安装推荐的版本。我们只支持推荐版本的安装问题。
|
||||||
|
|
||||||
|
**我在安装推荐的先决条件时遇到问题。我该怎么办？**
|
||||||
|
|
||||||
|
我们定期开发流行的和最新的操作系统，如macOS 10.12或更高版本，Ubuntu 16.04或更高版本以及Windows 10.它建议在以下资源上查找您的特定问题：Google，Stack Overflow或Stack Exchange。有可能有人遇到了同样的问题，并且您的特定查询已经有了答案。
|
||||||
|
|
||||||
|
如果您使用的是其他操作系统，和/或仍然遇到问题，请联系我们公共论坛上的[贡献者社区]（https://www.freeCodeCamp.org/c/contributors）或[贡献者聊天室] （https://gitter.im/freeCodeCamp/Contributors）。我们或许可以解决一些常见问题。
|
||||||
|
|
||||||
|
我们无法在GitHub上为您提供支持，因为软件安装问题超出了本项目的范围。
|
||||||
|
|
||||||
|
###安装依赖项
|
||||||
|
|
||||||
|
首先安装应用程序启动所需的依赖项。
|
||||||
|
|
||||||
|
```壳
|
||||||
|
＃安装NPM依赖项
|
||||||
|
npm安装
|
||||||
|
```
|
||||||
|
|
||||||
|
然后，您需要添加私有环境变量（API密钥）：
|
||||||
|
|
||||||
|
```壳
|
||||||
|
＃创建“sample.env”的副本并将其命名为“.env”。
|
||||||
|
＃使用必要的API密钥和秘密填充它：
|
||||||
|
|
||||||
|
#macOS / Linux
|
||||||
|
cp sample.env .env
|
||||||
|
|
||||||
|
#Windows
|
||||||
|
copy sample.env .env
|
||||||
|
```
|
||||||
|
无需更改密钥即可在本地运行应用程序。您可以保留`sample.env`中的默认值。
|
||||||
|
|
||||||
|
`MONGOHQ_URL`是最重要的一个。除非您在不同于默认值的设置中运行MongoDB，否则`sample.env`中的URL应该可以正常工作。
|
||||||
|
|
||||||
|
您可以保留其他键。请记住，如果您想使用更多服务，您必须为这些服务获取自己的API密钥，并在`.env`文件中相应地编辑这些条目。
|
||||||
|
|
||||||
|
接下来，引导各种服务，即api-server，客户端UI应用程序等。您可以[在本指南中了解有关这些服务的更多信息]（＃）。
|
||||||
|
|
||||||
|
通过引导，您将绑定服务之间的链接。他们是半独立的。这意味着，在生产中，这些服务会部署到自己的位置，但在本地运行时，您希望它们都可供您使用。
|
||||||
|
|
||||||
|
```壳
|
||||||
|
＃引导此存储库中的所有项目
|
||||||
|
npm运行bootstrap
|
||||||
|
```
|
||||||
|
|
||||||
|
###启动MongoDB
|
||||||
|
|
||||||
|
在启动应用程序之前，您需要启动MongoDB：
|
||||||
|
|
||||||
|
在单独的终端中启动MongoDB服务器
|
||||||
|
|
||||||
|
- 在macOS和Ubuntu上：
|
||||||
|
|
||||||
|
```壳
|
||||||
|
的mongod
|
||||||
|
```
|
||||||
|
|
||||||
|
- 在Windows上，您必须指定`mongod`二进制文件的完整路径
|
||||||
|
|
||||||
|
确保用您安装的版本替换`3.6`
|
||||||
|
|
||||||
|
```壳
|
||||||
|
“C：\ Program Files \ MongoDB \ Server \ 3.6 \ bin \ mongod”
|
||||||
|
```
|
||||||
|
|
||||||
|
> ProTip：
|
||||||
|
>通过将其作为后台服务安装，您可以避免每次都启动MongoDB。
|
||||||
|
>您可以[在他们的操作系统文档中了解更多信息]（https://docs.mongodb.com/manual/administration/install-community/）
|
||||||
|
|
||||||
|
###播种数据库
|
||||||
|
|
||||||
|
接下来，让数据库播种。在此步骤中，我们运行以下命令，该命令将使MongoDB服务器填充其他服务所需的一些初始数据集。这包括一些模式，以及其他内容。
|
||||||
|
|
||||||
|
```壳
|
||||||
|
npm run seed
|
||||||
|
```
|
||||||
|
###开始freeCodeCamp客户端应用程序和API服务器
|
||||||
|
您能现在开始API服务器和客户端应用程序。
|
||||||
|
```壳
|
||||||
|
npm奔跑开发
|
||||||
|
这
|
||||||
|
单一命令将射击所有服务的```包括API服务器和客户端应用程序可利用为您运作。
|
||||||
|
现在打开浏览器并且参观< http://localhost:8000 >。 如果app装载，祝贺-您是全部设置了。
|
||||||
|
> ProTip ：
|
||||||
|
>
|
||||||
|
> API服务器服务APIs在`http://localhost:3000 `
|
||||||
|
> Gatsby app为客户端应用程序服务在`http://localhost:8000 `
|
||||||
|
意思，如果您参观< http://localhost:3000/explorer >您应该看APIs我们有。
|
||||||
|
祝贺🎉! 您现在有freeCodeCamp的整个学习的平台的拷贝运行在您的地方机器的。
|
||||||
|
##快的命令参考当工作地方
|
||||||
|
[这一个即时参考](/docs/README.md)时在您可能时常当地需要命令的名单：
|
||||||
|
当地做对freeCodeCamp您的克隆的##变动
|
||||||
|
其次，您能做对文件的变动，并且做您的变动。
|
||||||
|
跟随这些步：
|
||||||
|
1.一旦提交了編輯內容，系統將提示您在fork的GitHub頁面上創建一個拉取請求。
|
||||||
|
|
||||||
|
！[圖片 - 比較GitHub上的拉取請求提示]（/ docs / images / github / compare-pull-request-prompt.png）
|
||||||
|
|
||||||
|
2.默認情況下，所有pull請求都應該針對freeCodeCamp主repo，`master`分支。
|
||||||
|
|
||||||
|
提出拉取請求時，請確保將Base Fork設置為freeCodeCamp / freeCodeCamp。**
|
||||||
|
|
||||||
|
！[圖片 - 在提出拉取請求時比較叉子]（/ docs / images / github / comparison -forks-for-pull-request.png）
|
||||||
|
|
||||||
|
3.將分支的pull請求提交給freeCodeCamp的`master`分支。
|
||||||
|
|
||||||
|
4.在PR的正文中包含更詳細的摘要，包括您所做的更改以及原因。
|
||||||
|
|
||||||
|
- 您將看到一個拉取請求模板。這是在打開拉取請求之前應該遵循的清單。
|
||||||
|
|
||||||
|
- 填寫適合您的詳細信息。我們將審核此信息，並決定是否接受您的提款請求。
|
||||||
|
|
||||||
|
- 如果PR旨在解決現有的錯誤/問題，那麼，在結束時
|
||||||
|
你PR的描述，附加關鍵字`closes`和#xxxx（其中xxxx
|
||||||
|
是問題編號）。示例：`關閉＃1337`。這告訴GitHub
|
||||||
|
如果PR被接受並合併，則自動關閉現有問題。
|
||||||
|
|
||||||
|
5.表明您是否在本地網站上進行過測試。
|
||||||
|
|
||||||
|
當您進行非複制編輯降價文件的更改時，這非常重要。例如，對CSS或JavaScript代碼等的更改
|
||||||
|
|
||||||
|
##讓你的PR接受
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
##獲得幫助
|
||||||
|
|
||||||
|
如果您遇到困難並需要幫助，請通過我們論壇上的['貢獻者'類別]（https://www.freecodecamp.org/forum/c/contributors）或[貢獻者聊天室]詢問我們（關於Gitter的https://gitter.im/FreeCodeCamp/Contributors）。
|
||||||
|
|
||||||
|
您的瀏覽器控制台或Bash /終端/命令行中可能存在錯誤，有助於識別問題。
|
||||||
|
|
||||||
|
＃＃＃ 故障排除
|
||||||
|
|
||||||
|
如果應用程序啟動但您遇到UI本身的錯誤，例如，如果未加載字體或代碼編輯器未正確顯示，您可以嘗試至少一次以下故障排除步驟：
|
||||||
|
|
||||||
|
```殼
|
||||||
|
＃刪除所有已安裝的節點模塊
|
||||||
|
rm -rf node_modules ./**/node_modules
|
||||||
|
|
||||||
|
＃重新安裝npm包
|
||||||
|
npm安裝
|
||||||
|
|
||||||
|
＃引導項目
|
||||||
|
npm運行bootstrap
|
||||||
|
|
||||||
|
＃種子數據庫
|
||||||
|
npm run seed
|
||||||
|
|
||||||
|
＃重新啟動應用程序
|
||||||
|
npm run develop
|
||||||
|
```
|
||||||
@ -1,17 +1,93 @@
|
|||||||
<table>
|
＃如何处理编码挑战
|
||||||
<tr>
|
|
||||||
<td> Read these guidelines in </td>
|
|
||||||
<td><a href="/CONTRIBUTING.md"> English </a></td>
|
|
||||||
<td><a href="/docs/chinese/CONTRIBUTING.md"> 中文 </a></td>
|
|
||||||
<td><a href="/docs/russian/CONTRIBUTING.md"> русский </a></td>
|
|
||||||
<td><a href="/docs/arabic/CONTRIBUTING.md"> عربى </a></td>
|
|
||||||
<td><a href="/docs/spanish/CONTRIBUTING.md"> Español </a></td>
|
|
||||||
<td><a href="/docs/portuguese/CONTRIBUTING.md"> Português </a></td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
# Contribution Guidelines
|
###在GitHub上更改
|
||||||
|
|
||||||
Hello 👋 !
|
每个挑战都存储在自己的降价文件中。这使得从GitHub中编辑挑战变得容易。
|
||||||
|
|
||||||
These instructions have not been translated yet. Please check this issue for details: [`#18312`](https://github.com/freeCodeCamp/freeCodeCamp/issues/18312)
|
您无需在本地系统上运行任何操作即可进行更改。
|
||||||
|
|
||||||
|
在GitHub界面中找到要修改的文件后，单击铅笔图标开始编辑文件。这将自动创建项目的分支，如果您还没有。
|
||||||
|
|
||||||
|
您还可以克隆项目并在计算机上进行本地编辑。如需帮助，请阅读主要[贡献指南]（/ CONTRIBUTING.md）。
|
||||||
|
|
||||||
|
###挑战模板
|
||||||
|
|
||||||
|
这是挑战markdown文件的模板。
|
||||||
|
|
||||||
|
````MD
|
||||||
|
---
|
||||||
|
id：唯一标识符（alphanumerical，MongoDB _id）
|
||||||
|
标题：挑战标题
|
||||||
|
challengeType：0
|
||||||
|
guideUrl：'引导文章的网址'
|
||||||
|
videoUrl：'视频解释的网址'
|
||||||
|
---
|
||||||
|
|
||||||
|
##说明
|
||||||
|
<section id ='description'>
|
||||||
|
挑战的描述以及通过的要求
|
||||||
|
</节>
|
||||||
|
|
||||||
|
##说明
|
||||||
|
<section id ='说明'>
|
||||||
|
关于究竟需要做什么的说明。
|
||||||
|
</节>
|
||||||
|
##测试
|
||||||
|
<section id ='tests'>
|
||||||
|
|
||||||
|
```yml
|
||||||
|
- 文字：应该返回“foo”。
|
||||||
|
testString：'使用Chai断言的字符串化函数'
|
||||||
|
```
|
||||||
|
|
||||||
|
</节>
|
||||||
|
|
||||||
|
<div id ='js-seed'>
|
||||||
|
|
||||||
|
```JS
|
||||||
|
默认情况下，代码在编辑器中显示。
|
||||||
|
```
|
||||||
|
|
||||||
|
</ DIV>
|
||||||
|
|
||||||
|
###测试前
|
||||||
|
<div id ='js-setup'>
|
||||||
|
|
||||||
|
```JS
|
||||||
|
测试设置代码。
|
||||||
|
```
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</节>
|
||||||
|
|
||||||
|
###经过测试
|
||||||
|
<div id ='js-teardown'>
|
||||||
|
|
||||||
|
```JS
|
||||||
|
测试拆解代码。
|
||||||
|
```
|
||||||
|
|
||||||
|
</ DIV>
|
||||||
|
|
||||||
|
</节>
|
||||||
|
|
||||||
|
##解决方案
|
||||||
|
<section id ='solution'>
|
||||||
|
|
||||||
|
```JS
|
||||||
|
挑战解决方案代码
|
||||||
|
```
|
||||||
|
|
||||||
|
</节>
|
||||||
|
````
|
||||||
|
|
||||||
|
###有用的链接
|
||||||
|
|
||||||
|
创建和编辑挑战：
|
||||||
|
|
||||||
|
1. [挑战风格指南]（style-guide-for-curriculum-challenges.md） - 如何创建和格式化挑战
|
||||||
|
|
||||||
|
2. [挑战类型]（https://github.com/freeCodeCamp/learn/blob/a5cb25704168aa37f59a582f0bb5a19b7bd89b46/utils/challengeTypes.js） - 数字挑战类型值的含义（枚举）。
|
||||||
|
|
||||||
|
3. [贡献FreeCodeCamp - 编写ES6挑战测试]（https://www.youtube.com/watch?v=iOdD84OSfAE#t=2h49m55s） - 视频[Ethan Arrowood]（https://twitter.com/ ArrowoodTech）因为他对旧版课程做出了贡献
|
||||||
@ -1,17 +1,259 @@
|
|||||||
<table>
|
#如何在指南文章工作
|
||||||
<tr>
|
在您的帮助下，我们可以创造将帮助成千上万人学会未来几年编码的一个全面参考工具。 💛
|
||||||
<td> Read these guidelines in </td>
|
您能：
|
||||||
<td><a href="/CONTRIBUTING.md"> English </a></td>
|
- [帮助我们通过创造和编辑指南文章](#steps为创造和编辑指南文章)。
|
||||||
<td><a href="/docs/chinese/CONTRIBUTING.md"> 中文 </a></td>
|
- [帮助回顾拉扯要求指南文章(]) ##
|
||||||
<td><a href="/docs/russian/CONTRIBUTING.md"> русский </a></td>
|
步的我们为创造和编辑指南文章
|
||||||
<td><a href="/docs/arabic/CONTRIBUTING.md"> عربى </a></td>
|
1。 🍴 [叉子这repo] (https://github.com/freeCodeCamp/freeCodeCamp#fork-destination-box)
|
||||||
<td><a href="/docs/spanish/CONTRIBUTING.md"> Español </a></td>
|
2。 👀️遵循如下所示的贡献的指导方针。
|
||||||
<td><a href="/docs/portuguese/CONTRIBUTING.md"> Português </a></td>
|
3. 🔧做一些令人敬畏的变动!
|
||||||
</tr>
|
4. 📖读了这个 [样式指南为最佳的实践](/docs/style指南为指南文章)。
|
||||||
</table>
|
5. 👉 [做拉扯请求](https://github.com/freeCodeCamp/freeCodeCamp/compare)
|
||||||
|
6。 🎉得到您的拉扯请求被批准-成功!
|
||||||
|
或请 [创造一个问题](https://github.com/freeCodeCamp/freeCodeCamp/issues) -任何一点帮助计数! 😊
|
||||||
|
### [遵循这些被推荐的指导方针从我们的样式指南为创造拉扯请求](PR)的
|
||||||
|
一強制指南文章(/docs/style指南为指南articles.md) ###提出那里
|
||||||
|
变动是您能提出对贮藏库的变动的二种方式，在您编辑或增加一篇指南文章之后：
|
||||||
|
- [使用GitHub网接口在您的浏览器](#using这github网接口在你浏览器)。
|
||||||
|
- [工作在您的地方机器](#working在你地方机器) (_recommended_为预览变动)。
|
||||||
|
####使用GitHub网接口在您的浏览器
|
||||||
|
手表录影示范或在它之下跟随步：
|
||||||
|
**[ TODO] **更新GIF录音。
|
||||||
|
! [显示GitHub接口的GIF跨步](#)
|
||||||
|
1。 进入** “页” **文件夹(位于 [`客户或src或者页或者指南`](/client/src/pages/guide)) 并且发现您希望写或编辑的文章残余部分。
|
||||||
|
> 所有残余部分在index.md文件
|
||||||
|
2。 点击<kbd>Edit这个file</kbd>铅笔像并且做您的对文件的变动在GitHub调味的减价。
|
||||||
|
> 如果像是greyed，并且发出您警告“您必须是在做或提出对这个文件的变动的分支”，则您是可能的在另一个人的树。 在顶面左页，有认为“树的下落下来装箱： #######". 点击下落下来并且改变分支到“大师”。 铅笔像应该现在clickable。
|
||||||
|
3. 纸卷对底部的屏幕和增加解释您的变动的一则做消息。
|
||||||
|
(任意) ： 我们高度推荐做常规做消息。 这是您在某些将看普遍的开放来源贮藏库的很好的练习。 作为开发商，这鼓励您跟随标准操作。
|
||||||
|
有些例子的常规做消息是：
|
||||||
|
```md
|
||||||
|
固定： 更新HTML指南文章
|
||||||
|
固定： 更新修造剧本为TravisCI
|
||||||
|
技艺： 增加文章为Java语言卷扬
|
||||||
|
docs ： 更新贡献的指南
|
||||||
|
```
|
||||||
|
保留这些短小，不超过50个字符。 您在做消息的描述能总增加其它信息。
|
||||||
|
这比一则跌荡的消息象‘更新文件’或‘增加index.md’不花费另外的时间
|
||||||
|
您能学会更多在大约 [为什么您这里如果这些](https://www.conventionalcommits.org/en/v1.0.0-beta.2/#why-use-conventional-commits)。
|
||||||
|
4. 然后选择单选按钮选择为** “创造一个新的分支为此做并且开始拉扯请求” **并且点击<kbd>Propose文件changes</kbd>。
|
||||||
|
|
||||||
# Contribution Guidelines
|
5. 在下个屏幕，您能增加关于您的PR的所有其他细节，然后点击<kbd>Create拉扯request</kbd>。
|
||||||
|
祝贺🎉! 您创造了拉扯请求。
|
||||||
|
运作在您的地方机器(_recommended_的####为预览变动)
|
||||||
|
没有要求您在您的地方机器工作，除非您希望预览您编辑或者与UI固定和改进一起使用。 也推荐这您是否跑入git问题象合并冲突， rebasing等等。
|
||||||
|
#####读了这些指南关于 [怎样设定得到PR的]地方freeCodeCamp (
|
||||||
|
/docs/how对设定freecodecamp locally.md) ###这里
|
||||||
|
被接受是评论者遵循的几指导方针，当回顾PRs时：
|
||||||
|
-有一个相关的描述，并且标题
|
||||||
|
- PR尊敬 [样式指南](/docs/style指南为指南文章)
|
||||||
|
-我们跟随在调解人指南发现的一般 [QA技巧](https://forum.freecodecamp.org/t/freecodecamp-moderator-guidelines/18295)
|
||||||
|
-，只要拉扯请求改进或扩展指南，我们接受它，即使它包含不完美的英国或部份内容
|
||||||
|
-更旧的拉扯请求是被回顾的第一个
|
||||||
|
####标签
|
||||||
|
- **内容**是为在指南的拉扯请求(他们修改文章内容增加一篇新的文章或更新一篇现有的文章)
|
||||||
|
- **复制品**是为有内容和一样另一开放PR -的拉扯
|
||||||
|
请求**以前需要变动的变动请求**是为拉扯请求 得到被合并的
|
||||||
|
- **陈旧**为拉扯请求与_ “改变没在大约2个星期以后得到活动，并且随后是闭合的请求的” _标签。
|
||||||
|
- _stale_拉扯请求应该是闭合的。
|
||||||
|
-这 [例子](https://github.com/freeCodeCamp/freeCodeCamp/pull/235)。
|
||||||
|
####相冲突或复制内容
|
||||||
|
A PR被认为a **复制品**，如果它做对文章的变动和另一PR一样。
|
||||||
|
一般来说，评论者将：
|
||||||
|
1. 排序PR从最旧
|
||||||
|
2。 查寻PRs与相似的内容
|
||||||
|
3。 合并从最老到它是
|
||||||
|
非常可能的那里的最新将是合并冲突与复制PRs。
|
||||||
|
评论者将作出每一努力解决这些冲突和合并复制PRs。
|
||||||
|
####请求变动
|
||||||
|
，如果拉扯请求不是完善的，评论者可以：
|
||||||
|
-对贡献者的请求变动和增加*changes requested*标签
|
||||||
|
-固定较小问题并且做做在所有PRs
|
||||||
|
必须通过Travis
|
||||||
|
CI检查的PR #### Travis CI修造顶部，在我们可以合并它之前。
|
||||||
|
如果PR打破修造(Travis CI支票发生故障，并且展示红色“X”)那里是三个可能的来源。
|
||||||
|
在我们可以合并您的PR之前，您将需要修理问题：
|
||||||
|
1. 您的PR创造一篇新的文章，并且它错过`index.md `文件某处。
|
||||||
|
-每个文件夹在`src或页`在它(和名字需要`index.md `文件必须是`index.md `)。
|
||||||
|
-二个可能的情景是
|
||||||
|
除`index.md `之外， -您命名了新的文章文件某事或者
|
||||||
|
-您创造了一个新的文件夹，然后次级文件夹，您在次级文件夹在新的文件夹2写新的文章，但忘记投入残余部分`index.md `
|
||||||
|
|
||||||
Hello 👋 !
|
2.您的PR創建一個新文件夾，文件夾名稱格式不正確。
|
||||||
|
- 您的文件夾名稱應全部小寫並以kebab-case格式化（即my-new-folder）。
|
||||||
|
這篇文章的頂部沒有`title`字段。
|
||||||
|
- 請參閱下面[編寫文章的樣式指南]下的[標題]（＃title）部分（/ docs / style-guide-for-guide-articles.md）。
|
||||||
|
|
||||||
These instructions have not been translated yet. Please check this issue for details: [`#18312`](https://github.com/freeCodeCamp/freeCodeCamp/issues/18312)
|
###我們何時關閉拉取請求
|
||||||
|
|
||||||
|
我們關閉拉取請求
|
||||||
|
|
||||||
|
- 如果同一篇文章的較舊PR合併，並且您的PR不添加新內容
|
||||||
|
- 如果它沒有/很少的努力（例如：從維基百科等其他來源複製粘貼）
|
||||||
|
- 如果有受版權保護的來源複製文本 - 請參閱[引用問題]（https://github.com/freeCodeCamp/freeCodeCamp/issues/2503）
|
||||||
|
- 如果它不尊重[撰寫文章的風格指南]（/ docs / style-guide-for-guide-articles.md）
|
||||||
|
- 如果不尊重[學術誠信政策]（https://www.freecodecamp.org/academic-honesty）
|
||||||
|
- 如果它是陳舊的（如果要求更改並且約2週沒有活動）
|
||||||
|
|
||||||
|
此外，如果您正在處理“存根”文章，則您的更改必須足夠大，以替換存根文本。
|
||||||
|
|
||||||
|
我們不接受只添加“更多信息：”部分鏈接的公關。
|
||||||
|
|
||||||
|
存儲庫有一個`Normalise.js`腳本，它為鏈接添加屬性，但也通過RegEx檢查“這是一個存根...”文本。
|
||||||
|
|
||||||
|
如果找到，它會將文章文本還原為通用存根文本（並刪除更改）。
|
||||||
|
|
||||||
|
這是預期的行為，因為它允許我們在模板存根因任何原因而更改時更新所有存根。
|
||||||
|
|
||||||
|
###獲得幫助
|
||||||
|
|
||||||
|
這是一個由整個貢獻者團隊提供支持的社區，您可以從中汲取創意，並在撰寫時提出意見。
|
||||||
|
|
||||||
|
保持活躍在[貢獻者聊天室]（https://gitter.im/freecodecamp/contributors）並提出很多問題。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
##披露指南文章拉取請求的步驟
|
||||||
|
|
||||||
|
>本節針對此回購的評論者。
|
||||||
|
|
||||||
|
##壁球和合併
|
||||||
|
|
||||||
|
在合併保持提交歷史記錄清潔的PR時，我們使用<kcd> Squash和merge </ kcd>選項。
|
||||||
|
|
||||||
|
！[GIF - 壁球和合併]（https://files.gitter.im/FreeCodeCamp/Contributors/56MQ/9cb8db153d7bb1b3576cd1ffc207e39d.gif）
|
||||||
|
|
||||||
|
###過濾PR
|
||||||
|
|
||||||
|
> PR，Open，Oldest First，Travis CI建立成功，沒有人分配，沒有評論
|
||||||
|
|
||||||
|
[`是：pr is：open sort：updated-asc status：success no：assignee comments：0`]（https://github.com/freeCodeCamp/freeCodeCamp/pulls?utf8=%E2%9C%93&q=is% 3Apr％圖20是％3Aopen％20sort％3Aupdated-ASC％20status％3Asuccess％20no％3Aassignee％20comments％3A0）
|
||||||
|
|
||||||
|
> PR，Open，Oldest First，沒有標籤：`platform`，`enhancement`，`invalid`或`change changes'
|
||||||
|
|
||||||
|
[`是：pr是：open sort：updated-asc -label：platform -label：enhancement -label：invalid -label：“changes requested”“]（https://github.com/freeCodeCamp/freeCodeCamp/pulls?utf8 =％E2％9C％93＆q =是％3Apr％圖20是％3Aopen％20sort％3Aupdated-ASC％20-標記％3Aplatform％20-標記％3Aenhancement％20-標記％3Ainvalid％20-標籤％3A％22changes％20requested％ 22）。
|
||||||
|
|
||||||
|
###模板
|
||||||
|
|
||||||
|
>您可以使用GitHub內置的[**已保存回复**]（https://github.com/settings/replies/）功能製作您自己的功能，或使用以下功能。
|
||||||
|
|
||||||
|
＃＃＃＃ 謝謝
|
||||||
|
|
||||||
|
```降價
|
||||||
|
感謝您對該頁面的貢獻！ 👍
|
||||||
|
我們很高興接受這些變化，並期待未來的貢獻。 🎉
|
||||||
|
```
|
||||||
|
|
||||||
|
####謝謝你，恭喜你
|
||||||
|
|
||||||
|
>感謝和鼓勵第一次貢獻者。
|
||||||
|
|
||||||
|
```降價
|
||||||
|
嗨@username。恭喜你的第一次拉動請求（PR）！ 🎉
|
||||||
|
|
||||||
|
感謝您對該頁面的貢獻！ 👍
|
||||||
|
我們很高興接受這些變化，並期待未來的貢獻。 📝
|
||||||
|
```
|
||||||
|
|
||||||
|
####構建錯誤
|
||||||
|
|
||||||
|
```降價
|
||||||
|
嘿@username
|
||||||
|
|
||||||
|
因此，我希望能夠合併您的更改，但看起來Travis CI版本存在錯誤。 ⚠️
|
||||||
|
|
||||||
|
解決這些問題後，我將能夠審核您的PR並將其合併。 😊
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
>請隨意參考[文章指南撰寫文章]（https://github.com/freeCodeCamp/freeCodeCamp#article-title），以便正確格式化文章，以便Travis CI構建通過。 ✅
|
||||||
|
>
|
||||||
|
>此外，GitHub在創建PR時寫下您的更改的簡要說明是一種很好的做法。 📝
|
||||||
|
```
|
||||||
|
|
||||||
|
####同步Fork
|
||||||
|
|
||||||
|
>當PR與`master`分支不同時。
|
||||||
|
|
||||||
|
``````降價
|
||||||
|
嘿@username
|
||||||
|
|
||||||
|
因此，我希望能夠合併您的更改，但看起來Travis CI版本存在錯誤。 ⚠️
|
||||||
|
|
||||||
|
```慶典
|
||||||
|
錯誤：ENOTDIR：不是目錄，打開'src / pages / java / data-abstraction / index.md'
|
||||||
|
```
|
||||||
|
|
||||||
|
這個特殊錯誤實際上並不是由您的文件引起的，而是由於將錯誤代碼合併到`master`分支引起的舊錯誤。它已經解決了。
|
||||||
|
|
||||||
|
要傳遞構建，您必須同步來自`freeCodeCamp / freeCodeCamp` repo的`master`分支的最新更改。
|
||||||
|
|
||||||
|
使用命令行，您可以通過三個簡單的步驟完成此操作：
|
||||||
|
|
||||||
|
```慶典
|
||||||
|
git remote add upstream git：//github.com/freeCodeCamp/freeCodeCamp.git
|
||||||
|
|
||||||
|
git fetch upstream
|
||||||
|
|
||||||
|
git pull上游大師
|
||||||
|
```
|
||||||
|
|
||||||
|
如果你正在使用GUI，你只需“添加一個新的遠程...”並使用上面的鏈接`git：// github.com / freeCodeCamp / freeCodeCamp.git`。
|
||||||
|
|
||||||
|
一旦你同步你的fork並傳遞構建，我將能夠檢查你的PR並合併它。 😊
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
>隨意參考GitHub上的[Syncing a Fork]（https://help.github.com/articles/syncing-a-fork/）文章，了解如何讓您的叉子與最新版本保持同步上游存儲庫。 🔄
|
||||||
|
>
|
||||||
|
>此外，GitHub在創建PR時寫下您的更改的簡要說明是一種很好的做法。 📝
|
||||||
|
``````
|
||||||
|
|
||||||
|
####合併衝突
|
||||||
|
|
||||||
|
>當PR出現需要解決的合併衝突時.¹
|
||||||
|
|
||||||
|
```降價
|
||||||
|
嘿@username
|
||||||
|
|
||||||
|
所以我希望能夠合併您的更改，但看起來您有一些合併衝突。 ⚠️
|
||||||
|
|
||||||
|
解決這些衝突後，我將能夠檢查您的PR並將其合併。 😊
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
>如果您不熟悉合併衝突過程，請隨時查看GitHub關於[“解決合併衝突”的指南]（https://help.github.com/articles/resolving-a-merge-conflict-上的github /）。 🔍️
|
||||||
|
>
|
||||||
|
>此外，GitHub在創建PR時寫下您的更改的簡要說明是一種很好的做法。 📝
|
||||||
|
```
|
||||||
|
¹如果第一次撰稿人有合併衝突，維護人員將為他們解決衝突。
|
||||||
|
|
||||||
|
####複製
|
||||||
|
|
||||||
|
> PR重複或重複時。
|
||||||
|
|
||||||
|
```降價
|
||||||
|
嘿@username
|
||||||
|
|
||||||
|
對於您正在編輯的這篇文章，似乎已經接受了類似的更改，對此抱歉。 😓
|
||||||
|
|
||||||
|
如果您覺得還有更多要添加的內容，請隨時打開新的PR。
|
||||||
|
|
||||||
|
再次感謝！ 😊
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
>如果您有任何疑問，請隨時通過[Gitter]（https://gitter.im/FreeCodeCamp/Contributors）或通過以下評論與您聯繫。 💬
|
||||||
|
```
|
||||||
|
|
||||||
|
####關閉無效的拉取請求
|
||||||
|
|
||||||
|
> PR無效時。
|
||||||
|
|
||||||
|
```降價
|
||||||
|
嘿@username
|
||||||
|
|
||||||
|
你實際上沒有添加任何內容，所以我將無效拉請求此PR並將其標記為“無效”。 😓️
|
||||||
|
|
||||||
|
隨意打開另一個公關！ 👍
|
||||||
|
```
|
||||||
Reference in New Issue
Block a user