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

package/docs/zh/roadmap.md

@@ -29,6 +29,12 @@ Intlayer 是一个内容管理和国际化解决方案，旨在简化您在应
 
 ---
 
+## 目录
+
+<TOC/>
+
+---
+
 ## 当前功能
 
 ### 1. 内容声明

package/docs/zh/vs_code_extension.md

@@ -119,13 +119,6 @@ Intlayer 建议将您的 AI API 密钥，以及 Intlayer 客户端 ID 和密钥
 - **非破坏性**：不会覆盖已有的 `process.env` 值。
 - **作用域**：文件从配置的基础目录解析（默认为工作区根目录）。
 
-#### 选择活动环境
-
-- **命令面板**：打开命令面板并运行 `Intlayer: Select Environment`，然后选择环境（例如，`development`、`staging`、`production`）。扩展将尝试加载上述优先级列表中第一个可用的文件，并显示类似“已从 `.env.<env>.local` 加载环境”的通知。
-- **设置**：进入 `设置 → 扩展 → Intlayer`，并设置：
-  - **环境**：用于解析 `.env.<env>*` 文件的环境名称。
-  - （可选）**环境文件**：显式指定一个 `.env` 文件路径。提供后，该路径优先于推断的列表。
-
 #### Monorepos 和自定义目录
 
 - **命令面板**：打开命令面板并运行 `Intlayer: Select Environment`，然后选择环境（例如，`development`、`staging`、`production`）。扩展将尝试加载上述优先列表中的第一个可用文件，并显示类似“已从 `.env.<env>.local` 加载环境”的通知。

package/docs/zh-TW/intlayer_with_angular_21.md

@@ -85,28 +85,44 @@ author: aymericzip
 
 使用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
+```
+
+> `--interactive` 標誌是可選的。如果您是 AI 代理，請使用 `intlayer-cli init`。
+
+> 此命令將偵測您的環境並安裝所需的套件。例如：
+
 ```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/zh-TW/packages/intlayer/comparePaths.md

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: comparePaths 函式文件 | intlayer
+description: 了解如何使用 intlayer 套件中的 comparePaths 函式
+keywords:
+  - comparePaths
+  - normalizePath
+  - 活躍連結
+  - 導覽
+  - Intlayer
+  - intlayer
+  - 國際化
+  - 文件
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - comparePaths
+history:
+  - version: 9.0.0
+    date: 2026-06-22
+    changes: "初始文件"
+author: aymericzip
+---
+
+# 文件: `intlayer` 中的 `comparePaths` 函式
+
+## 描述
+
+`comparePaths` 函式在忽略語言設定（locale）區段、通訊協定/主機名稱、查詢字串、雜湊值和結尾斜線的情況下，比較兩個 URL 或路徑是否相等。這是判斷導覽連結是否指向目前頁面的推薦方法（例如，用於標示目前活動的連結），而無需撰寫自己（容易出錯）的正規化邏輯。
+
+它在內部重複使用了 [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/packages/intlayer/getPathWithoutLocale.md) 來移除語言設定區段，因此它會遵循您配置的路由模式和語言設定。
+
+該套件還匯出了底層的 [`normalizePath`](#normalizepath) 輔助函式，它會回傳用於比較的、與語言設定無關的正規路徑名稱。
+
+**主要功能：**
+
+- 與語言設定無關的比較（`/zh-TW/about` 與 `/about` 匹配）
+- 適用於絕對 URL 和相對路徑
+- 忽略查詢字串、雜湊值和結尾斜線
+- 容許缺少前導斜線和空值（正規化為 `/`）
+- 輕量級 — 建構在 `getPathWithoutLocale` 之上
+
+---
+
+## 函式簽名
+
+```typescript
+comparePaths(
+  pathname: string,  // 必填
+  href: string,      // 必填
+  locales?: Locales[] // 選填
+): boolean
+
+normalizePath(
+  inputUrl: string,   // 必填
+  locales?: Locales[] // 選填
+): string
+```
+
+---
+
+## 參數
+
+- `pathname: string`
+  - **描述**: 要比較的第一個 URL 字串或路徑名稱（通常是目前路徑）。
+  - **型別**: `string`
+  - **必填**: 是
+
+- `href: string`
+  - **描述**: 要比較的第二個 URL 字串或路徑名稱（通常是導覽連結的 `href`）。
+  - **型別**: `string`
+  - **必填**: 是
+
+- `locales: Locales[]`
+  - **描述**: 支援的語言設定的選填陣列。預設為專案中設定的語言。
+  - **型別**: `Locales[]`
+  - **必填**: 否 (選填)
+
+### 回傳值
+
+- **型別**: `boolean`
+- **描述**: 當兩個輸入都解析為相同的與語言設定無關的路徑時回傳 `true`，否則回傳 `false`。
+
+---
+
+## 範例用法
+
+### 基本用法
+
+```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
+```
+
+### 絕對和相對 URL
+
+```typescript
+import { comparePaths } from "intlayer";
+
+comparePaths("https://example.com/ru/path", "/path"); // true
+```
+
+### 標示活動的導覽連結
+
+```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` 回傳由 `comparePaths` 使用的、與語言設定無關的正規路徑名稱。它移除了語言設定區段、通訊協定/主機、查詢字串和雜湊，確保單個前導斜線，刪除任何結尾斜線（根目錄除外），對於空值則回退為 `/`。
+
+```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"
+```
+
+---
+
+## 相關函式
+
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/packages/intlayer/getPathWithoutLocale.md): 從 URL 或路徑中刪除語言設定區段。
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/packages/intlayer/getPrefix.md): 取得給定語言設定的 URL 前綴。
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/packages/intlayer/getLocalizedUrl.md): 為特定語言設定生成本地化 URL。
+
+---
+
+## TypeScript
+
+```typescript
+function normalizePath(inputUrl: string, locales?: Locales[]): string;
+
+function comparePaths(
+  pathname: string,
+  href: string,
+  locales?: Locales[]
+): boolean;
+```

package/frequent_questions/pt/translated_path_url.md

@@ -32,7 +32,7 @@ es -> /es/producto
 
 Para implementar isso, você pode configurar a seção `routing` no seu arquivo `intlayer.config.ts`.
 
-Para mais informações sobre como implementar este recurso, consulte a [documentação de Reescritas de URL Personalizadas](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md).
+Para mais informações sobre como implementar este recurso, consulte a [documentação de Reescritas de URL Personalizadas](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/custom_url_rewrites.md).
 
 Você também pode usar as funções `getMultilingualUrl` e `getLocalizedUrl` para gerar essas URLs programaticamente, e elas respeitarão suas regras de reescrita.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "8.12.5-canary.0",
+  "version": "9.0.0-canary.10",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,14 +73,14 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "9.0.0-canary.0",
-    "@intlayer/core": "9.0.0-canary.0",
-    "@intlayer/types": "9.0.0-canary.0"
+    "@intlayer/config": "9.0.0-canary.10",
+    "@intlayer/core": "9.0.0-canary.10",
+    "@intlayer/types": "9.0.0-canary.10"
   },
   "devDependencies": {
-    "@intlayer/api": "9.0.0-canary.0",
-    "@intlayer/cli": "9.0.0-canary.0",
-    "@types/node": "25.9.3",
+    "@intlayer/api": "9.0.0-canary.10",
+    "@intlayer/cli": "9.0.0-canary.10",
+    "@types/node": "25.9.4",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
@@ -88,7 +88,7 @@
     "rimraf": "6.1.3",
     "tsdown": "0.21.10",
     "typescript": "6.0.3",
-    "vitest": "4.1.8"
+    "vitest": "4.1.9"
   },
   "engines": {
     "node": ">=14.18"