Skip to content

Latest commit

 

History

History
178 lines (124 loc) · 7.77 KB

README.md

File metadata and controls

178 lines (124 loc) · 7.77 KB
Raw

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-CN 或 zh-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客户端（韩文） + 油猴脚本