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。