yuque-hexo:语雀写⽂,⾃动部署Hexo博客
关于劳动的作文熟悉我的⼩伙伴应该知道,我喜欢使⽤ Markdown 来⼯作、学习笔记,主要是简洁⽅便。
并且我是⼀个坚定地“原⽣ Markdown ⽀持者”,什么“所见即所得”都是异端,所以对于 Typora、Notion、Bear、语雀等等⼀些软件都是略有尝试,但是我始终使⽤的是 VS Code + Markdown All in One + Markdown Table Marker + Paste Image + One Dark Pro + Project Manager 等组成了⼀个笔记软件,也确实对我来说 VS Code 只是⼀个笔记软件。
为什么喜欢原⽣ Markdown?
因为从最开始写笔记、代码中的 README 时,对其中的语法还花了⼀段时间来记录,并且总感觉⾟⾟苦苦写了⼀篇⽂章,看着都是⽂字还有各种语法,在预览的瞬间,有⼀种成就感(可能有吧)。
后来喜欢写 Hexo 博客,等,都需要⽀持原⽣ Markdown,虽然很多“所见即所得”可以复制导出 Markdown,但是在各个平台的兼容性,以及导出的语法并不能够很通⽤,所以就⼀直使⽤原⽣ Markdown 来记录笔记。
当然这⼀切在我(被迫)使⽤⼀段时间语雀之后,突然觉得⽤惯了还挺好,就在想是不是可以⾃动同步⽂章到 Hexo?或者⾃动同步到其他平台,结果查了查,还真有⼩伙伴写了插件 yuque-hexo。
下⾯进⼊教程部分:
1Hexo
在开始之前,肯定是要有⼀个 Hexo 博客的,这⾥默认⼤家对 Hexo 都有所了解。
我是使⽤的 Hexo + butterfly 来搭建的博客,并且⾃⼰购买了域名指向 Github 静态页⾯。
2语雀
新建知识库
登录语雀,新建知识库
导⼊⽂章霸气游戏名字大全
将之前写的 Hexo ⽂章导⼊到这个知识库中,我是直接将 _post 压缩了⼀下,批量上传的。
上传之后会存在⼀个问题,之前在 Hexo 笔记中有配置封⾯(img、cover 等)字段,可能上传后会被转换为链接,这⾥需要⾃⼰改⼀下。
安装 yuque-hexo 插件
配置知识库
颜丙燕个人资料
在 package.json 中添加以下配置,记得修改配置,其中 login 和 repo 在仓库浏览器 url 中都可以看到。
"yuqueConfig": {
"postPath": "source/_posts",
"cachePath": "yuque.json",
"mdNameFormat": "slug",
"adapter": "markdown",
"concurrency": 5,
社保转移"baseUrl": "www.yuque/api/v2",
"login": "语雀 login (group), 也称为个⼈路径",司马青衫是形容
"repo": "语雀仓库短名称,也称为语雀知识库路径",    "token": "这⾥是语雀的 token ",
"onlyPublished": true,
"onlyPublic": true
}
最初的起点如何获取语雀 Token
账户设置 -> Token 然后权限⾃⼰看着选。
本地调试
执⾏yuque-hexo sync就会拉取语雀的⽂章到本地 _post 路径下,所以记得先把⾃⼰的⽂章备份。
hexo g & hexo s 本地启动看看。尤其是看看封⾯之类的,如果不对,就⾃⼰看看从语雀拉取的⽂章格式对不对。
3GitHub
上⾯已经实现了,将语雀知识库的⽂章拉取到⾃⼰的博客的 _post 路径下,这时候⾃⼰hexo deploy也是可以的,当然,咱们要实现的是⾃动化,可不是要⾃⼰再拉下来⼀次,然后再⼿动推倒 github。
配置 submodule
git submodule add <url> <path>
如果不配置 submodule,其实也可以将主题下⾯的 .git ⽂件删掉,这样主题内容就会作为你博客的⼀部分,推到你的代码仓库了。
创建 secret
这个 secret 在后⾯的 workflow 脚本会⽤到,所以需要记住。