Skip to main content

WeRead2Notion Pro使用文档

WeRead2Notion-Pro使用文档

使用​

{{< note 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值

{{< note tip >}} 如果没有内容显示，请刷新下浏览器。

建议使用Chrome浏览器，有的小伙伴使用QQ浏览器拿到的Cookie一直不能用。 {{< /note >}}

获取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复制。

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

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

{{< note warning >}} 这里是通过数据库的名字来自动获取对应的ID的，所以请先不要修改数据库的名字。{{< /note >}}

在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值为前面获取的页面链接，最终的结果如下图所示。

注意这三个变量名一定要填写正确，一个字母都不能错，否则会同步失败。之前遇到过有的同学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，查看运行状态，绿色是成功，红色是失败。

运行成功，只代表程序没有出错，不代表就一定同步数据，比如微信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进行同步

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

Last updated on by allen.zhou