🤝 为文档做出贡献
你好 Dyno!你好 Markdown!
本文档基于 Docusaurus 平台制作,并使用 Markdown 编写!请随时在 GitHub 上提出修改建议和编辑页面,这些帮助对我们至关重要,我们衷心感谢每一位参与文档编写的人!
提出修改建议
你可以直接在 GitHub 上提出修改建议,只需点击每个页面左下角的 编辑此页面 按钮,提出你的建议并为此开启一个拉取请求即可!一旦被接受,你的建议将立即应用到文档的 bleeding-edge 版本中!
本地运行文档
要在打开拉取请求之前预览你的更改,请克隆 docs 仓库 及其子模块(API 是一个子模块),然后使用 Node.js 和 Yarn 运行它:
Terminal
git clone --recurse-submodules https://github.com/nanos-world/docs.git
cd docs
yarn install
yarn start
文档将在 http://localhost:3000 打开,并在你编辑文件时重新加载。
在哪编辑
docs/是文档的 bleeding-edge 版本,与最新的游戏更新相匹配。大部分更改应该在这里进行。versioned_docs/version-latest/是稳定版。仅用于修复当前稳定版游戏版本中也存在的问题。blog/包含新闻文章。src/api/是一个包含 API JSON 文件的子模块(见下文)。
写作提示
- 每个标题都以明确的锚点结尾,例如
## My Heading {/* #my-heading */},这样链接在翻译后的页面中仍然有效。运行yarn write-heading-ids来生成它们。 - 使用文件路径链接到其他页面,例如
[包指南](/core-concepts/packages/packages-guide.mdx)。 - 使用内置组件来引用 API,例如
<Classes.Character />,<StaticClasses.Server />,<MethodReference type="Class" class_name="Actor" method_name="SetLocation" />和<EventReference type="Class" class_name="Character" event="Death" />。 - 在 Lua 代码块的标题中添加服务器位置信息(例如
```lua title="Server/Index.lua"),这有助于读者了解代码的运行位置。
API 参考
我们的文档非常智能!脚本参考部分是基于我们在 GitHub 上的 JSON API 仓库自动生成的。我们已将所有的类、方法和事件定义为 JSON 格式,它可以被解析为任何格式!
因此,如果你想对在那里发现的任何描述或拼写错误提出修改建议,请参考我们 API 仓库的对应文件夹:Classes、StaticClasses、Structs、UtilityClasses、StandardLibraries 或 Enums!
翻译页面
默认情况下,GitHub 上的所有页面均为英文,所有翻译均由 Crowdin 提供。你可以访问 nanos world 官方文档 Crowdin 页面,帮助我们完成所有可用语言的翻译!你也可以申请支持更多语言!如果你想协助翻译一种新的语言,请联系我们!