[Hexo 博客插件系列-02] 语雀 yuque-hexo

插件来源于: https://github.com/x-cold/yuque-hexo

首先先安装插件:

1
2
3
npm i -g yuque-hexo
# or
npm i --save-dev yuque-hexo

注意, 需要安装全局的插件;

然后再 hexo 博客目录下的 package.json 文件中添加 语雀 的配置信息, 如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"name": "your hexo project",
"yuqueConfig": {
"postPath": "source/_posts/yuque",
"cachePath": "yuque.json",
"mdNameFormat": "title",
"adapter": "hexo",
"concurrency": 5,
"baseUrl": "https://www.yuque.com/api/v2",
"login": "yinzhi",
"repo": "blog",
"onlyPublished": false
}
}

配置解释如下表格:

参数名含义默认值
postPath文档同步后生成的路径source/_posts/yuque
cachePath文档下载缓存文件yuque.json
mdNameFormat文件名命名方式 (title / slug)title
adapter文档生成格式 (hexo/markdown)hexo
concurrency下载文章并发数5
baseUrl语雀 API 地址-
login语雀 login (group)-
repo语雀仓库短名称-
onlyPublished只展示已经发布的文章true

slug 是语雀的永久链接名,一般是几个随机字母。
repo 即语雀上要同步到 Hexo 的知识库名称;
login 即登录 ID 标识, 鼠标移到右上角头像图标, 弹出框里即可看到;
其他配置默认即可;

接着可以执行同步命令, 将语雀上指定知识库(repo)的文章同步到 hexo 博客中指定的位置(postPath):

1
yuque-hexo sync

也可以执行清空命令, 清除从语雀上同步下来的文章:

1
yuque-hexo clean

最后, 嗯, 讲白了就是将 语雀 上的文章 markdown 到 hexo 博客下面; 网上说的复杂一些的都是那些自动化部署发布啥的, 阁主不清楚, 暂时也没用到那些, 这里就不介绍了.
对于不同主题和插件的 front-matter 配置, 该插件还有待完善, 期待进一步的开发, 毕竟, 语雀还是很好的一个文章编辑器.


--------------------本文至此结束  感谢您的阅读--------------------

本文标题:[Hexo 博客插件系列-02] 语雀 yuque-hexo

文章作者:Memento

发布时间:2019年04月15日 - 13:04

最后更新:2019年04月15日 - 17:04

原始链接:https://memento.net.cn/post/6f3f19b1.html

许可协议: 署名-非商业性使用-禁止演绎 4.0 国际 转载请保留原文链接及作者。

Memento wechat
欢迎您扫一扫上面的微信公众号, 订阅阁主公众号!
坚持原创技术分享, 您的支持将鼓励我继续创作