@intlayer/docs 8.12.4 → 9.0.0-canary.10

package/docs/cs/intlayer_with_angular_21.md

@@ -28,6 +28,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "Počáteční historie"
+author: aymericzip
 ---
 
 # Přeložte svůj web Angular 21 (Vite) pomocí Intlayer | Internacionalizace (i18n)
@@ -84,28 +85,44 @@ Podívejte se na [šablonu aplikace](https://github.com/aymericzip/intlayer-angu
 
 Nainstalujte potřebné balíčky pomocí npm:
 
+```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
+```
+
+> příznak `--interactive` je volitelný. Pokud jste AI agent, použijte `intlayer-cli init`.
+
+> Tento příkaz detekuje vaše prostředí a nainstaluje potřebné balíčky. Například:
+
 ```bash packageManager="npm"
 npm install intlayer angular-intlayer
 npm install @angular-builders/custom-esbuild --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer
 pnpm add @angular-builders/custom-esbuild --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer
 yarn add @angular-builders/custom-esbuild --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer angular-intlayer
 bun add @angular-builders/custom-esbuild --dev
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/cs/intlayer_with_fastify.md

@@ -25,6 +25,7 @@ history:
   - version: 7.6.0
     date: 2025-12-31
     changes: "Inicializována historie"
+author: aymericzip
 ---
 
 # Přeložte svůj backendový web ve Fastify pomocí Intlayer | Internacionalizace (i18n)
@@ -60,27 +61,39 @@ Podívejte se na [šablonu aplikace](https://github.com/aymericzip/intlayer-fast
 Chcete-li začít používat `fastify-intlayer`, nainstalujte balíček pomocí npm:
 
 ```bash packageManager="npm"
-npm install intlayer fastify-intlayer
-npx intlayer init
+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
+```
+
+> příznak `--interactive` je volitelný. Pokud jste AI agent, použijte `intlayer-cli init`.
 
+> Tento příkaz detekuje vaše prostředí a nainstaluje potřebné balíčky. Například:
+
+```bash packageManager="npm"
+npm install intlayer fastify-intlayer
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer fastify-intlayer
-pnpm intlayer init
-
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer fastify-intlayer
-yarn intlayer init
-
 ```
 
 ```bash packageManager="bun"
 bun add intlayer fastify-intlayer
-bun x intlayer init
-
 ```
 
 ### Nastavení

package/docs/cs/intlayer_with_hono.md

@@ -25,6 +25,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "Iniciace historie"
+author: aymericzip
 ---
 
 # Přeložte svůj backendový web Hono pomocí Intlayer | Internacionalizace (i18n)
@@ -61,24 +62,40 @@ Viz [Šablona aplikace](https://github.com/aymericzip/intlayer-hono-template) na
 
 Chcete-li začít používat `hono-intlayer`, nainstalujte balíček pomocí npm:
 
+```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
+```
+
+> příznak `--interactive` je volitelný. Pokud jste AI agent, použijte `intlayer-cli init`.
+
+> Tento příkaz detekuje vaše prostředí a nainstaluje potřebné balíčky. Například:
+
 ```bash packageManager="npm"
 npm install intlayer hono-intlayer
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer hono-intlayer
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer hono-intlayer
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer hono-intlayer
-bun x intlayer init
 ```
 
 ### Nastavení

package/docs/cs/intlayer_with_storybook.md

@@ -23,6 +23,7 @@ history:
   - version: 8.4.5
     date: 2026-03-20
     changes: "Iniciace dokumentace"
+author: aymericzip
 ---
 
 # Intlayer se Storybookem
@@ -151,7 +152,13 @@ const config: StorybookConfig = {
     } as const;
 
     const viteConfig = defineConfig(() => ({
-      plugins: [intlayer()],
+      plugins: [
+        intlayer({
+          proxy: {
+            ignore: (req) => req.url?.startsWith("/api"),
+          },
+        }),
+      ],
     }));
 
     return mergeConfig(baseConfig, viteConfig(env));
@@ -221,10 +228,11 @@ export default preview;
 
 > Hodnoty `locale` musí odpovídat jazykům deklarovaným ve vašem `intlayer.config.ts`.
 
+</Step>
+</Steps>
 </Tab>
 <Tab value="Webpack Setup">
-
-</Step>
+<Steps>
 
 <Step number={1} title="Instalace závislostí">
 
@@ -346,14 +354,10 @@ const preview: Preview = {
 export default preview;
 ```
 
-</Tab>
-</Tabs>
-
----
-
 </Step>
-
 </Steps>
+</Tab>
+</Tabs>
 
 ## Deklarování obsahu
 

package/docs/cs/intlayer_with_vanilla.md

@@ -24,6 +24,7 @@ history:
   - version: 8.4.10
     date: 2026-03-31
     changes: "Inicializace historie"
+author: aymericzip
 ---
 
 # Přeložte svůj web Vanilla JS pomocí Intlayer | Internacionalizace (i18n)

package/docs/cs/intlayer_with_vite+lit.md

@@ -24,6 +24,7 @@ history:
   - version: 8.4.10
     date: 2026-03-23
     changes: "Počáteční historie"
+author: aymericzip
 ---
 
 # Přeložte svůj web ve Vite a Lit pomocí Intlayer | Internacionalizace (i18n)
@@ -78,28 +79,44 @@ S Intlayer můžete:
 
 Nainstalujte potřebné balíčky pomocí npm:
 
+```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
+```
+
+> příznak `--interactive` je volitelný. Pokud jste AI agent, použijte `intlayer-cli init`.
+
+> Tento příkaz detekuje vaše prostředí a nainstaluje potřebné balíčky. Například:
+
 ```bash packageManager="npm"
 npm install intlayer lit-intlayer
 npm install vite-intlayer --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer lit-intlayer
 pnpm add vite-intlayer --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer lit-intlayer
 yarn add vite-intlayer --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer lit-intlayer
 bun add vite-intlayer --dev
-bun x intlayer init
 ```
 
 - **intlayer**
@@ -150,7 +167,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -419,7 +442,7 @@ Nejprve přidejte `intlayerProxy` do své konfigurace Vite:
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [intlayer(), intlayerProxy()],

package/docs/cs/intlayer_with_vite+vanilla.md

@@ -25,6 +25,7 @@ history:
   - version: 8.4.10
     date: 2026-03-23
     changes: "Počáteční historie"
+author: aymericzip
 ---
 
 # Přeložte svůj web s Vite a Vanilla JS pomocí Intlayer | Internacionalizace (i18n)
@@ -79,28 +80,44 @@ S Intlayer můžete:
 
 Nainstalujte potřebné balíčky pomocí npm:
 
+```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
+```
+
+> příznak `--interactive` je volitelný. Pokud jste AI agent, použijte `intlayer-cli init`.
+
+> Tento příkaz detekuje vaše prostředí a nainstaluje potřebné balíčky. Například:
+
 ```bash packageManager="npm"
 npm install intlayer vanilla-intlayer
 npm install vite-intlayer --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vanilla-intlayer
 pnpm add vite-intlayer --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vanilla-intlayer
 yarn add vite-intlayer --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer vanilla-intlayer
 bun add vite-intlayer --dev
-bun x intlayer init
 ```
 
 - **intlayer**
@@ -150,7 +167,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -411,12 +434,15 @@ Nejprve přidejte `intlayerProxy` do konfigurace Vite:
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // mělo by být umístěno jako první
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -548,6 +574,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel kompilátor'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Aktualizujte svůj `vite.config.ts` a zahrňte plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -557,7 +585,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Přidá kompilátor plugin
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/cs/introduction.md

@@ -16,6 +16,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "Init history"
+author: aymericzip
 ---
 
 # Dokumentace Intlayer

package/docs/cs/packages/intlayer/comparePaths.md

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Dokumentace funkce comparePaths | intlayer
+description: Zjistěte, jak používat funkci comparePaths z balíčku intlayer
+keywords:
+  - comparePaths
+  - normalizePath
+  - aktivní odkaz
+  - navigace
+  - Intlayer
+  - intlayer
+  - Internacionalizace
+  - Dokumentace
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - comparePaths
+history:
+  - version: 9.0.0
+    date: 2026-06-22
+    changes: "Úvodní dokumentace"
+author: aymericzip
+---
+
+# Dokumentace: Funkce `comparePaths` v `intlayer`
+
+## Popis
+
+Funkce `comparePaths` porovnává dvě URL adresy nebo cesty na shodu, přičemž ignoruje segment s jazykem (locale), protokol/hostitele, dotazovací řetězec (query string), hash a koncová lomítka (trailing slashes). Jde o doporučený způsob, jak zjistit, zda navigační odkaz ukazuje na aktuální stránku — například za účelem zvýraznění aktivního odkazu — aniž byste museli psát vlastní (často chybovou) normalizační logiku.
+
+Interně znovu využívá [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/packages/intlayer/getPathWithoutLocale.md) k odstranění segmentu s jazykem, takže respektuje váš nastavený režim směrování a nakonfigurované jazyky.
+
+Balíček také exportuje základní pomocnou funkci [`normalizePath`](#normalizepath), která vrací kanonickou cestu nezávislou na jazyce, využívanou k samotnému porovnání.
+
+**Klíčové vlastnosti:**
+
+- Porovnání nezávislé na jazyce (`/cs/about` odpovídá `/about`)
+- Funguje s absolutními URL i s relativními cestami
+- Ignoruje dotazovací řetězce, hash a koncová lomítka
+- Toleruje chybějící úvodní lomítka a prázdné hodnoty (normalizuje je na `/`)
+- Odlehčená (lightweight) — postavena nad funkcí `getPathWithoutLocale`
+
+---
+
+## Signatura funkce
+
+```typescript
+comparePaths(
+  pathname: string,  // Povinné
+  href: string,      // Povinné
+  locales?: Locales[] // Volitelné
+): boolean
+
+normalizePath(
+  inputUrl: string,   // Povinné
+  locales?: Locales[] // Volitelné
+): string
+```
+
+---
+
+## Parametry
+
+- `pathname: string`
+  - **Popis**: První URL řetězec nebo cesta k porovnání (typicky aktuální cesta).
+  - **Typ**: `string`
+  - **Povinné**: Ano
+
+- `href: string`
+  - **Popis**: Druhý URL řetězec nebo cesta k porovnání (typicky `href` navigačního odkazu).
+  - **Typ**: `string`
+  - **Povinné**: Ano
+
+- `locales: Locales[]`
+  - **Popis**: Volitelné pole podporovaných jazyků. Výchozí jsou jazyky nakonfigurované v projektu.
+  - **Typ**: `Locales[]`
+  - **Povinné**: Ne (Volitelné)
+
+### Vrací
+
+- **Typ**: `boolean`
+- **Popis**: `true`, když se oba vstupy přeloží na stejnou cestu nezávislou na jazyce, jinak `false`.
+
+---
+
+## Příklady použití
+
+### Základní použití
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { comparePaths } from "intlayer";
+
+comparePaths("/ru/path", "/path"); // true
+comparePaths("/ru/path/", "/path"); // true
+comparePaths("/ru/path", "/path/"); // true
+comparePaths("/ru/", "/"); // true
+comparePaths("/ru", "/"); // true
+comparePaths("ru/path", "/path"); // true
+comparePaths("", "/"); // true
+comparePaths("/ru", ""); // true
+comparePaths("/ru/path", "/other"); // false
+```
+
+### Absolutní a relativní URL
+
+```typescript
+import { comparePaths } from "intlayer";
+
+comparePaths("https://example.com/ru/path", "/path"); // true
+```
+
+### Zvýraznění aktivního navigačního odkazu
+
+```tsx
+import { comparePaths } from "intlayer";
+import { useLocation } from "react-router";
+
+const NavLink = ({ href, children }) => {
+  const { pathname } = useLocation();
+  const isActive = comparePaths(pathname, href);
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {children}
+    </a>
+  );
+};
+```
+
+---
+
+## normalizePath
+
+Funkce `normalizePath` vrací kanonickou cestu nezávislou na jazyce, kterou využívá `comparePaths`. Odstraní segment jazyka, protokol/hostitele, dotazovací řetězec i hash, zajistí jedno úvodní lomítko, odstraní veškerá koncová lomítka (s výjimkou kořenové složky) a u prázdnných hodnot se vrátí na `/`.
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { normalizePath } from "intlayer";
+
+normalizePath("/ru/path"); // "/path"
+normalizePath("/ru/path/"); // "/path"
+normalizePath("ru/path"); // "/path"
+normalizePath("/ru/"); // "/"
+normalizePath("/ru"); // "/"
+normalizePath(""); // "/"
+normalizePath("https://example.com/ru/path"); // "/path"
+```
+
+---
+
+## Související funkce
+
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/packages/intlayer/getPathWithoutLocale.md): Odstraní segment jazyka z URL nebo cesty.
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/packages/intlayer/getPrefix.md): Získá URL prefix pro daný jazyk (locale).
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/packages/intlayer/getLocalizedUrl.md): Vygeneruje lokalizovanou URL pro konkrétní jazyk.
+
+---
+
+## TypeScript
+
+```typescript
+function normalizePath(inputUrl: string, locales?: Locales[]): string;
+
+function comparePaths(
+  pathname: string,
+  href: string,
+  locales?: Locales[]
+): boolean;
+```

package/docs/de/CI_CD.md

@@ -19,12 +19,17 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "Historie initialisieren"
+author: aymericzip
 ---
 
 # Automatische Generierung von Übersetzungen in einer CI/CD-Pipeline
 
 Intlayer ermöglicht die automatische Generierung von Übersetzungen für Ihre Content-Deklarationsdateien. Es gibt verschiedene Möglichkeiten, dies je nach Ihrem Workflow zu realisieren.
 
+## Inhaltsverzeichnis
+
+<TOC/>
+
 ## Verwendung des CMS
 
 Mit Intlayer können Sie einen Workflow verwenden, bei dem nur eine einzige Locale lokal deklariert wird, während alle Übersetzungen remote über das CMS verwaltet werden. Dies ermöglicht es, Inhalte und Übersetzungen vollständig von der Codebasis zu trennen, bietet mehr Flexibilität für Content-Editoren und ermöglicht ein Hot Content Reloading (kein erneutes Bauen der Anwendung erforderlich, um Änderungen anzuwenden).

package/docs/de/agent_skills.md

@@ -16,6 +16,7 @@ history:
   - version: 8.1.0
     date: 2026-02-09
     changes: "Init history"
+author: aymericzip
 ---
 
 # Agent Skills