@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.11

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.

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,40 @@ Ten przewodnik pokazuje, jak wykorzystać zaawansowany system deklaracji treści
 
 Zainstaluj niezbędne pakiety:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> 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,40 @@ 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-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> 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,40 @@ Ten przewodnik pokazuje, jak wykorzystać zaawansowany system deklaracji treści
 
 Zainstaluj niezbędne pakiety:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> 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,40 @@ Ten przewodnik pokazuje, jak wykorzystać zaawansowany system deklaracji treści
 
 Zainstaluj niezbędne pakiety:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> 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,40 @@ Ten przewodnik pokazuje, jak wykorzystać zaawansowany system deklaracji treści
 
 Zainstaluj niezbędne pakiety:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> 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,40 @@ 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-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> 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/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.

package/blog/pt/intlayer_with_i18next.md

@@ -34,6 +34,10 @@ author: aymericzip
 
 <iframe title="Como automatizar suas traduções JSON do i18next usando 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"/>
 
+## Sumário
+
+<TOC/>
+
 ## O que é o Intlayer?
 
 **Intlayer** é uma biblioteca inovadora e open-source de internacionalização, projetada para resolver as limitações das soluções tradicionais de i18n. Ela oferece uma abordagem moderna para o gerenciamento de conteúdo em aplicações JavaScript.
@@ -59,28 +63,46 @@ Este guia mostra como aproveitar o sistema superior de declaração de conteúdo
 
 ## Guia passo a passo para configurar o Intlayer com o i18next
 
-### Passo 1: Instalar dependências
+<Steps>
+
+<Step number={1} title="Instalar dependências">
 
 Instale os pacotes necessários:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> a flag `--interactive` é opcional. Use `intlayer-cli init` se você for um agente de IA.
+
+> Este comando detectará seu ambiente e instalará os pacotes necessários. Por exemplo:
+
 ```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
 ```
 
 **Descrição dos pacotes:**
@@ -88,7 +110,9 @@ bun x intlayer init
 - **intlayer**: Biblioteca principal para gerenciamento de internacionalização, declaração de conteúdo e construção
 - **@intlayer/sync-json-plugin**: Plugin para exportar declarações de conteúdo do Intlayer para o formato JSON compatível com i18next
 
-### Passo 2: Implemente o plugin Intlayer para encapsular o JSON
+</Step>
+
+<Step number={2} title="Implemente o plugin Intlayer para encapsular o JSON">
 
 Crie um arquivo de configuração do Intlayer para definir os seus locais suportados:
 
@@ -124,7 +148,9 @@ Se alterações forem feitas usando a CLI para traduzir o JSON, ou usando o CMS,
 
 Para ver mais detalhes sobre o plugin `syncJSON`, consulte a [documentação do plugin syncJSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/plugins/sync-json.md).
 
-### (Opcional) Passo 3: Implementar traduções JSON por componente
+</Step>
+
+<Step number={3} title="Implementar traduções JSON por componente" isOptional={true}>
 
 Por padrão, o Intlayer irá carregar, mesclar e sincronizar tanto os arquivos JSON quanto os arquivos de declaração de conteúdo. Veja [a documentação da declaração de conteúdo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/content_file.md) para mais detalhes. Mas, se preferir, usando um plugin do Intlayer, você também pode implementar o gerenciamento por componente de JSON localizado em qualquer lugar da sua base de código.
 
@@ -167,6 +193,10 @@ Isso carregará todos os arquivos JSON no diretório `src` que correspondem ao p
 
 ---
 
+</Step>
+
+</Steps>
+
 ## Configuração do Git
 
 É recomendado ignorar os arquivos gerados automaticamente pelo Intlayer:

package/blog/pt/intlayer_with_next-i18next.md

@@ -34,17 +34,6 @@ author: aymericzip
 
 <TOC/>
 
-## O que é o next-i18next?
-
-**next-i18next** é um dos frameworks de internacionalização (i18n) mais populares para aplicações Next.js. Construído sobre o poderoso ecossistema **i18next**, ele oferece uma solução abrangente para gerenciar traduções, localização e troca de idiomas em projetos Next.js.
-
-No entanto, o next-i18next apresenta alguns desafios:
-
-- **Configuração complexa**: Configurar o next-i18next requer múltiplos arquivos de configuração e uma configuração cuidadosa das instâncias i18n no lado do servidor e do cliente.
-- **Traduções dispersas**: Os arquivos de tradução geralmente são armazenados em diretórios separados dos componentes, dificultando a manutenção da consistência.
-- **Gerenciamento manual de namespaces**: Os desenvolvedores precisam gerenciar manualmente os namespaces e garantir o carregamento adequado dos recursos de tradução.
-- **Segurança de tipos limitada**: O suporte ao TypeScript requer configuração adicional e não fornece geração automática de tipos para traduções.
-
 ## O que é o Intlayer?
 
 **Intlayer** é uma biblioteca inovadora e de código aberto para internacionalização, projetada para resolver as limitações das soluções tradicionais de i18n. Ela oferece uma abordagem moderna para o gerenciamento de conteúdo em aplicações Next.js.
@@ -67,28 +56,46 @@ Este guia mostra como aproveitar o sistema superior de declaração de conteúdo
 
 ## Guia Passo a Passo para Configurar o Intlayer com next-i18next
 
-### Passo 1: Instalar Dependências
+<Steps>
+
+<Step number={1} title="Instalar Dependências">
 
 Instale os pacotes necessários usando seu gerenciador de pacotes preferido:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> a flag `--interactive` é opcional. Use `intlayer-cli init` se você for um agente de IA.
+
+> Este comando detectará seu ambiente e instalará os pacotes necessários. Por exemplo:
+
 ```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
 ```
 
 **Explicações dos pacotes:**
@@ -96,7 +103,9 @@ bun x intlayer init
 - **intlayer**: Biblioteca principal para declaração e gerenciamento de conteúdo
 - **@intlayer/sync-json-plugin**: Plugin para sincronizar declarações de conteúdo do Intlayer para o formato JSON do i18next
 
-### Passo 2: Implemente o plugin Intlayer para encapsular o JSON
+</Step>
+
+<Step number={2} title="Implemente o plugin Intlayer para encapsular o JSON">
 
 Crie um arquivo de configuração do Intlayer para definir os locais suportados:
 
@@ -134,7 +143,9 @@ Para ver mais detalhes sobre o plugin `syncJSON`, por favor consulte a [document
 
 ---
 
-### (Opcional) Passo 3: Implementar traduções JSON por componente
+</Step>
+
+<Step number={3} title="Implementar traduções JSON por componente" isOptional={true}>
 
 Por padrão, o Intlayer irá carregar, mesclar e sincronizar tanto os arquivos JSON quanto os arquivos de declaração de conteúdo. Veja [a documentação da declaração de conteúdo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/content_file.md) para mais detalhes. Mas se preferir, usando um plugin do Intlayer, você também pode implementar o gerenciamento por componente de JSON localizado em qualquer lugar da sua base de código.
 
@@ -177,6 +188,10 @@ Isso irá carregar todos os arquivos JSON no diretório `src` que correspondem a
 
 ---
 
+</Step>
+
+</Steps>
+
 ## Configuração do Git
 
 Exclua arquivos gerados do controle de versão: