@intlayer/docs 9.4.1 → 9.4.2

package/docs/pl/introduction.md

@@ -93,7 +93,6 @@ export const MyComponent: FC = () => {
 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:
 
 <AccordionGroup>
-
 <Accordion header="Rozmiar paczki (Bundle size)">
 
 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%**.
@@ -204,3 +203,107 @@ Każdy przewodnik integracyjny zawiera najlepsze praktyki korzystania z funkcji
 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](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
 
 **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.
+
+## Często Zadawane Pytania
+
+<FAQ>
+
+<Question title="Do czego służy Intlayer?">
+
+Intlayer to biblioteka internacjonalizacji (i18n) dla aplikacji JavaScript i TypeScript. Deklarujesz treść komponentu obok samego komponentu w pliku `.content.ts`, Intlayer kompiluje te deklaracje w typowane słowniki w czasie budowy, a Twoje komponenty odczytują je za pomocą hooka, takiego jak `useIntlayer`. Obejmuje tłumaczenia, reguły liczby mnogiej, płeć, Markdown, routing uwzględniający lokalizację, metadane SEO, tłumaczenia ze wsparciem AI oraz edytor wizualny dla osób nietechnicznych.
+
+</Question>
+
+<Question title="O ile i18n zwiększa rozmiar mojego bundle'a?">
+
+Znacznie mniej niż rozwiązania oparte na przestrzeniach nazw, ponieważ strona nigdy nie pobiera katalogu, którego nie renderuje. Znaczniki renderowane po stronie serwera rozwiązują treść na serwerze, a kompilator czasu budowy zastępuje wywołania `useIntlayer` dokładnymi wpisami, których używa komponent, dzięki czemu nieużywane klucze i nieużywane języki są usuwane. [Słowniki dynamiczne](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/index.md) dzielą resztę na poszczególne języki. W porównaniu z typowymi alternatywami, Intlayer zmniejsza rozmiar bundle'a i strony nawet o 50%. Zobacz [optymalizację bundle'a](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/bundle_optimization.md) oraz [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/benchmark/index.md).
+
+</Question>
+
+<Question title="Czy mogę zmigrować z i18next, next-intl lub react-i18next bez przepisywania moich komponentów?">
+
+Tak, i są dwie drogi. Możesz migrować treść stopniowo za pomocą [przewodnika migracji z i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/migration_from_i18next_to_intlayer.md) lub [przewodnika migracji z next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/migration_from_next-intl_to_intlayer.md). Możesz także zachować obecne API w całości: [adaptery kompatybilności](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compat/index.md) udostępniają dokładnie to samo API co `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` i `Lingui`, ale zasilane słownikami Intlayer, więc zmieniają się importy, a kod komponentów pozostaje nienaruszony.
+
+</Question>
+
+<Question title="Czy mogę zachować moje istniejące pliki tłumaczeń JSON?">
+
+Tak. Wtyczka [sync JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/plugins/sync-json.md) utrzymuje Twoje pliki `/messages/{locale}/{namespace}.json` jako źródło prawdy i generuje z nich słowniki Intlayer w obu kierunkach. Wtyczka [sync PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/plugins/sync-po.md) robi to samo dla katalogów gettext, a [pliki per locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/per_locale_file.md) pozwalają rozdzielić zawartość według języka zamiast grupować lokalizacje w jednym pliku.
+
+</Question>
+
+<Question title="Czy muszę przenosić moją zawartość klucz po kluczu?">
+
+Nie. Uruchom `npx intlayer extract`, a Intlayer odczyta Twoje pliki źródłowe, wyodrębni ciągi widoczne dla użytkownika i utworzy plik `.content` obok każdego z nich, dzięki czemu przeglądasz diff zamiast ręcznie kopiować ciągi do katalogu pojedynczo. Zobacz [polecenie extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/extract.md).
+
+W przypadku w pełni zautomatyzowanego procesu [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compiler.md) robi to samo w czasie budowania w kodzie JSX, TSX, Vue i Svelte, generując słowniki przy każdej zmianie, dzięki czemu nie ma potrzeby ręcznego zarządzania kluczami. Działa on w oparciu o analizę statyczną, więc ciągi istniejące tylko w czasie wykonywania pozostają poza jego zasięgiem i wymaga kilku adnotacji do odróżnienia tekstu dla użytkownika od logiki aplikacji.
+
+</Question>
+
+<Question title="Jakie narzędzia dla edytora i agentów AI są dostępne?">
+
+Pięć narzędzi, wszystkie opcjonalne:
+
+- **[Rozszerzenie VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/vs_code_extension.md)**: przejście od klucza `useIntlayer` do pliku treści, który go deklaruje, wyodrębnianie treści z komponentu oraz uruchamianie build, fill, test, push i pull z palety poleceń lub dedykowanej karty Intlayer.
+- **[Serwer LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/lsp.md)**: taka sama świadomość w dowolnym edytorze obsługującym LSP, z funkcjami przejdź do definicji (go to definition), znajdź wszystkie referencje, podglądem przetłumaczonej wartości po najechaniu kursorem, autouzupełnianiem kluczy i pól oraz ostrzeżeniem, gdy klucz nie jest nigdzie zadeklarowany. Rozpoznaje również wywołania `i18next`, `react-i18next`, `next-intl` i `use-intl`, co ułatwia migrację.
+- **[Serwer MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/mcp_server.md)**: udostępnia dokumentację i CLI Intlayer dla Cursor, VS Code, Claude Desktop, Claude Code i ChatGPT, dzięki czemu asystent odpowiada na podstawie aktualnej dokumentacji zamiast zgadywać i może samodzielnie wykonywać polecenia, takie jak `intlayer fill`.
+- **[Umiejętności agenta (Agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/agent_skills.md)**: wyspecjalizowane umiejętności, takie jak `intlayer-config`, `intlayer-cli` i `intlayer-content`, oraz po jednej dla każdego frameworka, które uczą agenta konfiguracji routingu i typów węzłów treści.
+- **[Wtyczka ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/eslint.md)**: reguła `no-raw-text` oznacza zakodowane na stałe ciągi tekstowe, z dodatkowymi regułami dla statycznych kluczy słownika i nieużywanej zawartości.
+
+</Question>
+
+<Question title="Jakie są różne rozwiązania dostępne do internacjonalizacji aplikacji JavaScript?">
+
+Obszar ten dzieli się na trzy generacje:
+
+- **Biblioteki katalogów w czasie działania (runtime)**: `i18next`, `react-i18next`, `next-i18next`, `vue-i18n`, `ngx-translate`. Wiadomości znajdują się w przestrzeniach nazw JSON ładowanych w runtime. Dojrzałe i niezależne od frameworka, ale bez typowania statycznego i przesyłające cały katalog na klienta.
+- **Biblioteki wiadomości w czasie kompilacji**: `Lingui`, `Paraglide`, `react-intl` oraz `next-intl` z etapem ekstrakcji. Lepsze zachowanie bundle'a i częściowe typowanie, ale wciąż zależne od scentralizowanych katalogów.
+- **Biblioteki z warstwą treści (Content layer)**: `Intlayer`. Treść deklarowana per komponent i kompilowana per komponent, łącząca typowanie, tree-shaking, narzędzia deweloperskie i edycję w jednym źródle prawdy.
+
+Zobacz [dlaczego Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/interest_of_intlayer.md) oraz [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/benchmark/index.md).
+
+</Question>
+
+<Question title="Które frameworki obsługuje Intlayer?">
+
+React, Next.js, Vite, TanStack Start, React Router, Vue, Nuxt, Svelte, SvelteKit, Angular, Solid, Preact, Lit, Astro z dowolnymi wyspami (islands), React Native z Expo, Lynx, a po stronie backendu Express, Fastify, NestJS, Hono, Elysia i AdonisJS. Każdy z nich ma dedykowany przewodnik w sekcji środowisk.
+
+</Question>
+
+<Question title="Dlaczego deklarować treść obok komponentu zamiast w centralnym pliku JSON?">
+
+Z trzech powodów: po pierwsze, strona dostarcza tylko te wpisy, które faktycznie renderują jej komponenty, zamiast całej przestrzeni nazw, co znacznie zmniejsza bundle. Po drugie, katalog funkcji można przenosić lub usuwać autonomicznie bez szukania osieroconych kluczy. Po trzecie, modele LLM lub agenci AI edytujący komponent widzą treść w tym samym folderze, co zapewnia wyższą dokładność. Zobacz [jak działa Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/how_works_intlayer.md).
+
+</Question>
+
+<Question title="Jak automatycznie przetłumaczyć aplikację za pomocą AI?">
+
+Uruchom `npx intlayer fill`. Narzędzie CLI wykrywa brakujące tłumaczenia i uzupełnia je za pomocą wybranego modelu LLM, korzystając z Twojego dostawcy i klucza API, płacąc bezpośrednio swojemu dostawcy AI. Flaga `--git-diff` ogranicza operację do treści zmienionych na bieżącej gałęzi. Zobacz [polecenie fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/fill.md) oraz [integrację CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/CI_CD.md).
+
+</Question>
+
+<Question title="Jak znaleźć brakujące tłumaczenia?">
+
+Uruchom `npx intlayer test`. Polecenie kończy się błędem, gdy w zadeklarowanym języku brakuje treści, co uniemożliwia trafienie nieprzetłumaczonego tekstu na produkcję. Rozszerzenie VS Code wyświetla te same błędy bezpośrednio w edytorze, a wtyczka ESLint oznacza nieopakowane teksty regułą `no-raw-text`. Zobacz [testowanie treści](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/testing.md).
+
+</Question>
+
+<Question title="Czy muszę umieszczać lokalizację w adresie URL?">
+
+Nie. Opcja `routing.mode` przyjmuje `"prefix-no-default"` (domyślnie: `/about` i `/pl/about`), `"prefix-all"`, `"no-prefix"` oraz `"search-params"`, a opcja `routing.domains` pozwala przypisać każdy język do własnej domeny. Niezależnie od schematu funkcja `getMultilingualUrls` tworzy linki alternatywne `hreflang` dla metadanych i sitemapy. Zobacz [dokumentację konfiguracji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md).
+
+</Question>
+
+<Question title="Jak tłumacze i edytorzy treści mogą pracować bez dotykania kodu?">
+
+Edytor wizualny działa na Twojej własnej infrastrukturze i pozwala każdemu klikać w tekst działającej aplikacji w celu jego edycji, zapisując zmiany z powrotem do bazy kodu. CMS wyodrębnia treść, dzięki czemu można ją modyfikować bez ponownego wdrażania, a funkcja synchronizacji na żywo (live sync) aplikuje aktualizacje w locie. Zobacz [edytor wizualny](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md) oraz [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md).
+
+</Question>
+
+<Question title="Czy Intlayer jest darmowy i open source?">
+
+Tak. Intlayer jest projektem open source na licencji Apache 2.0. Biblioteka, CLI, kompilator i edytor wizualny są bezpłatne do użytku komercyjnego. Hostowany CMS to opcjonalna płatna usługa, którą można również [hostować samodzielnie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/self_hosting.md).
+
+</Question>
+
+</FAQ>

package/docs/pl/migration_from_i18next_to_intlayer.md

@@ -27,7 +27,6 @@ author: aymericzip
 ## Dlaczego migrować z i18next do Intlayer?
 
 <AccordionGroup>
-
 <Accordion header="Rozmiar bundle">
 
 Zamiast ładować ogromne pliki JSON do stron, ładuj tylko niezbędną zawartość. Intlayer pomaga **zmniejszyć bundle i rozmiary stron nawet o 50%**.
@@ -65,7 +64,6 @@ Użyj automatyzacji do tłumaczenia w pipeline CI/CD korzystając z wybranego LL
 Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany **edytor wizualny** i **pełny CMS** aby pomóc ci zarządzać multilingual zawartością w **rzeczywistym czasie**, czyniąc współpracę z tłumaczami, copywriterami i innymi członkami zespołu bezproblemową. Zawartość może być przechowywana lokalnie i/lub zdalnie.
 
 </Accordion>
-
 </AccordionGroup>
 
 ---

package/docs/pl/migration_from_next-i18next_to_intlayer.md

@@ -30,7 +30,6 @@ author: aymericzip
 ## Dlaczego migrować z next-i18next do Intlayer?
 
 <AccordionGroup>
-
 <Accordion header="Rozmiar bundle">
 
 Zamiast ładować ogromne pliki JSON do stron, ładuj tylko niezbędną zawartość. Intlayer pomaga **zmniejszyć bundle i rozmiary stron nawet o 50%**.
@@ -68,7 +67,6 @@ Użyj automatyzacji do tłumaczenia w pipeline CI/CD korzystając z wybranego LL
 Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany **edytor wizualny** i **pełny CMS** aby pomóc ci zarządzać multilingual zawartością w **rzeczywistym czasie**, czyniąc współpracę z tłumaczami, copywriterami i innymi członkami zespołu bezproblemową. Zawartość może być przechowywana lokalnie i/lub zdalnie.
 
 </Accordion>
-
 </AccordionGroup>
 
 ---

package/docs/pl/migration_from_next-intl_to_intlayer.md

@@ -28,7 +28,6 @@ author: aymericzip
 ## Dlaczego migrować z next-intl do Intlayer?
 
 <AccordionGroup>
-
 <Accordion header="Rozmiar bundle">
 
 Zamiast ładować ogromne pliki JSON do stron, ładuj tylko niezbędną zawartość. Intlayer pomaga **zmniejszyć bundle i rozmiary stron nawet o 50%**.
@@ -66,7 +65,6 @@ Użyj automatyzacji do tłumaczenia w pipeline CI/CD korzystając z wybranego LL
 Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany **edytor wizualny** i **pełny CMS** aby pomóc ci zarządzać multilingual zawartością w **rzeczywistym czasie**, czyniąc współpracę z tłumaczami, copywriterami i innymi członkami zespołu bezproblemową. Zawartość może być przechowywana lokalnie i/lub zdalnie.
 
 </Accordion>
-
 </AccordionGroup>
 
 ---

package/docs/pl/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -29,7 +29,6 @@ author: aymericzip
 ## Dlaczego migrować z @nuxtjs/i18n do Intlayer?
 
 <AccordionGroup>
-
 <Accordion header="Rozmiar bundle">
 
 Zamiast ładować ogromne pliki JSON do stron, ładuj tylko niezbędną zawartość. Intlayer pomaga **zmniejszyć bundle i rozmiary stron nawet o 50%**.
@@ -67,7 +66,6 @@ Użyj automatyzacji do tłumaczenia w pipeline CI/CD korzystając z wybranego LL
 Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany **edytor wizualny** i **pełny CMS** aby pomóc ci zarządzać multilingual zawartością w **rzeczywistym czasie**, czyniąc współpracę z tłumaczami, copywriterami i innymi członkami zespołu bezproblemową. Zawartość może być przechowywana lokalnie i/lub zdalnie.
 
 </Accordion>
-
 </AccordionGroup>
 
 ---

package/docs/pl/migration_from_react-i18next_to_intlayer.md

@@ -29,7 +29,6 @@ author: aymericzip
 ## Dlaczego migrować z react-i18next / i18next do Intlayer?
 
 <AccordionGroup>
-
 <Accordion header="Rozmiar bundle">
 
 Zamiast ładować ogromne pliki JSON do stron, ładuj tylko niezbędną zawartość. Intlayer pomaga **zmniejszyć bundle i rozmiary stron nawet o 50%**.
@@ -67,7 +66,6 @@ Użyj automatyzacji do tłumaczenia w pipeline CI/CD korzystając z wybranego LL
 Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany **edytor wizualny** i **pełny CMS** aby pomóc ci zarządzać multilingual zawartością w **rzeczywistym czasie**, czyniąc współpracę z tłumaczami, copywriterami i innymi członkami zespołu bezproblemową. Zawartość może być przechowywana lokalnie i/lub zdalnie.
 
 </Accordion>
-
 </AccordionGroup>
 
 ---

package/docs/pl/migration_from_vue-i18n_to_intlayer.md

@@ -28,7 +28,6 @@ author: aymericzip
 ## Dlaczego migrować z vue-i18n do Intlayer?
 
 <AccordionGroup>
-
 <Accordion header="Rozmiar bundle">
 
 Zamiast ładować ogromne pliki JSON do stron, ładuj tylko niezbędną zawartość. Intlayer pomaga **zmniejszyć bundle i rozmiary stron nawet o 50%**.
@@ -66,7 +65,6 @@ Użyj automatyzacji do tłumaczenia w pipeline CI/CD korzystając z wybranego LL
 Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany **edytor wizualny** i **pełny CMS** aby pomóc ci zarządzać multilingual zawartością w **rzeczywistym czasie**, czyniąc współpracę z tłumaczami, copywriterami i innymi członkami zespołu bezproblemową. Zawartość może być przechowywana lokalnie i/lub zdalnie.
 
 </Accordion>
-
 </AccordionGroup>
 
 ---

package/docs/pl/packages/next-intlayer/useIntlayer.md

@@ -178,6 +178,9 @@ const ServerComponentExample: FC = () => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ## Obsługa lokalizacji atrybutów
 
 Aby lokalizować atrybuty takie jak `alt`, `title`, `href`, `aria-label` itp., upewnij się, że poprawnie odwołujesz się do zawartości:

package/docs/pl/packages/vite-intlayer/intlayerMinify.md

@@ -71,7 +71,7 @@ Wtyczka kieruje swoje działanie na dwie lokalizacje słowników (rozpoznane na
 
 Gdy wtyczka `intlayerPrune` przeanalizuje bazę kodu i uzupełni `pruneContext.dictionaryKeyToFieldRenameMap`, wtyczka `intlayerMinify` również zmienia nazwy pól zawartości na krótkie aliasy. Na przykład:
 
-```json
+```jsonc
 // przed
 { "key": "myDict", "content": { "title": "Hello", "description": "World" } }