Autor:
    Aymeric PINEAU
    Data utworzenia:2025-08-23Ostatnia aktualizacja:2025-08-23

    Dokumentacja Intlayer

    Witamy w oficjalnej dokumentacji Intlayer! Tutaj znajdziesz wszystko, czego potrzebujesz, aby zintegrować, skonfigurować i opanować Intlayer dla wszystkich Twoich potrzeb związanych z internacjonalizacją (i18n), niezależnie od tego, czy pracujesz z Next.js, React, Vite, Express, czy w innym środowisku JavaScript.

    Wprowadzenie

    Czym jest Intlayer?

    Intlayer to biblioteka internacjonalizacji zaprojektowana specjalnie dla programistów JavaScript. Pozwala ona na deklarowanie treści w dowolnym miejscu Twojego kodu. Przekształca deklaracje wielojęzycznych treści w ustrukturyzowane słowniki w celu ich łatwej integracji z Twoim kodem. Wykorzystując TypeScript, Intlayer sprawia, że Twoje tworzenie oprogramowania jest solidniejsze i bardziej wydajne.

    Intlayer udostępnia również opcjonalny edytor wizualny, który pozwala w prosty sposób edytować i zarządzać treścią. Ten edytor jest szczególnie przydatny dla programistów, którzy preferują wizualny interfejs do zarządzania treścią, lub dla zespołów generujących treści bez konieczności przejmowania się kodem.

    Przykład użycia

    bash
    .
└── Components
    └── MyComponent
        ├── index.content.ts
        └── index.tsx
    src/components/MyComponent/index.content.ts
    import { t, type Dictionary } from "intlayer";

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

export default componentContent;
    src/components/MyComponent/index.tsx
    import type { FC } from "react";
import { useIntlayer } from "react-intlayer";

export const MyComponent: FC = () => {
  const { myTranslatedContent } = useIntlayer("component-key");

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

    Dlaczego Intlayer, a nie alternatywy?

    W porównaniu do wiodących rozwiązań takich jak next-intl lub i18next, Intlayer to rozwiązanie, które ma zintegrowane optymalizacje, takie jak:

    Zamiast pobierać ogromne pliki JSON do Twoich stron, ładuj tylko niezbędną treść. Intlayer pomaga zmniejszyć rozmiary Twojego kodu wynikowego oraz stron nawet o 50%.

    Ograniczanie zasięgu (scoping) treści Twojej aplikacji ułatwia utrzymanie dużych projektów. Możesz skopiować lub usunąć folder pojedynczej funkcjonalności bez obciążania umysłu koniecznością przeglądania całej bazy kodu treści. Ponadto, Intlayer jest w pełni zadeklarowany statycznie (fully typed), co gwarantuje poprawność Twojej treści.

    Wspólne umiejscowienie (co-locating) kodu i treści zmniejsza kontekst wymagany przez duże modele językowe (LLM). Intlayer jest również dostarczany z pakietem narzędzi, takim jak CLI służącym do testowania pod kątem brakujących tłumaczeń, LSP, MCP oraz agent skills, dzięki czemu środowisko programistyczne (DX) dla agentów AI staje się znacznie wygodniejsze.

    Skorzystaj z automatyzacji, by tłumaczyć w Twoim potoku CI/CD, używając wybranego modelu LLM zgodnie z kosztem Twojego dostawcy AI. Intlayer oferuje również kompilator, aby automatyzować wyciąganie treści, a także platformę webową, by pomóc tłumaczyć w tle.

    Podłączanie ogromnych plików JSON do komponentów może prowadzić do problemów z wydajnością i reaktywnością. Intlayer optymalizuje proces ładowania Twojej treści w fazie budowania (build time).

    Więcej niż rozwiązanie i18n — Intlayer dostarcza samodzielnie hostowany edytor wizualny oraz w pełni wyposażony system CMS, który pomaga zarządzać Twoimi wielojęzycznymi treściami w czasie rzeczywistym, umożliwiając bezproblemową współpracę między tłumaczami, twórcami treści i pozostałymi członkami zespołu. Treść można przechowywać lokalnie i/lub zdalnie.

    Główne funkcje

    Intlayer oferuje szereg funkcji dostosowanych do potrzeb nowoczesnego tworzenia stron internetowych. Poniżej znajdują się kluczowe funkcje wraz z linkami do szczegółowej dokumentacji dla każdej z nich:

    • Wsparcie dla internacjonalizacji: Zwiększ globalny zasięg swojej aplikacji dzięki wbudowanemu wsparciu dla internacjonalizacji.
    • Edytor Wizualny: Usprawnij swój przepływ pracy za pomocą wtyczek edytora zaprojektowanych dla Intlayer. Sprawdź Przewodnik po Edytorze Wizualnym.
    • Elastyczność Konfiguracji: Dostosuj swoją konfigurację za pomocą rozbudowanych opcji konfiguracyjnych, wyszczególnonych w Przewodniku po konfiguracji.
    • Zaawansowane Narzędzia CLI: Zarządzaj efektywnie swoimi projektami przy użyciu interfejsu wiersza poleceń Intlayer. Odkryj możliwości w Dokumentacji Narzędzi CLI.

    Kluczowe Koncepcje

    Słownik (Dictionary)

    Organizuj swoje wielojęzyczne treści w pobliżu kodu, aby zachować spójność i łatwość w utrzymaniu.

    Środowiska i Integracje

    Zbudowaliśmy Intlayer z myślą o elastyczności, oferując płynną integrację w obrębie popularnych frameworków i narzędzi do budowania:

    Każdy przewodnik integracyjny zawiera najlepsze praktyki korzystania z funkcji Intlayer, takich jak renderowanie po stronie serwera (SSR), dynamiczne routowanie, czy renderowanie po stronie klienta, dzięki czemu możesz utrzymać szybką, przyjazną dla SEO i wysoce skalowalną aplikację.

    Wnoszenie Wkładu i Opinie

    Cenimy siłę open-source i tworzenia oprogramowania opartego o społeczność. Jeśli chciałbyś zaproponować usprawnienia, dodać nowy poradnik lub poprawić błędy w naszych dokumentach, śmiało wyślij Pull Request lub otwórz Issue w naszym repozytorium GitHub.

    Gotowy, aby tłumaczyć swoją aplikację szybciej i wydajniej? Zanurz się w naszej dokumentacji, aby rozpocząć korzystanie z Intlayer już dziś. Doświadcz solidnego, zoptymalizowanego podejścia do internacjonalizacji, które sprawi, że Twoje treści będą uporządkowane, a Twój zespół bardziej produktywny.

    Dlaczego Intlayer?Jak działa Intlayer