微信读书 on Malinkang's Blog

Werad2NotionPro支持自定义设置了

Thu, 03 Oct 2024 15:28:05 +0800

自定义设置

现在Weread2NotionPro支持用户设置同步样式了。接下来就给大家讲解下如何使用。

首先就是同步代码。打开你Fork的项目，点击Sync fork进行同步，如果有冲突可以点击Discard那个按钮。

同步成功之后，手动运行一下任务。打开你Fork的项目，依次点击Actions->weread note sync-> Run workflow，就可以运行了。

运行完成之后，Notion中会增加一个名为设置的database，点击打开。

接下来依次讲解下每个配置：

NotinPage、NotinToken和WeReadCookie三个值用来存储之前填写到Github上的值

同步书签

之前书签和划线都会被同步到Notion，如果不希望同步书签，取消勾选即可，默认是勾选状态。

样式

样式用于自定义同步到Notion的样式，目前支持如下值：

callout：默认样式
quote：引用样式
paragraph：普通段落
bulleted_list_item：无序列表
numbered_list_item：有序列表

根据划线颜色设置文字颜色

之前同步默认会根据划线颜色设置Notion中文字的颜色，如果不希望根据划线颜色来设置Notion中文字的颜色，取消勾选即可，默认是勾选状态。

以上就是所有的配置项。所有的修改只会对后续的同步有效，并不会对之前同步过的数据进行修改。未来会把热力图的配置也迁移到Notion中。你还需要哪些自定义设置，请在评论区里留言。

修复重复Bug

国庆节前代码重构，导致同步会有重复的书籍，目前已经修复，之前重复的书籍需要手动删除。

如何新增图表

Notion出了图表功能之后，我也给自己的读书模板增加了图表功能，一直有人问如何设置，我也简单讲解下。

在月这个Database中新增一列函数类型，名字为阅读时长（小时）。默认提供的时长单位是秒。所以直接使用公式floor(prop("时长")/3600)对将阅读时长转化为小时格式。

在想要放置图表的地方添加数据库的链接视图，选择月这个database。

X轴显示内容选择日期然后选择月

Y轴显示内容选择阅读时长（小时）然后选择总和

筛选选择本年

这样就可以看到今年每个月的阅读时长图表了。

WeRead2NotionPro使用文档

Wed, 03 Jan 2024 15:28:05 +0800

Warning

Weread2Notion和Weread2Notion-Pro是两个不同的项目，模板也不相同，切勿用错模板。

Weread2Notion教程：https://malinkang.com/posts/weread2notion/
热力图使用教程：https://malinkang.com/posts/github_heatmap/

WeRead2Notion-Pro不仅仅是将微信读书笔记同步到Notion，它是一个强大的管理系统。

WeRead2Notion和WeRead2Notion-Pro有什么区别主要有如下

WeRead2Notion不支持在笔记中添加自己的笔记，每次有新笔记会删除原有的笔记。WeRead2Notion-Pro支持添加自己的笔记，每次更新不会覆盖笔记。
WeRead2Notion功能更加简洁，同步速度更快。
WeRead2Notion-Pro支持按照年、月、周、日的阅读时长、笔记数阅读数的时间统计，支持数据可视化。所以选用哪个看个人喜好，也可以两个都用。

预览

也可以打开网页版本查看效果：https://malinkang.notion.site/9a311b7413b74c8788752249edd0b256?pvs=74

下面给大家讲解一下如何使用：

Fork工程

打开Weread2Notion-Pro，点击右上角的Fork（顺便点个star谢谢）

获取微信读书Cookie

浏览器打开网页版微信读书扫码登录
按F12进入开发者模式，依次点网络->文档，然后选中weread.qq.com，下拉找到Cookie，复制Cookie值

Tip

如果没有内容显示，请刷新下浏览器。

建议使用Chrome浏览器，有的小伙伴使用QQ浏览器拿到的Cookie一直不能用。

授权

浏览器打开 https://api.notion.com/v1/oauth/authorize?client_id=f86ce456-f9cb-4cd5-8e4b-07bd9e18a8f8&response_type=code&owner=user&redirect_uri=https%3A%2F%2Fnotion-auth.malinkang.com%2Fweread2notionpro-oauth-callback
然后点击Next->Allow access

点击复制按钮，复制NOTION_TOKEN和NOTION_PAGE的值。

在Github的Secrets中添加变量

打开你fork的工程，点击Settings->Secrets and variables->New repository secret

Name输入WEREAD_COOKIE，Secret输入框中填入你前面获取的微信读书Cookie，然后点击Add secret

同理，继续点击New repository secret，分别增加变量NOTION_TOKEN和NOTION_PAGE。最终的结果如下图所示。

Warning

注意这三个变量名一定要填写正确，一个字母都不能错，否则会同步失败。

运行

上面配置完成之后，打开你Fork的项目，依次点击Actions->weread note sync-> Run workflow，就可以运行了。

以相同的方式运行read time sync。weread note sync主要用来同步书籍、笔记和划线。read time sync 用来生成热力图和同步阅读时长。

问题排查

可以点击你Fork项目的Action，查看运行状态，绿色是成功，红色是失败。

Warning

运行成功，只代表程序没有出错，不代表就一定同步数据，比如微信Cookie过期就不会报错。所以如果运行成功，Notion中没有数据的话，也可以通过下面第2步来查看日志

2.可以点进去查日志，来自行排查问题。

问题解答

如何自动运行

Github Action提供每日定时自动运行程序的功能。之前有的朋友会问，我关了电脑会同步吗，该脚本运行在Github的服务器上，并不是运行在你的电脑上，所以你关机并不会影响程序自动运行。

每天何时同步

笔记设置的是utc时间的0点同步，如果你在中国，那就是每天8点同步。不过据我观察，Github这个可能有延迟。时间同步是每3个小时运行一次。你也可以自行修改同步时间，具体参考这里。需要注意的是Github每个月2000分钟有免费的额度，如果改的过于频繁可能会导致额度不够。

模板中哪些可以修改

Database中的Formula和Rollup类型的属性名可以修改，其他的属性名不支持修改，因为代码中是通过属性的名字来增加修改这个属性的，修改了名字程序就无法正常运行。要修改数据库的名字需要按照以下步骤。依次选择Settings->Secrets and variables -> variables-> New repository variable。

具体的变量名可以参考下表中的变量名，值为你想要修改的名字。

变量名	当前数据库的名字
BOOK_DATABASE_NAME	书架
REVIEW_DATABASE_NAME	笔记
BOOKMARK_DATABASE_NAME	划线
DAY_DATABASE_NAME	日
WEEK_DATABASE_NAME	周
MONTH_DATABASE_NAME	月
YEAR_DATABASE_NAME	年
CATEGORY_DATABASE_NAME	分类
AUTHOR_DATABASE_NAME	作者
CHAPTER_DATABASE_NAME	章节

除此之外，其他数据可以任意修改，包括页面的布局都不会影响程序运行。

年月周天中的进度是什么

这里的进度我设置的是每天1小时，每周7小时，每月30小时，每年365小时。你可以自行修改公式设置你的进度。

表中的时间是什么

如果这本书你读完了，时间是读完的时间，如果没有读完，就是你最后阅读的时间。表中的日，周，月，年都是根据这个时间来设置的。

升级

如果我添加了新功能，你需要将自己的代码与我的代码进行同步。打开你Fork的项目，点击Sync fork进行同步，如果有冲突可以点击Discard那个按钮

捐赠

如果你觉得项目对你有帮助，可以捐赠。我也会不断的优化项目，并做出其他开源的项目。

微信

支付宝

付费解答

有问题先自行解决，往往失败都是一些小细节没注意导致的。我的文档写的已经足够详细，按照文档来操作基本都能成功。你也可以尝试在群里咨询。不要直接加我微信来让我来解答，这个项目我已经投入了大量时间来开发维护，实在没有更多的精力来一对一解答。如果实在解决不了，可以付费一对一咨询，30元一位。付完款可以微信私聊我。

群

欢迎加入微信群讨论。使用中遇到的任何问题，包括Notion的使用，微信读书组队打卡，后续的更新都会在群里讨论。

微信读书热力图使用指南

Fri, 22 Dec 2023 14:28:05 +0800

升级

如果你是新用户，可以直接跳过这一步。

打开你Fork的项目，点击Sync fork进行同步

权限

确保你打开了读写权限。

依次选择Settings->Actions->General，然后下拉，找到Workflow permissions，如果没有选中Read and write permissions，请选中，然后点下面的save保存。

设置NAME

设置这个Name用来展示在热力图上。

依次选择Settings->Secrets and variables -> New repository secret.

输NAME和Secret，然后点 Add secret保存即可。

设置年

依次选择Settings->Secrets and variables -> variables-> New repository variable.

添加变量名为year，值为年份。如果要显示多个年份，比如2018到2024年的就输入2018-2024。主要微信读书只能拿到2018年之后的数据，所以如果输入2016-2024，还是只会显示2018-2024的数据。

设置颜色

和上面设置Year一样依次选择Settings->Secrets and variables -> variables-> New repository variable。具体的变量名可以参考下表中的变量名，值为色值。

变量名	变量说明
BACKGROUND_COLOR	背景颜色
DOM_COLOR	未填充的色块
TRACK_COLOR	一级颜色
SPECIAL_COLOR	二级颜色
SPECIAL_COLOR2	三级级颜色
TEXT_COLOR	文字颜色

variables示例

手动运行

配置完成之后，你就可以手动运行一下。

最终生成的图保存在OUT_FOLDER文件夹下。

WeRead2Notion使用文档

Sun, 10 Sep 2023 15:28:05 +0800

WeRead2Notion用于将微信读书的笔记自动同步到Notion。该项目不支持在Notion中添加自己的笔记，每次有笔记更新会删除原有笔记，需要添加自己的笔记可以使用WeRead2Notion-Pro。

Warning

Weread2Notion和Weread2Notion-Pro是两个不同的项目，模板也不相同，切勿用错模板。

Weread2Notion-Pro教程：https://malinkang.com/posts/weread2notion-pro/
热力图使用教程：https://malinkang.com/posts/github_heatmap/

预览

也可以打开网页版本查看效果：https://book.malinkang.com/

Fork工程

打开Weread2Notion，点击右上角的Fork（顺便点个star谢谢）

权限

确保你打开了读写权限。

依次选择Settings->Actions->General，然后下拉，找到Workflow permissions，如果没有选中Read and write permissions，请选中，然后点下面的save保存。

获取微信读书Cookie

浏览器打开网页版微信读书扫码登录
按F12进入开发者模式，依次点网络->文档，然后选中weread.qq.com，下拉找到Cookie，复制Cookie值

Tip

如果没有内容显示，请刷新下浏览器。

建议使用Chrome浏览器，有的小伙伴使用QQ浏览器拿到的Cookie一直不能用。

授权

浏览器打开 https://api.notion.com/v1/oauth/authorize?client_id=801fd03a-a44f-41af-9a17-feb048b4bbdd&response_type=code&owner=user&redirect_uri=https%3A%2F%2Fnotion-auth.malinkang.com%2Fweread2notion-oauth-callback
然后点击Next->Allow access

点击复制按钮，复制NOTION_TOKEN和NOTION_PAGE的值。

在Github的Secrets中添加变量

打开你fork的工程，点击Settings->Secrets and variables->New repository secret

Name输入WEREAD_COOKIE，Secret输入框中填入你前面获取的微信读书Cookie，然后点击Add secret

同理，继续点击New repository secret，分别增加变量NOTION_TOKEN和NOTION_PAGE。最终的结果如下图所示。

Warning

注意这三个变量名一定要填写正确，一个字母都不能错，否则会同步失败。

运行

上面配置完成之后，打开你Fork的项目，依次点击Actions->weread sync-> Run workflow，就可以运行了。

问题排查

可以点击你Fork项目的Action，查看运行状态，绿色是成功，红色是失败。

Warning

2.可以点进去查日志，来自行排查问题。

问题解答

为什么有的书没有同步过来

本项目只会同步划线或者做了笔记的书，书架里的书如果没有划线或者做笔记是不会同步的。后续可能会考虑增加同步书架中的书。

每天何时同步

本项目设置的是utc时间的0点，如果你在中国，那就是每天8点同步。不过据我观察，Github这个可能有延迟，会在每天8点零几分同步。你也可以自行修改同步时间，具体参考这里。

升级

如果我添加了新功能，你需要将自己的代码与我的代码进行同步。打开你Fork的项目，点击Sync fork进行同步，如果有冲突可以点击Discard那个按钮

捐赠

如果你觉得项目对你有帮助，可以捐赠。我也会不断的优化项目，并做出其他开源的项目。

微信

支付宝

付费解答

群

欢迎加入微信群讨论。使用中遇到的任何问题，包括Notion的使用，微信读书组队打卡，后续的更新都会在群里讨论。