@intlayer/docs 5.5.8

package/zh/privacy_notice.md

@@ -0,0 +1,61 @@
+# 隐私通知
+
+## 简介
+
+在 Intlayer，我们非常重视隐私。本声明解释了我们如何处理通过我们的网站和 CMS 收集的信息。
+
+## 联系方式
+
+如果您对隐私有任何疑问或担忧，请通过以下地址联系我们：[contact@intlayer.org](mailto:contact@intlayer.org)。
+
+## 使用 Cookies 和跟踪技术
+
+我们使用 **Google Analytics** 和 **Meta (Facebook) Pixel** 来分析我们网站的使用情况并改进我们的服务。这些工具通过存储在用户设备上的 cookies 生成有关网站的统计数据和其他信息。
+
+更多信息请参阅：
+
+- [Google 的隐私政策](https://policies.google.com/privacy)
+- [Meta 的隐私政策](https://www.facebook.com/privacy/policy)
+
+## 身份验证和用户数据
+
+访问 Intlayer CMS 需要用户身份验证。我们提供电子邮件/密码身份验证以及通过 **Google** 和 **GitHub** 的第三方登录。
+
+在身份验证过程中，我们会收集以下信息：
+
+- 电子邮件地址
+- 显示名称（或选择的名称）
+
+用户还可以通过与其账户关联的访问令牌访问 CMS。这些令牌与相同的身份验证数据相关联。
+
+## 数据存储和安全
+
+用户身份验证数据存储在 **MongoDB 数据库** 中，托管于 **cloud.mongodb.com**：
+
+- **区域：** AWS / Oregon (us-west-2)
+- **类型：** 副本集 (3 个节点)
+- **密码安全：** 所有密码均使用行业标准方法进行哈希处理。
+
+我们不会存储除身份验证和安全 CMS 访问所需之外的任何不必要的个人数据。
+
+## 与第三方的数据共享
+
+我们**不会**出售或与第三方共享您的个人数据，除非是用于分析（Google Analytics、Facebook Pixel）或作为身份验证过程的一部分（Google 或 GitHub 登录）。
+
+## 用户权利
+
+作为用户，您有权：
+
+- 访问我们持有的关于您的个人数据
+- 请求更正或删除您的数据
+- 撤销访问权限或删除您的账户
+
+有关您的数据的任何请求，请通过 [contact@intlayer.org](mailto:contact@intlayer.org) 联系我们。
+
+## 本声明的变更
+
+我们可能会不时更新本隐私声明。建议用户定期查看此页面以了解任何更改。
+
+---
+
+如果您希望使用更正式的语气，添加 GDPR/CCPA 提及，或将其调整为您网站上的法律页面，请告诉我们。

package/zh/roadmap.md

@@ -0,0 +1,206 @@
+# Intlayer: 功能概览与路线图
+
+Intlayer 是一种内容管理和国际化解决方案，旨在简化您在应用程序中声明、管理和更新内容的方式。它提供了强大的功能，例如集中式或分布式内容声明、广泛的国际化选项、Markdown 支持、条件渲染、TypeScript/JavaScript/JSON 集成等。以下是 Intlayer 当前功能的全面概述，以及即将推出的路线图功能。
+
+---
+
+## 当前功能
+
+### 1. 内容声明
+
+#### 集中式或分布式
+
+- **集中式**：在应用程序的基础位置使用一个大型文件声明所有内容，类似于 i18next，这样您可以在一个地方管理所有内容。
+- **分布式**：或者，将内容拆分到组件或功能级别的单独文件中，以提高可维护性。这使您的内容与相关代码（组件、测试、Storybook 等）保持紧密联系。移除组件时，相关内容也会被移除，防止遗留数据使代码库变得混乱。
+
+> 资源:
+
+> - [内容声明](https://github.com/aymericzip/intlayer/blob/main/docs/zh/dictionary/get_started.md)
+
+### 2. 国际化
+
+- 支持 **230 种语言和区域**（包括区域变体，如法语（法国）、英语（加拿大）、英语（英国）、葡萄牙语（葡萄牙）等）。
+- 可以轻松地从一个地方管理所有这些语言的翻译。
+
+> 资源:
+
+> - [国际化](https://github.com/aymericzip/intlayer/blob/main/docs/zh/dictionary/translation.md)
+
+### 3. Markdown 支持
+
+- 使用 **Markdown** 声明内容，允许您自动格式化带有段落、标题、链接等的文本。
+- 非常适合博客文章、文档页面或任何需要丰富文本格式的场景。
+
+> 资源:
+
+> - [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/zh/dictionary/markdown.md)
+
+### 4. 条件渲染
+
+- 定义基于特定条件（如用户语言、用户登录状态或任何其他上下文相关变量）适应的内容。
+- 帮助定制个性化体验，而无需在多个文件中重复内容。
+
+> 资源:
+
+> - [条件渲染](https://github.com/aymericzip/intlayer/blob/main/docs/zh/dictionary/condition.md)
+
+### 5. 内容声明格式
+
+Intlayer 支持使用 **TypeScript**（也支持 JavaScript）和 **JSON** 声明内容。
+
+- **TypeScript**:
+
+  - 确保您的内容结构正确且没有缺失的翻译。
+  - 提供严格或更灵活的验证模式。
+  - 允许从变量、函数或外部 API 动态获取数据。
+
+- **JSON**:
+
+  - 由于其标准化格式，便于与外部工具（如可视化编辑器）集成。
+
+  > 资源:
+  >
+  > - [内容声明格式](https://github.com/aymericzip/intlayer/blob/main/docs/zh/dictionary/content_extention_customization.md)
+
+---
+
+## 与框架和环境的集成
+
+### 1. Next.js
+
+#### a. 服务端和客户端组件
+
+- 为服务端和客户端组件提供 **统一的内容管理方法**。
+- 为服务端组件提供内置上下文，与其他解决方案相比简化了实现。
+
+#### b. 元数据、站点地图和 robots.txt
+
+- 动态获取并注入内容以生成元数据、站点地图或 `robots.txt` 文件。
+
+#### c. 中间件
+
+- 添加中间件以根据用户的首选语言 **重定向用户** 到相应内容。
+
+#### d. Turbopack 和 Webpack 兼容性
+
+- 完全兼容新的 Next.js Turbopack 以及传统的 Webpack。
+
+> 资源:
+
+> - [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/zh/intlayer_with_nextjs_15.md)
+
+### 2. Vite
+
+- 类似于 Next.js，您可以将 Intlayer 与 Vite 集成，并使用 **中间件** 根据用户的首选语言重定向到相应内容。
+
+> 资源:
+
+> - [Vite](https://github.com/aymericzip/intlayer/blob/main/docs/zh/intlayer_with_vite+react.md)
+
+### 3. Express
+
+- 管理内容并国际化基于 Express 构建的后端服务。
+- 使用本地化文本个性化电子邮件、错误消息、推送通知等。
+
+> 资源:
+
+> - [Express](https://github.com/aymericzip/intlayer/blob/main/docs/zh/intlayer_with_express.md)
+
+---
+
+## 可视化编辑器和 CMS
+
+### 1. 本地可视化编辑器
+
+- 一个 **免费的本地可视化编辑器**，允许您通过直接选择页面上的元素来编辑应用程序内容。
+- 集成 AI 功能以帮助：
+  - 生成或修复翻译
+  - 检查语法和拼写
+  - 提出改进建议
+- 可以本地托管或部署在远程服务器上。
+
+> 资源:
+
+> - [可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/zh/intlayer_visual_editor.md)
+
+### 2. Intlayer CMS（远程）
+
+- 一个 **托管的 CMS** 解决方案，允许您在线管理应用程序内容，而无需接触代码库。
+- 提供 AI 辅助功能，用于声明内容、管理翻译以及修复语法或拼写错误。
+- 通过您的实时应用程序界面与内容交互。
+
+> 资源:
+
+> - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/zh/intlayer_CMS.md)
+
+---
+
+## Intlayer CLI
+
+- **审计和翻译生成**：对内容文件运行审计以生成缺失的翻译或识别未使用的翻译。
+- **远程交互**：将本地内容发布到远程 CMS 或获取远程内容以集成到本地应用程序中。
+- 对于 **CI/CD 管道** 非常有用，确保您的内容始终与代码同步。
+
+> 资源:
+
+> - [CLI](https://github.com/aymericzip/intlayer/blob/main/docs/zh/intlayer_cli.md)
+
+---
+
+## 环境
+
+- 使用 **环境变量** 在生产、测试和本地环境中以不同方式配置 Intlayer。
+- 根据您的环境定义要定位的可视化编辑器或远程 CMS 项目。
+
+---
+
+## 热内容更新
+
+- 使用远程字典和 Intlayer CMS 时，您可以 **实时更新应用程序的内容**，无需重新部署。
+
+> 资源:
+
+> - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/zh/intlayer_CMS.md)
+
+---
+
+## 路线图：即将推出的功能
+
+### 1. A/B 测试与个性化
+
+- **多变量测试**：测试内容的不同版本以查看哪个表现最佳（例如更高的点击率）。
+- **数据驱动的个性化**：根据用户人口统计（性别、年龄、位置等）或其他行为模式显示不同内容。
+- **自动迭代**：允许 AI 自动测试多个版本，并选择表现最佳的版本或推荐选项供管理员批准。
+
+### 2. 版本控制
+
+- 使用 **内容版本控制** 恢复内容的先前版本。
+- 跟踪随时间的更改，并在需要时恢复到早期状态。
+
+### 3. 自动翻译
+
+- 对于远程 CMS 用户，支持 **一键翻译生成** 任意支持的语言。
+- 系统将在后台生成翻译，然后提示您进行验证或编辑。
+
+### 4. SEO 增强
+
+- 工具用于 **分析关键词**、用户搜索意图和新兴趋势。
+- 提出改进内容的建议以获得更好的排名，并跟踪长期表现。
+
+### 5. 与更多框架的兼容性
+
+- 正在努力支持 **Vite、Angular、React Native** 等。
+- 目标是使 Intlayer 与 **任何基于 JavaScript 的应用程序** 兼容。
+
+### 6. IDE 扩展
+
+- 为主要 IDE 提供扩展，提供 **图形界面** 来管理本地和远程翻译。
+- 功能可能包括为组件自动生成内容声明文件、与 Intlayer CMS 的直接集成以及实时验证。
+
+---
+
+## 结论
+
+Intlayer 旨在成为内容管理和国际化的一站式解决方案。它专注于灵活性（集中式或分布式文件）、广泛的语言支持、与现代框架和打包工具的轻松集成以及强大的 AI 驱动功能。随着 A/B 测试、版本控制和自动翻译等新功能的推出，Intlayer 将继续简化内容工作流并提升不同平台上的用户体验。
+
+敬请期待即将发布的版本，并随时探索现有功能，看看 Intlayer 如何帮助集中和优化您的内容管理流程！

package/zh/terms_of_service.md

@@ -0,0 +1,33 @@
+# 服务条款
+
+## 1. 接受条款
+
+使用 Intlayer 即表示您同意受这些使用条款的约束。如果您不接受这些条款，请不要使用该工具。
+
+## 2. 许可
+
+Intlayer 根据 **Apache 2.0 许可** 分发，该许可允许在开源和商业项目中使用、修改和分发代码。用户可以修改源代码并按照我们[贡献指南](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md)中规定的指南通过拉取请求提交贡献。严禁为商业用途盗用代码。
+
+## 3. 商业用途
+
+您可以将 Intlayer 用于商业项目。然而，禁止在没有显著改造或实质性价值增加的情况下，重用代码创建基于 Intlayer 的直接竞争工具。
+
+## 4. 责任
+
+Intlayer 的维护者努力在发现错误和安全问题后尽快修复。然而，他们对用户基础设施因这些问题而导致的损害不承担任何责任。我们鼓励用户通过我们的[问题跟踪系统](https://github.com/aymericzip/intlayer/issues)报告问题。
+
+## 5. 隐私
+
+Intlayer 不会收集或存储用户的任何个人数据。
+
+## 6. 贡献
+
+我们鼓励用户按照贡献指南为 Intlayer 做出贡献。任何提交的代码必须符合既定的质量标准，并将在集成之前由维护者进行审查。
+
+## 7. 归属
+
+任何扩展或利用 Intlayer 代码开发的工具必须明确将 Intlayer 作为代码的基础进行归属。此归属必须在源代码以及任何用户或宣传文档中可见。
+
+## 8. 条款修改
+
+这些使用条款可能随时修改。用户将被告知使用条款的任何重大更改，并且必须接受这些更改才能继续使用 Intlayer。

package/zh/vs_code_extension.md

@@ -0,0 +1,139 @@
+# Intlayer VS Code 扩展
+
+## 概述
+
+**Intlayer** 是 **Intlayer** 的官方 Visual Studio Code 扩展，旨在提升开发者在 **React、Next.js 和 JavaScript** 项目中处理本地化内容的体验。
+
+通过此扩展，开发者可以**快速导航**到其内容字典，管理本地化文件，并通过强大的自动化命令优化工作流程。
+
+![Intlayer VS Code Extension](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif)
+
+扩展链接: [https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)
+
+## 功能
+
+### 即时导航
+
+**定义跳转支持** – 使用 `Cmd+Click`（Mac）或 `Ctrl+Click`（Windows/Linux）点击 `useIntlayer` 键，立即打开对应的内容文件。  
+**无缝集成** – 与 **react-intlayer** 和 **next-intlayer** 项目完美兼容。  
+**多语言支持** – 支持跨多种语言的本地化内容。  
+**VS Code 集成** – 与 VS Code 的导航和命令面板无缝整合。
+
+### 字典管理命令
+
+直接从 VS Code 管理您的内容字典：
+
+- **生成字典** (`extension.buildDictionaries`) – 根据项目结构生成内容文件。
+- **上传字典** (`extension.pushDictionaries`) – 将最新的字典内容上传到您的代码库。
+- **同步字典** (`extension.pullDictionaries`) – 将代码库中的最新字典内容同步到本地环境。
+
+### 内容声明生成器
+
+轻松生成不同格式的结构化字典文件：
+
+- **TypeScript (`.ts`)** – `extension.createDictionaryFile.ts`
+- **ES Module (`.esm`)** – `extension.createDictionaryFile.esm`
+- **CommonJS (`.cjs`)** – `extension.createDictionaryFile.cjs`
+- **JSON (`.json`)** – `extension.createDictionaryFile.json`
+
+## 安装
+
+您可以直接从 VS Code Marketplace 安装 **Intlayer**：
+
+1. 打开 **VS Code**。
+2. 进入 **扩展市场**。
+3. 搜索 **"Intlayer"**。
+4. 点击 **安装**。
+
+或者，通过命令行安装：
+
+```sh
+code --install-extension intlayer
+```
+
+## 使用方法
+
+### 快速导航
+
+1. 打开一个使用 **react-intlayer** 的项目。
+2. 找到一个 `useIntlayer()` 调用，例如：
+
+   ```tsx
+   const content = useIntlayer("app");
+   ```
+
+3. **Command+点击**（macOS 上为 `⌘+Click`）或 **Ctrl+点击**（Windows/Linux 上）键（例如 `"app"`）。
+4. VS Code 将自动打开对应的字典文件，例如 `src/app.content.ts`。
+
+### 管理内容字典
+
+#### 生成字典
+
+使用以下命令生成所有字典内容文件：
+
+```sh
+Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
+```
+
+搜索 **Build Dictionaries** 并执行命令。
+
+#### 上传字典
+
+上传最新的字典内容：
+
+1. 打开 **命令面板**。
+2. 搜索 **Push Dictionaries**。
+3. 选择要上传的字典并确认。
+
+#### 同步字典
+
+同步最新的字典内容：
+
+1. 打开 **命令面板**。
+2. 搜索 **Pull Dictionaries**。
+3. 选择要同步的字典。
+
+### 自定义字典文件路径
+
+默认情况下，扩展遵循标准的 **Intlayer** 项目结构。不过，您可以配置自定义路径：
+
+1. 打开 **设置（`Cmd + ,` 在 macOS / `Ctrl + ,` 在 Windows/Linux）**。
+2. 搜索 `Intlayer`。
+3. 调整内容文件路径设置。
+
+## 开发与贡献
+
+想要贡献代码？我们欢迎社区贡献！
+
+代码库地址: https://github.com/aymericzip/intlayer-vs-code-extension
+
+### 入门指南
+
+克隆代码库并安装依赖：
+
+```sh
+git clone https://github.com/aymericzip/intlayer-vs-code-extension.git
+cd intlayer-vs-code-extension
+npm install
+```
+
+> 使用 `npm` 包管理器以确保与 `vsce` 包兼容，用于构建和发布扩展。
+
+### 开发模式运行
+
+1. 在 **VS Code** 中打开项目。
+2. 按 `F5` 启动一个新的 **扩展开发主机** 窗口。
+
+### 提交拉取请求
+
+如果您改进了扩展，请在 [GitHub](https://github.com/aymericzip/intlayer-vs-code-extension) 上提交 PR。
+
+## 反馈与问题
+
+发现错误或有功能请求？请在我们的 **GitHub 代码库** 上提交问题：
+
+[GitHub Issues](https://github.com/aymericzip/intlayer-vs-code-extension/issues)
+
+## 许可证
+
+Intlayer 根据 **MIT 许可证** 发布。