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, --check-cache, -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). Por defecto, 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). Los ID de encabezado existentes de cualquier forma (línea de anclaje HTML, sufijo clásico {#id}, comentario MDX {/* #id */}) se reemplazan con el estilo seleccionado; el slug siempre se deriva del texto del encabezado actual. Con --slug-style mdx-comment, escribe un sufijo de comentario MDX de Docusaurus en la línea del encabezado en su lugar (el mismo algoritmo de slug estilo GitHub) y elimina un anclaje HTML precedente si está presente. --remove elimina todas esas formas de ID de encabezado y no escribe nada en su lugar.
Después de actualizar los archivos de origen, el comando también recorre el markdown traducido existente de cada configuración regional (la misma asignación de ruta docsOutput que translate-docs). Copia los ID de encabezado en inglés en los encabezados ATX coincidentes en orden de documento (nunca crea un slug del título traducido) y mueve un {#id} / {/* #id */} a mitad de encabezado (o un <a id> HTML extraviado) de nuevo a la forma que Docusaurus / el estilo elegido espera. Los archivos traducidos que faltan se omiten. --remove también elimina los ID de encabezado de esos archivos traducidos, incluidos los tokens mal ubicados a mitad de línea.
Cuando los ID de encabezado de un archivo traducido se reubican o corrigen, el segmento traducido en caché correspondiente (indexado por el hash de origen en inglés) también se actualiza, siempre que el texto fuente en inglés y el contenido traducido anterior y nuevo tengan el mismo número de segmentos. Una discrepancia en el recuento hace que se omita dicho archivo y configuración regional. Posteriormente, un sync --force-update vuelve a ensamblar el archivo a partir de la fila de caché actualizada.
Opciones clave: -p / --path, -f / --file, --slug-style, --remove, --dry-run
--slug-style: github (predeterminado; doctoc / anchor-markdown-header), bitbucket, gitlab, pymdown, azure-devops, mdx-comment (sufijo Docusaurus {/* #… */}). Con pymdown, opcional --pymdown-case, --pymdown-normalize, --pymdown-percent-encode / --no-pymdown-percent-encode. --remove no se puede combinar con --pymdown-*.
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