@intlayer/docs 5.5.10 → 5.5.11

package/zh/privacy_notice.md

@@ -1,61 +0,0 @@
-# 隐私通知
-
-## 简介
-
-在 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

@@ -1,206 +0,0 @@
-# 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

@@ -1,33 +0,0 @@
-# 服务条款
-
-## 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

@@ -1,139 +0,0 @@
-# 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 许可证** 发布。