感谢你有兴趣为 p5.js 做出贡献！我们的团队重视每一种形式的帮助，并且正在尽可能的扩大你能帮助的范围，这包括了参考文献、教学、编写程序、创作艺术、写作、设计、活动、组织、展策或者任何你能想象到的东西。我们的社群网页提供了一些贡献与参与项目的方法。如果你要提供技术性的帮助，请接着往下读。

本项目遵循贡献者名单规格。你可遵循指示把你和你的贡献添加到 readme，或者是在 GitHub issue 中评论你的贡献，我们就会把你加入到贡献者名单中。

源代码

p5.js 项目除了这个代码库外还包括了以下几个其他的代码库：

p5.js：包括了 p5.js 源代码。面向用户的 p5.js 参考文献也是由包含在此源代码中的 JSDoc 注解生成的。Lauren Lee McCarthy 为维持者。
p5.js-website：此源代码包含了 [p5.js website](http://p5js.org /)的大多数代码（除参考文献外）。Lauren Lee McCarthy 为维持者。
p5.js-sound：包括了 p5.sound.js 程式库。Jason Sigal 为维持者。
p5.js-web-editor：包含了 p5.js web editor 的源代码。Cassie Tarakajian 为维持者。请注意，旧版 p5.js editor 已不再受支持。
p5.accessibility：使 p5.js 更适合盲人和视障人士使用的程式库。

文件结构

这个代码库有很多文件，所以这里提供了文件总览。有些文件可能很难懂——不过你并不需要每一个都看懂才能开始。我们建议你先从一个特定区域入手（例如说，修复某些内联参考文献），并逐渐地探索更多领域。Luisa Pereira 的 Looking Inside p5.js 也给出了 p5.js 工具与文件的视频总览。

contributor_docs/ 包含了贡献者所需遵循的原则；
docs/ 并不包含参考文献！它包含了生成线上参考文献的代码；
lib/ 包含一个空白示例和 p5.sound 扩展程式库，并且会周期性地通过 p5.js-sound 代码库更新。这里也是当用 Grunt 把 p5.js 编译到单个文件后 p5.js 程式库的位置。发出 Pull request 时，无需将其检入 GitHub 代码库。
src/ 包含所有的源代码，这些源代码通常组织成多个单独的模块。如果要更改 p5.js，这就是你需要参考的地方。大多数文件夹内部都有独自的 README.md 文件，以帮助您浏览该文件夹。
tasks/ 包含创建 p5.js 与新版本 p5.js 的构建、部署和发行有关的自动化任务的脚本。
tests/ 包含单元测试，这些单元测试可确保库随着更改仍继续正常运行。
utils/ 可能包含对存储库有用的其他文件，但是通常您可以忽略此目录。

参考文献

我们意识到参考文献是这个项目中最重要的部分。不好的参考文献是新用户与新贡献者的最大屏障，让项目不具有包容性。contributing_documentation.md 页面为开始修改参考文献给出了一个深入的导览。p5.js 的参考文献可以在以下几个地方找到：

p5js.org/reference：由 inline documentation 的源代码生成。它包括了文本描述和参数以及随附的代码片段示例。我们将所有这些内联文献和代码放在一起，以使代码和参考文献保持紧密的联系，并强化这样的思想，贡献参考文献与贡献代码至少同等重要。构建库后，它将检查内联参考文献和示例，以确保它们与代码的行为方式匹配。要做出贡献，您可以先查看 inline_documentation.md 页面。
p5js.org/examples 页面包含更长的示例，这些示例对于学习 p5.js 可能有用。要做出贡献，您可以先查看 adding_examples.md。
p5js.org/learn 页面包含可帮助您学习 p5.js 和编程概念的教程。要做出贡献，您可以先查看 p5.js guide to contributing to tutorials。
您可能会注意到 p5.js 网站目前支持几种不同的语言。这称为国际化（i18n）。您可以在 i18n_contribution页面了解更多。

GitHub Issue 流程

我们使用 GitHub issue 跟踪已知的错误和预期的新功能。Issue lables 用于将问题分类，例如适合初学者的问题。
如果您想开始处理现有问题，请对你打算探查的问题发表评论，以便其他贡献者知道该问题正在处理中并可以提供帮助。
完成有关此问题的工作后，请针对 p5.js main 分支提交 Pull request 。在PR的描述字段中，包括 “resolves #XXXX” 标记，以解决您要解决的问题。如果 PR 并不能完全解决该问题（即，在PR合并后该问题应保持打开状态），请输入 “addresses #XXXX”。
如果发现错误或有想要添加新功能的主意，请先提交问题。请不要直接地提交包含修复程序或新功能的 Pull Request，而不先发出问题，否则我们将无法接受该 Pull Request。在有关该问题获得反馈并得到同意解决该问题后，您可以按照上述过程以提供修复或功能。
您可以对问题进行分类，其中可能包括复制错误报告或要求提供重要信息，例如版本号或复制说明。如果您想开始分类问题，一种简单的入门方法是在 CodeTriage 上订阅 p5.js。
organization.md 文件提供了有关如何组织问题以及决策过程的高级概述。如果您有兴趣，欢迎您参与。

开发过程

我们知道开发过程可能会有点难——不只是你一个人，所有人一开始都会这么觉得。你可以遵循下面的步骤来设置；如果遇到了问题，你可以在论坛上讨论或发布一个关于你的问题的 issue，我们会尽力帮助你的。

下载 node.js（同时将会自动下载 npm 程式包管理器）
将 p5.js 代码库 fork 到你的 GitHub 账号

复制此代码库的新 fork 到本地电脑：

$ git clone https://github.com/您的用户名/p5.js.git

导航到项目文件夹，并使用 npm 安装其所有所需的程式包。
```
$ cd p5.js
$ npm ci
```
Grunt 需要被安装，您可以使用它从源代码构建程式库。
```
$ npm run grunt
```
如果您要不断更改库中的文件，您可以运行 npm run dev 以便在源文件发生任何更改时自动为您重建程式库，而无需手动键入命令。

在本地源代码更改然后用 Git commit 它们。

$ git add -u
$ git commit -m "YOUR COMMIT MESSAGE"

再次运行 npm run grunt 确保没有语法错误，测试失败或其他问题。
将您对 GitHub 上的 fork 上载（Push）新更改。
```
$ git push
```
一切准备就绪后，使用 pull request 发布。

注意事项

p5.js 代码库附带的开发人员工具在某些方面特意非常严格。这是一件好事！它使所有内容保持一致，并勉励您在编写代码时保持一致性。这意味着您可能尝试更改某些东西——但您的提交可能会被项目拒绝，但不要灰心，即使是经验丰富的 p5.js 开发人员也方会犯同样的错误。通常，问题将出在以下两个方面之一：代码语法或单元测试。

代码语法

p5.js 要求整齐且在风格上一致的代码语法，它使用 ESlint 帮助检查代码。提交前这些工具会检查某些样式规则，但是您也可以为代码编辑器安装 ESlint 插件，以在键入代码后立即显示错误。总的来说，在代码风格方面我们会趋向选择灵活性，以减少参与和贡献的阻碍。

要检查错误，在命令行输入以下指令（不要键入 $ 提示符）：

$ npm run lint

一些语法错误可以自动修复：

$ npm run lint:fix

坚持使用已建立的项目样式通常是更可取的，但是偶尔可能使用不同的语法会使您的代码更易于理解。这些情况下，Prettier 提供了一个解决方式，// prettier-ignore注释，您可以使用它来指定个别例外代码。不过如果可以的话，尽量避免使用它，因为 linter 实施的大多数代码格式都有好的理由。

这是代码样式规则的快速摘要。请注意，此列表可能不完整，最好参考 .prettierrc 和 .eslintrc 文件以获取完整列表。

使用 ES6 语法
优先使用单引号
缩排使用两个空格
所有变量至少要使用一次，否则彻底删除
不要使用 x == true 或 x == false，请使用 (x) 或 (x)!。如果可能导致误解，请将物件与 null 对比、字符串与 "" 对比、数字与 0 对比。
在复杂或模棱两可的地方使用注释
参考 Mozilla JS practices 以了解一些有用的代码格式技巧。

单元测试

单元测试是一小段代码，它们是对主逻辑的补充，并执行验证。unit_testing.md页面提供了有关使用单元测试的更多信息。如果您正在开发 p5.js 的主要新功能，尽可能应该包含测试。不要提交没有通过测试的 pull request，因为这意味着某些代码中有错误。

以运行单元测试，您需要确保已安装项目的依赖项。

$ npm ci

这将安装所有 p5.js 的依赖项；简要地说，特定于单元测试的最重要依赖项包括：

-Mocha，一个功能强大的测试框架，可以执行特定于 p5.js 的各个测试文件 -mocha-chrome，一个可使用无头 Google Chrome 浏览器运行 mocha 测试的 mocha 插件

一旦安装了依赖项，请使用Grunt运行单元测试。

$ grunt

在浏览器而不是命令行中运行测试有时很有用。为此，请首先启动 connect 服务器：

$ npm run dev

在服务器运行的情况下，您应该能够在浏览器中打开 test/test.html。

完整的单元测试指南超出了 p5.js 文档的范围，但是简短的版本是 src/ 目录中包含的源代码中若有任何重大更改或新功能，它应随附有在 test/ 目录中的测试记录，以验证该库的所有将来版本中的行为一致。在编写单元测试时，请使用 Chai.js 参考文献作为分阶段声明消息的指南，以便将来在测试中捕获的任何错误都会是一致地，并使其他开发人员更容易理解问题在哪里。

其他

您可以浏览 contributor_docs / 文件夹中的其他文件。它们涉及贡献于此项目的技术和非技术方面的特定领域。
深入p5.js 是 p5.js 开发工作流程中使用的工具和文件的视频教程。
来自 The Coding Train 的视频 :train::rainbow: 概述了对 p5.js 的技术贡献入门。
p5.js Docker 映像可以安装在 Docker 中，并用于开发p5 .js，无需手动安装诸如 Node 之类的要求，也无需以其他方式影响主机操作系统（除了安装 Docker 外）。
p5.js 库的构建过程会生成一个 json 数据文件，其中包含了 p5.js 的公共 API，可用于自动化工具中，例如在编辑器中自动完成 p5.js 语法。该文件托管在 p5.js 网站上，但不包含在代码库中。
p5.js 的语言最近已改版到 ES6。要查看此举措如何影响您的贡献，请参考 ES6 adoption 。