Neue Intlayer v6 – Was ist neu?

Willkommen bei Intlayer v6! Diese Version konzentriert sich auf Leistung, Entwicklererfahrung und Zuverlässigkeit. Nachfolgend finden Sie die Highlights, Migrationshinweise und kopierbare Beispiele.

Highlights

• Neuer Befehl: npx intlayer content test zum Erkennen fehlender Übersetzungen
• Neue globale autoFill-Option zur automatischen Generierung fehlender Übersetzungen
• Fill-Befehl überspringt standardmäßig vorhandene Übersetzungen: npx intlayer fill
• VS Code-Erweiterung: neue Intlayer-Aktivitätsleiste (Suche & Wörterbücher), Toolbar-/Kontextaktionen, automatische Anzeige, Fill-/Test-Befehle
• 10× schnellere Builds dank paralleler Verarbeitung von Promises
• Remote-Wörterbuch-Caching, um erneutes Abrufen beim App-Start zu vermeiden
• Verbesserte Protokollierung: log.mode: 'verbose' einstellen, um das Verhalten zu überprüfen
• Stärkere Validierung, um App-Abstürze bei Wörterbuchproblemen zu verhindern
• Live-Updates mit CMS durch build.importMode = 'live' und pnpm intlayer live
• Fehlerbehebungen: Vue.js-Integration, Lynx-Adapter, Visual Editor unter Windows

Neu: Fehlende Übersetzungen testen

Prüfen Sie schnell Ihr Projekt, um fehlende Schlüssel/Sprachen zu finden.

npx intlayer content test

Ausgabe:

pnpm intlayer content testFehlende Übersetzungen: - blog-data       - Japanisch (ja), Koreanisch (ko), Chinesisch (zh), Deutsch (de), Italienisch (it) - src/components/BlogPage/blogData.content.ts - demo-page       - Französisch (fr), Italienisch (it)                                         - src/components/DemoPage/demo.content.ts - locale-switcher - Italienisch (it), Portugiesisch (pt)                                       - src/components/LocaleSwitcher/localeSwitcher.content.tsSprachversionen: Englisch (en), Russisch (ru), Japanisch (ja), Französisch (fr), Koreanisch (ko), Chinesisch (zh), Spanisch (es), Deutsch (de), Arabisch (ar), Italienisch (it), Britisches Englisch (en-GB), Portugiesisch (pt), Hindi (hi)Erforderliche Sprachversionen: Englisch (en)Fehlende Sprachversionen: Japanisch (ja), Koreanisch (ko), Chinesisch (zh), Deutsch (de), Italienisch (it), Französisch (fr), Portugiesisch (pt)Fehlende erforderliche Sprachversionen: -Insgesamt fehlende Sprachversionen: 7Insgesamt fehlende erforderliche Sprachversionen: 0

Siehe weitere Optionen in der CLI-Dokumentation: CLI-Referenz → „Test fehlender Übersetzungen“. Ebenso der Testing-Leitfaden.

Neu: Globales autoFill zum automatischen Vervollständigen fehlender Übersetzungen

Sie können jetzt autoFill global aktivieren, sodass jedes Wörterbuch mit fehlenden Übersetzungen automatisch vervollständigt wird.

import { type IntlayerConfig, Locales } from "intlayer";const config: IntlayerConfig = {  internationalization: {    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],    defaultLocale: Locales.ENGLISH,    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],  },  content: {    // Fehlende Übersetzungen für alle Wörterbücher automatisch generieren    autoFill: "./{{fileName}}.content.ts",    //    // autoFill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",    //    // autoFill: true, // Fehlende Übersetzungen für alle Wörterbücher automatisch generieren, ähnlich wie "./{{fileName}}.content.json"    //    // autoFill: {    //   en: "./{{fileName}}.en.content.json",    //   fr: "./{{fileName}}.fr.content.json",    //   es: "./{{fileName}}.es.content.json",    // },  },};export default config;

Sie können pro Wörterbuch weiterhin mit dem Feld autoFill in Inhaltsdateien feinabstimmen. Die vollständige Referenz finden Sie in doc/autoFill und doc/dictionary/content_file.

Fill-Befehl: sicherere Standardeinstellungen

Der Fill-Befehl füllt jetzt standardmäßig nur fehlende Übersetzungen und überspringt vorhandene Inhalte.

npx intlayer fill

Betroffene Wörterbuchschlüssel zur Verarbeitung: access-key-creation-form-schema, doc-search-metadata, doc-search-page  - [access-key-creation-form-schema]      Wörterbuch hat keinen Dateipfad. Überspringen.  - [access-key-creation-form-schema]      Verarbeite Inhaltsdeklaration: src/components/Dashboard/ProjectForm/AccessKey/useAccessKeyCreationFormSchema.content.ts  - [access-key-creation-form-schema]      Keine Sprachen zum Füllen - Wörterbuch wird übersprungen  - [doc-search-metadata]                  Wörterbuch hat keinen Dateipfad. Überspringen.  - [doc-search-metadata]                  Verarbeite Inhaltsdeklaration: src/app/[locale]/(docs)/doc/search/metadata.content.ts  - [doc-search-metadata]                  Keine Sprachen zum Ausfüllen – Wörterbuch wird übersprungen  - [doc-search-page]                      Wörterbuch hat keinen Dateipfad. Überspringen.  - [doc-search-page]                      Verarbeite Inhaltsdeklaration: src/app/[locale]/(docs)/doc/search/page.content.ts  - [doc-search-page]                     [Russisch (ru)]                   Vorbereitung der Übersetzung für das Wörterbuch von Englisch (en) nach Russisch (ru)[intlayer]  Prettier-Formatierung auf src/app/[locale]/(docs)/doc/search/page.content.ts angewendet  - [doc-search-page]                      Inhaltsdeklaration geschrieben nach src/app/[locale]/(docs)/doc/search/page.content.ts

CI-Beispiele sind verfügbar in CI/CD.

Aktualisierte VS Code-Erweiterung

Die Erweiterung enthält jetzt einen eigenen Intlayer-Tab in der Aktivitätsleiste sowie mehrere Workflow-Verbesserungen:

• Intlayer-Aktivitätsleiste mit zwei Ansichten:
  • Such-Webview (intlayer.searchBar) für die Live-Suche in Wörterbüchern/Inhalten
  • Wörterbuchbaum (intlayer.dictionaries), der Umgebungen, Wörterbücher und beitragende Dateien auflistet
• Symbolleiste in der Wörterbuchansicht: Erstellen, Abrufen (Pull), Senden (Push), Füllen, Aktualisieren, Testen, Wörterbuchdatei erstellen

• Kontextmenüs: Abrufen (Pull)/Senden (Push) bei Wörterbüchern; Füllen bei Dateien

• Automatisches Hervorheben: Die aktuelle Editor-Datei wird im Wörterbuchbaum hervorgehoben, wenn zutreffend
• Neue Befehle im Befehlsmenü verfügbar: Wörterbücher füllen und Wörterbücher testen

Details finden Sie in der Offiziellen VS Code Erweiterung Dokumentation.

Leistung: 10× schneller

• Parallele Auflösung von lokalen und entfernten Wörterbüchern
• Entfernte Wörterbücher werden zwischengespeichert, um erneutes Abrufen beim App-Start zu vermeiden

npx intlayer build

Ausgabe:

[intlayer]  Vorbereitung von Intlayer (v6.0.1)[intlayer]  Wörterbücher:[intlayer]  ✓ Lokaler Inhalt: 163/163[intlayer]  ✓ Entferntes Inhalt: 100/100[intlayer]   - access-key-creation-form             [lokal: ✔ erstellt] [entfernt: ✔ importiert][intlayer]   - access-key-creation-form-schema      [lokal: ✔ erstellt] [entfernt: ✔ importiert][intlayer]   - access-key-form                      [lokal: ✔ erstellt] [entfernt: ✔ importiert][intlayer]   - ai-ab-testing-section                                 [entfernt: ✔ importiert][intlayer]   - application-not-running-view         [lokal: ✔ erstellt] [entfernt: ✔ importiert][intlayer]   - application-template-message         [lokal: ✔ erstellt] [entfernt: ✔ abgerufen][intlayer]   - aside-navigation                     [lokal: ✔ erstellt] [entfernt: ✔ importiert][intlayer]   - ask-reset-password                   [lokal: ✔ erstellt] [entfernt: ✔ importiert][intlayer]   - ask-reset-password-schema            [lokal: ✔ erstellt] [entfernt: ✔ importiert][intlayer]   - autocompletion-section               [lokal: ✔ erstellt] [entfernt: ✔ abgerufen][intlayer]   - available-techno-section             [lokal: ✔ erstellt] [entfernt: ✔ importiert][intlayer]   - blog-data                            [lokal: ✔ erstellt][intlayer]   - blog-metadata                        [lokal: ✔ erstellt][intlayer]   - blog-nav-list                        [lokal: ✔ erstellt] [entfernt: ✔ importiert][intlayer]   - blog-page                                             [entfernt: ✔ abgerufen][intlayer]   - blog-search-metadata                 [lokal: ✔ erstellt] [entfernt: ✔ importiert][intlayer]   - blog-search-page                     [lokal: ✔ erstellt] [entfernt: ✔ importiert]...[intlayer]  Inhalt geladen  (Gesamt: 8401ms - Lokal: 4050ms - Remote: 4222ms)

Verbesserungen beim Logging

Das Logging-System wurde verbessert, um detailliertere Informationen darüber bereitzustellen, was während der Build- und Laufzeit-Transformationen passiert.

Aktivieren Sie ausführliche Logs, um besser zu verstehen, was während der Build- und Laufzeit-Transformationen geschieht.

export default {  log: {    mode: "verbose", // Optionen: "default" | "verbose" | "disabled"  },};

Siehe Konfiguration für alle Logging-Optionen.

Stärkere Validierung

Die Verarbeitung von Wörterbüchern führt jetzt eine robustere Validierung durch. Wenn ein Wörterbuch nicht verarbeitet werden kann, verhindert Intlayer, dass Ihre Anwendung abstürzt, und zeigt umsetzbare Fehler an.

Live-Updates mit CMS (Produktion-sicher)

Das Protokollierungssystem wurde verbessert, um detailliertere Informationen darüber bereitzustellen, was während der Build- und Laufzeittransformationen passiert.

Aktivieren Sie ausführliche Protokolle, um besser zu verstehen, was während der Build- und Laufzeittransformationen passiert.

export default {  log: {    mode: "verbose", // Optionen: "default" | "verbose" | "disabled"  },};

Siehe Konfiguration für alle Protokollierungsoptionen.

Stärkere Validierung

Die Verarbeitung von Wörterbüchern führt jetzt eine robustere Validierung durch. Wenn ein Wörterbuch nicht verarbeitet werden kann, verhindert Intlayer, dass Ihre Anwendung abstürzt, und zeigt umsetzbare Fehler an.

Live-Updates mit CMS (Produktionssicher)

Liefern Sie Live-Inhaltsaktualisierungen (z. B. redaktionelle Updates) in der Produktion, ohne Ihre Anwendung neu zu bauen.

1. Aktivieren Sie den Live-Importmodus:

import { type IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  build: {    importMode: "live", // "static" | "dynamic" | "live"  },  editor: {    liveSync: true, // Live-Synchronisation serverseitig aktivieren  },};export default config;

2. Führen Sie Ihre App und den Live-Prozess parallel aus:

npx intlayer live --process 'vite preview'

Hinweise:

• Nur Wörterbücher, die für den Live-Modus gekennzeichnet sind, werden live abgerufen. Andere sind für Leistung optimiert.
• Fällt auf dynamischen Import zurück, wenn die Live-API nicht erreichbar ist.

Siehe CMS und Live-Sync und Konfiguration für vollständige Anleitungen.

Migrationshinweise

• Entfernt: dictionaryOutput (früher i18next oder next-intl). Dies wird in zukünftigen Versionen als anpassbare Adapter zurückkehren. Entfernen Sie das Feld aus Ihrer Konfiguration.
• Verwandte Entfernung: i18nextResourcesDir (siehe doc/configuration Changelog).
• Bevorzugen Sie die neue globale Option content.autoFill, um fehlende Übersetzungen im großen Maßstab zu generieren.
• Verwenden Sie npx intlayer content test, um PRs auf fehlende Übersetzungen zu prüfen.
• Für ausführliche Diagnosen setzen Sie log.mode = 'verbose'.

Fehlerbehebungen

• Stabilität der Vue.js-Integration
• Verbesserungen des Lynx-Adapters
• Visueller Editor unter Windows

Nützliche Links

• CLI-Referenz
• Auto‑fill
• Konfiguration
• Referenz für Inhaltsdateien
• Offizielle VS Code Erweiterung
• CMS und Live-Synchronisation