Featured image of post WeRead2Notion-Pro使用文档

WeRead2Notion-Pro使用文档

使用

Warning

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

Fork工程

打开Weread2Notion-Pro,点击右上角的Fork(顺便点个star谢谢)

权限

确保你打开了读写权限。

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

获取微信读书Cookie

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

Tip

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

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

获取NotionToken

  1. 浏览器打开https://www.notion.so/my-integrations点击New integration按钮,输入name后点Submit。

  1. 提交完成后,进入Secrets页面,先点击Show,然后点击Copy复制,后面需要用到

复制Notion模板

  1. 浏览器打开模板https://malinkang.notion.site/13d2e1548f024687a42ec68a79a01c62?pvs=4,点击右上角的Duplicate复制。

  1. 打开你刚复制的模板,点击右上角的三个点,找到Connections,然后添加你创建的Integration。

  1. 点击右上角的Share,然后点击Copy link获取页面的链接。

Warning

这里是通过数据库的名字来自动获取对应的ID的,所以请先不要修改数据库的名字。

在Github的Secrets中添加变量

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

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

  1. 同理,继续点击New repository secret,分别增加变量名NOTION_TOKEN和NOTION_PAGE。NOTION_TOKEN的值为前面获取的NOTION_TOKEN值,NOTION_PAGE值为前面获取的页面链接,最终的结果如下图所示。

Warning

注意这三个变量名一定要填写正确,一个字母都不能错,否则会同步失败。之前遇到过有的同学NOTION_DATABASE_ID写成NOTION_DATEBASE_ID。

运行

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

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

问题排查

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

Warning

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

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

问题解答

  1. WeRead2Notion和WeRead2Notion-Pro有什么区别

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

  1. 如何自动运行

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

  1. 每天何时同步

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

  1. 模板中哪些可以修改

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. 年月周天中的进度是什么

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

  1. 表中的时间是什么

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

升级

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

当然你也可以上面使用中提到的步骤重新来一遍。

捐赠

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

微信

支付宝

付费解答

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

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

Built with Hugo
Theme Stack designed by Jimmy