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

package/docs/zh/roadmap.md

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

package/docs/zh/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: 自托管 Intlayer
+description: 通过一条命令在您自己的基础设施上运行完整的 Intlayer 实例。无需 Intlayer Cloud 账户。
+keywords:
+  - 自托管
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - 安装
+  - 基础设施
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# 自托管 Intlayer
+
+Intlayer 可以完全在您自己的基础设施上运行——无需 Intlayer Cloud 账户。只需一条命令即可启动一个生产就绪的堆栈：
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+安装程序会下载 `docker-compose.yml` 和 `.env` 文件，自动生成所需的密钥，并使用 `docker compose up -d` 启动所有容器。
+
+## 目录
+
+<TOC/>
+
+---
+
+## 架构
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1-node RS)             (S3 API)     (SMTP)        (in-image)
+                             minio:9001   mailpit:8025
+                             (console)    (web UI)
+```
+
+Chromium（用于 Puppeteer 屏幕截图生成）捆绑在后端镜像中——无需单独的容器。
+
+---
+
+## 先决条件
+
+- **Docker** ≥ 24 和 **Docker Compose** ≥ v2。如果其中任何一个缺失，安装程序将打印安装链接并退出。
+- 主机上端口 `3000`、`3100`、`8025`、`9000` 和 `9001` 可用。
+- Linux 或 macOS 主机（或 Windows 上的 WSL2）。
+
+---
+
+## 快速开始
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+安装程序执行以下操作：
+
+1. 检查 `docker` 和 `docker compose` 是否存在。
+2. 将 `docker-compose.yml` 和 `.env.example` 下载到 `./intlayer/` 目录中。
+3. 如果不存在 `.env` 文件，则复制示例文件并使用 `openssl rand` 为 `BETTER_AUTH_SECRET`、`S3_ACCESS_KEY_ID` 和 `S3_SECRET_ACCESS_KEY` 生成随机密钥。
+4. 运行 `docker compose pull` + `docker compose up -d`。
+5. 打印 URL：仪表盘 `:3000`、API `:3100`、电子邮件 UI `:8025`、MinIO 控制台 `:9001`。
+
+堆栈启动后，打开 **http://localhost:3000** 并创建您的第一个账户。
+
+---
+
+## 服务
+
+| 服务        | 镜像                              | 主机端口                       | 用途                               |
+| ----------- | --------------------------------- | ------------------------------ | ---------------------------------- |
+| **app**     | 从 `apps/app/Dockerfile` 构建     | `3000`                         | TanStack Start 仪表盘 (CMS UI)     |
+| **backend** | 从 `apps/backend/Dockerfile` 构建 | `3100`                         | Fastify REST API (`/health` 端点)  |
+| **mongo**   | `mongo:7`                         | 内部                           | 单节点副本集 (`rs0`)               |
+| **redis**   | `redis:7-alpine`                  | 内部                           | 任务队列 (BullMQ) 和缓存 (ioredis) |
+| **minio**   | `minio/minio`                     | `9000` (S3), `9001` (控制台)   | 用于头像和截图的 S3 兼容对象存储   |
+| **mailpit** | `axllent/mailpit`                 | `1025` (SMTP), `8025` (Web UI) | 本地事务性电子邮件接收器           |
+
+默认情况下，内部端口（mongo、redis）不会暴露给主机。
+
+> MinIO 端口 `9000` 必须可从浏览器访问，因为上传的资产（头像、截图）直接从 `S3_PUBLIC_URL=http://localhost:9000/intlayer` 加载。
+
+---
+
+## 环境变量
+
+安装程序会生成一个即用型 `.env` 文件。下表描述了每个变量。
+
+### 必需（自动生成或提示）
+
+| 变量                   | 示例                                            | 描述                             |
+| ---------------------- | ----------------------------------------------- | -------------------------------- |
+| `NODE_ENV`             | `production`                                    | 运行时环境                       |
+| `PORT`                 | `3100`                                          | 后端监听端口                     |
+| `BACKEND_URL`          | `http://localhost:3100`                         | 后端 API 的公共 URL              |
+| `APP_URL`              | `http://localhost:3000`                         | 仪表盘的公共 URL                 |
+| `DOMAIN`               | `localhost`                                     | Cookie 域                        |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | 完整的 MongoDB 连接 URI          |
+| `REDIS_URL`            | `redis://redis:6379`                            | Redis 连接 URL                   |
+| `BETTER_AUTH_SECRET`   | _(已生成)_                                      | 用于会话签名的 32 字节密钥       |
+| `MAIL_PROVIDER`        | `smtp`                                          | 邮件传输方式：`smtp` 或 `resend` |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | SMTP 主机名 (Mailpit 容器名称)   |
+| `MAIL_SMTP_PORT`       | `1025`                                          | SMTP 端口                        |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | 发件人地址                       |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | S3 兼容端点                      |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | 用于浏览器资产加载的公共 URL     |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | 存储桶名称                       |
+| `S3_ACCESS_KEY_ID`     | _(已生成)_                                      | MinIO 访问密钥                   |
+| `S3_SECRET_ACCESS_KEY` | _(已生成)_                                      | MinIO 秘密密钥                   |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | 构建时嵌入到仪表盘中的后端 URL   |
+| `VITE_DOMAIN`          | `localhost`                                     | 构建时嵌入到仪表盘中的域         |
+
+### 可选（缺少时功能会优雅降级）
+
+| 变量                                                     | 功能                                                   |
+| -------------------------------------------------------- | ------------------------------------------------------ |
+| `OPENAI_API_KEY`                                         | AI 辅助翻译和内容审计                                  |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | 账单和订阅管理                                         |
+| `RESEND_API_KEY`                                         | 通过 Resend 发送事务性电子邮件（设置后会覆盖 Mailpit） |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | GitHub OAuth 登录                                      |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Google OAuth 登录                                      |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | GitLab OAuth 登录                                      |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Microsoft OAuth 登录                                   |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuth 登录                                    |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuth 登录                                   |
+
+---
+
+## 连接您的 Intlayer 项目
+
+堆栈运行后，将您的项目指向自托管的后端和仪表盘，而不是 `intlayer.org`。
+
+### 项目配置
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+
+    /**
+     * 自托管 CMS 仪表盘的 URL。
+     * 默认值: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * 自托管后端 API 的 URL。
+     * 默认值: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+在您项目的 `.env` 中设置环境变量：
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+在您的自托管仪表盘中，通过 `http://localhost:3000/projects` 下的 **项目 → 访问密钥** 创建访问凭据。
+
+### `@intlayer/api` SDK
+
+以编程方式使用 `@intlayer/api` SDK 时，明确传递 `backendURL`：
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+```
+
+---
+
+## 升级
+
+在现有部署上重新运行安装程序会执行滚动升级：
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+这会拉取最新镜像并使用 `docker compose pull && docker compose up -d` 重启容器。现有卷（`mongo-data`、`redis-data`、`minio-data`）会保留——不会丢失数据。
+
+要在 `./intlayer/` 目录中手动升级：
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## 备份与恢复
+
+所有持久化数据都存储在三个命名 Docker 卷中。
+
+### 备份
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### 恢复
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# 对 redis-data 和 minio-data 重复此操作
+```
+
+---
+
+## 使用反向代理 (Nginx / Caddy)
+
+对于生产部署，请在应用和后端容器前放置一个反向代理，而不是直接暴露它们。
+
+### Nginx 示例
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+更新以下 `.env` 变量以匹配您的公共域名：
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> `VITE_*` 变量在构建时被嵌入到仪表盘镜像中。如果在镜像构建后更改它们，您需要重建 `app` 镜像 (`docker compose build app`) 或使用运行时配置注入。
+
+---
+
+## 故障排除
+
+### 后端首次启动时崩溃循环
+
+MongoDB 和 Redis 必须在后端启动前保持健康。compose 文件使用带有 `condition: service_healthy` 的 `depends_on`。如果您看到后端重复重启，请检查 `mongo` 和 `redis` 的健康检查是否通过：
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### 仪表盘无法连接到 API
+
+验证 `VITE_BACKEND_URL` 是否与后端可以从**浏览器**（而非 Docker 网络）访问的 URL 匹配。如果您更改了后端端口或添加了反向代理，请重建仪表盘镜像：
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### 电子邮件未发送
+
+默认情况下，所有出站电子邮件都会被 Mailpit 捕获。打开 `http://localhost:8025` 查看已发送的消息。要发送真实电子邮件，请在 `.env` 中设置 `MAIL_PROVIDER=resend` 和 `RESEND_API_KEY=<your-key>`，然后重启后端：
+
+```sh
+docker compose restart backend
+```
+
+### MinIO 存储桶缺失
+
+如果 `minio-init` 一次性服务未运行（或在 MinIO 准备好之前运行），请手动创建存储桶：
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## 有用链接
+
+- [Intlayer CMS 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)
+- [配置参考](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)
+- [CMS SDK — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)
+- [Docker Image (aymercizip/intlayer-selfhost)](https://hub.docker.com/repository/docker/aymercizip/intlayer-selfhost/general)

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/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.js 需要依靠 `@intlayer/swc` 外掛程式來進行最佳化步驟（匯
 
 > 該外掛程式並未預設安裝，因為 SWC 外掛程式在 Next.js 當中目前仍處於實驗階段。未來這部分有可能會發生改變。
 
+<Tabs>
+ <Tab value="npm">
+
 ```bash packageManager="npm"
 npm install -D @intlayer/swc
 ```
@@ -247,6 +250,19 @@ pnpm add -D @intlayer/swc
 bun add -d @intlayer/swc
 ```
 
+ </Tab>
+ <Tab value="Crates.io (rust)">
+
+```toml fileName="Cargo.toml"
+[dependencies]
+intlayer-swc-plugin = "*"
+```
+
+[View on Crates.io](https://crates.io/crates/intlayer-swc-plugin)
+
+ </Tab>
+</Tabs>
+
 安裝完畢後，Intlayer 將會自動偵測並使用該外掛程式。
 
 至於**清除（purge）和最小化（minify）**步驟（即欄位移除和欄位重新命名），請連同 `@intlayer/babel` 一併安裝並加入 Babel 外掛程式。由於 Next.js 依靠 SWC 處理程式碼轉化，但仍會評估 `babel.config.js` 以決定外掛程式設定，因此上述 Babel 外掛程式能夠在進入 SWC 前作為預處理步驟得以執行。

package/docs/zh-TW/intlayer_with_angular_21.md

@@ -85,28 +85,48 @@ author: aymericzip
 
 使用npm安裝必要的套件：
 
+```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
+```
+
+> `--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": "9.0.0-canary.2",
+  "version": "9.0.0-canary.21",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,22 +73,22 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "9.0.0-canary.2",
-    "@intlayer/core": "9.0.0-canary.2",
-    "@intlayer/types": "9.0.0-canary.2"
+    "@intlayer/config": "9.0.0-canary.21",
+    "@intlayer/core": "9.0.0-canary.21",
+    "@intlayer/types": "9.0.0-canary.21"
   },
   "devDependencies": {
-    "@intlayer/api": "9.0.0-canary.2",
-    "@intlayer/cli": "9.0.0-canary.2",
-    "@types/node": "25.9.3",
+    "@intlayer/api": "9.0.0-canary.21",
+    "@intlayer/cli": "9.0.0-canary.21",
+    "@types/node": "26.1.1",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
     "fast-glob": "3.3.3",
     "rimraf": "6.1.3",
-    "tsdown": "0.21.10",
-    "typescript": "6.0.3",
-    "vitest": "4.1.9"
+    "tsdown": "0.22.12",
+    "typescript": "7.0.2",
+    "vitest": "4.1.10"
   },
   "engines": {
     "node": ">=14.18"