CLI – Dokumente
translate-docs
Synopsis: ai-i18n-tools translate-docs [options]
Übersetzt Markdown, MDX, .astro, optionalen Docusaurus-Katalog-JSON (docusaurusCatalogDir), optionales Nextra _meta.ts/Wörterbuch .ts und optionalen VitePress-Themenkatalog für jeden docs-Block.
Wichtige Optionen: -l, -j, -b, --prompt-format, --force, --force-update, --check-cache, --recheck-glossary-warnings, -p / -f, --dry-run
-j: maximale parallele Lokalisierungen; -b: maximale parallele Batch-API-Aufrufe pro Datei. --prompt-format: Batch-Wire-Format (xml | json-array | json-object).
Siehe auch: Cache-Verhalten und translate-docs-Flags, Batch-Prompt-Format
write-heading-ids
Synopsis: ai-i18n-tools write-heading-ids [options]
Erfordert mindestens einen docs[]-Block. Sammelt .md / .mdx unter dem contentPaths jedes Blocks (berücksichtigt .translate-ignore). Standardmäßig wird eine HTML-Ankerzeile <a id="slug"></a> unmittelbar vor jeder flachen ATX-#-Überschrift eingefügt (Überschriften innerhalb von Codeblöcken werden übersprungen). Bestehende Überschriften-IDs jeglicher Form (HTML-Ankerzeile, klassisches {#id}-Suffix, MDX-{/* #id */}-Kommentar) werden durch den ausgewählten Stil ersetzt; der Slug wird immer aus dem aktuellen Überschriftentext abgeleitet. Wenn mehrere HTML-Anker über einer Überschrift gestapelt sind, wird nur der Anker für den aktuellen Überschriftentext beibehalten, und Markdown-Links im Repository, die auf eine entfernte ID zeigten, werden auf die verbleibende ID aktualisiert. Ein <a id>, der sich nicht direkt über einer Überschrift befindet, bleibt erhalten. Mit --slug-style mdx-comment wird stattdessen ein Docusaurus MDX-Kommentar-Suffix in die Überschriftenzeile geschrieben (gleicher GitHub-Stil-Slug-Algorithmus) und der vorhergehende HTML-Ankerblock, falls vorhanden, entfernt. --remove entfernt alle diese Überschriften-ID-Formen und schreibt nichts an ihre Stelle.
Nach dem Aktualisieren von Quelldateien durchläuft der Befehl auch den vorhandenen übersetzten Markdown-Code jedes Gebietsschemas (gleiche docsOutput Pfadzuordnung wie translate-docs). Er kopiert die Überschriften-IDs des Quell-Gebietsschemas auf die übereinstimmenden ATX-Überschriften in Dokumentreihenfolge — er erzeugt niemals einen Slug aus dem übersetzten Titel — und verschiebt eine {#id} / {/* #id */} (oder verirrte HTML <a id>) zurück in das Format, das Docusaurus / der gewählte Stil erwartet. Die Quellsprache ist sourceLocale und kann jede beliebige Sprache sein. Fehlende übersetzte Dateien werden übersprungen. --remove entfernt auch Überschriften-IDs aus diesen übersetzten Dateien, einschließlich falsch platzierter Token in der Mitte der Zeile.
Wenn die Überschriften-IDs einer übersetzten Datei neu positioniert oder repariert werden, wird auch das entsprechende zwischengespeicherte übersetzte Segment (das durch den Quellsegment-Hash identifiziert wird) aktualisiert, wenn der Quellinhalt und der alte sowie neue übersetzte Inhalt die gleiche Anzahl von Segmenten aufweisen. Eine Abweichung in der Anzahl überspringt diese Datei und dieses Gebietsschema. Ein späteres sync --force-update setzt die Datei dann wieder aus der aktualisierten Cache-Zeile zusammen.
Wichtige Optionen: -p / --path, -f / --file, --slug-style, --remove, --dry-run
--slug-style: github (Standard; doctoc / anchor-markdown-header), bitbucket, gitlab, pymdown, azure-devops, mdx-comment (Docusaurus {/* #… */}-Suffix). Mit pymdown, optional --pymdown-case, --pymdown-normalize, --pymdown-percent-encode / --no-pymdown-percent-encode. --remove kann nicht mit --pymdown-* kombiniert werden.
Siehe auch: Anker-Links
check-markdown
Synopsis: ai-i18n-tools check-markdown [options]
Scannt Markdown/MDX unter dem docs[] jedes Blocks contentPaths (gleiche Erkennung wie translate-docs, berücksichtigt .translate-ignore): Begrenzerpaare, nicht geschlossener Inline-Code und STRONG_OUTSIDE_LINK, wenn **/__ einen [text](url)-Link umschließen.
Gibt relativePath:line: [ISSUE_CODE] message Zeilen in stderr aus; beendet sich mit dem Code 1, wenn ein Problem gefunden wird. --json: JSON-Bericht auf stdout. Schreibt markdown_source_issues in cacheDir, es sei denn --no-cache. -v fügt Quell-Hashes zu stderr-Zeilen hinzu.
Schlüsseloptionen: -p / --path, -f / --file, --json, --no-cache
Siehe auch: Markdown-Probleme