Skip to content

添加新代码示例 ​

代码示例贡献指南 ​

  • 提交内容必须使用英文撰写。
  • 尽可能详细地为您的示例编写文档。
  • 确保您的代码可正常运行并已通过充分测试。

我们保留以下权利: ​

  • 在提交后对您的内容进行修改。
  • 在必要时删除您的提交。

创建新的代码示例 ​

1. Fork 本仓库 ​

2. Clone 您的 Fork 并进入项目目录 (cd) ​

3. 安装 VitePress ​

您可以在官方文档中查看 VitePress 的前置条件。

sh
npm add -D vitepress@next
sh
pnpm add -D vitepress@next
sh
yarn add -D vitepress@next vue
sh
bun add -D vitepress@next

4. 添加您的代码示例 ​

4.1 创建示例文件 ​

  1. 在 /docs/examples 中创建一个以编程语言命名的新文件。
  2. 文件名必须以 .md 结尾。
  3. 至少包含两种不同的 API 调用实现方式。

4.2 将示例添加到侧边栏 ​

  1. 打开 /docs/.vitepress/config.mts。
  2. 在侧边栏中找到 "Code Examples" 部分。
  3. 将您的新文件添加到列表中。
  4. 按编程语言字母顺序保持列表排序。

5. 启动开发服务器 ​

在创建 Pull Request 之前,请在本地验证您的更改未造成任何破坏。

sh
npm run dev
sh
pnpm run dev
sh
yarn dev
sh
bun run dev

6. 创建 Pull Request ​

向原始仓库提交 Pull Request。