@intlayer/docs 7.0.6 → 7.0.8-canary.0

package/frequent_questions/pl/get_locale_cookie.md

@@ -0,0 +1,142 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Jak pobrać locale z ciasteczek / nagłówków?
+description: Dowiedz się, jak pobrać locale z ciasteczek / nagłówków.
+keywords:
+  - cookie
+  - headers
+  - intlayer
+  - locale
+  - hook
+  - useLocale
+  - useLocaleCookie
+  - next.js
+  - react-intlayer
+  - vue-intlayer
+slugs:
+  - frequent-questions
+  - get-locale-cookie
+---
+
+# Jak pobrać locale z ciasteczek / nagłówków
+
+## Używanie Hooków (zalecane)
+
+W większości przypadków zaleca się pobieranie aktualnego locale za pomocą hooka `useLocale`, ponieważ jest on automatycznie rozwiązywany. Działa to podobnie jak kompozycja `useLocale` w Vue.js.
+
+```ts
+import { useLocale } from "next-intlayer";
+// or import { useLocale } from "react-intlayer";
+// or import { useLocale } from "vue-intlayer";
+
+// Użycie po stronie klienta
+const { locale } = useLocale();
+```
+
+Dla komponentów serwerowych można zaimportować go z:
+
+```tsx
+import { useLocale } from "next-intlayer/server";
+
+const Test = () => {
+  const { locale } = useLocale();
+  return <>{locale}</>;
+};
+
+const Page = async ({ params }) => {
+  const { locale } = await params;
+
+  return (
+    <IntlayerServerProvider locale={locale}>
+      <Test />
+    </IntlayerServerProvider>
+  );
+};
+```
+
+Istnieje również hook `useLocaleCookie`, który rozwiązuje tylko wartość ciasteczka.
+
+## Ręczna konfiguracja ciasteczek
+
+Możesz zadeklarować niestandardową nazwę ciasteczka jako
+
+```ts
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  middleware: {
+    cookieName: "myCustomLocaleCookie", // domyślnie 'intlayer-locale'
+  },
+};
+
+export default config;
+```
+
+następnie pobierz ją jako
+
+### Po stronie klienta
+
+```ts
+// Używając domyślnej nazwy ciasteczka
+const locale = document.cookie
+  .split("; ")
+  .find((row) => row.startsWith("intlayer-locale="))
+  ?.split("=")[1];
+
+// Używając niestandardowej nazwy ciasteczka
+const locale = document.cookie
+  .split("; ")
+  .find((row) => row.startsWith("myCustomLocaleCookie="))
+  ?.split("=")[1];
+```
+
+### Po stronie serwera (Next.js)
+
+```ts
+import { cookies } from "next/headers";
+
+// Używając domyślnej nazwy ciasteczka
+const locale = cookies().get("intlayer-locale")?.value;
+
+// Używając niestandardowej nazwy ciasteczka
+const locale = cookies().get("myCustomLocaleCookie")?.value;
+```
+
+### Jeśli locale nie jest jeszcze ustawione
+
+Locale jest ustawiana jako ciasteczko tylko wtedy, gdy użytkownik wyraźnie wybierze locale. Domyślnie, dla nowych odwiedzających, locale jest interpretowana na podstawie pól nagłówków.
+
+Możesz wykryć preferowane locale użytkownika na podstawie nagłówków żądania. Oto przykład, jak to obsłużyć:
+
+```ts
+/**
+ * Wykrywa locale na podstawie nagłówków żądania
+ *
+ * Nagłówek accept-language jest najważniejszy przy wykrywaniu locale.
+ * Zawiera listę kodów języków wraz z wartościami jakości (q-values), które wskazują
+ * preferencje językowe użytkownika w kolejności preferencji.
+ *
+ * Przykład: "en-US,en;q=0.9,fr;q=0.8,es;q=0.7"
+ * - en-US jest językiem podstawowym (q=1.0 jest domyślne)
+ * - en jest drugim wyborem (q=0.9)
+ * - fr jest trzecim wyborem (q=0.8)
+ * - es jest czwartym wyborem (q=0.7)
+ */
+import { localeDetector } from "@intlayer/core";
+
+/**
+ * Przykład nagłówków negocjatora, które przeglądarki zazwyczaj wysyłają
+ * Te nagłówki pomagają określić preferowany język użytkownika
+ */
+const exampleNegotiatorHeaders: Record<string, string> = {
+  "accept-language": "en-US,en;q=0.9,fr;q=0.8,es;q=0.7",
+  "accept":
+    "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
+  "user-agent":
+    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
+};
+
+// Przykład użycia:
+const detectedLocale = localeDetector(exampleNegotiatorHeaders);
+```

package/frequent_questions/pl/intlayer_command_undefined.md

@@ -0,0 +1,155 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Komenda Intlayer niezdefiniowana
+description: Dowiedz się, jak naprawić błąd niezdefiniowanej komendy intlayer.
+keywords:
+  - intlayer
+  - komenda
+  - niezdefiniowana
+  - błąd
+  - vscode
+  - rozszerzenie
+  - wtyczka
+  - framework
+  - next.js
+  - vite
+slugs:
+  - frequent-questions
+  - intlayer-command-undefined
+---
+
+# Komenda Intlayer niezdefiniowana
+
+## Przegląd
+
+CLI Intlayer zapewnia wygodny sposób zarządzania zawartością intlayer, w tym budowanie słowników, przesyłanie tłumaczeń i inne. Jednak nie jest to niezbędne do działania Twojego projektu. Jeśli używasz wtyczki bundlera (takiej jak `withIntlayer()` dla Next.js lub `intlayer()` dla Vite), Intlayer automatycznie zbuduje słowniki podczas budowania aplikacji lub uruchamiania serwera deweloperskiego. W trybie deweloperskim będzie również monitorować zmiany i automatycznie przebudowywać pliki deklaracji zawartości.
+
+Możesz uzyskać dostęp do poleceń intlayer na różne sposoby:
+
+- Używając bezpośrednio polecenia CLI `intlayer`
+- Korzystając z [rozszerzenia VSCode](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/vs_code_extension.md)
+- Używając SDK `@intlayer/cli`
+
+## Problem
+
+Podczas próby użycia polecenia `intlayer` możesz napotkać ten błąd:
+
+```bash
+'intlayer' nie jest rozpoznawany jako polecenie wewnętrzne lub zewnętrzne,
+program wykonywalny lub plik wsadowy.
+```
+
+## Rozwiązania
+
+Wypróbuj te rozwiązania w kolejności:
+
+1. **Sprawdź, czy polecenie jest zainstalowane**
+
+```bash
+npx intlayer -h
+```
+
+Oczekiwany wynik:
+
+```bash
+Usage: intlayer [options] [command]
+
+Intlayer CLI
+
+Options:
+    -V, --version            wyświetl numer wersji
+    -h, --help               wyświetl pomoc dla polecenia
+
+Commands:
+    dictionary|dictionaries  operacje na słownikach
+    configuration|config     operacje konfiguracyjne
+    help [command]           wyświetl pomoc dla polecenia
+```
+
+2. **Zainstaluj globalnie pakiet intlayer-cli**
+
+```bash
+npm install intlayer-cli -g -g
+```
+
+> Nie powinno to być konieczne, jeśli już zainstalowałeś pakiet `intlayer`
+
+3. **Zainstaluj pakiet globalnie**
+
+```bash
+npm install intlayer -g
+```
+
+4. **Uruchom ponownie terminal**  
+   Czasami konieczne jest ponowne uruchomienie terminala, aby rozpoznał nowe polecenia.
+
+5. **Wyczyść i zainstaluj ponownie**  
+   Jeśli powyższe rozwiązania nie działają:
+
+```bash
+rm -rf node_modules package-lock.json
+npm install
+```
+
+6. **Zweryfikuj pliki instalacyjne**  
+   Jeśli problem nadal występuje, sprawdź, czy istnieją następujące pliki:
+   - `node_modules/intlayer/dist/cjs/cli.cjs`
+   - `node_modules/intlayer/package.json` (powinien zawierać pole `bin` wskazujące na `./dist/cjs/cli.cjs`)
+
+7. **Sprawdź zmienną środowiskową PATH**  
+   Upewnij się, że globalny katalog binarny npm jest w Twojej zmiennej PATH:
+
+```bash
+# Dla systemów Unix (macOS/Linux)
+echo $PATH
+# Powinno zawierać coś w stylu /usr/local/bin lub ~/.npm-global/bin
+
+# Dla Windows
+echo %PATH%
+# Powinno zawierać katalog globalny bin npm
+```
+
+8. **Użyj npx z pełną ścieżką**  
+   Jeśli polecenie nadal nie jest znalezione, spróbuj użyć npx z pełną ścieżką:
+
+```bash
+npx ./node_modules/intlayer/ dictionaries build
+```
+
+9. **Sprawdź konflikty instalacji**
+
+```bash
+# Wyświetl wszystkie globalnie zainstalowane pakiety
+npm list -g --depth=0
+
+# Usuń wszelkie konfliktujące globalne instalacje
+npm uninstall -g intlayer
+npm uninstall -g intlayer-cli
+# Następnie zainstaluj ponownie
+npm install -g intlayer
+```
+
+10. **Zweryfikuj wersje Node.js i npm**  
+    Upewnij się, że używasz kompatybilnych wersji:
+
+```bash
+node --version
+npm --version
+```
+
+    Jeśli używasz przestarzałej wersji, rozważ aktualizację Node.js i npm.
+
+11. **Sprawdź problemy z uprawnieniami**  
+    Jeśli pojawiają się błędy związane z uprawnieniami:
+
+    ```bash
+    # Dla systemów opartych na Unix
+    sudo npm install -g intlayer
+
+    # Lub zmień domyślny katalog npm
+    mkdir ~/.npm-global
+    npm config set prefix '~/.npm-global'
+    # Dodaj do swojego ~/.profile lub ~/.bashrc:
+    export PATH=~/.npm-global/bin:$PATH
+    ```

package/frequent_questions/pl/locale_incorect_in_url.md

@@ -0,0 +1,73 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Niepoprawny lokalizator pobrany z URL
+description: Dowiedz się, jak naprawić problem z niepoprawnym lokalizatorem pobieranym z URL.
+keywords:
+  - locale
+  - url
+  - intlayer
+  - next.js
+  - vite
+  - framework
+  - middleware
+  - configuration
+  - prefixDefault
+  - noPrefix
+slugs:
+  - frequent-questions
+  - locale-incorect-in-url
+---
+
+# Niepoprawny lokalizator pobrany z URL
+
+## Opis problemu
+
+Podczas próby uzyskania parametru locale z URL możesz napotkać problem, gdzie wartość locale jest niepoprawna:
+
+```js
+const { locale } = await params;
+console.log(locale); // zwraca "about" zamiast oczekiwanego lokalizatora
+```
+
+## Rozwiązanie
+
+### 1. Sprawdź strukturę plików
+
+Upewnij się, że ścieżka routera aplikacji Next.js ma następującą strukturę:
+
+```bash
+src/app/[locale]/about/page.tsx
+```
+
+### 2. Sprawdź konfigurację middleware
+
+Problem często występuje, gdy middleware nie jest obecny lub nie jest wywoływany. Plik middleware powinien znajdować się w lokalizacji:
+
+```bash
+src/middleware.ts
+```
+
+Ten middleware odpowiada za przepisywanie tras, gdy `prefixDefault` jest ustawione na `false`. Na przykład, przepisuje `/en/about` na `/about`.
+
+### 3. Wzorce URL w zależności od konfiguracji
+
+#### Domyślna konfiguracja (`prefixDefault: false`, `noPrefix: false`)
+
+- Angielski: `/about`
+- Francuski: `/fr/about`
+- Hiszpański: `/es/about`
+
+#### Z `prefixDefault: true`
+
+- Angielski: `/en/about`
+- Francuski: `/fr/about`
+- Hiszpański: `/es/about`
+
+#### Z `noPrefix: true`
+
+- Angielski: `/about`
+- Francuski: `/about`
+- Hiszpański: `/about`
+
+Aby uzyskać więcej informacji na temat tych opcji konfiguracji, zobacz [Dokumentację Konfiguracji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md).

package/frequent_questions/pl/static_rendering.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Statyczne vs dynamiczne renderowanie z i18n w Next.js
+description: Dowiedz się, jak używać statycznego i dynamicznego renderowania z i18n w Next.js.
+keywords:
+  - statyczne
+  - dynamiczne
+  - renderowanie
+  - i18n
+  - next.js
+  - next-intl
+  - intlayer
+  - framework
+  - middleware
+  - konfiguracja
+slugs:
+  - frequent-questions
+  - static-rendering
+---
+
+# Statyczne vs dynamiczne renderowanie z i18n w Next.js
+
+## Problem z **next-intl**
+
+- **Co się dzieje?**
+  Gdy używasz `useTranslations`, `getTranslations` lub jakiegokolwiek helpera next-intl _wewnątrz komponentu serwerowego_ w aplikacji z trasowaniem i18n (`/en/…`, `/fr/…`), Next.js oznacza całą trasę jako **dynamiczną**. ([Next Intl][1])
+
+- **Dlaczego?**
+  next-intl odczytuje bieżący locale z nagłówka dostępnego tylko w żądaniu (`x-next-intl-locale`) za pomocą `headers()`. Ponieważ `headers()` jest **dynamicznym API**, każdy komponent, który z niego korzysta, traci optymalizację statyczną. ([Next Intl][1], [Next.js][2])
+
+- **Oficjalne obejście (boilerplate)**
+  1. Eksportuj `generateStaticParams` dla każdego obsługiwanego locale.
+  2. Wywołaj `setRequestLocale(locale)` w **każdym** layoucie/stronie _przed_ wywołaniem `useTranslations`. ([Next Intl][1])
+     To usuwa zależność od nagłówka, ale teraz masz dodatkowy kod do utrzymania oraz niestabilne API w produkcji.
+
+## Jak **intlayer** omija ten problem
+
+**Wybory projektowe**
+
+1. **Tylko parametr trasy** – Locale pochodzi z segmentu URL `[locale]`, który Next.js już przekazuje do każdej strony.
+2. **Pakiety w czasie kompilacji** – Tłumaczenia są importowane jako zwykłe moduły ES, dzięki czemu są poddawane tree-shakingowi i osadzane podczas budowania.
+3. **Brak dynamicznych API** – `useT()` odczytuje dane z kontekstu React, a nie z `headers()` czy `cookies()`.
+4. **Zero dodatkowej konfiguracji** – Gdy Twoje strony znajdują się pod `app/[locale]/`, Next.js automatycznie prerenderuje jeden plik HTML na locale.

package/frequent_questions/pl/translated_path_url.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Czy mogę przetłumaczyć ścieżkę URL?
+description: Dowiedz się, jak przetłumaczyć ścieżkę URL.
+keywords:
+  - tablica
+  - zawartość
+  - deklaracja
+  - intlayer
+  - middleware
+  - proxy
+  - przepisywanie
+  - prefiks
+  - lokalizacja
+  - url
+slugs:
+  - frequent-questions
+  - translated-path-url
+---
+
+# Czy możliwe jest przetłumaczenie URL w następujący sposób:
+
+```bash
+en -> /product (bez prefiksu) lub /en/product (z prefiksem)
+fr -> /fr/produit
+es -> /es/producto
+```
+
+Niestety Intlayer nie pozwala na tłumaczenie URLi w podany sposób. Aby to osiągnąć, powinieneś użyć własnego middleware lub proxy do przepisywania URLi.
+
+Możesz jednak użyć funkcji `getMultilingualUrl`, aby wstawić prefiks w URL dla danej lokalizacji.
+
+```ts
+import { getMultilingualUrl, Locales } from "intlayer";
+
+const url = getMultilingualUrl("/product");
+
+/**
+ * en -> /product (bez prefiksu) lub /en/product (z prefiksem)
+ * fr -> /fr/product
+ * es -> /es/product
+ */
+console.log(url);
+```
+
+Lub `getLocalizedUrl`
+
+```ts
+import { getLocalizedUrl, Locales } from "intlayer";
+
+const url = getLocalizedUrl("/product", Locales.FRENCH);
+
+console.log(url); // /fr/product
+```

package/frequent_questions/pl/unknown_command.md

@@ -0,0 +1,97 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Nieznane polecenie
+description: Dowiedz się, jak naprawić błąd nieznanego polecenia.
+keywords:
+  - nieznane
+  - polecenie
+  - błąd
+  - intlayer
+  - fill
+  - build
+  - verbose
+  - terminal
+  - restart
+  - lokalny
+slugs:
+  - frequent-questions
+  - unknown-command
+---
+
+# błąd: nieznane polecenie fill / build / itp.
+
+Jeśli `npx intlayer fill --verbose` zwraca:
+
+```
+error: unknown command 'fill'
+```
+
+ale jesteś pewien, że polecenie `fill` _powinno_ istnieć, oto kroki, aby to rozwiązać:
+
+## 1. **Upewnij się, że używasz najnowszej wersji**
+
+Uruchom:
+
+```bash
+npx intlayer --version                  # aktualna lokalna wersja intlayer
+npx intlayer@latest --version           # aktualna najnowsza wersja intlayer
+```
+
+To wymusza na `npx` pobranie najnowszej wersji. Następnie spróbuj ponownie:
+
+```bash
+npx intlayer@latest build --verbose
+```
+
+## 2. **Sprawdź, czy polecenie jest zarejestrowane**
+
+Możesz to sprawdzić za pomocą:
+
+```bash
+npx intlayer --help                     # wyświetla informacje dotyczące poleceń
+```
+
+Sprawdź, czy polecenie pojawia się na liście poleceń.
+
+Przejdź do repozytorium i potwierdź, że Twoje polecenie jest eksportowane i zarejestrowane w punkcie wejścia CLI. Intlayer używa frameworka `commander`.
+
+Kod dotyczący CLI:
+https://github.com/aymericzip/intlayer/blob/main/packages/%40intlayer/cli/src/cli.ts
+
+## 4. **Uruchom ponownie terminal**
+
+Czasami konieczne jest ponowne uruchomienie terminala, aby rozpoznał nowe polecenia.
+
+## 5. **Jeśli rozwijasz `intlayer`, przebuduj i połącz go**
+
+Jeśli rozwijasz `intlayer` lokalnie:
+
+```bash
+# W katalogu intlayer
+npm install
+npm run build
+npm link
+```
+
+Następnie w innym terminalu:
+
+```bash
+intlayer fill --verbose
+```
+
+To używa lokalnej wersji nad którą pracujesz.
+
+## 6. **Wyczyść pamięć podręczną npx (jeśli utknąłeś na starszej wersji)**
+
+```bash
+npx clear-npx-cache
+```
+
+Lub ręcznie usuń pamięć podręczną pakietów intlayer:
+
+```bash
+rm -rf ~/.npm/_npx
+```
+
+Sprawdź odpowiednik, jeśli używasz pnpm, yarn, bun lub innego menedżera pakietów

package/frequent_questions/pt/SSR_Next_no_[locale].md

@@ -15,8 +15,7 @@ keywords:
   - prefixDefault
   - noPrefix
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - ssr-next-no-[locale]
 ---
 

package/frequent_questions/pt/array_as_content_declaration.md

@@ -9,8 +9,7 @@ keywords:
   - declaração
   - intlayer
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - array-as-content-declaration
 ---
 

package/frequent_questions/pt/build_dictionaries.md

@@ -15,8 +15,7 @@ keywords:
   - next.js
   - vite
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - build-dictionaries
 ---
 

package/frequent_questions/pt/build_error_CI_CD.md

@@ -15,8 +15,7 @@ keywords:
   - prebuild
   - automação
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - build-error-ci-cd
 ---
 

package/frequent_questions/pt/bun_set_up.md

@@ -10,8 +10,7 @@ keywords:
   - configuração
   - gerenciador de pacotes
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - bun-set-up
 ---
 

package/frequent_questions/pt/customized_locale_list.md

@@ -15,8 +15,7 @@ keywords:
   - idioma
   - lista
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - customized-locale-list
 ---
 

package/frequent_questions/pt/domain_routing.md

@@ -15,8 +15,7 @@ keywords:
   - vite
   - framework
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - domain-routing
 ---
 

package/frequent_questions/pt/esbuild_error.md

@@ -14,8 +14,7 @@ keywords:
   - react-native
   - lynx
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - esbuild-error
 ---
 

package/frequent_questions/pt/get_locale_cookie.md

@@ -15,8 +15,7 @@ keywords:
   - react-intlayer
   - vue-intlayer
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - get-locale-cookie
 ---
 

package/frequent_questions/pt/intlayer_command_undefined.md

@@ -15,8 +15,7 @@ keywords:
   - next.js
   - vite
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - intlayer-command-undefined
 ---
 

package/frequent_questions/pt/locale_incorect_in_url.md

@@ -15,8 +15,7 @@ keywords:
   - prefixDefault
   - noPrefix
 slugs:
-  - doc
-  - faq
+  - frequent-questions
   - locale-incorect-in-url
 ---