CLI — 文件

translate-docs

簡介： ai-i18n-tools translate-docs [options]

翻譯 markdown、MDX、.astro、可選的 Docusaurus 目錄 JSON (docusaurusCatalogDir)、可選的 Nextra _meta.ts/字典 .ts，以及每個 docs 區塊的可選 VitePress 主題目錄。

主要選項： -l, -j, -b, --prompt-format, --force, --force-update, -p / -f, --dry-run

-j：最大並行語言環境；-b：每個檔案的最大並行批次 API 呼叫。--prompt-format：批次傳輸格式 (xml | json-array | json-object)。

另請參閱： 快取行為與 translate-docs 旗標, 批次提示格式

---

write-heading-ids

簡介： ai-i18n-tools write-heading-ids [options]

至少需要一個 docs[] 區塊。收集每個區塊的 contentPaths 下的 .md / .mdx（遵循 .translate-ignore）。在每個平面 ATX # 標題之前立即插入 HTML 錨點行 <a id="slug"></a>（跳過圍欄程式碼區塊內的標題）；當錨點行已存在時，如果它不再與從目前標題文字衍生的 slug 相符，則更新 id。

主要選項： -p / --path, -f / --file, --slug-style, --dry-run

--slug-style：github（預設；doctoc / anchor-markdown-header）、bitbucket、gitlab、pymdown、azure-devops。使用 pymdown，可選 --pymdown-case、--pymdown-normalize、--pymdown-percent-encode / --no-pymdown-percent-encode。

另請參閱： 錨點連結

---

check-markdown

簡介： ai-i18n-tools check-markdown [options]

掃描每個 docs[] 區塊的 contentPaths 下的 markdown/MDX（與 translate-docs 相同的探索方式，遵循 .translate-ignore）：分隔符號配對、未關閉的行內程式碼，以及當 **/__ 包裝 [text](url) 連結時的 STRONG_OUTSIDE_LINK。

將 relativePath:line: [ISSUE_CODE] message 行列印到 stderr；如果有任何問題，結束代碼為 1。--json：在 stdout 上輸出 JSON 報告。除非 --no-cache，否則將 markdown_source_issues 寫入 cacheDir。-v 將來源雜湊新增到 stderr 行。

主要選項： -p / --path, -f / --file, --json, --no-cache

另請參閱： Markdown 問題