基于Elog的 Notion-hexo 同步方案

博客工具

• 写作平台：Notion
• 博客平台：Hexo
• 博客主题：Butterfly
• 博客文档同步：Elog
• 原项目仓库：https://github.com/elog-x/notion-hexo

博客搭建指南

Fork模板仓库

将模板仓库 clone 到本地

之前已经有博客的情况

1. 使用旧博客文件覆盖博客仓库

2. 修改package.json中的依赖：

   {
     "name": "hexo-site",
     "version": "0.0.0",
     "private": true,
     "scripts": {
       "build": "hexo generate",
       "clean": "hexo clean",
       "deploy": "hexo deploy",
   +   "server": "hexo clean && hexo server",
   +   "sync:local": "elog sync -e .elog.env",
   +   "elog:init": "elog init",
   +   "sync": "elog sync",
   +   "elog:clean": "elog clean"
     },
     "hexo": {
       "version": "7.3.0"
     },
     "dependencies": {
   +   "@elog/cli": "^0.14.0",
       "hexo": "^7.0.0",
       "hexo-abbrlink": "^2.2.1",
       "hexo-bilibili-bangumi": "^1.10.8",
       "hexo-butterfly-categories-card": "^1.0.0",
       "hexo-butterfly-clock-anzhiyu": "^1.1.8",
       "hexo-butterfly-envelope": "^1.0.15",
       "hexo-butterfly-footer-beautify": "^1.0.6",
       "hexo-butterfly-tag-plugins-plus": "^1.0.18",
       "hexo-butterfly-wowjs": "^1.0.5",
       "hexo-deployer-git": "^4.0.0",
       "hexo-generator-archive": "^2.0.0",
       "hexo-generator-category": "^2.0.0",
       "hexo-generator-feed": "^3.0.0",
       "hexo-generator-index": "^3.0.0",
       "hexo-generator-search": "^2.4.3",
       "hexo-generator-sitemap": "^3.0.1",
       "hexo-generator-tag": "^2.0.0",
       "hexo-renderer-ejs": "^2.0.0",
       "hexo-renderer-kramed": "^0.1.4",
   +   "hexo-renderer-marked": "^6.0.0",
       "hexo-renderer-pug": "^3.0.0",
       "hexo-renderer-stylus": "^3.0.1",
       "hexo-server": "^3.0.0",
       "hexo-tag-aplayer": "^3.0.4",
       "hexo-theme-landscape": "^1.0.0"
     },
     "devDependencies": {
       "hexo-generator-baidu-sitemap": "^0.1.9"
     }
   }

3. 继续后续操作

安装依赖

在项目根目录下运行命令安装依赖

npm install

新建 Elog 本地调试文件

1. 将.elog.example.env文件重命名为.elog.env，此文件将用于本地同步Notion 文档

配置 Notion 关键信息

配置流程

1. 使用 Database 模板 创建数据库副本或增加必要属性到已有 Notion 数据库
   • 博客平台为Hexo时，可参考elog-hexo-template 创建数据库副本或增加必要属性到已有 Notion 数据库
2. 创建 Integration Token，具体请参考 Notion 官方教程
3. 将复制的数据库连接到刚创建的 Integration，具体请参考 Notion 官方教程
4. 获取数据库 DatabaseId

按照文档提示配置 Notion 并获取 token 和 databaseId，在本地.elog.env中写入

text

NOTION_TOKEN=获取的token
NOTION_DATABASE_ID=获取的databaseId

配置Notion Database

示例：

Database字段：

• permalink为文档的永久链接，例如https://notion-hexo.vercel.app/notion-hexo/，注意记得在结尾加上/
• categories为文档的分类
• tags 为文档的标签
• description为主题配置中可选的文档描述

获取token

1. 登录Notion 网页版 =>访问My integrations =>New Integration => 生成 Internal Integration Token

   

2. Internal Intergration Secret即为token

   

3. 在使用的Notion Database页面点击右上角设置→Connections，选择刚才创建的Integration

   

其他注意事项：

• notion文章必须有封面（cover），否则同步会失败

获取DatabaseId

图中url中红框部分（1b8a0f24b32980ca9c66cbc557236562）即为DatabaseId

本地调试

在项目根目录运行同步命令，Notion Database中的文章就会被全部同步值本地

npm run sync:local
# 或
elog sync -e .elog.env

Elog配置CloudFlare R2图床

官方插件文档

安装插件

npm install @elog/plugin-img-r2

配置 elog.config.js

// elog.config.js
const r2 = require('@elog/plugin-img-r2')

module.exports = {
  // ...省略
  image: {
    enable: true,
    plugin: r2,
    r2: {
      accessKeyId: process.env.R2_ACCESSKEYID,
      secretAccessKey: process.env.R2_SECRET_ACCESSKEY,
      bucket: process.env.R2_BUCKET,
      endpoint: process.env.R2_ENDPOINT,
      host: process.env.R2_HOST,
      prefixKey: 'elog-image-plugin-test'
    }
  },
}

配置 .elog.env文件

在 .elog.env 中插入以下信息

# .elog.env 配置R2 相关账号参数
#R2
# 访问密钥 ID
R2_ACCESSKEYID=
# 机密访问密钥
R2_SECRET_ACCESSKEY=
R2_ENDPOINT=
# R2 需要使r2.dev子域供网络访问或者绑定自己的域名
R2_HOST=
R2_BUCKET=

• R2_ACCESSKEYID、R2_SECRET_ACCESSKEY、R2_ENDPOINT：API令牌中查看
• R2_HOST：生成的R2.dev子域 或 自己的域名
• R2_BUCKET：存储桶的名称

令牌信息仅在创建令牌时显示一次，之后无法再次查看，如需查看只能选择轮转重新生成令牌信息。