【亲测免费】 Obsidian-i18n 插件使用教程

1. 项目介绍

Obsidian-i18n 是一个用于翻译其他 Obsidian 插件的插件。它通过正则匹配其他插件源代码中可能需要被翻译的内容，并输出为词典（待翻译），然后提供三种方式（本地文件模式、云端文件模式和机器翻译模式）来翻译此词典。借助 i18n，可以动态地注入与卸载词典。因此，Obsidian-i18n 是一个 Obsidian 插件国际化的一站式解决方案。

2. 项目快速启动

安装插件

由于插件暂时没有上架 Obsidian 插件市场，目前有两种安装方法：

方法一：使用 GitHub 代码安装

1. 克隆或下载项目代码到本地：

   git clone https://github.com/0011000000110010/obsidian-i18n.git
   

2. 将下载的 main.js、manifest.json 和 styles.css 文件放入 Obsidian 插件目录下的 i18n 文件夹中。

3. 在 Obsidian 设置中确认本插件已启用。

选择适合自己的翻译方式

云端文件模式

1. 在插件设置中启用云端文件模式。
2. 点击侧边栏的 i18n 按钮。
3. 选择对应插件右侧的“下载”按钮（下载后，按钮会变成“翻译”）。
4. 点击“翻译”按钮，正常情况下，翻译已生效。
5. 如有错误，请点击“还原”按钮，被翻译插件会回到原状态。

本地文件模式

1. 启用本地文件模式。
2. 点击侧边栏的 i18n 按钮。
3. 点击对应插件右侧的“提取”按钮。
4. 点击新出现的钢笔图案，即“编辑”按钮。
5. 在弹出的内置编辑器中手动完成翻译后，点击“翻译”按钮。
6. 正常情况下，翻译已生效。
7. 如有错误，请点击“还原”按钮，被翻译插件会回到原状态。

机器翻译模式

1. 打开机器翻译模式并配置对应接口。
2. 点击按钮，等待翻译完成后就能得到词典。
3. 如果注入词典出错，请检查插件词典内译文是否有误。

3. 应用案例和最佳实践

应用案例

• 将 Obsidian 插件翻译为其他语言，以便更好地适应不同地区用户的需求。
• 为个人或团队的项目提供统一的国际化解决方案。

最佳实践

• 在翻译前，确保备份原始插件文件，以防止翻译过程中出现不可逆的错误。
• 使用云端文件模式时，确保网络连接稳定，以便快速下载翻译文件。
• 在本地文件模式中，仔细检查翻译后的词典文件，确保没有遗漏或错误的翻译。

4. 典型生态项目

目前，Obsidian-i18n 已经支持 Obsidian 官方插件市场下载量 top100 的插件，并且社区贡献的词典数量不断增加。以下是几个典型生态项目的例子：

• Obsidian 插件市场中的热门插件，如“Excalidraw”、“MindMap”等。
• 社区开发的个性化插件，如“CustomCSS”、“Settings Sync”等。

通过使用 Obsidian-i18n，这些插件的国际化工作变得更加简单高效。