Warum sollten Sie Intlayer in Betracht ziehen?

Was ist Intlayer?

Intlayer ist eine Internationalisierungsbibliothek, die speziell für JavaScript-Entwickler entwickelt wurde. Sie ermöglicht es, Ihre Inhalte überall in Ihrem Code zu deklarieren. Sie wandelt Deklarationen von mehrsprachigen Inhalten in strukturierte Wörterbücher um, die sich leicht in Ihren Code integrieren lassen. Durch die Verwendung von TypeScript macht Intlayer Ihre Entwicklung robuster und effizienter.

Warum wurde Intlayer erstellt?

Intlayer wurde entwickelt, um ein häufiges Problem zu lösen, das alle gängigen i18n-Bibliotheken wie next-intl, react-i18next, react-intl, next-i18next, react-intl und vue-i18n betrifft.

Alle diese Lösungen verfolgen einen zentralisierten Ansatz zur Auflistung und Verwaltung Ihrer Inhalte. Zum Beispiel:

.├── locales│   ├── en.json│   ├── es.json│   └── fr.json├── i18n.ts└── src    └── components        └── MyComponent            └── index.tsx

Oder hier unter Verwendung von Namespaces:

.├── locales│   ├── en│   │  ├── footer.json│   │  └── navbar.json│   ├── fr│   │  ├── footer.json│   │  └── navbar.json│   └── es│      ├── footer.json│      └── navbar.json├── i18n.ts└── src    └── components        └── MyComponent            └── index.tsx

Diese Art von Architektur verlangsamt den Entwicklungsprozess und macht die Codebasis aus mehreren Gründen komplexer in der Wartung:

1. Für jede neu erstellte Komponente sollten Sie:

   • Die neue Ressource/den neuen Namespace im Ordner locales erstellen
   • Daran denken, den neuen Namespace in Ihre Seite zu importieren
   • Ihren Inhalt übersetzen (oft manuell durch Kopieren/Einfügen von KI-Anbietern)

2. Für jede Änderung an Ihren Komponenten sollten Sie:

   • Die zugehörige Ressource/den zugehörigen Namespace suchen (weit entfernt von der Komponente)
   • Ihren Inhalt übersetzen
   • Sicherstellen, dass Ihr Inhalt für jede Locale auf dem neuesten Stand ist
   • Überprüfen, ob Ihr Namespace keine ungenutzten Schlüssel/Werte enthält
   • Sicherstellen, dass die Struktur Ihrer JSON-Dateien für alle Locales identisch ist

Bei professionellen Projekten, die diese Lösungen verwenden, werden häufig Lokalisierungsplattformen eingesetzt, um die Übersetzung Ihrer Inhalte zu verwalten. Dies kann jedoch bei großen Projekten schnell kostspielig werden.

Um dieses Problem zu lösen, verfolgt Intlayer einen Ansatz, bei dem Ihre Inhalte pro Komponente definiert werden und nah an Ihrer Komponente bleiben, so wie wir es oft mit CSS (styled-components), Typen, Dokumentation (storybook) oder Unit-Tests (jest) machen.

.└── components    └── MyComponent        ├── index.content.ts        ├── index.test.tsx        ├── index.stories.tsx        └── index.tsx

import { t, type Dictionary } from "intlayer";

const componentExampleContent = {
  key: "component-example",
  content: {
    myTranslatedContent: t({
      en: "Hello World",
      es: "Hola Mundo",
      fr: "Bonjour le monde",
    }),
  },
} satisfies Dictionary;

export default componentExampleContent;

import { useIntlayer } from "react-intlayer";

export const ComponentExample = () => {
  const { myTranslatedContent } = useIntlayer("component-example");

  return <span>{myTranslatedContent}</span>;
};

Dieser Ansatz ermöglicht es Ihnen:

1. Die Entwicklungsgeschwindigkeit zu erhöhen

   • .content.{{ts|mjs|cjs|json}} Dateien können mit einer VSCode-Erweiterung erstellt werden
   • KI-Tools zur Autovervollständigung in Ihrer IDE (wie GitHub Copilot) können Ihnen helfen, Ihre Inhalte zu deklarieren, was das Kopieren/Einfügen reduziert

2. Ihre Codebasis zu bereinigen

   • Die Komplexität zu reduzieren
   • Die Wartbarkeit zu erhöhen

3. Ihre Komponenten und die zugehörigen Inhalte einfacher zu duplizieren (Beispiel: Login/Register-Komponenten usw.)

   • Indem das Risiko verringert wird, die Inhalte anderer Komponenten zu beeinträchtigen
   • Indem Sie Ihre Inhalte ohne externe Abhängigkeiten von einer Anwendung in eine andere kopieren/einfügen

4. Vermeiden Sie es, Ihre Codebasis mit ungenutzten Schlüsseln/Werten für nicht genutzte Komponenten zu belasten

   • Wenn Sie eine Komponente nicht verwenden, importiert Intlayer die zugehörigen Inhalte nicht
   • Wenn Sie eine Komponente löschen, werden Sie sich leichter daran erinnern, die zugehörigen Inhalte zu entfernen, da sie sich im selben Ordner befinden

5. Reduzieren Sie die kognitiven Kosten für KI-Agenten bei der Deklaration Ihrer mehrsprachigen Inhalte

   • Der KI-Agent muss nicht Ihre gesamte Codebasis scannen, um zu wissen, wo er Ihre Inhalte implementieren muss
   • Übersetzungen können einfach durch KI-Tools zur Autovervollständigung in Ihrer IDE (wie GitHub Copilot) erstellt werden

6. Optimieren Sie die Ladeleistung

   • Wenn eine Komponente per Lazy-Loading geladen wird, werden die zugehörigen Inhalte gleichzeitig geladen

Zusätzliche Funktionen von Intlayer

Alle Tabellendaten anzeigen

Alle Tabellendaten anzeigen

Tabelle in einem Modal öffnen, um alle Daten übersichtlich anzuzeigen

Funktion	Beschreibung
	Framework-übergreifende Unterstützung Intlayer ist mit allen gängigen Frameworks und Bibliotheken kompatibel, einschließlich Next.js, React, Vite, Vue.js, Nuxt, Preact, Express und mehr.
	JavaScript-gestütztes Inhaltsmanagement Nutzen Sie die Flexibilität von JavaScript, um Ihre Inhalte effizient zu definieren und zu verwalten. - Inhaltsdeklaration
	Compiler Der Intlayer-Compiler extrahiert automatisch den Inhalt aus den Komponenten und generiert die Wörterbuchdateien. - Compiler
	Inhaltsdeklarationsdatei pro Locale Beschleunigen Sie Ihre Entwicklung, indem Sie Ihre Inhalte einmal deklarieren, bevor sie automatisch generiert werden. - Inhaltsdeklarationsdatei pro Locale
	Typsichere Umgebung Nutzen Sie TypeScript, um sicherzustellen, dass Ihre Inhaltsdefinitionen und Ihr Code fehlerfrei sind, und profitieren Sie gleichzeitig von der IDE-Autovervollständigung. - TypeScript-Konfiguration
	Vereinfachtes Setup Starten Sie schnell mit minimaler Konfiguration. Passen Sie Einstellungen für Internationalisierung, Routing, KI, Build und Inhaltsverwaltung mühelos an. - Erkunden Sie die Next.js-Integration
	Vereinfachter Inhaltsabruf Sie müssen Ihre t-Funktion nicht für jedes Inhaltselement aufrufen. Rufen Sie alle Ihre Inhalte direkt mit einem einzigen Hook ab. - React-Integration
	Konsistente Implementierung von Server-Komponenten Perfekt geeignet für Next.js-Server-Komponenten. Verwenden Sie dieselbe Implementierung sowohl für Client- als auch für Server-Komponenten; es ist nicht erforderlich, Ihre t-Funktion an jede Server-Komponente weiterzugeben. - Server-Komponenten
	Organisierte Codebasis Halten Sie Ihre Codebasis organisierter: 1 Komponente = 1 Wörterbuch im selben Ordner. Übersetzungen in der Nähe ihrer jeweiligen Komponenten verbessern die Wartbarkeit und Klarheit. - Wie Intlayer funktioniert
	Erweitertes Routing Volle Unterstützung für App-Routing, das sich nahtlos an komplexe Anwendungsstrukturen anpasst, für Next.js, React, Vite, Vue.js usw. - Erkunden Sie die Next.js-Integration
	Markdown-Unterstützung Importieren und interpretieren Sie Locale-Dateien und Remote-Markdown für mehrsprachige Inhalte wie Datenschutzrichtlinien, Dokumentationen usw. Interpretieren Sie Markdown-Metadaten und machen Sie sie in Ihrem Code zugänglich. - Inhaltsdateien
	Kostenloser visueller Editor & CMS Ein kostenloser visueller Editor und ein CMS stehen für Content-Autoren zur Verfügung, wodurch eine Lokalisierungsplattform überflüssig wird. Halten Sie Ihre Inhalte mit Git synchron oder externalisieren Sie sie ganz oder teilweise mit dem CMS. - Intlayer Editor - Intlayer CMS
	Tree-shakable Inhalt Tree-shakable Inhalt, der die Größe des endgültigen Bundles reduziert. Lädt Inhalte pro Komponente und schließt ungenutzte Inhalte aus Ihrem Bundle aus. Unterstützt Lazy Loading, um die Ladeeffizienz der App zu verbessern. - Optimierung des App-Builds
	Statisches Rendering Blockiert statisches Rendering nicht. - Next.js-Integration
	KI-gestützte Übersetzung Verwandeln Sie Ihre Website mit nur einem Klick in 231 Sprachen mithilfe der fortschrittlichen KI-gestützten Übersetzungstools von Intlayer unter Verwendung Ihres eigenen KI-Anbieters/API-Schlüssels. - CI/CD-Integration - Intlayer CLI - Auto fill
	MCP-Server-Integration Bietet einen MCP-Server (Model Context Protocol) für die IDE-Automatisierung, der eine nahtlose Inhaltsverwaltung und i18n-Workflows direkt in Ihrer Entwicklungsumgebung ermöglicht. - MCP-Server
	VSCode-Erweiterung Intlayer bietet eine VSCode-Erweiterung, die Ihnen hilft, Ihre Inhalte und Übersetzungen zu verwalten, Ihre Wörterbücher zu erstellen, Ihre Inhalte zu übersetzen und vieles mehr. - VSCode-Erweiterung
	Interoperabilität Ermöglicht die Interoperabilität mit react-i18next, next-i18next, next-intl und react-intl. - Intlayer und react-intl - Intlayer und next-intl - Intlayer und next-i18next
Testen fehlender Übersetzungen (CLI/CI)	✅ CLI: npx intlayer content test (CI-freundliches Audit)

Vergleich von Intlayer mit anderen Lösungen

GitHub-Sterne

GitHub-Sterne sind ein starker Indikator für die Popularität eines Projekts, das Vertrauen der Community und die langfristige Relevanz. Sie sind zwar kein direktes Maß für die technische Qualität, spiegeln jedoch wider, wie viele Entwickler das Projekt nützlich finden, seinen Fortschritt verfolgen und es wahrscheinlich übernehmen werden. Um den Wert eines Projekts einzuschätzen, helfen Sterne dabei, die Traktion verschiedener Alternativen zu vergleichen und Einblicke in das Wachstum des Ökosystems zu gewinnen.

Interoperabilität

intlayer kann auch dabei helfen, Ihre react-intl, react-i18next, next-intl, next-i18next und vue-i18n Namespaces zu verwalten.

Mit intlayer können Sie Ihren Inhalt im Format Ihrer bevorzugten i18n-Bibliothek deklarieren, und intlayer generiert Ihre Namespaces an dem Ort Ihrer Wahl (Beispiel: /messages/{{locale}}/{{namespace}}.json).