@intlayer/docs 6.0.2 → 6.1.0

package/docs/zh/packages/lynx-intlayer/index.md

@@ -1,83 +0,0 @@
----
-createdAt: 2025-03-13
-updatedAt: 2025-06-29
-title: 包文档 | lynx-intlayer
-description: 查看如何使用 lynx-intlayer 包
-keywords:
-  - Intlayer
-  - lynx-intlayer
-  - 国际化
-  - 文档
-  - Next.js
-  - JavaScript
-  - React
-slugs:
-  - doc
-  - packages
-  - lynx-intlayer
----
-
-# lynx-intlayer：为 Lynx 应用程序实现国际化（i18n）
-
-**Intlayer** 是一套专为 JavaScript 开发者设计的包集合。它兼容 React、React 和 Express.js 等框架。
-
-**`lynx-intlayer` 包** 允许您为 Vite 应用程序实现国际化。它包含 Metro 插件，通过环境变量将配置设置到 [Lynx 打包器](https://lynxjs.org/index.html) 中。
-
-## 为什么要为您的 Lynx 应用程序实现国际化？
-
-为您的 Lynx 应用程序实现国际化对于有效服务全球用户至关重要。它使您的应用程序能够以每个用户偏好的语言提供内容和信息。这种能力提升了用户体验，并通过使应用程序对不同语言背景的人更易访问和更具相关性，扩大了应用程序的覆盖范围。
-
-## 配置
-
-`lynx-intlayer` 包与 [`react-intlayer` 包](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/react-intlayer/index.md) 和 [`intlayer` 包](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/intlayer/index.md) 无缝协作。有关更多信息，请查看相关文档。
-
-## 安装
-
-使用您喜欢的包管理器安装所需的包：
-
-```bash packageManager="npm"
-npm install lynx-intlayer
-```
-
-```bash packageManager="yarn"
-yarn add lynx-intlayer
-```
-
-```bash packageManager="pnpm"
-pnpm add lynx-intlayer
-```
-
-## 使用示例
-
-查看如何将插件包含到您的 vite 配置中的示例。
-
-```ts
-// lynx.config.ts
-import { defineConfig } from "@lynx-js/rspeedy";
-import { pluginIntlayerLynx } from "lynx-intlayer/plugin";
-
-export default defineConfig({
-  plugins: [
-    // ... 其他插件
-    pluginIntlayerLynx(),
-  ],
-});
-```
-
-## 精通您的 Vite 应用程序的国际化
-
-Intlayer 提供了许多功能，帮助您实现 Vite 应用程序的国际化。
-
-**要了解有关这些功能的更多信息，请参阅 Lynx 应用程序的 [使用 Intlayer 和 Lynx 的 React 国际化 (i18n)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_lynx+react.md) 指南。**
-
-## 了解 Intlayer
-
-- [Intlayer 网站](https://intlayer.org)
-- [Intlayer 文档](https://intlayer.org/doc)
-- [Intlayer GitHub](https://github.com/aymericzip/intlayer)
-
-- [向我们的智能文档提问](https://intlayer.org/doc/chat)
-
-## 文档历史
-
-- 5.5.10 - 2025-06-29：初始化历史

package/docs/zh/packages/next-intlayer/index.md

@@ -1,285 +0,0 @@
----
-createdAt: 2024-08-11
-updatedAt: 2025-06-29
-title: 包文档 | next-intlayer
-description: 查看如何使用 next-intlayer 包
-keywords:
-  - Intlayer
-  - next-intlayer
-  - 国际化
-  - 文档
-  - Next.js
-  - JavaScript
-  - React
-slugs:
-  - doc
-  - packages
-  - next-intlayer
----
-
-# next-intlayer：用于国际化（i18n）Next.js 应用的 NPM 包
-
-**Intlayer** 是一套专为 JavaScript 开发者设计的包。它兼容 React、Next.js 和 Express.js 等框架。
-
-**`next-intlayer` 包** 允许您对 Next.js 应用进行国际化。它提供了用于 Next.js 国际化的上下文提供者和钩子。此外，它还包含用于将 Intlayer 集成到 [Webpack](https://webpack.js.org/) 或 [Turbopack](https://nextjs.org/docs/app/api-reference/turbopack) 的 Next.js 插件，以及用于检测用户首选语言环境、管理 Cookie 和处理 URL 重定向的中间件。
-
-## 为什么要对您的 Next.js 应用进行国际化？
-
-国际化您的 Next.js 应用对于有效服务全球用户至关重要。它使您的应用能够以每个用户偏好的语言传递内容和信息。这种能力提升了用户体验，扩大了应用的覆盖范围，使其对来自不同语言背景的人们更具可访问性和相关性。
-
-## 为什么要集成 Intlayer？
-
-- **基于 JavaScript 的内容管理**：利用 JavaScript 的灵活性高效定义和管理您的内容。
-- **类型安全环境**：借助 TypeScript 确保所有内容定义准确无误。
-- **集成内容文件**：将翻译内容与各自组件紧密结合，提升可维护性和清晰度。
-
-## 安装
-
-使用您喜欢的包管理器安装必要的包：
-
-```bash packageManager="npm"
-npm install next-intlayer
-```
-
-```bash packageManager="yarn"
-yarn add next-intlayer
-```
-
-```bash packageManager="pnpm"
-pnpm add next-intlayer
-```
-
-## 使用示例
-
-使用 Intlayer，您可以在代码库中的任何地方以结构化的方式声明您的内容。
-
-默认情况下，Intlayer 会扫描扩展名为 `.content.{json,ts,tsx,js,jsx,mjs,mjx,cjs,cjx}` 的文件。
-
-> 您可以通过在[配置文件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)中设置 `contentDir` 属性来修改默认扩展名。
-
-```bash codeFormat="typescript"
-.
-├── intlayer.config.ts
-└── src
-    └── components
-        ├── ClientComponent
-        │   ├── index.content.ts
-        │   └── index.tsx
-        └── ServerComponent
-            ├── index.content.ts
-            └── index.tsx
-```
-
-```bash codeFormat="esm"
-.
-├── intlayer.config.mjs
-└── src
-    └── components
-        ├── ClientComponent
-        │   ├── index.content.mjs
-        │   └── index.mjx
-        └── ServerComponent
-            ├── index.content.mjs
-            └── index.mjx
-```
-
-```bash codeFormat="commonjs"
-.
-├── intlayer.config.cjs
-└── src
-    └── components
-        ├── ClientComponent
-        │   ├── index.content.cjs
-        │   └── index.cjx
-        └── ServerComponent
-            ├── index.content.cjs
-            └── index.cjx
-```
-
-### 声明你的内容
-
-`next-intlayer` 设计用于配合 [`intlayer` 包](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/intlayer/index.md) 使用。`intlayer` 是一个允许你在代码中的任何位置声明内容的包。它将多语言内容声明转换为结构化的字典，能够无缝集成到你的应用程序中。
-
-以下是内容声明的示例：
-
-```tsx fileName="src/ClientComponent/index.content.ts" codeFormat="typescript"
-import { t, type Dictionary } from "intlayer";
-
-const clientComponentContent = {
-  key: "client-component",
-  content: {
-    myTranslatedContent: t({
-      en: "Hello World",
-      es: "Hola Mundo",
-      fr: "Bonjour le monde",
-    }),
-    numberOfCar: enu({
-      "<-1": "Less than minus one car",
-      "-1": "负一辆车",
-      "0": "没有车",
-      "1": "一辆车",
-      ">5": "几辆车",
-      ">19": "许多车",
-    }),
-  },
-} satisfies Dictionary;
-
-export default clientComponentContent;
-```
-
-```jsx fileName="src/ClientComponent/index.content.mjs" contentDeclarationFormat="esm"
-import { t } from "intlayer";
-
-/** @type {import('intlayer').Dictionary} */
-const clientComponentContent = {
-  key: "client-component",
-  content: {
-    myTranslatedContent: t({
-      en: "Hello World",
-      es: "Hola Mundo",
-      fr: "Bonjour le monde",
-    }),
-    numberOfCar: enu({
-      "<-1": "少于负一辆车",
-      "-1": "负一辆车",
-      "0": "没有车",
-      "1": "一辆车",
-      ">5": "几辆车",
-      ">19": "许多车",
-    }),
-  },
-};
-
-export default clientComponentContent;
-```
-
-```jsx fileName="src/ClientComponent/index.content.cjs" contentDeclarationFormat="commonjs"
-const { t } = require("intlayer");
-
-/** @type {import('intlayer').Dictionary} */
-const clientComponentContent = {
-  key: "client-component",
-  content: {
-    myTranslatedContent: t({
-      en: "Hello World",
-      es: "Hola Mundo",
-      fr: "Bonjour le monde",
-    }),
-    numberOfCar: enu({
-      "<-1": "少于负一辆车",
-      "-1": "负一辆车",
-      "0": "没有车",
-      "1": "一辆车",
-      ">5": "一些车",
-      ">19": "许多车",
-    }),
-  },
-};
-
-module.exports = clientComponentContent;
-```
-
-```json fileName="src/ClientComponent/index.content.json" codeFormat="json"
-{
-  "key": "client-component",
-  "content": {
-    "myTranslatedContent": {
-      "nodeType": "translation",
-      "translation": {
-        "en": "Hello World",
-        "fr": "Bonjour le monde",
-        "es": "Hola Mundo"
-      }
-    },
-    "numberOfCar": {
-      "nodeType": "enumeration",
-      "enumeration": {
-        "<-1": "少于负一辆车",
-        "-1": "负一辆车",
-        "0": "没有车",
-        "1": "一辆车",
-        ">5": "一些车",
-        ">19": "许多车"
-      }
-    }
-  }
-}
-```
-
-### 在代码中使用内容
-
-一旦声明了内容，就可以在代码中使用它。以下是如何在 React 组件中使用内容的示例：
-
-```tsx {4,7} fileName="src/components/ClientComponentExample.tsx" codeFormat="typescript"
-"use client";
-
-import type { FC } from "react";
-import { useIntlayer } from "next-intlayer";
-
-export const ClientComponentExample: FC = () => {
-  const { myTranslatedContent } = useIntlayer("client-component"); // 创建相关内容声明
-
-  return (
-    <div>
-      <p>{myTranslatedContent}</p>
-    </div>
-  );
-};
-```
-
-```jsx {3,6} fileName="src/components/ClientComponentExample.mjx" codeFormat="esm"
-"use client";
-
-import { useIntlayer } from "next-intlayer";
-
-const ClientComponentExample = () => {
-  const { myTranslatedContent } = useIntlayer("client-component"); // 创建相关内容声明
-
-  return (
-    <div>
-      <p>{myTranslatedContent}</p>
-    </div>
-  );
-};
-```
-
-```jsx {3,6} fileName="src/components/ClientComponentExample.csx" codeFormat="commonjs"
-"use client";
-
-const { useIntlayer } = require("next-intlayer");
-
-const ClientComponentExample = () => {
-  const { myTranslatedContent } = useIntlayer("client-component"); // 创建相关内容声明
-
-  return (
-    <div>
-      <p>{myTranslatedContent}</p>
-    </div>
-  );
-};
-```
-
-## 精通您的 Next.js 应用程序的国际化
-
-Intlayer 提供了许多功能，帮助您实现 Next.js 应用程序的国际化。以下是一些关键功能：
-
-- **服务器组件的国际化**：Intlayer 允许您以与客户端组件相同的方式对服务器组件进行国际化。这意味着您可以为客户端和服务器组件使用相同的内容声明。
-- **用于语言环境检测的中间件**：Intlayer 提供了用于检测用户首选语言环境的中间件。该中间件用于检测用户的首选语言环境，并根据[配置](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)将用户重定向到相应的 URL。
-- **元数据的国际化**：Intlayer 提供了一种国际化元数据的方法，例如页面标题，使用 Next.js 提供的 `generateMetadata` 函数。您可以使用 `getTranslation` 函数来翻译您的元数据。
-- **sitemap.xml 和 robots.txt 的国际化**：Intlayer 允许您对 sitemap.xml 和 robots.txt 文件进行国际化。您可以使用 `getMultilingualUrls` 函数为您的 sitemap 生成多语言 URL。
-- **URL 的国际化**：Intlayer 允许您通过使用 `getMultilingualUrls` 函数来实现 URL 的国际化。该函数为您的 sitemap 生成多语言 URL。
-
-**要了解有关这些功能的更多信息，请参阅 [Next.js 与 Intlayer 及 Next.js 15 App Router 的国际化 (i18n)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_nextjs_15.md) 指南。**
-
-## `next-intlayer` 包提供的函数
-
-`next-intlayer` 包还提供了一些函数，帮助您实现应用程序的国际化。
-
-- [`t()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/next-intlayer/t.md)
-- [`useIntlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/next-intlayer/useIntlayer.md)
-- [`useDictionary()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/next-intlayer/useDictionary.md)
-- [`useLocale()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/next-intlayer/useLocale.md)
-
-## 文档历史
-
-- 5.5.10 - 2025-06-29：初始化历史

package/docs/zh/packages/nuxt-intlayer/index.md

@@ -1,53 +0,0 @@
----
-createdAt: 2025-06-18
-updatedAt: 2025-06-29
-title: 包文档 | nuxt-intlayer
-description: 查看如何使用 nuxt-intlayer 包
-keywords:
-  - Intlayer
-  - nuxt-intlayer
-  - 国际化
-  - 文档
-  - JavaScript
-  - Nuxt
-slugs:
-  - doc
-  - packages
-  - nuxt-intlayer
----
-
-# nuxt-intlayer：用于国际化（i18n）Vue 应用的 NPM 包
-
-**Intlayer** 是一套专为 JavaScript 开发者设计的包集合。它兼容 Vue、Vue 和 Express.js 等框架。
-
-**`nuxt-intlayer` 包** 允许您对 Vue 应用进行国际化。它为 Vue 国际化提供了上下文提供者和钩子。
-
-## 为什么要对您的 Vue 应用进行国际化？
-
-对 Vue 应用进行国际化对于有效服务全球用户至关重要。它使您的应用能够以每个用户偏好的语言传递内容和信息。这种能力提升了用户体验，并通过使应用对不同语言背景的人更易访问和相关，扩大了应用的影响范围。
-
-## 为什么要集成 Intlayer？
-
-- **基于 JavaScript 的内容管理**：利用 JavaScript 的灵活性高效定义和管理您的内容。
-- **类型安全环境**：利用 TypeScript 确保所有内容定义准确无误，避免错误。
-- **集成内容文件**：将翻译内容与各自组件紧密结合，提高可维护性和清晰度。
-
-## 安装
-
-使用您喜欢的包管理器安装所需的包：
-
-```bash packageManager="npm"
-npm install nuxt-intlayer
-```
-
-```bash packageManager="yarn"
-yarn add nuxt-intlayer
-```
-
-```bash packageManager="pnpm"
-pnpm add nuxt-intlayer
-```
-
-## 文档历史
-
-- 5.5.10 - 2025-06-29：初始化历史

package/docs/zh/packages/preact-intlayer/index.md

@@ -1,53 +0,0 @@
----
-createdAt: 2025-04-18
-updatedAt: 2025-06-29
-title: 包文档 | preact-intlayer
-description: 查看如何使用 preact-intlayer 包
-keywords:
-  - Intlayer
-  - preact-intlayer
-  - 国际化
-  - 文档
-  - JavaScript
-  - Preact
-slugs:
-  - doc
-  - packages
-  - preact-intlayer
----
-
-# preact-intlayer：用于国际化（i18n）Preact 应用的 NPM 包
-
-**Intlayer** 是一套专为 JavaScript 开发者设计的包集合。它兼容 Preact、Preact 和 Express.js 等框架。
-
-**`preact-intlayer` 包** 允许您对 Preact 应用进行国际化。它为 Preact 国际化提供了上下文提供者和钩子。
-
-## 为什么要对您的 Preact 应用进行国际化？
-
-对您的 Preact 应用进行国际化对于有效服务全球用户至关重要。它使您的应用能够以每个用户偏好的语言传递内容和信息。这种能力提升了用户体验，并通过使应用对不同语言背景的人群更易访问和相关，扩大了应用的覆盖范围。
-
-## 为什么要集成 Intlayer？
-
-- **基于 JavaScript 的内容管理**：利用 JavaScript 的灵活性高效地定义和管理您的内容。
-- **类型安全环境**：利用 TypeScript 确保所有内容定义准确无误且无错误。
-- **集成内容文件**：将翻译内容与各自组件紧密结合，提升可维护性和清晰度。
-
-## 安装
-
-使用您偏好的包管理器安装所需的包：
-
-```bash packageManager="npm"
-npm install preact-intlayer
-```
-
-```bash packageManager="yarn"
-yarn add preact-intlayer
-```
-
-```bash packageManager="pnpm"
-pnpm add preact-intlayer
-```
-
-## 文档历史
-
-- 5.5.10 - 2025-06-29：初始化历史