拓冰网站定制 
如何把你的汉化成果发布到GitHubObsidian i18n社区分享完整教程【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18nObsidian i18n是一款基于 AST 解析与大模型驱动的全自动汉化工具帮你零代码翻译 Obsidian 插件与主题。当你完成一个插件的汉化后只需配置好 GitHub 访问令牌就能通过插件内置的Cloud 视图一键把译文库发布到自己的 GitHub 仓库与全球社区共享你的汉化成果。本教程将带你走完全流程生成 Token → 配置共建生态 → 提交发布 → 社区下载。 为什么要把汉化成果发布到 GitHub自己汉化当然爽但分享给更多人更有价值。Obsidian i18n 的发布机制带来三重收益版本化备份译文以 JSON 形式存入你的 GitHub 仓库换电脑、换笔记库都不怕丢社区共享他人可通过 Cloud 视图或默认云端仓库直接下载你的汉化包无需手动传输可持续更新仓库中的metadata.json会自动记录每个译文源的标题、版本和描述方便社区浏览和检索。 发布前准备生成 GitHub 访问令牌发布依赖 GitHub API你只需准备一个个人访问令牌PAT无需安装 Git也无需 clone 任何仓库。进入设置 → 社区插件 → I18N → 共建生态页面上方就提供了两个一键跳转按钮对应两种令牌类型令牌类型权限要求适合人群Classic Token自动勾选repo权限图省事的新手Fine-grained Token手动选择 All repositories 并开启Contents 读写权限追求最小权限的安全党 插件官方推荐 Fine-grained Token权限更精细、更安全。令牌只需具备Contents 读写权限因为整个发布过程只做三件事上传译文 JSON、更新metadata.json、回读校验——这正是相关 API 封装的实现见 src/api/github.ts。⚙️ 配置共建生态填入令牌与目标仓库回到共建生态设置页完成两项配置访问令牌粘贴刚生成的 Token。输入框失焦后插件会静默验证显示「登录成功: 你的用户名」即代表生效验证逻辑见 src/settings/ui/i18n-mode-share.ts。目标仓库填写你的仓库名例如obsidian-translations。仓库可以提前在 GitHub 建好也可以留着让插件在发布时自动创建。页面还支持多账号方案Profile可保存多套「令牌 仓库」组合随时切换个人仓库和公司仓库互不干扰。 五步发布汉化成果到 GitHub配置完成后整个发布流程在 Cloud 视图内即可完成步骤操作说明1️⃣打开管理中心点击状态栏地球图标进入2️⃣点击顶部工具栏云图标进入 Cloud 视图3️⃣切换到管理中心标签进入你的仓库管理面板4️⃣点击发布入口视图切换到发布状态5️⃣选择类型并提交表单插件/主题 → 本地译文源 → 标题、版本、描述提交后插件会自动完成以下动作详见 src/views/cloud/components/publish-tab.tsx把本地源文件上传到仓库的plugins/{source-id}.json或themes/{source-id}.json读取并更新仓库根目录的metadata.json登记你的汉化条目把本地译文源的来源标记更新为cloud代表它已同步到云端。 如果云端已存在同一个译文源发布会自动进入更新模式并弹出差异对比窗口让你确认新旧译文变化后再提交避免误覆盖。⬇️ 发布之后让社区下载你的汉化你的条目进入仓库后其他用户就能以三种方式获取你的汉化成果管理中心列表在 Obsidian i18n 的综合设置 → 云端仓库填入你的owner/repo后插件和主题列表会直接从该仓库的metadata.json读取可下载的云端版本Cloud 视图通过社区目录或探索资源按仓库浏览并一键下载管理标签导入也可用导出按钮生成.i18n.gz归档文件直接发给群友导入。下载流程的完整说明见 docs/guides/import-community-translations.mdx分享全流程见 docs/guides/share-translations.mdx。❓ 常见问题 FAQQ1为什么令牌验证失败Classic Token 必须包含repo权限Fine-grained Token 必须选择 All repositories 并开启Contents 读写权限。令牌末尾的隐藏空格也会导致失败粘贴后建议全选重贴一次。Q2发布时提示网络超时请求默认 10 秒超时。若国内网络访问不稳定可在综合设置 → 加速节点切换代理它只影响原始资源下载不影响带令牌的身份验证请求。Q3发布和「导出」有什么区别导出管理标签是把本地译文打包成.i18n.gz归档走本地文件流发布Cloud 视图是推送到 GitHub 仓库走云端共享流。两者可配合使用定期发布保云端随时导出传好友。Q4可以撤销或回滚发布吗可以。Cloud 视图的管理中心内置历史功能支持查看提交历史并回滚到更早的版本。 总结用 Obsidian i18n 分享汉化成果其实只有三步生成一个带 Contents 权限的 Token → 在共建生态里填好令牌和仓库名 → 在 Cloud 视图管理中心点击发布。从配置到上架全程不超过 5 分钟无需写代码、无需操作 Git。你的每一个汉化词条都会变成社区里一位中文用户顺滑体验 Obsidian 的一份助力 延伸阅读docs/features/cloud-sharing.mdx云端译文库与社区共享详解、docs/configuration/general-settings.mdx综合设置全解【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18n创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何把你的汉化成果发布到GitHub：Obsidian i18n社区分享完整教程
如何把你的汉化成果发布到GitHubObsidian i18n社区分享完整教程【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18nObsidian i18n是一款基于 AST 解析与大模型驱动的全自动汉化工具帮你零代码翻译 Obsidian 插件与主题。当你完成一个插件的汉化后只需配置好 GitHub 访问令牌就能通过插件内置的Cloud 视图一键把译文库发布到自己的 GitHub 仓库与全球社区共享你的汉化成果。本教程将带你走完全流程生成 Token → 配置共建生态 → 提交发布 → 社区下载。 为什么要把汉化成果发布到 GitHub自己汉化当然爽但分享给更多人更有价值。Obsidian i18n 的发布机制带来三重收益版本化备份译文以 JSON 形式存入你的 GitHub 仓库换电脑、换笔记库都不怕丢社区共享他人可通过 Cloud 视图或默认云端仓库直接下载你的汉化包无需手动传输可持续更新仓库中的metadata.json会自动记录每个译文源的标题、版本和描述方便社区浏览和检索。 发布前准备生成 GitHub 访问令牌发布依赖 GitHub API你只需准备一个个人访问令牌PAT无需安装 Git也无需 clone 任何仓库。进入设置 → 社区插件 → I18N → 共建生态页面上方就提供了两个一键跳转按钮对应两种令牌类型令牌类型权限要求适合人群Classic Token自动勾选repo权限图省事的新手Fine-grained Token手动选择 All repositories 并开启Contents 读写权限追求最小权限的安全党 插件官方推荐 Fine-grained Token权限更精细、更安全。令牌只需具备Contents 读写权限因为整个发布过程只做三件事上传译文 JSON、更新metadata.json、回读校验——这正是相关 API 封装的实现见 src/api/github.ts。⚙️ 配置共建生态填入令牌与目标仓库回到共建生态设置页完成两项配置访问令牌粘贴刚生成的 Token。输入框失焦后插件会静默验证显示「登录成功: 你的用户名」即代表生效验证逻辑见 src/settings/ui/i18n-mode-share.ts。目标仓库填写你的仓库名例如obsidian-translations。仓库可以提前在 GitHub 建好也可以留着让插件在发布时自动创建。页面还支持多账号方案Profile可保存多套「令牌 仓库」组合随时切换个人仓库和公司仓库互不干扰。 五步发布汉化成果到 GitHub配置完成后整个发布流程在 Cloud 视图内即可完成步骤操作说明1️⃣打开管理中心点击状态栏地球图标进入2️⃣点击顶部工具栏云图标进入 Cloud 视图3️⃣切换到管理中心标签进入你的仓库管理面板4️⃣点击发布入口视图切换到发布状态5️⃣选择类型并提交表单插件/主题 → 本地译文源 → 标题、版本、描述提交后插件会自动完成以下动作详见 src/views/cloud/components/publish-tab.tsx把本地源文件上传到仓库的plugins/{source-id}.json或themes/{source-id}.json读取并更新仓库根目录的metadata.json登记你的汉化条目把本地译文源的来源标记更新为cloud代表它已同步到云端。 如果云端已存在同一个译文源发布会自动进入更新模式并弹出差异对比窗口让你确认新旧译文变化后再提交避免误覆盖。⬇️ 发布之后让社区下载你的汉化你的条目进入仓库后其他用户就能以三种方式获取你的汉化成果管理中心列表在 Obsidian i18n 的综合设置 → 云端仓库填入你的owner/repo后插件和主题列表会直接从该仓库的metadata.json读取可下载的云端版本Cloud 视图通过社区目录或探索资源按仓库浏览并一键下载管理标签导入也可用导出按钮生成.i18n.gz归档文件直接发给群友导入。下载流程的完整说明见 docs/guides/import-community-translations.mdx分享全流程见 docs/guides/share-translations.mdx。❓ 常见问题 FAQQ1为什么令牌验证失败Classic Token 必须包含repo权限Fine-grained Token 必须选择 All repositories 并开启Contents 读写权限。令牌末尾的隐藏空格也会导致失败粘贴后建议全选重贴一次。Q2发布时提示网络超时请求默认 10 秒超时。若国内网络访问不稳定可在综合设置 → 加速节点切换代理它只影响原始资源下载不影响带令牌的身份验证请求。Q3发布和「导出」有什么区别导出管理标签是把本地译文打包成.i18n.gz归档走本地文件流发布Cloud 视图是推送到 GitHub 仓库走云端共享流。两者可配合使用定期发布保云端随时导出传好友。Q4可以撤销或回滚发布吗可以。Cloud 视图的管理中心内置历史功能支持查看提交历史并回滚到更早的版本。 总结用 Obsidian i18n 分享汉化成果其实只有三步生成一个带 Contents 权限的 Token → 在共建生态里填好令牌和仓库名 → 在 Cloud 视图管理中心点击发布。从配置到上架全程不超过 5 分钟无需写代码、无需操作 Git。你的每一个汉化词条都会变成社区里一位中文用户顺滑体验 Obsidian 的一份助力 延伸阅读docs/features/cloud-sharing.mdx云端译文库与社区共享详解、docs/configuration/general-settings.mdx综合设置全解【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18n创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考