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

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

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentatie voor de functie comparePaths | intlayer
+description: Bekijk hoe u de functie comparePaths gebruikt voor het intlayer-pakket
+keywords:
+  - comparePaths
+  - normalizePath
+  - actieve link
+  - navigatie
+  - Intlayer
+  - intlayer
+  - Internationalisatie
+  - Documentatie
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - comparePaths
+history:
+  - version: 9.0.0
+    date: 2026-06-22
+    changes: "Initiële documentatie"
+author: aymericzip
+---
+
+# Documentatie: Functie `comparePaths` in `intlayer`
+
+## Beschrijving
+
+De functie `comparePaths` vergelijkt twee URL's of paden op gelijkheid, waarbij het locale-segment, het protocol/host, de query-string, de hash en afsluitende schuine strepen (trailing slashes) worden genegeerd. Het is de aanbevolen manier om te bepalen of een navigatielink naar de huidige pagina verwijst — bijvoorbeeld om de actieve link te markeren — zonder dat u zelf (foutgevoelige) normalisatielogica hoeft te schrijven.
+
+Intern hergebruikt het [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/packages/intlayer/getPathWithoutLocale.md) om het locale-segment te verwijderen, zodat het uw geconfigureerde routeringsmodus en locales respecteert.
+
+Het pakket exporteert ook de onderliggende hulpmethode [`normalizePath`](#normalizepath), die het canonieke, locale-onafhankelijke pad retourneert dat wordt gebruikt voor de vergelijking.
+
+**Belangrijkste kenmerken:**
+
+- Locale-onafhankelijke vergelijking (`/nl/about` komt overeen met `/about`)
+- Werkt met zowel absolute URL's als relatieve paden
+- Negeert query-strings, hashes en afsluitende schuine strepen
+- Tolereert ontbrekende voorloopstrepen en lege waarden (genormaliseerd naar `/`)
+- Lichtgewicht — gebouwd bovenop `getPathWithoutLocale`
+
+---
+
+## Functiesignatuur
+
+```typescript
+comparePaths(
+  pathname: string,  // Vereist
+  href: string,      // Vereist
+  locales?: Locales[] // Optioneel
+): boolean
+
+normalizePath(
+  inputUrl: string,   // Vereist
+  locales?: Locales[] // Optioneel
+): string
+```
+
+---
+
+## Parameters
+
+- `pathname: string`
+  - **Beschrijving**: De eerste URL-tekenreeks of het pad om te vergelijken (meestal het huidige pad).
+  - **Type**: `string`
+  - **Vereist**: Ja
+
+- `href: string`
+  - **Beschrijving**: De tweede URL-tekenreeks of het pad om te vergelijken (meestal de `href` van een navigatielink).
+  - **Type**: `string`
+  - **Vereist**: Ja
+
+- `locales: Locales[]`
+  - **Beschrijving**: Optionele array van ondersteunde locales. Standaard ingesteld op de geconfigureerde locales in het project.
+  - **Type**: `Locales[]`
+  - **Vereist**: Nee (Optioneel)
+
+### Retourneert
+
+- **Type**: `boolean`
+- **Beschrijving**: `true` wanneer beide invoeren leiden tot hetzelfde locale-onafhankelijke pad, anders `false`.
+
+---
+
+## Voorbeeldgebruik
+
+### Basisgebruik
+
+```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
+```
+
+### Absolute en relatieve URL's
+
+```typescript
+import { comparePaths } from "intlayer";
+
+comparePaths("https://example.com/ru/path", "/path"); // true
+```
+
+### De actieve navigatielink markeren
+
+```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
+
+`normalizePath` retourneert het canonieke, locale-onafhankelijke pad dat wordt gebruikt door `comparePaths`. Het verwijdert het locale-segment, het protocol/host, de query-string en de hash, zorgt voor een enkele voorloopstreep, verwijdert eventuele afsluitende schuine strepen (behalve voor de root) en valt terug op `/` voor lege waarden.
+
+```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"
+```
+
+---
+
+## Gerelateerde functies
+
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/packages/intlayer/getPathWithoutLocale.md): Verwijdert het locale-segment van een URL of pad.
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/packages/intlayer/getPrefix.md): Bepaalt de URL-prefix voor een gegeven locale.
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/packages/intlayer/getLocalizedUrl.md): Genereert een gelokaliseerde URL voor een specifieke locale.
+
+---
+
+## TypeScript
+
+```typescript
+function normalizePath(inputUrl: string, locales?: Locales[]): string;
+
+function comparePaths(
+  pathname: string,
+  href: string,
+  locales?: Locales[]
+): boolean;
+```

package/docs/pl/intlayer_with_adonisjs.md

@@ -59,24 +59,40 @@ Zobacz [Application Template](https://github.com/aymericzip/intlayer-adonisjs-te
 
 Aby zacząć korzystać z `adonis-intlayer`, zainstaluj pakiet za 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
+```
+
+> 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 adonis-intlayer
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer adonis-intlayer
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer adonis-intlayer
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer adonis-intlayer
-bun x intlayer init
 ```
 
 ### Konfiguracja

package/docs/pl/intlayer_with_analog.md

@@ -101,24 +101,40 @@ Zobacz [Szablon aplikacji](https://github.com/aymericzip/intlayer-analog-templat
 
 Zainstaluj niezbędne pakiety za 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
+```
+
+> 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 angular-intlayer vite-intlayer
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer vite-intlayer
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer vite-intlayer
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer angular-intlayer vite-intlayer
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/pl/intlayer_with_angular_19.md

@@ -104,28 +104,44 @@ Zobacz [Szablon aplikacji](https://github.com/aymericzip/intlayer-angular-19-tem
 
 Zainstaluj niezbędne pakiety za 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
+```
+
+> 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 angular-intlayer
 npm install @angular-builders/custom-webpack --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer
 pnpm add @angular-builders/custom-webpack --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer
 yarn add @angular-builders/custom-webpack --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer angular-intlayer
 bun add @angular-builders/custom-webpack --dev
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/pl/intlayer_with_angular_21.md

@@ -106,28 +106,44 @@ Zobacz [Szablon Aplikacji](https://github.com/aymericzip/intlayer-angular-21-tem
 
 Zainstaluj niezbędne pakiety używając 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
+```
+
+> 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 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/pl/intlayer_with_astro_lit.md

@@ -105,27 +105,39 @@ Sprawdź [szablon aplikacji](https://github.com/aymericzip/intlayer-astro-templa
 Zainstaluj niezbędne pakiety za pomocą preferowanego menedżera pakietów:
 
 ```bash packageManager="npm"
-npm install intlayer astro-intlayer lit lit-intlayer @astrojs/lit
+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.
 
-npx intlayer init
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
+```bash packageManager="npm"
+npm install intlayer astro-intlayer lit lit-intlayer @astrojs/lit
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer astro-intlayer lit lit-intlayer @astrojs/lit
-
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer astro-intlayer lit lit-intlayer @astrojs/lit
-
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer astro-intlayer lit lit-intlayer @astrojs/lit
-
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/pl/intlayer_with_astro_preact.md

@@ -104,27 +104,39 @@ Sprawdź [szablon aplikacji](https://github.com/aymericzip/intlayer-astro-templa
 Zainstaluj niezbędne pakiety za pomocą preferowanego menedżera pakietów:
 
 ```bash packageManager="npm"
-npm install intlayer astro-intlayer preact preact-intlayer @astrojs/preact
+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.
 
-npx intlayer init
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
+```bash packageManager="npm"
+npm install intlayer astro-intlayer preact preact-intlayer @astrojs/preact
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer astro-intlayer preact preact-intlayer @astrojs/preact
-
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer astro-intlayer preact preact-intlayer @astrojs/preact
-
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer astro-intlayer react react-dom react-intlayer @astrojs/react
-
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/pl/intlayer_with_astro_react.md

@@ -107,27 +107,39 @@ Sprawdź [szablon aplikacji](https://github.com/aymericzip/intlayer-astro-templa
 Zainstaluj niezbędne pakiety za pomocą preferowanego menedżera pakietów:
 
 ```bash packageManager="npm"
-npm install intlayer astro-intlayer react react-dom react-intlayer @astrojs/react
+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.
 
-npx intlayer init
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
+```bash packageManager="npm"
+npm install intlayer astro-intlayer react react-dom react-intlayer @astrojs/react
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer astro-intlayer react react-dom react-intlayer @astrojs/react
-
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer astro-intlayer react react-dom react-intlayer @astrojs/react
-
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer astro-intlayer react react-dom react-intlayer @astrojs/react
-
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/pl/intlayer_with_astro_solid.md

@@ -104,27 +104,39 @@ Sprawdź [szablon aplikacji](https://github.com/aymericzip/intlayer-astro-templa
 Zainstaluj niezbędne pakiety za pomocą preferowanego menedżera pakietów:
 
 ```bash packageManager="npm"
-npm install intlayer astro-intlayer solid-js solid-intlayer @astrojs/solid-js
+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.
 
-npx intlayer init
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
+```bash packageManager="npm"
+npm install intlayer astro-intlayer solid-js solid-intlayer @astrojs/solid-js
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer astro-intlayer solid-js solid-intlayer @astrojs/solid-js
-
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer astro-intlayer solid-js solid-intlayer @astrojs/solid-js
-
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer astro-intlayer solid-js solid-intlayer @astrojs/solid-js
-
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/pl/intlayer_with_astro_svelte.md

@@ -104,27 +104,39 @@ Sprawdź [szablon aplikacji](https://github.com/aymericzip/intlayer-astro-templa
 Zainstaluj niezbędne pakiety za pomocą preferowanego menedżera pakietów:
 
 ```bash packageManager="npm"
-npm install intlayer astro-intlayer svelte svelte-intlayer @astrojs/svelte
+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.
 
-npx intlayer init
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
+```bash packageManager="npm"
+npm install intlayer astro-intlayer svelte svelte-intlayer @astrojs/svelte
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer astro-intlayer svelte svelte-intlayer @astrojs/svelte
-
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer astro-intlayer svelte svelte-intlayer @astrojs/svelte
-
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer astro-intlayer svelte svelte-intlayer @astrojs/svelte
-
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/pl/intlayer_with_astro_vanilla.md

@@ -104,27 +104,39 @@ Sprawdź [szablon aplikacji](https://github.com/aymericzip/intlayer-astro-templa
 Zainstaluj niezbędne pakiety za pomocą preferowanego menedżera pakietów:
 
 ```bash packageManager="npm"
-npm install intlayer astro-intlayer vanilla-intlayer
+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.
 
-npx intlayer init
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
+```bash packageManager="npm"
+npm install intlayer astro-intlayer vanilla-intlayer
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer astro-intlayer vanilla-intlayer
-
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer astro-intlayer vanilla-intlayer
-
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer astro-intlayer vanilla-intlayer
-
-bun x intlayer init
 ```
 
 - **intlayer**