type
status
date
slug
summary
tags
category
icon
password
前言
截止到现在,已经持续使用了Notion近两年,也基本上将之前在Typora上写的Markdown文章搬运过来了。但是,有个问题,极端一点思考,如果Notion突然不维护了,那么我的这些数据该怎么办?
尽管,Notion 也提供了导出Markdown格式的功能,但是,只能一个一个导出,后期文档数量上去的话,导出都挺折腾时间的。
于是,寻求一种能够批量、快速、自动化导出Notion文章的方法就成了最近关心的事情。好在,在Matrixcore 的帮助下,发现一件神器 —— Elog。
使用 Notion+Elog+Slack+Pipedream 这一套组合拳就解决了持续集成的方式来自动化更新Notion文档。
本地实践开始
因为我的主要目的是能够使用 Elog 定时备份 NotionNext下的文档,并且定期归档,所以实践这块以完成持续集成部署为结果展开流程。
安装依赖
参考快速开始
前置依赖,需要安装好 node
配置Elog
在本地目录执行初始化,我这边是在云服务器上,地址为:
/data/server/Myblog_backup
根据提示初始化成功后,会在根目录生成一份
elog.config.js
配置文件和本地调试用的.elog.env
环境变量配置文件。其中
elog.config.js
是关键的配置文件,而 .elog.env
是用于保存本地关键配置的文件。关于具体参考 目录结构 | Elog (1874.cool)
主要关注以下三个字段的内容:
- write 写作平台详细配置
- deploy 博客平台详细配置
- image 图床平台详情配置
我本地的配置是:
我这边就是需要将 notion 数据库中的
type
字段 为 Post
的文章导出到 ./docs目录下,Markdown名称以 title
字段作为名称,按照 catalog
进行文件夹归类。文章的图片下载到本地 ./docs/images
目录下,并使用相对路径替换掉原始的图片。同步
本地效果【左边为Notion数据库部分截图,右边为生成的MD文档】:
![notion image](https://image.kuangyichen.com/image/202311162036134.webp?t=a76182ac-5e81-4874-b60e-0e2c2e1c12fd)
![notion image](https://image.kuangyichen.com/image/202311162034131.png?t=b7781eab-fd4f-4b5e-b5ec-4de51d211096)
持续集成部署
说了这么多,一直都是本地在操作,如何实现自动化持续集成呢?
需要借助Notion+Slack+Pipedream+GitHub了
notion ⇒ slack ⇒ pipedream ⇒ github action
slack 设置
1、注册好之后,创建频道(channel)
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2Fd57cceec-abea-4500-b629-1f699baed808%2FUntitled.png?table=block&id=e9296c4d-8411-4300-886b-35a5838e612d&t=e9296c4d-8411-4300-886b-35a5838e612d&width=480&cache=v2)
2、添加应用 Notion
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2Fd59711a2-85d7-4c0d-9db5-e3cabdd024e1%2FUntitled.png?table=block&id=c05f25ea-df40-42ba-93f4-37a9ff5035ee&t=c05f25ea-df40-42ba-93f4-37a9ff5035ee&width=480&cache=v2)
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2Fda136fb8-4852-46fe-94e9-13a367699e7c%2FUntitled.png?table=block&id=e963b0a6-3e62-42f6-b5cc-eb5f5ab51b68&t=e963b0a6-3e62-42f6-b5cc-eb5f5ab51b68&width=2204&cache=v2)
notion 设置
1、创建 automation
在数据库页面点击闪电按钮,可以创建
automation
,增加触发器以及执行器![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2F361acabd-7c2b-4a9e-a26c-ee109bf480cf%2FUntitled.png?table=block&id=dac15f73-b129-4ef5-8c7f-a0d144109980&t=dac15f73-b129-4ef5-8c7f-a0d144109980&width=435&cache=v2)
触发器设置为 状态变为
Published
触发。因为在slack上设置添加了应用Notion,所以可以在执行器中看到 推送消息至频道,选择好在Slack中创建的频道,这里是 notion![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2F41e958bc-8b6d-4950-96d0-4dc5981dbc3b%2FUntitled.png?table=block&id=d3022ac7-04a6-45f3-baa1-3b3f700411e9&t=d3022ac7-04a6-45f3-baa1-3b3f700411e9&width=471&cache=v2)
pipedream 设置
1、注册
2、创建 project
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2Fb435a34b-dead-41a8-967f-28fc7affff2f%2FUntitled.png?table=block&id=cfd60f0a-be60-4872-82c6-955f4d1bad74&t=cfd60f0a-be60-4872-82c6-955f4d1bad74&width=1382&cache=v2)
3、在 project 下创建 workflow
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2F9228da9e-1e24-4aed-9cdf-dfbd67e0a74a%2FUntitled.png?table=block&id=6fbc93e2-1e7d-49bd-9810-5cf006d60d06&t=6fbc93e2-1e7d-49bd-9810-5cf006d60d06&width=830&cache=v2)
4、设置 workflow
trigger 触发器选择 Slack
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2F10cfdbce-2d41-4bea-8fdd-ceee79321d59%2FUntitled.png?table=block&id=8221b1d5-a44a-4a0b-b464-cfe4df9f67fb&t=8221b1d5-a44a-4a0b-b464-cfe4df9f67fb&width=1125&cache=v2)
选择
New Message In Channels
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2F5c1250e0-809d-430b-80cc-25c3deffc073%2FUntitled.png?table=block&id=f245dd39-e0cf-44ff-bb18-6f79a9a8a4a7&t=f245dd39-e0cf-44ff-bb18-6f79a9a8a4a7&width=1127&cache=v2)
按照如下设置
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2F94e1fd3b-5637-40fb-927c-6436b782035b%2FUntitled.png?table=block&id=73dd0d91-cb83-44ac-9322-ae328e5afd01&t=73dd0d91-cb83-44ac-9322-ae328e5afd01&width=1124&cache=v2)
增加一个Step Python
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2F2c83c076-600f-4af0-98af-ae0de5297964%2FUntitled.png?table=block&id=e5355408-c261-4863-905a-73754a09faa1&t=e5355408-c261-4863-905a-73754a09faa1&width=1155&cache=v2)
按照如下编写即可:
配置环境变量,用于 code 中使用,在环境中通过
os.environ['your_token']
来使用![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2Fbcc75a11-13bf-47f2-9922-e88ea235d9f0%2FUntitled.png?table=block&id=4272fc87-3a28-4229-8167-2a9cf00b8610&t=4272fc87-3a28-4229-8167-2a9cf00b8610&width=2910&cache=v2)
至此,已完成一半的设置。
注意:
以下三个变量需要在 GitHub 获取
github_username: 你的github账户名称
github_repo:你需要同步的 github 仓库,后续会将生成的markdown推送到这个仓库
token:github token
github设置
在Github上新建一个仓库,将本地与远程仓库链接上。
在
.github/workflows/
main.yaml
添加如下添加环境变量:
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2F4fee4106-f3b5-49d0-a1b8-8a0d4e679bd0%2FUntitled.png?table=block&id=df2175ec-a79a-4f8e-86a3-bab9c743b274&t=df2175ec-a79a-4f8e-86a3-bab9c743b274&width=1811&cache=v2)
增加执行权限:
Setting
下 Actions
Tab 的 Workflow permissions 需要选中 Read and write permissions
,否则会报错,没有权限更新。![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2F0c2ecb6d-fbb8-44de-8f67-b10fbbabfe7e%2FUntitled.png?table=block&id=6a4218c7-cf36-4715-ba8d-997a94a725ad&t=6a4218c7-cf36-4715-ba8d-997a94a725ad&width=2318&cache=v2)
执行效果:
当在Notion数据库中,将文章的状态从
Draft
转为 Published
,随即触发执行Slack:
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2Fe5efc5a5-132c-4a20-b64b-ce308723cefc%2FUntitled.png?table=block&id=1537155e-c2d4-4de8-b745-1fb8369cb67d&t=1537155e-c2d4-4de8-b745-1fb8369cb67d&width=1911&cache=v2)
Pipedream:
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2Faaa638ce-ea8a-4213-b940-4fa90e513e47%2FUntitled.png?table=block&id=97955e7b-5573-4246-9b02-e08d9b53276f&t=97955e7b-5573-4246-9b02-e08d9b53276f&width=1969&cache=v2)
Github:
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2F2985fb3d-08cc-4617-be3f-5db47f2f298a%2FUntitled.png?table=block&id=09c2358d-4f22-4530-b953-9fdd3b113edb&t=09c2358d-4f22-4530-b953-9fdd3b113edb&width=1658&cache=v2)
![notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fdea38628-64dc-40fd-8d17-2efa87e3d554%2F949dbf46-9a8d-4637-8c60-e05ef9d3114a%2FUntitled.png?table=block&id=04f0c251-3920-4128-b2c8-d7e7f7945d69&t=04f0c251-3920-4128-b2c8-d7e7f7945d69&width=1207&cache=v2)
关于Elog
什么是Elog
Elog
名为Easy Blogging
,简单、轻松的书写&部署博客 它是一种开放式跨端博客解决方案,随意组合写作平台(语雀/飞书/Notion/FlowUs)和博客平台(Hexo/Vitepress/Confluence/WordPress)等
用我的话来说,就是Elog支持从多个写作平台中导出Markdown文件格式,然后生成不同博客平台的静态博客文件部署。就是方便不懂技术的小伙伴也能在不同的写作平台以及博客平台自由切换,体验一条龙服务。
Elog支持的写作平台与博客平台
写作平台:
- Notion
- 语雀
- FlowUs
- 飞书云文档
博客平台:
- Hexo
- Vitepress
- HuGo
- Docusaurus
- Docz
- Confluence
- WordPress
支持图床
- 本地
- 腾讯云COS
- 阿里云OSS
- Github图床
- 七牛云
- 又拍云
注意事项:
【github】如何将本地仓库与远程仓库建立连接
- 【空仓库】创建完空仓库就将本地项目关联到远程
- 如果本地项目已经通过git管理:
- 本地项目未通过git管理:
- 【非空仓库】创建完非空仓库就将本地项目关联到远程
- 远程非空仓库的关联,就要涉及到2个不同项目的关联了;得先将远程的代码合并下来,才能提交;我们先假设项目已经通过git管理了。缺少关联push远程仓库的步骤讲:
【github】如何获取 github token
![notion image](https://image.kuangyichen.com/image/202311171004131.png?t=82eed8b2-fba2-4247-84c6-098f6da07669)
![notion image](https://image.kuangyichen.com/image/202311171006864.png?t=84e9995c-74a2-4318-968f-62e50c59f5d4)
参考:
- 作者:eachenkuang
- 链接:https://kuangyichen.com/article/elog
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。