Setting Up Your Environment Chinese Translation#1433
Conversation
| category: introduction | ||
| categoryIndex: 0 | ||
| featuredImage: ../images/featured/SetupA.jpg | ||
| featuredImageAlt: 一个在 p5.js 编辑器中随鼠标指针移动而在画布上绘制圆圈的交互式草图。 |
There was a problem hiding this comment.
语序稍拗口。"随鼠标指针移动而在画布上绘制圆圈" 建议改为 "随着鼠标指针移动在画布上绘制圆圈",更符合技术文档表达习惯。
| import EditableSketch from "../../../components/EditableSketch/index.astro"; | ||
| import Callout from "../../../components/Callout/index.astro"; | ||
|
|
||
|  |
There was a problem hiding this comment.
多个图片的 alt 文本仍为英文,建议统一翻译为中文(如本条可改为 "p5.js 和 Visual Studio Code 的 Logo"),以保持一致性和无障碍体验。
| 2. 一台台式电脑、笔记本电脑或Chromebook。 | ||
|
|
||
|
|
||
| ## 步骤 0:选择编码环境类型 |
There was a problem hiding this comment.
"编码环境" 在中文技术语境里不常用,建议改为 "开发环境" 或 "编程环境"。
|
|
||
|  | ||
|
|
||
| - 根据提示输入您的 Google 账号邮箱和密码 |
There was a problem hiding this comment.
漏译了原文中的 (if necessary),建议补充为:"按提示输入 Google 账号的邮箱和密码(如需要)"。
|
|
||
|  | ||
|
|
||
| - 根据提示输入您的 Github 账号邮箱和密码 |
There was a problem hiding this comment.
原文是 username and password,此处误译成了 "邮箱和密码",建议改为 "用户名和密码"。另外 "Github" 建议统一为 "GitHub"。
|
|
||
| 电脑屏幕是由被称为*像素*的微小光点组成的,这些光点是构成任何图像的最小单元。在预览窗口中创建画布的代码行是 [`createCanvas(400, 400)`](/reference/p5/createCanvas)。 没有这行代码,就没有可以绘画的画布!数字 400, 400 对应画布的宽度和高度(单位为像素)。这些数字也被称为[`createCanvas()`](/reference/p5/createCanvas)函数的*参数*。 | ||
|
|
||
| 放置在函数括号内的任何值都称为 *参数*: [`createCanvas()`](/reference/p5/createCanvas) 出现在 [`setup()`](/reference/p5/setup) 函数内部,用于创建一个可供绘制的 HTML 画布元素。 |
There was a problem hiding this comment.
漏译了原文 "any value used to customize functions" 这一整句,建议在冒号后补充:"用于自定义函数行为的任何值。"
| - 在 [`background()`](/reference/p5/background) 函数下方添加以下代码: | ||
|
|
||
| ```js | ||
| //在中心绘制一个宽度为 100 的圆 |
There was a problem hiding this comment.
- 后文解释此参数为 diameter(直径),"宽度" 不够准确,建议改为 "直径"。
- // 后建议统一加空格,与 VS Code 部分的注释格式保持一致。
|
|
||
| p5.js 拥有非常丰富的函数,可用于在画布中同时融入静态和交互式元素。 | ||
|
|
||
| - 将原本的背景和圆形命令替换为以下文本: |
There was a problem hiding this comment.
"原本" 偏口语;"文本" 不如 "代码" 准确;建议保留函数英文名,便于读者对照代码。可改为:"将原来的 background 和 circle 命令替换为以下代码:"
| 访问 [p5.js 参考文档](/reference/) 以了解更多 p5.js 函数,例如 [2D 基础形状](/reference/#Shape/)。 | ||
|
|
||
|
|
||
| ### 程序出错 |
There was a problem hiding this comment.
- 小标题 "程序出错" 建议简化为 "错误" 或 "程序错误",更简洁。
- 正文中 "程序漏洞" 在中文技术语境中通常指安全漏洞(security vulnerability),建议用 "bug" 或 "程序错误"。
- "规则被破坏" 语气过重,描述语法规则用 "被违反" 或 "被打破" 更自然。
| - 使用[这些资源](https://code.visualstudio.com/docs/getstarted/introvideos)探索 VS Code 的各项功能和多种配置选项。 | ||
|
|
||
|
|
||
| ### 步骤 2:安装 p5.js 库插件 |
There was a problem hiding this comment.
VS Code 官方中文界面将 extension 译为 "扩展","插件" 对应的是 plugin。建议改为 "安装 p5.js 库扩展"。
| 访问 [p5.js 参考文档](/reference/) 以了解更多 p5.js 函数,例如其他可以绘制的形状。 | ||
|
|
||
|
|
||
| ### 程序出错 |
There was a problem hiding this comment.
同 Web Editor 部分:1. 小标题建议简化为 "错误";2. "程序漏洞" 建议改为 "bug";3. "规则被违反" 比 "被破坏" 更自然。
There was a problem hiding this comment.
Hi @luciawang0901, thank you so much for this contribution! The Simplified Chinese translation of the "Setting Up Your Environment" tutorial is a great addition to the project. I've left a few inline review comments with some minor suggestions. Overall the quality is solid, and most of the notes are small wording or consistency improvements.
A couple of quick notes on process:
- If this PR is meant to close an existing issue (e.g., #1397), feel free to add
Resolves #1397to the PR description so it will be automatically closed when this is merged. - For future PRs, it's best practice to create a new branch in your fork instead of working directly on main — this helps keep things tidy and makes it easier to sync with upstream.
- Once a maintainer approves the workflow, please take a look at the lint and test results to see if any additional fixes are needed.
Let me know once you've had a chance to review the comments. Thanks again for your hard work!
Hi @lirenjie95, I have updated the previous PR and it now resolves processing#1397. Thank you so much for all your detailed suggestions and thoughtful review. I really appreciate your time and guidance! Please take another look when you have a chance. Thanks again!
|
Hi @ksen0, this translation PR is ready to be merged. Can you help with that? Thanks! |
|
Thanks both @luciawang0901 @lirenjie95 ! In many cases I can easily cherry-pick to 2.0 version but in this case there's an updated VS code extension (and an additional author) in the 2.0 equivalent tutorial: https://beta.p5js.org/tutorials/setting-up-your-environment/ if one of you wants to take on copying the Chinese translation to |
|
Hi @ksen0, I'd be more than happy to take on copying the Chinese translation to the 2.0 branch and updating it to include the new changes! |
|
Thanks so much @luciawang0901 , your work is very much appreciated! Whenever you work on it, please do link to this thread in the PR for context, so other stewards know why the PR is there even if there's no issue. |
Hi, I've translated setting-up-your-environment.mdx into Simplified Chinese. I'd really appreciate it if you could take a look and let me know if anything needs to be adjusted. Thanks so much for your time and help! @lirenjie95
Resolve #1397