js lingui

LINuI _JS

? Eine lesbare, automatisierte und optimierte (3 KB) Internationalisierung für JavaScript

---

Dokumentation · QuickStart · Beispiel · Support · Beitrag · Lizenz beitragen

Die Internationalisierung ist das Design und die Entwicklung eines Produkts, einer Anwendung oder eines Dokumentinhalts, die eine einfache Lokalisierung für Zielgruppen ermöglichen, die sich in Kultur, Region oder Sprache unterscheiden.

--- W3C Web Internationalization FAQ

Lingui ist ein einfacher, aber leistungsstarker Rahmen für die Internationalisierung (I18N) für globale Projekte.

• Sauber und lesbar - Halten Sie Ihren Code sauber und lesbar, während die Bibliothek gegen die kattgetestete und leistungsstarke ICU -MessageFormat unter der Motorhaube verwendet wird.

• Universal - benutze es überall. @lingui/core bietet die wesentliche INTL -Funktionalität, die in jedem JavaScript -Projekt funktioniert, während @lingui/react Komponenten zur Nutzung von React -Rendering bietet, einschließlich der Unterstützung von React Server -Komponenten (RSC).

• Vollständige Unterstützung von Rich -Text - Verwenden Sie React -Komponenten in lokalisierten Nachrichten ohne Beschränkung. Das Schreiben von Rich-Text-Nachrichten ist so einfach wie das Schreiben von JSX.

• Leistungsstarke Tooling - Verwalten Sie Ihren INTL -Workflow mit dem Lingui CLI, dem VITE -Plugin und dem Eslint -Plugin. Das CLI extrahiert, kompiliert und validiert Nachrichten, während das Vite -Plugin Kataloge im laufenden Fliegen zusammenstellt, und das Eslint -Plugin hilft dabei, gemeinsame Nutzungsfehler zu erfassen.

• Unpinioniert - Integrieren Sie Lingui in Ihren vorhandenen Workflow. Es unterstützt Nachrichtenschlüssel sowie automatisch generierte Nachrichten. Übersetzungen werden entweder in JSON- oder Standard -PO -Dateien gespeichert, die in fast allen Übersetzungswerkzeugen unterstützt werden.

• Leichte und optimierte - Kernbibliothek ist weniger als 3 KB GZIPED, React -Komponenten sind zusätzlich 1,4 kb Gziped.

• Active Community - Schließen Sie sich der wachsenden Community von Entwicklern an, die Lingui verwenden, um globale Produkte aufzubauen.

• Kompatibel mit React-Intl -React-API mit niedriger Ebene ist React-intl sehr ähnlich und das Nachrichtenformat ist das gleiche. Es ist einfach, ein bestehendes Projekt zu migrieren.

QuickStart

1. Einführung
2. Installation und Setup

Tutorials

• Reagieren
• React Server -Komponenten
• Reagieren Sie nativ
• JavaScript

Beispiel

Kurzes Beispiel, wie i18n mit JSX aussieht:

 import { Trans } from "@lingui/react/macro"

function App ( ) {
  return (
    < Trans id = "msg.docs" /* id is optional */ >
      Read the < a href = "https://lingui.dev" > documentation </ a >
      for more info.
    </ Trans >
  )
}

Die Nachricht aus dieser Komponente wird im folgenden Format extrahiert:

 msgid "msg.docs"
msgstr "Read the <0>documentation</0> for more info."

Weitere Beispiele finden Sie im Beispielverzeichnis.

Unterstützung

Wenn Sie Probleme haben, lassen Sie es uns bitte wissen.

• Begleiten Sie uns auf Discord, um mit der Community zu chatten.
• Stellen Sie Fragen zum Stackoverflow und markieren Sie es mit dem linguijs -Tag.
• Wenn etwas nicht wie dokumentiert funktioniert, fehlt die Dokumentation oder wenn Sie nur eine neue Funktion vorschlagen möchten, erstellen Sie ein Problem.
• Sie können auch Lingui JS Guru fragen, es ist eine von Lingui JS fokussierte KI, um Ihre Fragen zu beantworten.

Beitragen

Der Beitrag zum Open-Source-Projekt ist alles, von der Verbreitung des Wortes über das Schreiben von Dokumentationen bis hin zur Implementierung von Funktionen und Behebung von Fehler.

• Verwenden Sie Lingui in der Produktionsstelle? Lass es uns wissen!
• Haben Sie einen interessanten Vortrag oder Artikel über i18n gesehen? Teilt es!
• Haben Sie einen Fehler gefunden oder möchten Sie eine neue Funktion vorschlagen? Erstellen Sie ein Problem!
• Möchten Sie die Dokumente verbessern und Code schreiben? Lesen Sie den Leitfaden für Mitwirkende und senden Sie eine PR!

Mitwirkende

Dieses Projekt besteht dank aller Menschen, die einen Beitrag leisten. [Beitragen].

Lizenz

Das Projekt ist unter der MIT -Lizenz lizenziert.