Intlayer Konfigurationsdokumentation

Überblick

Intlayer-Konfigurationsdateien ermöglichen die Anpassung verschiedener Aspekte des Plugins, wie Internationalisierung, Middleware und Inhaltsverwaltung. Dieses Dokument bietet eine detaillierte Beschreibung jeder Eigenschaft in der Konfiguration.

Unterstützte Konfigurationsdateiformate

Intlayer akzeptiert JSON-, JS-, MJS- und TS-Konfigurationsdateiformate:

• intlayer.config.ts
• intlayer.config.js
• intlayer.config.json
• intlayer.config.cjs
• intlayer.config.mjs
• .intlayerrc

Beispiel für eine Konfigurationsdatei

import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  internationalization: {    locales: [Locales.ENGLISH], // unterstützte Sprachen  },  content: {    autoFill: "./{{fileName}}.content.json", // automatische Befüllung der Inhaltsdatei    contentDir: ["src", "../ui-library"], // Verzeichnisse mit Inhalten  },  middleware: {    noPrefix: false, // Middleware ohne Präfix aktivieren/deaktivieren  },  editor: {    applicationURL: "https://example.com", // URL der Anwendung im Editor  },  ai: {    apiKey: process.env.OPENAI_API_KEY, // API-Schlüssel für KI-Dienste    applicationContext: "This is a test application", // Kontext der Anwendung für KI  },  build: {    importMode: "dynamic", // Importmodus für den Build-Prozess  },};export default config;

Konfigurationsreferenz

Die folgenden Abschnitte beschreiben die verschiedenen Konfigurationseinstellungen, die für Intlayer verfügbar sind.

Internationalisierungs-Konfiguration

Definiert Einstellungen im Zusammenhang mit der Internationalisierung, einschließlich verfügbarer Sprachen und der Standardsprache für die Anwendung.

Eigenschaften

• locales:

  • Typ: string[]
  • Standard: ['en']
  • Beschreibung: Die Liste der unterstützten Sprachen in der Anwendung.
  • Beispiel: ['en', 'fr', 'es']
• requiredLocales:
  • Typ: string[]
  • Standard: []
  • Beschreibung: Die Liste der erforderlichen Sprachen in der Anwendung.
  • Beispiel: []
  • Hinweis: Wenn leer, sind alle Sprachen im strict-Modus erforderlich.
  • Hinweis: Stellen Sie sicher, dass die erforderlichen Sprachen auch im Feld locales definiert sind.

• strictMode:

  • Typ: string
  • Standard: inclusive
  • Beschreibung: Gewährleistet eine strenge Umsetzung internationalisierter Inhalte mit TypeScript.
  • Hinweis: Wenn auf "strict" gesetzt, verlangt die Übersetzungsfunktion t, dass jede deklarierte Sprache definiert ist. Wenn eine Sprache fehlt oder nicht in Ihrer Konfiguration deklariert ist, wird ein Fehler ausgelöst.
  • Hinweis: Wenn auf "inclusive" gesetzt, verlangt die Übersetzungsfunktion t, dass jede deklarierte Sprache definiert ist. Wenn eine Sprache fehlt, wird eine Warnung ausgegeben. Es wird jedoch akzeptiert, wenn eine Sprache nicht in Ihrer Konfiguration deklariert, aber vorhanden ist.
  • Hinweis: Wenn auf "loose" gesetzt, akzeptiert die Übersetzungsfunktion t jede vorhandene Locale.

• defaultLocale:

  • Typ: string
  • Standard: 'en'
  • Beschreibung: Die Standard-Locale, die als Fallback verwendet wird, wenn die angeforderte Locale nicht gefunden wird.
  • Beispiel: 'en'
  • Hinweis: Dies wird verwendet, um die Locale zu bestimmen, wenn keine in der URL, im Cookie oder im Header angegeben ist.

Editor-Konfiguration

Definiert Einstellungen im Zusammenhang mit dem integrierten Editor, einschließlich Server-Port und Aktivstatus.

Eigenschaften

• applicationURL:

  • Typ: string
  • Standard: http://localhost:3000
  • Beschreibung: Die URL der Anwendung. Wird verwendet, um den Ursprung des Editors aus Sicherheitsgründen einzuschränken.
  • Beispiel:
    • 'http://localhost:3000'
    • 'https://example.com'
    • process.env.INTLAYER_EDITOR_URL
  • Hinweis: Die URL der Anwendung. Wird verwendet, um die Herkunft des Editors aus Sicherheitsgründen einzuschränken. Wenn auf '*' gesetzt, ist der Editor von jeder Herkunft aus zugänglich.

• port:

  • Typ: number
  • Standard: 8000
  • Beschreibung: Der Port, der vom visuellen Editor-Server verwendet wird.

• editorURL:

  • Typ: string
  • Standard: 'http://localhost:8000'
  • Beschreibung: Die URL des Editor-Servers. Wird verwendet, um die Herkunft des Editors aus Sicherheitsgründen einzuschränken.
    • 'http://localhost:3000'
    • 'https://example.com'
    • process.env.INTLAYER_EDITOR_URL
  • Hinweis: Die URL des Editor-Servers, die von der Anwendung aus erreichbar sein soll. Wird verwendet, um die Ursprünge einzuschränken, die mit der Anwendung aus Sicherheitsgründen interagieren können. Wenn auf '*' gesetzt, ist der Editor von jedem Ursprung aus zugänglich. Sollte gesetzt werden, wenn der Port geändert wird oder wenn der Editor auf einer anderen Domain gehostet wird.

• cmsURL:

  • Typ: string
  • Standard: 'https://intlayer.org'
  • Beschreibung: Die URL des Intlayer CMS.
  • Beispiel: 'https://intlayer.org'
  • Hinweis: Die URL des Intlayer CMS.

• backendURL:

  • Typ: string
  • Standard: https://back.intlayer.org
  • Beschreibung: Die URL des Backend-Servers.
  • Beispiel: http://localhost:4000

• enabled:

  • Typ: boolean
  • Standard: true
  • Beschreibung: Gibt an, ob die Anwendung mit dem visuellen Editor interagiert.
  • Beispiel: process.env.NODE_ENV !== 'production'
  • Hinweis: Wenn true, kann der Editor mit der Anwendung interagieren. Wenn false, kann der Editor nicht mit der Anwendung interagieren. In jedem Fall kann der Editor nur durch den visuellen Editor aktiviert werden. Das Deaktivieren des Editors für bestimmte Umgebungen ist eine Möglichkeit, die Sicherheit zu erhöhen.

• clientId:

  • Typ: string | undefined
  • Standard: undefined
  • Beschreibung: clientId und clientSecret ermöglichen es den Intlayer-Paketen, sich mit dem Backend über die oAuth2-Authentifizierung zu authentifizieren. Ein Zugriffstoken wird verwendet, um den Benutzer zu authentifizieren, der mit dem Projekt verbunden ist. Um ein Zugriffstoken zu erhalten, gehen Sie zu https://intlayer.org/dashboard/project und erstellen Sie ein Konto.
  • Beispiel: true
  • Hinweis: Wichtig: Die clientId und clientSecret sollten geheim gehalten und nicht öffentlich geteilt werden. Bitte stellen Sie sicher, dass sie an einem sicheren Ort, wie z.B. Umgebungsvariablen, aufbewahrt werden.

• clientSecret:

  • Typ: string | undefined
  • Standard: undefined
  • Beschreibung: clientId und clientSecret ermöglichen es den Intlayer-Paketen, sich mit dem Backend über die oAuth2-Authentifizierung zu authentifizieren. Ein Zugriffstoken wird verwendet, um den Benutzer zu authentifizieren, der mit dem Projekt verbunden ist. Um ein Zugriffstoken zu erhalten, gehen Sie zu https://intlayer.org/dashboard/project und erstellen Sie ein Konto.
  • Beispiel: true
  • Hinweis: Wichtig: Die clientId und clientSecret sollten geheim gehalten und nicht öffentlich geteilt werden. Bitte stellen Sie sicher, dass sie an einem sicheren Ort aufbewahrt werden, z. B. in Umgebungsvariablen.

• dictionaryPriorityStrategy:

  • Typ: string
  • Standard: 'local_first'
  • Beschreibung: Die Strategie zur Priorisierung von Wörterbüchern, wenn sowohl lokale als auch entfernte Wörterbücher vorhanden sind. Wenn auf 'distant_first' gesetzt, priorisiert die Anwendung entfernte Wörterbücher gegenüber lokalen Wörterbüchern. Wenn auf 'local_first' gesetzt, priorisiert die Anwendung lokale Wörterbücher gegenüber entfernten Wörterbüchern.
  • Beispiel: 'distant_first'

• liveSync:

  • Typ: boolean
  • Standard: false
  • Beschreibung: Gibt an, ob der Anwendungsserver den Inhalt der Anwendung automatisch neu laden soll, wenn eine Änderung im CMS / Visual Editor / Backend erkannt wird.
  • Beispiel: true
  • Hinweis: Zum Beispiel, wenn ein neues Wörterbuch hinzugefügt oder aktualisiert wird, aktualisiert die Anwendung den anzuzeigenden Inhalt auf der Seite.
  • Hinweis: Live-Sync erfordert die Externalisierung des Inhalts der Anwendung auf einen anderen Server. Das bedeutet, dass dies die Leistung der Anwendung leicht beeinträchtigen kann. Um dies zu begrenzen, empfehlen wir, die Anwendung und den Live-Sync-Server auf derselben Maschine zu hosten. Außerdem kann die Kombination von Live-Sync und optimize eine beträchtliche Anzahl von Anfragen an den Live-Sync-Server stellen. Abhängig von Ihrer Infrastruktur empfehlen wir, beide Optionen und deren Kombination zu testen.

• liveSyncPort:

  • Typ: number
  • Standard: 4000
  • Beschreibung: Der Port des Live-Sync-Servers.
  • Beispiel: 4000
  • Hinweis: Der Port des Live-Sync-Servers.

• liveSyncURL:

  • Typ: string
  • Standard: 'http://localhost:{liveSyncPort}'
  • Beschreibung: Die URL des Live-Sync-Servers.
  • Beispiel: 'https://example.com'
  • Hinweis: Standardmäßig zeigt es auf localhost, kann aber auf jede beliebige URL geändert werden, falls ein entfernter Live-Sync-Server verwendet wird.

Middleware-Konfiguration

Einstellungen, die das Verhalten der Middleware steuern, einschließlich wie die Anwendung Cookies, Header und URL-Präfixe für die Verwaltung von Sprachversionen behandelt.

Eigenschaften

• headerName:

  • Typ: string
  • Standard: 'x-intlayer-locale'
  • Beschreibung: Der Name des HTTP-Headers, der zur Bestimmung der Sprache verwendet wird.
  • Beispiel: 'x-custom-locale'
  • Hinweis: Nützlich für die sprachliche Bestimmung über APIs.

• cookieName:

  • Typ: string
  • Standard: 'intlayer-locale'
  • Beschreibung: Der Name des Cookies, das zur Speicherung der Sprache verwendet wird.
  • Beispiel: 'custom-locale'
  • Hinweis: Wird verwendet, um die Locale über Sitzungen hinweg zu speichern.

• prefixDefault:

  • Typ: boolean
  • Standard: false
  • Beschreibung: Ob die Standard-Locale in der URL enthalten sein soll.
  • Beispiel: true
  • Hinweis:
    • Wenn true und defaultLocale = 'en': Pfad = /en/dashboard oder /fr/dashboard
    • Wenn false und defaultLocale = 'en': Pfad = /dashboard oder /fr/dashboard

• basePath:

  • Typ: string
  • Standard: ''
  • Beschreibung: Der Basis-Pfad für die Anwendungs-URLs.
  • Beispiel: '/my-app'
  • Hinweis:
    • Wenn die Anwendung unter https://example.com/my-app gehostet wird
    • Der Basis-Pfad ist '/my-app'
    • Die URL wird https://example.com/my-app/en sein
    • Wenn der Basis-Pfad nicht gesetzt ist, wird die URL https://example.com/en sein.

• serverSetCookie:

  • Typ: string
  • Standard: 'always'
  • Beschreibung: Regel zum Setzen des Locale-Cookies auf dem Server.
  • Optionen: 'always', 'never'
  • Beispiel: 'never'
  • Hinweis: Steuert, ob das Locale-Cookie bei jeder Anfrage oder nie gesetzt wird.

• noPrefix:

  • Typ: boolean
  • Standard: false
  • Beschreibung: Ob das Locale-Präfix in URLs weggelassen wird.
  • Beispiel: true
  • Hinweis:
    • Wenn true: Kein Präfix in der URL
    • Wenn false: Präfix in der URL
    • Beispiel mit basePath = '/my-app':
      • Wenn noPrefix = false: URL wird https://example.com/my-app/en sein
      • Wenn noPrefix = true: URL wird https://example.com sein

• detectLocaleOnPrefetchNoPrefix:

  • Typ: boolean
  • Standard: false
  • Beschreibung: Steuert, ob die Lokalisierungserkennung während Next.js Prefetch-Anfragen erfolgt.
  • Beispiel: true
  • Hinweis: Diese Einstellung beeinflusst, wie Next.js das Prefetching von Lokalisierungen handhabt:
    • Beispielszenario:
      • Die Browsersprache des Benutzers ist 'fr'
      • Aktuelle Seite ist /fr/about
      • Link prefetcht /about
    • Mit detectLocaleOnPrefetchNoPrefix: true:
      • Prefetch erkennt die 'fr'-Lokalisierung aus dem Browser
      • Prefetch wird zu /fr/about umgeleitet
    • Mit detectLocaleOnPrefetchNoPrefix: false (Standard):
      • Prefetch verwendet die Standard-Lokalisierung
      • Prefetch wird zu /en/about umgeleitet (angenommen 'en' ist Standard)
    • Wann true verwendet werden sollte:
      • Ihre Anwendung verwendet nicht lokalisierte interne Links (z. B. <a href="/about">)
      • Sie möchten ein konsistentes Verhalten bei der Lokalerkennung zwischen regulären und Prefetch-Anfragen
    • Wann false (Standard) verwenden:
      • Ihre Anwendung verwendet lokalisierte Links mit Präfix (z. B. <a href="/fr/about">)
      • Sie möchten die Prefetch-Leistung optimieren
      • Sie möchten potenzielle Redirect-Schleifen vermeiden

Inhaltskonfiguration

Einstellungen im Zusammenhang mit der Inhaltsverwaltung innerhalb der Anwendung, einschließlich Verzeichnisnamen, Dateierweiterungen und abgeleiteter Konfigurationen.

Eigenschaften

• autoFill:

  • Typ: boolean | string | { [key in Locales]?: string }
  • Standard: undefined
  • Beschreibung: Gibt an, wie der Inhalt automatisch mit KI ausgefüllt werden soll. Kann global in der Datei intlayer.config.ts deklariert werden.
  • Beispiel: true
  • Beispiel: './{{fileName}}.content.json'
  • Beispiel: { fr: './{{fileName}}.fr.content.json', es: './{{fileName}}.es.content.json' }
  • Hinweis: Die Auto-Fill-Konfiguration kann sein:
    • boolean: Auto-Fill für alle Sprachen aktivieren
    • string: Pfad zu einer einzelnen Datei oder Vorlage mit Variablen
    • object: Pro-Sprache Dateipfade

• watch:

  • Typ: boolean
  • Standard: process.env.NODE_ENV === 'development'
  • Beschreibung: Gibt an, ob Intlayer Änderungen an den Inhaltsdeklarationsdateien in der App überwachen soll, um die zugehörigen Wörterbücher neu zu erstellen.

• fileExtensions:

  • Typ: string[]
  • Standard: ['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.tsx', '.content.jsx']
  • Beschreibung: Dateierweiterungen, nach denen beim Erstellen von Wörterbüchern gesucht wird.
  • Beispiel: ['.data.ts', '.data.js', '.data.json']
  • Hinweis: Die Anpassung der Dateierweiterungen kann helfen, Konflikte zu vermeiden.

• baseDir:

  • Typ: string
  • Standard: process.cwd()
  • Beschreibung: Das Basisverzeichnis für das Projekt.
  • Beispiel: '/path/to/project'
  • Hinweis: Dies wird verwendet, um alle Intlayer-bezogenen Verzeichnisse aufzulösen.

• dictionaryOutput:

  • Typ: string[]
  • Standard: ['intlayer']
  • Beschreibung: Der Typ der Wörterbuchausgabe, z.B. 'intlayer' oder 'i18next'.

• contentDir:

  • Typ: string[]
  • Standard: ['.']
  • Beispiel: ['src', '../../ui-library', require.resolve("@my-package/content")]
  • Beschreibung: Der Verzeichnispfad, in dem Inhalte gespeichert sind.

• dictionariesDir:

  • Typ: string
  • Standard: '.intlayer/dictionaries'
  • Beschreibung: Der Verzeichnispfad zum Speichern von Zwischen- oder Ausgabedateien.

• moduleAugmentationDir:

  • Typ: string
  • Standard: '.intlayer/types'
  • Beschreibung: Verzeichnis für Module-Augmentation, um bessere IDE-Vorschläge und Typüberprüfung zu ermöglichen.
  • Beispiel: 'intlayer-types'
  • Hinweis: Stellen Sie sicher, dass dies in der tsconfig.json enthalten ist.

• unmergedDictionariesDir:

  • Typ: string
  • Standard: '.intlayer/unmerged_dictionary'
  • Beschreibung: Das Verzeichnis zum Speichern von nicht zusammengeführten Wörterbüchern.
  • Beispiel: 'translations'

• dictionariesDir:

  • Typ: string
  • Standard: '.intlayer/dictionary'
  • Beschreibung: Das Verzeichnis zur Speicherung von Lokalisierungswörterbüchern.
  • Beispiel: 'translations'

• i18nextResourcesDir:

  • Typ: string
  • Standard: 'i18next_dictionary'
  • Beschreibung: Das Verzeichnis zur Speicherung von i18n-Wörterbüchern.
  • Beispiel: 'translations'
  • Hinweis: Stellen Sie sicher, dass dieses Verzeichnis für den i18next-Ausgabetyp konfiguriert ist.

• typesDir:

  • Typ: string
  • Standard: 'types'
  • Beschreibung: Das Verzeichnis zur Speicherung von Wörterbuchtypen.
  • Beispiel: 'intlayer-types'

• mainDir:

  • Typ: string
  • Standard: 'main'
  • Beschreibung: Das Verzeichnis, in dem die Hauptanwendungsdateien gespeichert sind.
  • Beispiel: 'intlayer-main'

• excludedPath:

  • Typ: string[]
  • Standard: ['node_modules']
  • Beschreibung: Verzeichnisse, die von der Inhaltssuche ausgeschlossen sind.
  • Hinweis: Diese Einstellung wird derzeit noch nicht verwendet, ist aber für zukünftige Implementierungen geplant.

Logger-Konfiguration

Einstellungen, die den Logger steuern, einschließlich des zu verwendenden Präfixes.

Eigenschaften

• mode:

  • Typ: string
  • Standard: default
  • Beschreibung: Gibt den Modus des Loggers an.
  • Optionen: default, verbose, disabled
  • Beispiel: default
  • Hinweis: Der Modus des Loggers. Der verbose-Modus protokolliert mehr Informationen und kann für Debugging-Zwecke verwendet werden. Der deaktivierte Modus schaltet den Logger aus.

• prefix:

  • Typ: string
  • Standard: '[intlayer] '
  • Beschreibung: Das Präfix des Loggers.
  • Beispiel: '[my custom prefix] '
  • Hinweis: Das Präfix des Loggers.

KI-Konfiguration

Einstellungen, die die KI-Funktionen von Intlayer steuern, einschließlich des Anbieters, Modells und API-Schlüssels.

Diese Konfiguration ist optional, wenn Sie mit einem Zugriffsschlüssel im Intlayer Dashboard registriert sind. Intlayer verwaltet automatisch die effizienteste und kostengünstigste KI-Lösung für Ihre Bedürfnisse. Die Verwendung der Standardoptionen gewährleistet eine bessere langfristige Wartbarkeit, da Intlayer kontinuierlich aktualisiert wird, um die relevantesten Modelle zu verwenden.

Wenn Sie Ihren eigenen API-Schlüssel oder ein bestimmtes Modell verwenden möchten, können Sie Ihre eigene KI-Konfiguration definieren. Diese KI-Konfiguration wird global in Ihrer Intlayer-Umgebung verwendet. CLI-Befehle verwenden diese Einstellungen als Standardwerte für die Befehle (z. B. fill), ebenso wie das SDK, der Visual Editor und das CMS. Sie können diese Standardwerte für spezifische Anwendungsfälle mit Befehlsparametern überschreiben.

Intlayer unterstützt mehrere KI-Anbieter für erhöhte Flexibilität und Auswahlmöglichkeiten. Derzeit unterstützte Anbieter sind:

• OpenAI (Standard)
• Anthropic Claude
• Mistral AI
• DeepSeek
• Google Gemini
• Meta Llama

Eigenschaften

• provider:

  • Typ: string
  • Standard: 'openai'
  • Beschreibung: Der Anbieter, der für die KI-Funktionen von Intlayer verwendet wird.
  • Optionen: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini'
  • Beispiel: 'anthropic'
  • Hinweis: Verschiedene Anbieter können unterschiedliche API-Schlüssel erfordern und haben unterschiedliche Preismodelle.

• model:

  • Typ: string
  • Standard: Keine
  • Beschreibung: Das Modell, das für die KI-Funktionen von Intlayer verwendet wird.
  • Beispiel: 'gpt-4o-2024-11-20'
  • Hinweis: Das spezifische Modell variiert je nach Anbieter.

• temperature:

  • Typ: number
  • Standard: Keine
  • Beschreibung: Die Temperatur steuert die Zufälligkeit der Antworten der KI.
  • Beispiel: 0.1
  • Hinweis: Eine höhere Temperatur macht die KI kreativer und weniger vorhersehbar.

• apiKey:

  • Typ: string
  • Standard: Keine
  • Beschreibung: Ihr API-Schlüssel für den ausgewählten Anbieter.
  • Beispiel: process.env.OPENAI_API_KEY
  • Hinweis: Wichtig: API-Schlüssel sollten geheim gehalten und nicht öffentlich geteilt werden. Bitte stellen Sie sicher, dass sie an einem sicheren Ort aufbewahrt werden, wie z. B. in Umgebungsvariablen.

• applicationContext:

  • Typ: string
  • Standard: Keine
  • Beschreibung: Bietet dem KI-Modell zusätzlichen Kontext zu Ihrer Anwendung, um genauere und kontextuell passendere Übersetzungen zu erzeugen. Dies kann Informationen über die Domäne Ihrer App, die Zielgruppe, den Tonfall oder spezifische Terminologie umfassen.

Build-Konfiguration

Einstellungen, die steuern, wie Intlayer die Internationalisierung Ihrer Anwendung optimiert und baut.

Build-Optionen gelten für die Plugins @intlayer/babel und @intlayer/swc.

Im Entwicklungsmodus verwendet Intlayer statische Importe für Wörterbücher, um die Entwicklungserfahrung zu vereinfachen.

Wenn optimiert, ersetzt Intlayer Wörterbuchaufrufe, um das Chunking zu optimieren, sodass das endgültige Bundle nur die tatsächlich verwendeten Wörterbücher importiert.

Eigenschaften

• optimize:

  • Typ: boolean
  • Standard: process.env.NODE_ENV === 'production'
  • Beschreibung: Steuert, ob der Build optimiert werden soll.
  • Beispiel: true
  • Hinweis: Wenn aktiviert, ersetzt Intlayer alle Wörterbuchaufrufe, um das Chunking zu optimieren. So importiert das endgültige Bundle nur die verwendeten Wörterbücher. Alle Importe bleiben statisch, um asynchrone Verarbeitung beim Laden der Wörterbücher zu vermeiden.
  • Hinweis: Intlayer ersetzt alle Aufrufe von useIntlayer durch den im importMode-Parameter definierten Modus und getIntlayer durch getDictionary.
  • Hinweis: Diese Option basiert auf den Plugins @intlayer/babel und @intlayer/swc.
  • Hinweis: Stellen Sie sicher, dass alle Schlüssel statisch in den useIntlayer-Aufrufen deklariert sind, z.B. useIntlayer('navbar').
• importMode:
  • Typ: 'static' | 'dynamic' | 'live'
  • Standard: 'static'
  • Beschreibung: Steuert, wie Wörterbücher importiert werden.
  • Beispiel: 'dynamic'
  • Hinweis: Verfügbare Modi:
    • "static": Wörterbücher werden statisch importiert. Ersetzt useIntlayer durch useDictionary.
    • "dynamic": Wörterbücher werden dynamisch mit Suspense importiert. Ersetzt useIntlayer durch useDictionaryDynamic.
• "live": Wörterbücher werden dynamisch über die Live-Sync-API abgerufen. Ersetzt useIntlayer durch useDictionaryFetch.
• Hinweis: Dynamische Importe basieren auf Suspense und können die Rendering-Leistung leicht beeinträchtigen.
• Hinweis: Wenn deaktiviert, werden alle Sprachversionen auf einmal geladen, auch wenn sie nicht verwendet werden.
• Hinweis: Diese Option basiert auf den Plugins @intlayer/babel und @intlayer/swc.
• Hinweis: Stellen Sie sicher, dass alle Schlüssel statisch in den useIntlayer-Aufrufen deklariert sind, z.B. useIntlayer('navbar').

• Hinweis: Diese Option wird ignoriert, wenn optimize deaktiviert ist.

  • Hinweis: Wenn auf "live" gesetzt, werden nur die Wörterbücher, die entfernte Inhalte enthalten und als "live" markiert sind, im Live-Modus transformiert. Andere werden dynamisch im "dynamic"-Modus importiert, um die Anzahl der Abrufanfragen und die Ladeleistung zu optimieren.
  • Hinweis: Der Live-Modus verwendet die Live-Sync-API, um die Wörterbücher abzurufen. Wenn der API-Aufruf fehlschlägt, werden die Wörterbücher dynamisch im "dynamic"-Modus importiert.
  • Hinweis: Diese Option hat keine Auswirkungen auf die Funktionen getIntlayer, getDictionary, useDictionary, useDictionaryAsync und useDictionaryDynamic.

• traversePattern:

  • Typ: string[]
  • Standard: ['**/*.{js,ts,mjs,cjs,jsx,tsx,mjx,cjx}', '!**/node_modules/**']
  • Beschreibung: Muster, die definieren, welche Dateien während der Optimierung durchlaufen werden sollen.
    • Beispiel: ['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']
  • Hinweis: Verwenden Sie dies, um die Optimierung auf relevante Code-Dateien zu beschränken und die Build-Leistung zu verbessern.
  • Hinweis: Diese Option wird ignoriert, wenn optimize deaktiviert ist.
  • Hinweis: Verwenden Sie Glob-Muster.

Dokumentationshistorie