Dlaczego warto rozważyć Intlayer?

Czym jest Intlayer?

Intlayer to biblioteka umiędzynarodowienia (i18n) zaprojektowana specjalnie dla programistów JavaScript. Umożliwia ona deklarowanie treści w dowolnym miejscu w kodzie. Konwertuje deklaracje treści wielojęzycznych na strukturyzowane słowniki, które można łatwo zintegrować z kodem. Dzięki użyciu TypeScript, Intlayer czyni Twój proces programowania silniejszym i bardziej wydajnym.

Dlaczego Intlayer zamiast alternatyw?

W porównaniu do głównych rozwiązań, takich jak next-intl czy i18next, Intlayer jest rozwiązaniem, które oferuje wbudowane optymalizacje, takie jak:

Dlaczego powstał Intlayer?

Intlayer powstał, aby rozwiązać powszechny problem dotykający wszystkie popularne biblioteki i18n, takie jak next-intl, react-i18next, react-intl, next-i18next, react-intl oraz vue-i18n.

Wszystkie te rozwiązania stosują scentralizowane podejście do listowania i zarządzania treściami. Na przykład:

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

Lub tutaj przy użyciu przestrzeni nazw (namespaces):

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

Tego typu architektura spowalnia proces programowania i komplikuje utrzymanie kodu z kilku powodów:

1. Dla każdego nowo tworzonego komponentu musisz:

   • Utworzyć nowy zasób/przestrzeń nazw w folderze locales
   • Pamiętać o zaimportowaniu nowej przestrzeni nazw na swojej stronie
   • Przetłumaczyć treść (często robione ręcznie przez kopiowanie/wklejanie z narzędzi AI)

2. Dla każdej zmiany wprowadzanej w komponentach musisz:

   • Wyszukać powiązany zasób/przestrzeń nazw (daleko od komponentu)
   • Przetłumaczyć treść
   • Upewnić się, że Twoja treść jest aktualna dla wszystkich języków (locales)
   • Zweryfikować, czy przestrzeń nazw nie zawiera nieużywanych kluczy/wartości
   • Upewnić się, że struktura plików JSON jest taka sama dla wszystkich języków

W profesjonalnych projektach korzystających z tych rozwiązań często stosuje się platformy lokalizacyjne, aby ułatwić zarządzanie tłumaczeniem treści. Może to jednak szybko stać się kosztowne w przypadku dużych projektów.

Aby rozwiązać ten problem, Intlayer przyjmuje podejście, które ogranicza zakres treści do poziomu pojedynczego komponentu i trzyma treść blisko niego, podobnie jak często robimy to z CSS (styled-components), typami, dokumentacją (storybook) czy testami jednostkowymi (jest).

.
└── 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>;
};

Takie podejście pozwala na:

1. Zwiększenie szybkości programowania

   • Pliki .content.{ts|js|mjs|cjs|json|tsx|jsx|md|mdx|yaml|yml} mogą być tworzone przy użyciu rozszerzenia VSCode
   • Narzędzia do automatycznego uzupełniania AI w Twoim IDE (takie jak GitHub Copilot) mogą pomóc w deklarowaniu treści, ograniczając kopiowanie/wklejanie

2. Uporządkowanie bazy kodu

   • Zmniejszenie złożoności
   • Zwiększenie łatwości konserwacji

3. Łatwiejsze duplikowanie komponentów i powiązanych z nimi treści (np. komponenty logowania/rejestracji itp.)

   • Ograniczając ryzyko wpłynięcia na treść innych komponentów
   • Kopiując i wklejając treść z jednej aplikacji do drugiej bez zewnętrznych zależności

4. Unikanie zaśmiecania bazy kodu nieużywanymi kluczami/wartościami dla nieużywanych komponentów

   • Jeśli nie używasz komponentu, Intlayer nie zaimportuje powiązanej z nim treści
   • Jeśli usuniesz komponent, łatwiej zapamiętasz o usunięciu powiązanej treści, ponieważ będzie się ona znajdować w tym samym folderze

5. Zmniejszenie kosztów wnioskowania dla agentów AI przy deklarowaniu treści wielojęzycznych

   • Agent AI nie będzie musiał skanować całej bazy kodu, aby dowiedzieć się, gdzie zaimplementować Twoją treść
   • Tłumaczenia mogą być łatwo wykonywane przez narzędzia AI do automatycznego uzupełniania w Twoim IDE (takie jak GitHub Copilot)

6. Optymalizację wydajności ładowania

   • Jeśli komponent jest ładowany leniwie (lazy-loaded), powiązana z nim treść zostanie załadowana w tym samym momencie

Aby zrozumieć, skąd wzięły się te biblioteki, przeczytaj historię i18n w JavaScript.

Dodatkowe funkcje Intlayer

Pokaż całą zawartość tabeli

Pokaż całą zawartość tabeli

Otwórz tabelę w oknie modalnym, aby wyraźnie zobaczyć całą zawartość

Funkcja	Opis
	Obsługa wielu frameworków Intlayer jest kompatybilny ze wszystkimi głównymi frameworkami i bibliotekami, w tym Next.js, React, Vite, Vue.js, Nuxt, Preact, Express i innymi.
	Zarządzanie treścią oparte na JavaScript Wykorzystaj elastyczność JavaScript do wydajnego definiowania i zarządzania treściami. - Deklaracja treści
	Kompilator Kompilator Intlayer automatycznie wyodrębnia treść z komponentów i generuje pliki słowników. - Kompilator
	Plik deklaracji treści dla konkretnego języka Przyspiesz proces tworzenia, deklarując treść raz, przed automatycznym generowaniem. - Plik deklaracji treści dla konkretnego języka
	Środowisko bezpieczne pod kątem typów Skorzystaj z TypeScript, aby upewnić się, że definicje treści i kod są wolne od błędów, jednocześnie czerpiąc korzyści z autouzupełniania w IDE. - Konfiguracja TypeScript
	Uproszczona konfiguracja Szybko rozpocznij pracę przy minimalnej konfiguracji. Z łatwością dostosuj ustawienia lokalizacji, routingu, sztucznej inteligencji, budowania i obsługi treści. - Poznaj integrację z Next.js
	Uproszczone pobieranie treści Nie musisz wywoływać funkcji t dla każdego elementu treści. Pobierz całą zawartość bezpośrednio za pomocą jednego hooka. - Integracja z React
	Spójna implementacja komponentów serwerowych Idealnie nadaje się do komponentów serwerowych Next.js, użyj tej samej implementacji dla komponentów klienckich i serwerowych, bez konieczności przekazywania funkcji t przez drzewo komponentów. - Komponenty serwerowe
	Uporządkowana baza kodu Utrzymuj bazę kodu w większym porządku: 1 komponent = 1 słownik w tym samym folderze. Tłumaczenia blisko powiązanych komponentów zwiększają łatwość konserwacji i przejrzystość. - Jak działa Intlayer
	Ulepszony routing Pełna obsługa routingu aplikacji, płynnie dostosowująca się do złożonych struktur aplikacji dla Next.js, React, Vite, Vue.js itp. - Poznaj integrację z Next.js
	Obsługa Markdown Importuj i interpretuj pliki lokalne oraz zdalny Markdown dla treści wielojęzycznych, takich jak polityki prywatności, dokumentacja itp. Interpretuj i udostępniaj metadane Markdown w swoim kodzie. - Pliki treści
	Darmowy edytor wizualny i CMS Darmowy edytor wizualny i CMS są dostępne dla twórców treści, co eliminuje potrzebę korzystania z zewnętrznej platformy lokalizacyjnej. Utrzymuj synchronizację treści za pomocą Git lub całkowicie bądź częściowo przenieś zarządzanie do CMS. - Edytor Intlayer - CMS Intlayer
	Zawartość podlegająca eliminacji nieużywanego kodu (Tree-shakable) Zawartość podlegająca tree-shakingowi, zmniejszająca rozmiar ostatecznej paczki. Ładuje treść dla poszczególnych komponentów, wykluczając nieużywane elementy z paczki. Obsługuje leniwe ładowanie w celu zwiększenia wydajności aplikacji. - Optymalizacja budowania aplikacji
	Renderowanie statyczne Nie blokuje renderowania statycznego. - Integracja z Next.js
	Tłumaczenie wspomagane przez AI Przetłumacz swoją witrynę na 231 języków jednym kliknięciem, korzystając z zaawansowanych narzędzi tłumaczeniowych Intlayer opartych na sztucznej inteligencji, korzystając z własnego dostawcy AI/klucza API. - Integracja CI/CD - Intlayer CLI - Autouzupełnianie
	Integracja z serwerem MCP Udostępnia serwer MCP (Model Context Protocol) do automatyzacji IDE, umożliwiając bezproblemowe zarządzanie treścią i przepływy pracy i18n bezpośrednio w środowisku programistycznym. - Serwer MCP
	Rozszerzenie VSCode Intlayer udostępnia rozszerzenie do VSCode, które pomaga zarządzać treścią i tłumaczeniami, budować słowniki, tłumaczyć zawartość i nie tylko. - Rozszerzenie VSCode
	Interoperacyjność Umożliwia interoperacyjność z react-i18next, next-i18next, next-intl i react-intl. - Intlayer i react-intl - Intlayer i next-intl - Intlayer i next-i18next - Adaptery kompatybilności Intlayer
Testowanie brakujących tłumaczeń (CLI/CI)	✅ CLI: npx intlayer content test (audyt przyjazny dla CI)

Porównanie Intlayer z innymi rozwiązaniami

Gwiazdki na GitHubie

Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania społeczności i długoterminowej trajektorii. Choć nie są bezpośrednią miarą jakości technicznej, odzwierciedlają liczbę programistów, którzy uważają projekt za przydatny, śledzą jego postępy i prawdopodobnie go wdrożą. Do szacowania wartości projektu gwiazdki pomagają porównać atrakcyjność alternatyw i dostarczają wglądu w rozwój ekosystemu.

Aktywność commitów

Gwiazdki pokazują popularność. Commity pokazują, ile pracy włożono w projekt. W chwili pisania Intlayer ma około 7 500 commitów, więcej niż większość porównywanych tu bibliotek i mniej więcej 5 razy więcej niż next-intl czy next-i18next.

Intlayer to monorepo, więc ta liczba obejmuje każdy pakiet dla frameworków, CLI i dokumentację. Traktuj commity jako sygnał aktywności, a nie jakości.

Pobrania z npm

Liczba pobrań nagradza najstarsze rozwiązania, a nie najlepsze. Biblioteka wydana lata temu wciąż jest instalowana przez każdy projekt, który ją wtedy wybrał, przez każde uruchomienie CI i przez każdy pakiet, który od niej zależy. Ta liczba mierzy bezwładność bardziej niż świadomy wybór.

Asystenci AI wzmacniają ten efekt. next-intl, i18next i vue-i18n są wszędzie w kodzie, na którym ich trenowano, więc proponują je domyślnie, bez porównywania alternatyw. Każda sugestia dodaje pobrań, które napędzają kolejną sugestię. Porównuj na podstawie benchmarku, a nie liczby pobrań.

Interoperacyjność

intlayer może również pomóc w zarządzaniu przestrzeniami nazw react-intl, react-i18next, next-intl, next-i18next i vue-i18n.

Używając intlayer, możesz zadeklarować treść w formacie swojej ulubionej biblioteki i18n, a intlayer wygeneruje przestrzenie nazw w wybranej przez Ciebie lokalizacji (przykład: /messages/{{locale}}/{{namespace}}.json).

Jeśli chcesz nadal korzystać z API swojej obecnej biblioteki i18n, intlayer udostępnia również adaptery kompatybilności (compat adapters): pakiety wystawiające dokładnie to samo API co react-i18next, next-intl, react-intl, vue-i18n i inne, ale zasilane słownikami Intlayer. Dzięki temu możesz migrować stopniowo, bez przepisywania kodu. Zobacz dokumentację adapterów kompatybilności.

Często Zadawane Pytania