Showcase
可以使用 Notion 来查看并管理你所有的 GitHub starred repo,并且还可以添加自己的标签、批注、以及其他内容。
复制 Notion 模板
复制这个模板:Github Notion Star
Fork Github Repo
Fork 这个 repo:
Fork 之后,需要在 Settings / Secrets 里面新建三个环境变量,分别是:
NOTION_API_KEY
Notion 的 API KEY,用于对页面进行修改
NOTION_DATABASE_ID
上面复制的页面的 database id
TOKEN_OF_GITHUB
Github 的 TOKEN,用于查询 star 过的 repo
如何获取配置
获取 Notion Database Id
- 打开 database 的单独页面(可以从左侧进入)
- 页面形如
https://www.notion.so/lcj/82be7d43506548ea82f994f6796e51f8?v=e285b32b024e4c619ed5a72bd4f3c0a1
,而前面的部分就是 database id:82be7d43506548ea82f994f6796e51f8
。
获取 Notion API Key
注意,需要把 Database 页面所在的文档,分享给这个 Notion API
获取 GitHub API Key
注意,这里申请 API Key 的时候,不需要授予任何权限。
开始同步
(可选)全量同步
全量同步会一次性的将之前所有 star 的 repo 同步到数据库(默认会同步 2000 个,可以通过覆盖
FULLSYNC_LIMIT
这个环境变量来修改),只需要执行一次就行。只需要在 GitHub 的 Actions 页面,执行
FullSync Notion Star
即可:(可选,推荐开启)定时增量同步
增量同步会同步最近 star 的若干个 repo(默认为 20 个,可以通过覆盖
PARTIALSYNC_LIMIT
环境变量来修改)增量同步的默认时间间隔是两小时,可以通过修改
github-notion-star/.github/workflows/partial-sync.yml
文件中间的 cron 时间来修改。开启增量同步,需要在 GitHub Actions 中,启用
Partial Sync Notion Star
这个 Action测试
完成「配置定时增量同步后」,可以给这个项目点一下 star,并手动执行下 Partial Sync(或者等待自动执行),不出意外会在 database 里面发现这个项目了。