/notion-zh_CN

notion 中文化

Primary LanguageRust

Window / Mac 版本已经更新3.1.0,请使用更新版本

notion-zh_CN 是什么?

notion-zh_CN 是对notion的汉化脚本。

功能

  • 支持 网页端 ( 油猴脚本 ) + 桌面端 ( win / mac ) + 安卓端 汉化脚本
  • (很久没有维护)提供cloudflare worker 版本代理 notion.so 域名 这是一个平台无关(IOS 上的safari也能直接使用)的汉化方式,只要你自己部署cloudflare worker,就可以使用。附带cf代理加速的能力。

    其实这里应该可以做域名映射到notion.so的访问的。(从而实现全平台汉化)

为什么要做这个项目?

Notion 已经有了中文语料,让用户能够提前使用中文语料

如何使用?

网页端

  1. 安装油猴插件

    此处提供搜索到知乎的一篇教程:https://zhuanlan.zhihu.com/p/128453110

  2. 安装油猴脚本

    打开链接:https://greasyfork.org/zh-CN/scripts/430116-notion-%E5%AE%8C%E5%85%A8%E4%B8%AD%E6%96%87%E5%8C%96-%E5%9F%BA%E4%BA%8E%E9%9F%A9%E8%AF%AD%E7%89%88%E6%9C%AC-%E4%BD%BF%E7%94%A8%E8%85%BE%E8%AE%AFapi%E6%9C%BA%E7%BF%BB 。然后点击安装。

  3. 体验汉化效果

    https://www.notion.so

桌面端

notion 客户端迎来了巨大更新,文件结构发生完全不一致的变化(没有了可以注入的preload.js了)

有问题发issue,最好是贴录屏,gif 能直接贴在issue

预处理版本

https://github.com/Reamd7/notion-zh_CN/releases/tag/3.0.0

  • app.win.zip
  • app.mac.zip

都已经有了app文件夹

打开 Notion安装目录/resources 解压 预处理压缩包Notion安装目录/resources 下 删除 app.asar 或 重命名为其他名字

(修改原理): windows / mac

打开 Notion安装目录/resources 解压 app.asar 到相同目录的 app 文件夹下 找到 .webpack/main/index.js

  1. 搜索 localeHtml 看到一个 localeHtml[r]r 替换为 zh-CN / zh-TW

目的是直接使用缓存资源文件中 zh-CN 的 html

  1. 搜索 requestReturnedAsIndexV2

看到 const e = l.default.join(i, u.path); 是文件的绝对路径 在下方直接注入以下代码, 目的是修改 renderer 中 localStorage 的 locale 缓存值

if (u.path.endsWith('.html')) {
    const fs = require('fs');
    const htmlContent = fs.readFileSync(e, 'utf-8')
    if (!htmlContent.includes(`{"id":"KeyValueStore2:preferredLocale","value":"zh-CN","timestamp":Date.now(),"important":true}`)) {
        (() => {
            fs.writeFileSync(e, htmlContent.replace("</html>", `<script>
            // ==UserScript==
            try {
                const preferredLocaleStr = window.localStorage.getItem(
                    "LRU:KeyValueStore2:preferredLocale"
                );
                const preferredLocale = JSON.parse(preferredLocaleStr) || {"id":"KeyValueStore2:preferredLocale","value":"zh-CN","timestamp":Date.now(),"important":true};
                if (preferredLocale.value) {
                    preferredLocale.value = "zh-CN";
                }
                window.localStorage.setItem(
                    "LRU:KeyValueStore2:preferredLocale",
                    JSON.stringify(preferredLocale)
                );
            } catch (e) {}
            </script>
            </html>`))
        })();
    }
}

保存

删除 app.asar 或 重命名为其他名字 打开应用

More

如果你不想修改软件源码,还有如下方案(之后可能会写成自动化脚本)

  1. 打开Notion的资源缓存文件

windows: C:\Users\[用户名]\AppData\Roaming\Notion\notionAssetCache-v2 mac

  1. 找到热更新资源最新的版本 基于语义化版本规则可以判断,或者看 latestVersion.json 内部 version 字段

以下以当前最新版本 23.13.0.23 举例子

  1. 打开最新版本所在文件夹 23.13.0.23/assets.json

搜索到 localeHtml 字段, 将下级en-US 字段的值改为和 zh-CNzh-TW 一致 保存 重启

该方案问题是 Notion 经常热更新会更新缓存,那就要一个自动化的脚本自动做如上的事情解决问题

cloudflare worker

不建议使用。不希望推广。有风险。你需要知道你在干什么。

  1. 首页:https://workers.cloudflare.com

  2. 注册,登陆,Start building,取一个子域名,Create a Worker

  3. 复制 worker.js 到左侧代码框,修改

    const BaseUrl = "xxxx.子域名.workers.dev" // 修改为自己的子域名
  4. Save and deploy。如果正常,右侧应显示提示框: Mismatch between origin and baseUrl (dev). 好的(这里就证明汉化成功了)

  5. 以后可直接访问 https://xxxx.子域名.workers.dev

安卓端

大家可以做什么?

  1. 优化汉化语言。都是机器翻译,看到不通畅的句子欢迎提issue/pr直接改了 (修改 json/zh.json 文件,了解之前,先找到原有的英文,韩文对照一下再更新翻译。)

呼吁:

提高付费率,支持你所支持的软让他发展更好,这样国内市场才会更受重视,而不是只是白嫖,买淘宝,搞教育账户。

Star History

Star History Chart

风险提示:使用 cloudflare worker 的同学,被官方检测出来并封号与我无关,希望自己看明白代码做了什么,以及为什么会被检测出来。 其他方式的,都是使用官方国际化方案进行国际化的,而且在本地进行操作不通过任何服务器——理论上除非故意钓鱼否则不会封你。 钓鱼:主动收集你是不是用了中文版国际化字段,而且,对比你并没有中文版权限。

如果担心有问题,可以等待官方中文版,可以稍微学习网页开发,可以询问网页开发朋友,项目都是开源的。究竟做了什么操作,对notion 应用本体有什么影响,没有理由的担心只能体现对别人的不信任。

该项目仅用于学习,如有侵权24h内会马上删除。

更新日志:

  • 2.4.20 补充 window 更新目录文件之后的 自动注入软件 / 手动注入教程
  • 2.4.2 翻译开始跟随着官方中文词条啦!!!!!
  • 2.4.1 支持 ios / macos user script
  • 2.3.1 权衡后,安卓版本使用新的 runtime 注入方式,实现全部的(包括键盘都能够汉化的方式)但有首页白屏事件较长的问题。
  • 2.3.0 支持使用 cloudflare worker 进行代理 notion.so 域名进行加速及国际化
  • 2.2.0 支持 安卓版本notion,与官方版共存 的汉化!
  • 2.1.0:支持中文版快捷命令!支持拼音输入的时候显示快捷命令!
  • 2.0.4: 彻底支持无论是默认英文还是韩文都会生效的汉化脚本(2021/08/19 油猴剧本 + win 客户端 + mac 客户端测试通过),统一 win mac 网页端实现。
  • 2.0.3:支持切换到韩文之后帮助文档还原到默认英文版本
  • 2.0.1:支持mac客户端(英文)
  • 2.0.0: 支持win客户端(韩文) + 油猴脚本