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 die Deklaration Ihres Inhalts überall in Ihrem Code. Sie wandelt Deklarationen mehrsprachiger Inhalte in strukturierte Wörterbücher um, um sie einfach in Ihren Code zu integrieren. 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, um Ihre Inhalte aufzulisten und zu verwalten. Zum Beispiel:

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

Oder hier mit 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 den Codebestand aus mehreren Gründen komplexer zu warten:

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

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

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

   • Nach der zugehörigen Ressource/dem Namespace suchen (weit entfernt von der Komponente)
   • Ihre Inhalte übersetzen
   • Sicherstellen, dass Ihre Inhalte für jede Locale aktuell sind
   • Überprüfen, dass Ihr Namespace keine ungenutzten Schlüssel/Werte enthält
   • Sicherstellen, dass die Struktur Ihrer JSON-Dateien für alle Locales gleich 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 abgegrenzt und nahe bei Ihrer Komponente gehalten werden, ähnlich wie wir es oft mit CSS (styled-components), Typen, Dokumentation (storybook) oder Unit-Tests (jest) tun.

.└── 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
   • Autovervollständigungs-KI-Tools in Ihrer IDE (wie GitHub Copilot) können Ihnen helfen, Ihren Inhalt zu deklarieren, wodurch Copy/Paste reduziert wird

2. Reduzieren Sie die Komplexität Ihres Codebestands

3. Erhöhen Sie die Wartbarkeit Ihres Codebestands

4. Duplizieren Sie Ihre Komponenten und deren zugehörigen Inhalte einfacher (Beispiel: Login/Register-Komponenten usw.)

   • Indem Sie das Risiko minimieren, den Inhalt anderer Komponenten zu beeinflussen
   • Indem Sie Ihre Inhalte von einer Anwendung in eine andere ohne externe Abhängigkeiten kopieren/einfügen

5. Vermeiden Sie es, Ihren Codebestand mit ungenutzten Schlüsseln/Werten für ungenutzte Komponenten zu verschmutzen

   • Wenn Sie eine Komponente nicht verwenden, müssen Sie deren Inhalt nicht importieren
   • Wenn Sie eine Komponente löschen, erinnern Sie sich leichter daran, den zugehörigen Inhalt zu entfernen, da dieser im selben Ordner vorhanden ist

6. Reduzieren Sie die Denkaufwand für KI-Agenten, um Ihre mehrsprachigen Inhalte zu deklarieren

   • Der KI-Agent muss nicht Ihren gesamten Codebestand durchsuchen, um zu wissen, wo Ihr Inhalt implementiert werden soll
   • Übersetzungen können einfach mit Autovervollständigungs-KI-Tools in Ihrer IDE (wie GitHub Copilot) durchgeführt werden

7. Optimieren Sie die Ladeleistung

   • Wenn eine Komponente lazy geladen wird, wird ihr zugehöriger Inhalt gleichzeitig geladen

Zusätzliche Funktionen von Intlayer

Funktion	Beschreibung
	Framework-übergreifende Unterstützung<br><br>Intlayer ist kompatibel mit allen wichtigen Frameworks und Bibliotheken, einschließlich Next.js, React, Vite, Vue.js, Nuxt, Preact, Express und mehr.
	JavaScript-gesteuertes Content-Management<br><br>Nutzen Sie die Flexibilität von JavaScript, um Ihre Inhalte effizient zu definieren und zu verwalten. <br><br> - Inhaltsdeklaration
	Pro-Lokale Inhaltsdeklarationsdatei<br><br>Beschleunigen Sie Ihre Entwicklung, indem Sie Ihre Inhalte einmalig deklarieren, bevor die automatische Generierung erfolgt.<br><br> - Pro-Lokale Inhaltsdeklarationsdatei
	Typsicheres Umfeld<br><br>Nutzen Sie TypeScript, um sicherzustellen, dass Ihre Inhaltsdefinitionen und Ihr Code fehlerfrei sind, und profitieren Sie gleichzeitig von der Autovervollständigung in der IDE.<br><br> - TypeScript-Konfiguration
	Vereinfachte Einrichtung<br><br>Starten Sie schnell mit minimaler Konfiguration. Passen Sie Einstellungen für Internationalisierung, Routing, KI, Build und Inhaltsverwaltung mühelos an.<br><br> - Next.js-Integration erkunden
	Vereinfachte Inhaltsabfrage<br><br>Sie müssen Ihre t-Funktion nicht für jeden einzelnen Inhalt aufrufen. Rufen Sie alle Ihre Inhalte direkt mit einem einzigen Hook ab.<br><br> - React-Integration
	Konsistente Implementierung von Server-Komponenten<br><br>Perfekt geeignet für Next.js Server-Komponenten, verwenden Sie dieselbe Implementierung sowohl für Client- als auch für Server-Komponenten, ohne Ihre t-Funktion an jede Server-Komponente weitergeben zu müssen. <br><br> - Server-Komponenten
	Organisierte Codebasis<br><br>Halten Sie Ihre Codebasis besser organisiert: 1 Komponente = 1 Wörterbuch im selben Ordner. Übersetzungen, die nahe bei ihren jeweiligen Komponenten liegen, verbessern die Wartbarkeit und Klarheit. <br><br> - Wie Intlayer funktioniert
	Erweitertes Routing<br><br>Volle Unterstützung des App-Routings, die sich nahtlos an komplexe Anwendungsstrukturen anpasst, für Next.js, React, Vite, Vue.js usw.<br><br> - Next.js-Integration erkunden
	Markdown-Unterstützung<br><br>Importieren und interpretieren Sie Lokalisierungsdateien und entfernte Markdown-Dateien für mehrsprachige Inhalte wie Datenschutzrichtlinien, Dokumentationen usw. Interpretieren Sie Markdown-Metadaten und machen Sie sie in Ihrem Code zugänglich.<br><br> - Inhaltsdateien
	Kostenloser visueller Editor & CMS<br><br>Ein kostenloser visueller Editor und CMS stehen Content-Autoren zur Verfügung, wodurch keine Lokalisierungsplattform mehr benötigt wird. Halten Sie Ihre Inhalte mit Git synchronisiert oder externalisieren Sie sie ganz oder teilweise mit dem CMS.<br><br> - Intlayer Editor <br> - Intlayer CMS
	Tree-shakable Inhalte<br><br>Tree-shakable Inhalte, die die Größe des finalen Bundles reduzieren. 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. <br><br> - App-Build-Optimierung
	Statisches Rendering<br><br>Blockiert das statische Rendering nicht. <br><br> - Next.js-Integration
	KI-gestützte Übersetzung<br><br>Verwandeln Sie Ihre Website mit nur einem Klick in 231 Sprachen mithilfe der fortschrittlichen KI-gestützten Übersetzungswerkzeuge von Intlayer unter Verwendung Ihres eigenen KI-Anbieters/API-Schlüssels. <br><br> - CI/CD-Integration <br> - Intlayer CLI <br> - Automatisches Ausfüllen
	MCP-Server-Integration<br><br>Stellt einen MCP (Model Context Protocol) Server für IDE-Automatisierung bereit, der nahtloses Content-Management und i18n-Workflows direkt in Ihrer Entwicklungsumgebung ermöglicht. <br><br> - MCP-Server
	VSCode-Erweiterung<br><br>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 mehr. <br><br> - VSCode-Erweiterung
	Interoperabilität<br><br>Ermöglicht die Interoperabilität mit react-i18next, next-i18next, next-intl und react-intl. <br><br> - Intlayer und react-intl <br> - Intlayer und next-intl <br> - Intlayer und next-i18next

Vergleich von Intlayer mit anderen Lösungen

Dokumenthistorie