Everblog ——使用 Evernote 写博客

我是个重度 Evernote 用户。在前几年造博客轮子盛行的时候，我也基于 Evernote 造了个轮子，最近抽空拿出来修了修，顺便记录一下。

什么是 Everblog?

Everblog = Evernote + Blog，即使用 Evernote 写博客。Everblog 有几个特点：

1. 简单。使用默认的 SPA 主题三步即可生成博客，使用其他博客构建工具（如: Hexo ）也只多了 everblog build 一步
2. 灵活。造轮子当然要利用好当前的生态，Everblog 支持多种 adaptor （目前支持 SPA、Hexo ），每种 adaptor 可使用它们生态下所有 theme，即 everblog-adaptor-hexo 可使用所有 Hexo 的主题去构建博客），Jekyll、Ghost 等的 adaptor 也正在开发中
3. 安全。数据保存在 Evernote （多端同步，手机也可以写博客），其他博客工具则会将文章存成本地文件

Everblog 设计难点与思路

在实现 Everblog 的过程中遇到几个难点：

1. 资料少，官方的 evernote/evernote-sdk-js 没有 demo，只能通过读源码去看和尝试 api
2. Evernote 使用的独有的 ENML 标记语言（类似于 HTML，添加了几种标签），所以通过 api 拿到 ENML 需要解析成 HTML 或者 Text，于是又造了两个轮子：
   1. enml2html: 将 ENML 解析成 HTML
   2. enml2text: 将 ENML 解析成 Text （可以是 Markdown ）
3. 国内印象笔记不支持公开链接，Evernote 国际版可以。所以印象笔记只能使用 Text （可以是 Markdown ），不能使用 Evernote 自带的富文本模式（如插入一张图片）生成博客，因为无法生成外链，所以建议使用 Evernote 国际版
4. 使用富文本模式将笔记生成博客，如果有图片和音频之类的内嵌附件，需要将附件（如：img 的 src ）拼凑成正确的地址（ enml 格式中只给一个附件的 hash ）。研究附件的外链地址格式，这个也稍微花了点时间
5. 最后遇到一个非常蛋疼的问题：在 Evernote 中创建 _config.yml ，构建的时候拿到 _config.yml （ ENML 格式）转换成纯文本然后用 js-yaml 去解析，结果出错，后来发现拿到的 yml 文本中竟然有 no-break space，而不是 space，所以在 enml2text 修复了空白符的逻辑。更多空白符见：Whitespace character

设计思路（想到啥写啥）：

1. 一个 Evernote 笔记本对应生成一个博客。所以可以在 Evernote 创建不同的笔记本生成多个博客，方便管理
2. 一条笔记生成一篇博文。如果标题是 .md 结尾，则使用 enml2text，如果不是 .md 结尾，则使用 enml2html，见 everblog-adaptor-spa 代码。笔记的创建时间，更新时间，标签等信息都可以给到 adaptor，然后复用
3. 每个笔记本下一定要有一个 _config.yml 的笔记，对应各个博客构建工具的 _config.yml ，这个无需多说。每次使用 everblog build 构建时都会读取这个配置（必要时 dump 到本地 _config.yml ）
4. clean 模式。ENML 转 HTML 时，标签内大量使用了内联样式（ inline style ）。everblog build 时可以添加 --clean 参数去除这些 style，防止跟主题的样式冲突
5. 利用当前几大静态博客构建工具的生态（主要是很多好看的主题），如 Hexo，Ghost 等。所以 Everblog 设计之初定位就是：everblog 用来获取 Evernote 笔记和一些必要信息（如：webApiUrlPrefix，content，tags，resources 等等），然后交给 adaptor 转化成其他博客构建工具所需的资源。如： /source/_posts/xxx.md + _config.yml 等文件

如何使用 Everblog?

第一次使用需要 4 步，以后只需要 第 3、4 步就可以了。

1. 全局安装 everblog+填写配置文件:

$ npm i everblog -g
$ vim ~/.everblogrc

  token: xxx,
  noteStoreUrl: xxx,
  notebook: myblog

2. 下载主题, 如下载默认 SPA 主题 everblog-theme-spa:

$ git clone https://github.com/everblogjs/everblog-theme-spa myblog
$ cd myblog && npm i

3. 打开 Evernote:

- 创建笔记本 myblog
- 创建配置文件 _config.yml ，添加一些配置如：title，author 等信息。每种 adaptor 的主题要求的配置不一样，根据主题来
- 创建一些笔记

4. 启动 everblog:

$ DEBUG=* everblog start

Tips: token 和 noteStoreUrl 从以下链接获取： https://www.evernote.com/api/DeveloperToken.action

图文步骤如下：

1. 创建 _config.yml
2. 创建一些笔记
3. 运行 DEBUG=* everblog start 构建并打开构建成功后的主页

使用 Hexo 主题

使用 Hexo 主题完整步骤如下：

$ npm i hexo-cli -g # 全局安装 hexo-cli
$ hexo init myblog # 初始化一个 hexo 项目
$ cd myblog && npm i # 安装依赖
$ npm i everblog -g # 全局安装 everblog
$ npm i everblog-adaptor-hexo --save # 在当前 hexo 项目下安装 adaptor
$ echo "module.exports = require('everblog-adaptor-hexo')" > index.js # 在当前 hexo 项目下创建 index.js ，引入 adaptor
$ DEBUG=* everblog build # 使用 everblog 构建 hexo 所需文件
$ hexo server # 启动 hexo
$ open http://localhost:4000/ # 浏览器打开博客主页

如下所示：

Tips: 记得修改 _config.yml ，填写 hexo 所需的配置。

链接

• 知乎：https://zhuanlan.zhihu.com/p/32456254
• GitHub https://github.com/everblogjs/everblog