i18n Gettext 0.2.1

i18n Gettext for VSCode：多语言翻译管理扩展，简化您的国际化开发

i18n Gettext for VSCode是一款基于Gettext的多语言翻译管理扩展，旨在帮助开发者轻松处理多语言项目的翻译工作。无论您是个人开发者还是团队成员，这款扩展都能为您提供高效的翻译管理解决方案。

功能特点：

• 翻译管理：集中管理和编辑PO翻译文件，简化翻译工作流程。
• 快速搜索：轻松查找和导航翻译条目，提升工作效率。
• 翻译进度：直观显示项目翻译完成度，帮助您掌控项目进展。
• AI翻译：支持多种AI模型进行高质量翻译，包括Deepseek、OpenAI、Anthropic、Mistral等，满足您的翻译需求。
• 机器翻译：集成Google翻译引擎，提供快速的机器翻译服务。
• 编辑器集成：专用的翻译编辑界面，方便您进行翻译编辑。
• 引用导航：支持从代码直接跳转到对应的翻译条目，提高开发效率。
• 文件监听：自动检测并同步翻译文件变化，确保翻译内容始终最新。
• 条目过滤：支持按全部/已翻译/未翻译条目进行筛选，方便管理翻译进度。

安装与要求：

• 在VSCode扩展商店中搜索"i18n Gettext"，点击安装即可使用。
• 要求VSCode 1.89.0或更高版本。

使用方法：

1. 配置翻译文件路径：扩展默认配置翻译文件位于 src/language/${locale}/${domain}.po，您可以根据项目结构进行自定义。
2. 访问翻译管理面板：点击活动栏中的"i18n Gettext"图标，打开翻译管理面板。
3. 查看当前文件翻译：打开包含国际化字符串的文件，翻译面板将显示该文件中的所有翻译内容。
4. 编辑翻译：点击任意翻译条目右侧的编辑图标，打开翻译编辑器进行编辑。
5. 查看翻译进度：在"翻译进度"视图中查看项目中各语言的翻译完成度。
6. 搜索翻译条目：使用翻译面板顶部的搜索功能，快速查找特定翻译条目。
7. 过滤翻译条目：使用翻译面板顶部的过滤按钮，筛选显示全部/已翻译/未翻译的条目。
8. 使用AI翻译：在翻译编辑器中选择AI模型进行单条或批量翻译。

配置选项：

在VSCode设置中，可以找到"i18n Gettext"部分，配置以下选项：

{
  "i18n-gettext.localesConfig": {
    "type": "nested",
    "basePath": "src/language",
    "pattern": "${locale}/${domain}.po",
    "defaultDomain": "app",
    "sourceLanguage": "en-US"
  }
}

• type：翻译文件组织方式，支持flat、nested、domain、custom四种类型。
• basePath：翻译文件根目录。
• pattern：翻译文件路径模式，使用${locale}和${domain}占位符。
• defaultDomain：默认域名。
• sourceLanguage：源语言代码。
• translator.engines：支持的翻译引擎。

AI翻译配置：

要使用AI翻译功能，需要在项目根目录或.vscode目录下创建.i18n-gettext.secret配置文件，格式如下：

{
  "ai": [
    {
      "provider": "openai",
      "modelId": "gpt-4o",
      "apiKey": "your-api-key"
    },
    {
      "provider": "anthropic",
      "modelId": "claude-3-opus-20240229",
      "apiKey": "your-api-key"
    },
    {
      "provider": "deepseek",
      "modelId": "deepseek-chat",
      "apiKey": "your-api-key"
    }
  ]
}

支持的AI提供商包括openai、deepseek、anthropic、mistral、groq、cohere、perplexity、deepseek、amazon-bedrock、azure、google-vertex等多种AI模型提供商。

提示与技巧：

• 在代码中可以通过定义跳转直接导航到对应的翻译条目。
• 在翻译编辑器中，可以一次性编辑多个语言的翻译。
• 对于大型项目，可以通过搜索功能快速定位需要修改的翻译。
• 使用AI批量翻译功能可以同时翻译多种语言，提高效率。
• 翻译条目列表支持按全部/已翻译/未翻译进行筛选，方便管理。

架构特点：

• 基于Vue 3 Composition API风格的组合式函数架构。
• 使用reactive-vscode库提供的响应式系统进行状态管理。
• 采用单例模式的组合式函数确保状态一致性。
• 清晰的依赖关系，避免循环依赖。
• 响应式状态自动处理依赖关系变化。

问题反馈：

如果您在使用过程中遇到任何问题，或者有功能建议，请在GitHub仓库上提交issue。

许可证：

MIT