` 中包含 `“notest”` 类：
+
+```
+* @example
+*
+* function setup() {
+* let c = createCanvas(100, 100);
+* saveCanvas(c, 'myCanvas', 'jpg');
+* }
+*
+```
+
+如果你的示例使用外部素材文件，请将它们放入 [/docs/yuidoc-p5-theme/assets](https://github.com/processing/p5.js/tree/main/docs/yuidoc-p5-theme/assets) 文件夹中（或者重用其中已有的文件），然后在代码中使用 "assets/filename.ext" 链接到它们。请参阅 [tint()](http://p5js.org/reference/#/p5/tint) 参考示例。
+
+
+### 使用 `describe()` 添加画布描述
+
+最后，对于你添加的每个示例，都需要使用 p5.js 函数 `describe()` 来创建一个屏幕阅读器可访问的画布描述。只包括一个参数：一个字符串，其中简要描述了画布上发生的事情。
+
+```
+* @example
+*
+*
+* let xoff = 0.0;
+* function draw() {
+* background(204);
+* xoff = xoff + 0.01;
+* let n = noise(xoff) * width;
+* line(n, 0, n, height);
+* describe('A vertical line moves randomly from left to right.');
+* }
+*
+*
+*
+*
+*
+* let noiseScale = 0.02;
+* function draw() {
+* background(0);
+* for (let x = 0; x < width; x += 1) {
+* let noiseVal = noise((mouseX + x) * noiseScale, mouseY * noiseScale);
+* stroke(noiseVal*255);
+* line(x, mouseY + noiseVal * 80, x, height);
+* }
+* describe('A horizontal wave pattern moves in the opposite direction of the mouse.');
+* }
+*
+*
+```
+
+有关 `describe()` 的更多信息，请访问 [网络无障碍贡献者文档](https://p5js.org/contributor-docs/#/web_accessibility?id=user-generated-accessible-canvas-descriptions)。
+
+以上就是你编写和编辑 p5.js 参考注释的大多数方法。然而，还有一些 JSDoc 样式参考注释的更多专门用法，你可能会在 p5.js 中遇到。这些在某些情况下很有用，但通常不是你经常需要的东西。
+
+
+### `@private` 标签
+
+如果属性或变量是私有函数或变量，则可以使用 `@private`。如果将功能标记为 `@private`，则不会将其作为渲染的参考的一部分包含在网站上。使用 `@private` 标签将参考注释块标记为私有的原因是当你记录库本身的内部功能时。例如，参考下面的 `_start` 的参考注释：
+
+
+
+```
+/**
+ * _start calls preload() setup() and draw()
+ *
+ * @method _start
+ * @private
+ */
+p5.prototype._start = function () {
+```
+
+
+### `@module` 和相关标签
+
+每个源代码文件的顶部都将有一个 `@module` 标签。模块对应于 p5.js 中的一组功能，在网站上呈现的渲染的参考页面将这些功能分成相应的部分。在每个模块中，使用 `@submodule` 标签定义额外的子模块。
+
+`@for` 标签定义此模块与整体 `p5` 类之间的关系，有效地表示此模块是 `p5` 类的一部分。
+
+`@requires` 标签定义当前模块依赖的所需导入模块。
+
+```
+/**
+ * @module Color
+ * @submodule Creating & Reading
+ * @for p5
+ * @requires core
+ * @requires constants
+ */
+```
+
+p5.js 遵循的约定是 `src/` 文件夹中的每个子文件夹将是一个 `@module`，而子文件夹中的每个文件将是该子文件夹的 `@module` 下的一个 `@submodule`。除非你正在向 p5.js 源代码添加新的子文件夹/文件，否则你不应直接编辑此参考注释块中的文件。
+
+
+### `@class` 标签
+
+使用 `@class` 标签和 `@constructor` 标签定义类构造函数。此块的格式类似于使用 `@method` 块定义函数的方式，类的名称将需要使用 `@class` 标签定义，而 `@constructor` 标签将指示类具有构造函数。参见下面的示例 `p5.Color` 类：
+
+```
+/**
+ * A class to describe a color. Each `p5.Color` object stores the color mode
+ * and level maxes that were active during its construction. These values are
+ * used to interpret the arguments passed to the object's constructor. They
+ * also determine output formatting such as when
+ *
saturation() is called.
+ *
+ * Color is stored internally as an array of ideal RGBA values in floating
+ * point form, normalized from 0 to 1. These values are used to calculate the
+ * closest screen colors, which are RGBA levels from 0 to 255. Screen colors
+ * are sent to the renderer.
+ *
+ * When different color representations are calculated, the results are cached
+ * for performance. These values are normalized, floating-point numbers.
+ *
+ *
color() is the recommended way to create an instance
+ * of this class.
+ *
+ * @class p5.Color
+ * @constructor
+ * @param {p5} [pInst] pointer to p5 instance.
+ *
+ * @param {Number[]|String} vals an array containing the color values
+ * for red, green, blue and alpha channel
+ * or CSS color.
+ */
+```
+
+## 生成和预览参考文献
+
+p5.js 存储库已经设置好，可以生成和预览参考文献，而不需要构建和运行 p5.js 网站。
+
+- 从源代码中的参考注释生成参考文献的主要命令是运行以下命令。
+
+```
+npm run docs
+```
+
+这将生成必要的预览文件和主 `docs/reference/data.json` 文件，这个文件（在缩小后）将用于在网站上呈现参考页面。
+
+- 为了持续修改完善参考文献，你可以运行以下命令。
+
+```
+npm run docs:dev
+```
+
+这将启动一个渲染参考文献的实时预览，每次你进行更改时都会更新（你需要在进行更改后刷新页面才能看到它们）。对于在浏览器中预览示例代码来说，这特别有用。
+
+- 主要的模板文件存储在 `docs/` 文件夹中，在大多数情况下，你不应直接更改此文件夹中的文件，除非是要在 `docs/yuidoc-p5-theme/assets` 文件夹中添加新的文件。
+
+
+## 下一步
+
+有关参考系统的详细信息，你可以查看[JSDoc](https://jsdoc.app/) 和 [YUIDoc](https://yui.github.io/yuidoc/) 的文档。
+
+有关参考资料相关 issue 的示例，请查看[#6519](https://github.com/processing/p5.js/issues/6519) 和 [#6045](https://github.com/processing/p5.js/issues/6045)。[贡献者指南](https://github.com/processing/p5.js/blob/main/contributor_docs/contributor_guidelines.md) 文档也是一个很好的起点。