Creation:2025-08-23Last update: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 umiejętności agentów (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