CLI — Documentos
translate-docs
Sinopsis: ai-i18n-tools translate-docs [options]
Traduce markdown, MDX, .astro, JSON de catálogo opcional de Docusaurus (docusaurusCatalogDir), _meta.ts/diccionario .ts opcional de Nextra y catálogo de temas opcional de VitePress para cada bloque docs.
Opciones clave: -l, -j, -b, --prompt-format, --force, --force-update, -p / -f, --dry-run
-j: número máximo de configuraciones regionales paralelas; -b: número máximo de llamadas a la API por lotes paralelas por archivo. --prompt-format: formato de conexión por lotes (xml | json-array | json-object).
Véase también: Comportamiento de la caché y banderas translate-docs, Formato de solicitud por lotes
write-heading-ids
Sinopsis: ai-i18n-tools write-heading-ids [options]
Requiere al menos un bloque docs[]. Recopila .md / .mdx bajo el contentPaths de cada bloque (respeta .translate-ignore). Inserta una línea de anclaje HTML <a id="slug"></a> inmediatamente antes de cada encabezado # ATX plano (omite los encabezados dentro de bloques de código cercados); cuando ya hay una línea de anclaje presente, actualiza el id si ya no coincide con el slug derivado del texto del encabezado actual.
Opciones clave: -p / --path, -f / --file, --slug-style, --dry-run
--slug-style: github (predeterminado; doctoc / anchor-markdown-header), bitbucket, gitlab, pymdown, azure-devops. Con pymdown, --pymdown-case, --pymdown-normalize, --pymdown-percent-encode / --no-pymdown-percent-encode opcionales.
Véase también: Enlaces de anclaje
check-markdown
Sinopsis: ai-i18n-tools check-markdown [options]
Escanea markdown/MDX bajo el contentPaths de cada bloque docs[] (mismo descubrimiento que translate-docs, respeta .translate-ignore): emparejamiento de delimitadores, código en línea no cerrado y STRONG_OUTSIDE_LINK cuando **/__ envuelven un enlace [text](url).
Imprime líneas relativePath:line: [ISSUE_CODE] message en stderr; código de salida 1 si hay algún problema. --json: informe JSON en stdout. Escribe markdown_source_issues en cacheDir a menos que --no-cache. -v añade hashes de origen a las líneas de stderr.
Opciones clave: -p / --path, -f / --file, --json, --no-cache
Véase también: Problemas de Markdown