@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.21

package/blog/pl/___per-component_vs_centralized_i18n.md

@@ -0,0 +1,100 @@
+---
+createdAt: 2025-09-10
+updatedAt: 2025-09-10
+title: "Per-Component vs. Centralized i18n: Nowe podejście z Intlayer"
+description: Dogłębne porównanie strategii internacjonalizacji w React, porównanie podejść scentralizowanych, per-key i per-component, oraz wprowadzenie Intlayer.
+keywords:
+  - i18n
+  - React
+  - Internationalization
+  - Intlayer
+  - Optimization
+  - Bundle Size
+slugs:
+  - blog
+  - per-component-vs-centralized-i18n
+author:
+  name: Aymeric PINEAU
+  github: aymericzip
+---
+
+# Per-Component vs. Centralized i18n
+
+Jestem twórcą Intlayer, rozwiązania i18n, które przyjmuje **podejście per-component**.
+
+Podejście per-component nie jest dokładnie nowe.
+Po stronie Vue, `vue-i18n` ma podejście ['Single File Components'](https://vue-i18n.intlify.dev/guide/advanced/sfc.html). Istnieje również w Nuxt z tłumaczeniami per-component [tutaj](https://i18n.nuxtjs.org/docs/guide/per-component-translations).
+
+Nawet w aplikacji Flutter możemy często znaleźć ten wzorzec:
+
+```bash
+lib/
+├── features/
+│   ├── login/
+│   │   ├── login_screen.dart
+│   │   └── login_screen.i18n.dart  <- Tłumaczenia żyją tutaj
+
+```
+
+```dart
+import 'package:i18n_extension/i18n_extension.dart';
+
+extension Localization on String {
+  static var _t = Translations("en_us") +
+      {
+        "en_us": "Hello",
+        "pt_br": "Olá",
+        "es": "Hola",
+      };
+
+  String get i18n => localize(this, _t);
+}
+
+```
+
+Niemniej jednak, w świecie React, głównie widzimy różne podejścia, które pogrupuję w trzy kategorie:
+
+1. **Podejście scentralizowane** (i18next, next-intl, react-intl, lingui)
+2. **Podejście per-component** (Intlayer)
+3. **Podejście per-key** (inlang)
+
+W tym blogu nie będę skupiać się na rozwiązaniach bazujących na kompilatorze, które już omówiłem tutaj: [Compiler vs Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/en/compiler_vs_declarative_i18n.md).
+Zauważ, że compiler-based i18n (np. Lingui) po prostu automatyzuje ekstrakcję i ładowanie zawartości. Za kulisami, często dzielą te same ograniczenia co podejście scentralizowane.
+
+Co zatem są różnice?
+
+- **Podejście scentralizowane** (bez namespaces) rozważa pojedyncze źródło do pobierania zawartości. Domyślnie ładujesz zawartość wszystkich stron przy załadowaniu aplikacji.
+- **Podejścia per-component i per-key** drobniutko dzielą pobieranie zawartości.
+
+> Zauważ, że im bardziej dzielisz jak pobierasz zawartość, tym bardziej ryzykujesz wstawiać dodatkowy stan i logikę do komponentów.
+> Na przykład, strona może łatwo zawierać 500 węzłów tekstu (`<p>`, `<span>`). Podejście per-key efektywnie wstawi 500 nowych instancji komponentu aby obsłużyć tłumaczenie, każde potencjalnie używając własnego `useState`, `useEffect`, lub `useContext`.
+
+Tutaj jest wizualizacja kompromisu:
+
+```bash
+Count of useState / Overhead (100 blocks <p> / 10 components)
+100 | x Per-key
+    |
+    |
+    ...
+    |
+    |
+    |
+    |
+ 10 |  x Per-component
+    |
+  1 |                                           x Centralized
+    |-------------------------------------------------------->
+    0                                          900     1000
+           % of unused content (Based on 10 unique pages)
+
+```
+
+Równolegle, powinieneś wiedzieć, że gdy dynamicznie ładujesz zawartość (`await import()`), skończysz z dodatkowymi żądaniami do serwera. Jedno dodatkowe `useState` lub hook odnosi się do jednego dodatkowego żądania do serwera.
+
+> Aby naprawić ten punkt, Intlayer sugeruje grupowanie wielu definicji zawartości pod tym samym kluczem, Intlayer będzie wtedy scalać tę zawartość.
+
+### Dlaczego zatem podejście scentralizowane jest tak popularne?
+
+- Najpierw, i18next była pierwszym rozwiązaniem, które stało się szeroko stosowane, podążając za podejściem inspirowanym PHP i Java, które opierają się na wyraźnej separacji obaw (MVP). i18next przybył nawet przed trendem frameworków frontendowych i architektury opartej na komponentach.
+- Następnie, gdy biblioteka jest szeroko przyjęta, trudno jest przesunąć ekosystem do innych wzorców.

package/blog/pl/internationalization_and_SEO.md

@@ -88,101 +88,10 @@ W swoim HTML dodasz coś takiego:
 
 ## 4. Tworzenie prawdziwie „lokalnych” treści (nie tylko tłumaczonych)
 
-### 4.1. Lokalizacja a Tłumaczenie
-
-- **Tłumaczenie** oznacza przekształcenie tekstu z jednego języka na drugi słowo w słowo.
-- **Lokalizacja** oznacza dostosowanie formatu treści, waluty, jednostek miar oraz odniesień kulturowych do lokalnej publiczności. Na przykład, jeśli kierujesz się do Francji, użyjesz `€` zamiast `---
-  createdAt: 2024-12-24
-  updatedAt: 2025-06-29
-  title: SEO i internacjonalizacja
-  description: Odkryj, jak zoptymalizować swoją wielojęzyczną stronę internetową pod kątem wyszukiwarek i poprawić SEO.
-  keywords:
-  - SEO
-  - Intlayer
-  - Internacjonalizacja
-  - Blog
-  - Next.js
-  - JavaScript
-  - React
-    slugs:
-  - blog
-  - SEO-and-i18n
-
----
-
-# SEO i I18n: Kompletny przewodnik po tworzeniu wielojęzycznej strony internetowej
-
-Chcesz dotrzeć do większej liczby użytkowników na całym świecie? Uczynienie swojej strony internetowej wielojęzyczną to jeden z najlepszych sposobów na rozszerzenie odbiorców i poprawę SEO (Search Engine Optimization). W tym wpisie na blogu wyjaśnimy podstawy międzynarodowego SEO, często określanego jako **i18n** (skrót od „internationalization”), w jasny i zrozumiały sposób. Dowiesz się o kluczowych decyzjach, które musisz podjąć, jak korzystać z elementów technicznych takich jak `hreflang` oraz dlaczego narzędzia takie jak **Intlayer** mogą uprościć Twoje wielojęzyczne projekty Next.js.
-
----
-
-## 1. Co oznacza uczynienie Twojej strony wielojęzyczną?
-
-Strona wielojęzyczna oferuje swoje treści w więcej niż jednym języku. Na przykład możesz mieć wersję angielską (`example.com/en/`), wersję francuską (`example.com/fr/`) oraz wersję hiszpańską (`example.com/es/`). Takie podejście pozwala wyszukiwarkom wyświetlać użytkownikom odpowiednią wersję językową na podstawie ich preferencji lub lokalizacji geograficznej.
-
-Jeśli zrobisz to poprawnie, stworzysz znacznie bardziej przyjazne doświadczenie dla użytkowników nieposługujących się językiem angielskim, co prowadzi do lepszego zaangażowania, wyższych wskaźników konwersji oraz poprawy SEO w różnych regionach.
-
----
-
-## 2. Wybór odpowiedniej struktury URL
-
-Jeśli zdecydujesz się na posiadanie wielu wersji językowych, będziesz potrzebować jasnego i spójnego sposobu organizacji adresów URL swojej strony. Każdy język (lub region) powinien mieć swój unikalny „adres” w internecie. Poniżej przedstawiono trzy popularne sposoby strukturyzacji stron wielojęzycznych:
-
-1. Domeny najwyższego poziomu z kodem kraju (ccTLD)
-   - Przykład: `example.fr`, `example.de`
-   - **Zalety:** Wysyła silny sygnał do wyszukiwarek, do którego kraju skierowane są treści (np. `.fr` = Francja).
-   - **Wady:** Zarządzanie wieloma domenami może być droższe i bardziej skomplikowane.
-
-2. **Subdomeny**
-   - **Przykład:** `fr.example.com`, `de.example.com`
-   - **Zalety:** Każdy język „mieszka” na własnej subdomenie, co ułatwia dodawanie lub usuwanie języków.
-   - **Wady:** Wyszukiwarki czasami traktują subdomeny jako oddzielne witryny, co może osłabić autorytet głównej domeny.
-
-3. **Podkatalogi (podfoldery)**
-   - **Przykład:** `example.com/fr/`, `example.com/de/`
-   - **Zalety:** Łatwe w zarządzaniu, a cały ruch kierowany jest do jednej głównej domeny.
-   - **Wady:** Nie daje tak silnego sygnału SEO lokalnego jak ccTLD (choć nadal jest bardzo skuteczne, jeśli jest dobrze wdrożone).
-
-> **Wskazówka:** Jeśli masz globalną markę i chcesz uprościć sprawy, podkatalogi często sprawdzają się najlepiej. Jeśli celujesz tylko w jeden lub dwa główne kraje i chcesz naprawdę podkreślić każdy z nich, ccTLD może być lepszym rozwiązaniem.
-
----
-
-## 3. Opanowanie targetowania językowego za pomocą Hreflang
-
 ### 3.1. Czym jest Hreflang?
 
 Kiedy masz identyczne lub bardzo podobne treści w wielu językach, wyszukiwarki takie jak Google mogą mieć trudności z określeniem, którą wersję wyświetlić użytkownikowi. **Hreflang** to atrybut HTML, który informuje wyszukiwarki, dla jakiego języka (i regionu) przeznaczona jest dana strona oraz jakie są alternatywne wersje językowe/regionowe.
 
-### 3.2. Dlaczego to jest ważne?
-
-1. Zapobiega problemom z **duplikacją treści** (gdy wyszukiwarki myślą, że publikujesz tę samą treść wielokrotnie).
-2. Zapewnia, że **użytkownicy francuscy zobaczą wersję francuską**, **użytkownicy hiszpańscy wersję hiszpańską** i tak dalej.
-3. Poprawia ogólne doświadczenie użytkownika, co oznacza lepsze zaangażowanie i wyższą pozycję w SEO.
-
-### 3.3. Jak używać Hreflang w tagu `<head>`
-
-W swoim HTML dodasz coś takiego:
-
-```html
-<link rel="alternate" hreflang="en" href="https://example.com/en" />
-<link rel="alternate" hreflang="fr" href="https://example.com/fr" />
-<link rel="alternate" hreflang="es" href="https://example.com/es" />
-<link rel="alternate" hreflang="x-default" href="https://example.com/en" />
-```
-
-- **`hreflang="en"`**: Wskazuje angielską wersję strony.
-- **`hreflang="fr"`**: Wskazuje francuską wersję strony.
-- **`hreflang="es"`**: Wskazuje hiszpańską wersję strony.
-- **`hreflang="x-default"`**: „Język zapasowy” lub domyślny URL, gdy żadna z innych wersji językowych nie pasuje do preferencji użytkownika.
-
-> **Szybka uwaga:** Upewnij się, że adresy URL w tych tagach prowadzą bezpośrednio do ostatecznej strony, bez **dodatkowych** przekierowań.
-
----
-
-## 4. Tworzenie prawdziwie „lokalnych” treści (nie tylko tłumaczonych)
-
-i możesz wspomnieć o lokalnych świętach lub szczegółach specyficznych dla regionu.
-
 ### 4.2. Unikanie Duplikatów Treści
 
 Nawet przy dobrych tłumaczeniach, wyszukiwarki mogą oznaczyć Twoją stronę jako duplikat, jeśli struktura jest zbyt podobna. Hreflang pomaga wyjaśnić, że te strony nie są duplikatami, lecz wariantami językowymi.
@@ -355,6 +264,12 @@ const LocaleSwitcher: FC = () => {
 
 ---
 
+## Przeprowadź audyt swojej witryny za pomocą Intlayer SEO Scanner
+
+Aby upewnić się, że Twoja wielojęzyczna aplikacja jest idealnie zoptymalizowana, zalecamy skorzystanie z [Intlayer SEO Scanner](https://intlayer.org/i18n-seo-scanner). Jest to specjalistyczne narzędzie do sprawdzania wielojęzycznych witryn, pomagające zidentyfikować brakujące tagi hreflang, uszkodzone linki i inne problemy związane z SEO na wszystkich zlokalizowanych stronach.
+
+---
+
 ## Podsumowanie
 
 Uczynienie Twojej strony internetowej wielojęzyczną to coś więcej niż tylko tłumaczenie tekstu. Chodzi o efektywne strukturyzowanie URL-i, używanie tagów `hreflang`, które pomagają wyszukiwarkom serwować właściwą wersję, oraz zapewnienie doskonałego doświadczenia użytkownika, obejmującego zlokalizowane elementy wizualne, selektory języka i spójną nawigację. Stosowanie się do tych najlepszych praktyk zapewni Ci sukces na rynkach globalnych, zwiększy satysfakcję użytkowników i ostatecznie przyniesie lepsze wyniki SEO w różnych regionach.

package/blog/pl/intlayer_with_i18next.md

@@ -34,6 +34,10 @@ author: aymericzip
 
 <iframe title="Jak zautomatyzować tłumaczenia JSON i18next za pomocą Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
+## Spis treści
+
+<TOC/>
+
 ## Czym jest Intlayer?
 
 **Intlayer** to innowacyjna, otwartoźródłowa biblioteka do internacjonalizacji, zaprojektowana, aby rozwiązać niedoskonałości tradycyjnych rozwiązań i18n. Oferuje nowoczesne podejście do zarządzania treścią w aplikacjach JavaScript.
@@ -65,24 +69,44 @@ Ten przewodnik pokazuje, jak wykorzystać zaawansowany system deklaracji treści
 
 Zainstaluj niezbędne pakiety:
 
+```bash packageManager="npm"
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
+```
+
+> flaga `--interactive` jest opcjonalna. Użyj `intlayer-cli init`, jeśli jesteś agentem AI.
+
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **Opis pakietów:**

package/blog/pl/intlayer_with_next-i18next.md

@@ -34,17 +34,6 @@ author: aymericzip
 
 <TOC/>
 
-## Czym jest next-i18next?
-
-**next-i18next** jest jednym z najpopularniejszych frameworków do internacjonalizacji (i18n) dla aplikacji Next.js. Zbudowany na bazie potężnego ekosystemu **i18next**, oferuje kompleksowe rozwiązanie do zarządzania tłumaczeniami, lokalizacją oraz przełączaniem języków w projektach Next.js.
-
-Jednak next-i18next wiąże się z pewnymi wyzwaniami:
-
-- **Złożona konfiguracja**: Konfiguracja next-i18next wymaga wielu plików konfiguracyjnych oraz starannego ustawienia instancji i18n po stronie serwera i klienta.
-- **Rozproszone tłumaczenia**: Pliki tłumaczeń są zazwyczaj przechowywane w oddzielnych katalogach od komponentów, co utrudnia utrzymanie spójności.
-- **Ręczne zarządzanie przestrzeniami nazw**: Programiści muszą ręcznie zarządzać przestrzeniami nazw i zapewniać poprawne ładowanie zasobów tłumaczeniowych.
-- **Ograniczone bezpieczeństwo typów**: Wsparcie dla TypeScript wymaga dodatkowej konfiguracji i nie zapewnia automatycznego generowania typów dla tłumaczeń.
-
 ## Czym jest Intlayer?
 
 **Intlayer** to innowacyjna, otwartoźródłowa biblioteka do internacjonalizacji, zaprojektowana w celu rozwiązania niedoskonałości tradycyjnych rozwiązań i18n. Oferuje nowoczesne podejście do zarządzania treścią w aplikacjach Next.js.
@@ -73,24 +62,44 @@ Ten przewodnik pokazuje, jak wykorzystać zaawansowany system deklaracji treści
 
 Zainstaluj niezbędne pakiety, używając preferowanego menedżera pakietów:
 
+```bash packageManager="npm"
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
+```
+
+> flaga `--interactive` jest opcjonalna. Użyj `intlayer-cli init`, jeśli jesteś agentem AI.
+
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **Wyjaśnienie pakietów:**

package/blog/pl/intlayer_with_next-intl.md

@@ -29,6 +29,10 @@ author: aymericzip
 
 <iframe title="Jak zautomatyzować tłumaczenia JSON next-intl za pomocą Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
+# Spis treści
+
+<TOC/>
+
 ## Czym jest Intlayer?
 
 **Intlayer** to innowacyjna, otwartoźródłowa biblioteka do internacjonalizacji, zaprojektowana, aby rozwiązać niedoskonałości tradycyjnych rozwiązań i18n. Oferuje nowoczesne podejście do zarządzania treścią w aplikacjach Next.js.
@@ -60,24 +64,44 @@ Ten przewodnik pokazuje, jak wykorzystać zaawansowany system deklaracji treści
 
 Zainstaluj niezbędne pakiety:
 
+```bash packageManager="npm"
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
+```
+
+> flaga `--interactive` jest opcjonalna. Użyj `intlayer-cli init`, jeśli jesteś agentem AI.
+
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **Opis pakietów:**

package/blog/pl/intlayer_with_react-i18next.md

@@ -63,24 +63,44 @@ Ten przewodnik pokazuje, jak wykorzystać zaawansowany system deklaracji treści
 
 Zainstaluj niezbędne pakiety:
 
+```bash packageManager="npm"
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
+```
+
+> flaga `--interactive` jest opcjonalna. Użyj `intlayer-cli init`, jeśli jesteś agentem AI.
+
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **Opis pakietów:**

package/blog/pl/intlayer_with_react-intl.md

@@ -61,24 +61,44 @@ Ten przewodnik pokazuje, jak wykorzystać zaawansowany system deklaracji treści
 
 Zainstaluj niezbędne pakiety:
 
+```bash packageManager="npm"
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
+```
+
+> flaga `--interactive` jest opcjonalna. Użyj `intlayer-cli init`, jeśli jesteś agentem AI.
+
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **Opis pakietów:**

package/blog/pl/intlayer_with_vue-i18n.md

@@ -63,24 +63,44 @@ Ten przewodnik pokazuje, jak wykorzystać zaawansowany system deklaracji treści
 
 Zainstaluj niezbędne pakiety, używając preferowanego menedżera pakietów:
 
+```bash packageManager="npm"
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
+```
+
+> flaga `--interactive` jest opcjonalna. Użyj `intlayer-cli init`, jeśli jesteś agentem AI.
+
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **Wyjaśnienie pakietów:**

package/blog/pl/l10n_platform_alternative/Lokalise.md

@@ -24,6 +24,12 @@ author: aymericzip
 
 <TOC/>
 
+# System Zarządzania Tłumaczeniami
+
+System Zarządzania Tłumaczeniami (TMS) to platforma programowa zaprojektowana w celu automatyzacji i usprawnienia procesu tłumaczenia i lokalizacji (L10n). Tradycyjnie TMS służy jako scentralizowany hub, w którym treść jest przesyłana, organizowana i przydzielana tłumaczom ludziom. Zarządza przepływami pracy, przechowuje pamięć tłumaczeń (aby uniknąć retłumaczenia tego samego zdania dwukrotnie) i obsługuje dostarczanie przetłumaczonych plików z powrotem do deweloperów lub menedżerów treści.
+
+W istocie, TMS historycznie był mostem między technicznym kodem (gdzie żyją ciągi znaków) a ludzkimi lingwistami (którzy rozumieją kulturę).
+
 # Lokalise
 
 Lokalise jest znaczącym graczem we współczesnym krajobrazie TMS. Założony w 2017 roku, pojawił się, aby zrewolucjonizować rynek, koncentrując się mocno na developer experience (DX) i integracji z designem. W przeciwieństwie do starszych konkurentów, Lokalise priorytetowo traktował elegancki interfejs użytkownika, potężne API oraz integracje z narzędziami takimi jak Figma i GitHub, aby zmniejszyć tarcia związane z przesyłaniem plików tam i z powrotem.

package/blog/pl/nextjs-multilingual-seo-comparison.md

@@ -345,6 +345,12 @@ export default robots;
 
 ---
 
+## Przeprowadź audyt swojej witryny za pomocą Intlayer SEO Scanner
+
+Aby upewnić się, że Twoja wielojęzyczna aplikacja jest idealnie zoptymalizowana, zalecamy skorzystanie z [Intlayer SEO Scanner](https://intlayer.org/i18n-seo-scanner). Jest to specjalistyczne narzędzie do sprawdzania wielojęzycznych witryn, pomagające zidentyfikować brakujące tagi hreflang, uszkodzone linki i inne problemy związane z SEO na wszystkich zlokalizowanych stronach.
+
+---
+
 ## Podsumowanie
 
 Poprawne wdrożenie i18n w Next.js to nie tylko tłumaczenie tekstu, ale także upewnienie się, że wyszukiwarki i użytkownicy dokładnie wiedzą, którą wersję Twoich treści wyświetlić.

package/blog/pl/rag_powered_documentation_assistant.md

@@ -317,3 +317,16 @@ A jeśli również eksperymentujesz z RAG, chętnie usłyszę, jak go używasz.
 </Step>
 
 </Steps>
+## Podsumowanie
+
+RAG to jeden z najprostszych i zarazem najpotężniejszych sposobów na uczynienie LLM praktycznymi. Łącząc **retrieval + generation**, możesz zamienić statyczną dokumentację w **inteligentnego asystenta** i jednocześnie uzyskać ciągły strumień informacji o produkcie.
+
+Dla mnie ten projekt pokazał, że RAG to nie tylko techniczny trik. To sposób na transformację dokumentacji w:
+
+- interaktywny system wsparcia
+- kanał do zbierania opinii
+- narzędzie strategii produktu
+
+👉 [Spróbuj demo tutaj](https://intlayer.org/doc/why) 👉 [Sprawdź szablon kodu na GitHubie](https://github.com/aymericzip/smart_doc_RAG)
+
+A jeśli ty też eksperymentujesz z RAG, chętnie usłyszę, jak go wykorzystujesz.

package/blog/pt/internationalization_and_SEO.md

@@ -113,7 +113,7 @@ No seu HTML, você adicionará algo como:
    - Você deve apenas traduzir o texto e os títulos do arquivo.
    - Você não deve alterar a estrutura do arquivo.
    - Você não deve alterar a lógica do código dos elementos de código.
-   - Você deve transformar URLs como `https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/**/*.md` em `https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/**/*.md`
+   - Você deve transformar URLs como `https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/**/*.md` em `https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/**/*.md`
    - Você não deve transformar URLs como `https://github.com/aymericzip/intlayer/blob/main/docs/assets/**/*`
    - Você deve transformar URLs de local como `/**/*` em `/{{locale}}/**/*`
    - Nos elementos de código, a nomeação das variáveis deve ser feita em inglês. Mas os comentários devem ser em português.
@@ -305,6 +305,12 @@ const LocaleSwitcher: FC = () => {
 
 ---
 
+## Audite seu site com o Intlayer SEO Scanner
+
+Para garantir que seu aplicativo multilíngue esteja perfeitamente otimizado, recomendamos o uso do [Intlayer SEO Scanner](https://intlayer.org/i18n-seo-scanner). É uma ferramenta especializada em verificação de sites multilíngues, ajudando você a identificar tags hreflang ausentes, links quebrados e outros problemas de SEO em todas as suas páginas localizadas.
+
+---
+
 ## Conclusão
 
 Tornar seu site multilíngue envolve mais do que apenas traduzir texto. Trata-se de estruturar URLs de forma eficaz, usar tags `hreflang` para ajudar os mecanismos de busca a servir a versão correta, e proporcionar uma experiência excepcional ao usuário, com visuais localizados, seletores de idiomas e navegação consistente. Seguir estas melhores práticas o preparará para o sucesso em mercados globais, aumentará a satisfação do usuário e, em última análise, fornecerá melhores resultados de SEO em várias regiões.