添加新代码示例
代码示例贡献指南
- 提交内容必须使用英文撰写。
- 尽可能详细地为您的示例编写文档。
- 确保您的代码可正常运行并已通过充分测试。
我们保留以下权利:
- 在提交后对您的内容进行修改。
- 在必要时删除您的提交。
创建新的代码示例
1. Fork 本仓库
2. Clone 您的 Fork 并进入项目目录 (cd)
3. 安装 VitePress
您可以在官方文档中查看 VitePress 的前置条件。
sh
npm add -D vitepress@nextsh
pnpm add -D vitepress@nextsh
yarn add -D vitepress@next vuesh
bun add -D vitepress@next4. 添加您的代码示例
4.1 创建示例文件
- 在
/docs/examples中创建一个以编程语言命名的新文件。 - 文件名必须以
.md结尾。 - 至少包含两种不同的 API 调用实现方式。
4.2 将示例添加到侧边栏
- 打开
/docs/.vitepress/config.mts。 - 在侧边栏中找到 "Code Examples" 部分。
- 将您的新文件添加到列表中。
- 按编程语言字母顺序保持列表排序。
5. 启动开发服务器
在创建 Pull Request 之前,请在本地验证您的更改未造成任何破坏。
sh
npm run devsh
pnpm run devsh
yarn devsh
bun run dev6. 创建 Pull Request
向原始仓库提交 Pull Request。