JSONC

Übersetze kommentierte Kataloge mit Kontexthinweisen und erfahre, welche Kommentare in der übersetzten Ausgabe erhalten bleiben.

Mit JSONC bleiben eine Nachricht und ihre Erklärung zusammen. Der Dateihandler für jsonc liest den Kommentar vor einer Zeichenfolge als Übersetzungshinweis und übersetzt verschachtelte Zeichenfolgenwerte über dieselben Pfade wie JSON.

Pflege diese Kommentare im Quellkatalog. Die rekonstruierte Zieldatei verwendet zwei Leerzeichen zur Einrückung und endet mit einem Zeilenumbruch. Sie behält @orphan-Markierungen an denselben Einträgen wie in der Quelle bei und entfernt alle anderen Kommentare. Ist eine verarbeitende Anwendung auf weitere Metadaten angewiesen, müssen diese daher auf anderem Weg erhalten bleiben.

Kontext direkt beim zugehörigen Wert platzieren #

Dieser Katalog erklärt, zu welcher Aktion „Zurück“ auffordert:

jsonc
{
  /* @context Button that returns to the previous checkout step */
  "back": "Back",
  "product": "Acme",
}

Der Kommentar gilt für den nächsten Zeichenfolgenwert, nicht für alle untergeordneten Werte eines umschließenden Objekts. Steht dazwischen eine Zahl, ein boolescher Wert oder null, wird der vorgemerkte Hinweis verworfen. Platziere den Kommentar unmittelbar vor der Zeichenfolge, die er beschreibt, und schütze feste Bezeichner über die entsprechenden Einstellungen der gewählten Schnittstelle.

Mit @context dient der Rest der Zeile als Hinweis. Ohne diese Markierung wird der gesamte Kommentar zum Hinweis. So gelangt jeder nicht leere Kommentar vor einer Zeichenfolge zur Übersetzung. Stehen mehrere Kommentare vor einer Zeichenfolge, wird der letzte nicht leere Hinweis verwendet – auch wenn ein früherer Kommentar @context enthält. @orphan kennzeichnet Katalogmetadaten; die Zeichenfolge lässt sich trotzdem für die Dateiübersetzung auswählen.

Dateiübersetzung und React-Kataloge #

Bei der Extraktion von React-Katalogen entstehen flache JSONC-Kataloge, deren Einträge mit Metadaten versehen sind. Der zugehörige Katalogleser erkennt @context, @src und @orphan. Die Extraktion nutzt diese Felder, um Fundstellen im Quellcode aktuell zu halten und Nachrichten zu markieren, die nicht mehr gefunden werden. Dieser Workflow dient der Katalogverwaltung und ist von der Übersetzung eines beliebigen JSONC-Dokuments getrennt.

Nutze React-Kataloge und Typen, wenn du extrahierte Nachrichten pflegst. Lösche keine Metadaten aus dem Quellkatalog in der Annahme, dass die allgemeine Dateiausgabe sie wiederherstellt.

Dateiübersetzung konfigurieren #

Die CLI leitet jsonc aus .jsonc ab; die GitHub App akzeptiert den konfigurierten Dateityp. Wähle die Quell- und Zielpfade in der CLI-Konfiguration oder der GitHub-Konfiguration aus.

Die richtigen Werte beibehalten #

Für den inkrementellen Vergleich, gesperrte, beibehaltene und ignorierte Pfade sowie das Einfügen der Sprache gelten dieselben Unterscheidungen wie beim JSON-Dateihandler. Sperren kopiert Quelldaten; Beibehalten erhält Zieldaten; Ignorieren entfernt einen Pfad. Unter JSON erfährst du, welche Option Vorrang hat und welche Folgen ein eingeschränkter Geltungsbereich hat. Behandle diese Optionen nicht als austauschbare Ausschlüsse.

Kontrolliere Schlüssel und geschützte Werte in der rekonstruierten Datei und lade die Zieldatei anschließend über den Katalogleser der Anwendung. Halte bei React-Katalogen die Quellmetadaten für die Extraktion verfügbar: Die übersetzte Zieldatei behält @orphan bei, aber weder @context noch @src.

Der Übersetzungs-Workflow kontrolliert unterstützte Platzhalter- und ICU-Strukturen und erkennt dabei auch geänderte oder fehlende Argumente. Sieh dir gemeldete Warnungen oder Fehler an und rendere anschließend die akzeptierte Vorlage mit den Werten, die deine Anwendung bereitstellt. Führe ergänzend zu diesen Strukturkontrollen eine Prüfung auf inhaltliche Richtigkeit und Vollständigkeit durch.