教程：静态博客使用语雀编辑器

tags: [Hexo]
categories: 教程

前言

语雀 是一款非常好用的知识管理网站（类似 GitBook)，它的编辑器非常好用，而且支持导出 Markdown，这篇文章是教你如何使用语雀的编辑器写静态博客。这里的静态博客用了 Hexo，Jekyll 也是没有问题的。

创建 Hexo 博客

已经有 Hexo 博客的可以跳过。如果你是 Jekyll ，也可以跳过。

  • 安装 Node.js

  • 安装 Hexo 脚手架

  1. npm install -g hexo-cli
  • 初始化一个博客
  1. hexo init <folder>
  2. cd <folder>
  3. npm install

安装语雀文章下载插件

yuque-hexo 是一个 Node.js 环境下的语雀下载器，使用 npm 安装

  • 安装 yuque-hexo
  1. npm i -g yuque-hexo

  • 注册语雀，创建知识库，获得你的个人路径和知识库的名字，比如我的博客的知识库是 https://www.yuque.com/page/luan.ma

  • 在 Hexo 博客的目录下面的 package.json 中，进行下面的配置

  1. {
  2.   "name": "your hexo project", //如果原来已经有这个不用再加了，直接加下面的就可以
  3.   "yuqueConfig": {
  4.     "baseUrl": "https://www.yuque.com/api/v2",
  5.     "login": "page",
  6.     "repo": "luan.ma",
  7.     "mdNameFormat": "slug",
  8.     "postPath": "source/_posts/yuque"
  9.   }
  10. }

  • 如果不是 Hexo 博客，则需要按照上面的文件保存一个 package.json 到博客目录，并且配置 postPath 为正确的文章目录

  • 同步文章

  1. yuque-hexo sync

PS: 插件支持 Front-matter，在语雀写文章的时候直接写在前面，然后插入一条分割线即可，不写也没问题：

  1. tags: [Hexo]
  2. categories: 教程
  3. date: 2018-10-05 10:43:50

启动/部署 Hexo 博客

  • 本地启动（调试用）
  1. hexo s
  • 生成 html 不部署
  1. hexo g
  • 自动上传到服务器/静态空间/git （部署）

  1. 先找到一个部署插件

  2. 在配置文件中配置好相关的账号密码

  3. 在 hexo 中生成 HTML 并且部署

  1. hexo g -d

静态博客空间选择

  1. Github Pages： 方便，不太稳定，Git部署

  2. Coding.net Pages： 需要挂一个链接 或者 付费，速度尚可，Git部署

  3. 腾讯云 COS + 腾讯云 CDN：需要备案，速度极快，COS 插件部署

  4. 自有服务器：可定制，速度一般 ，支持多种方式部署

后记

核心是把 yuque-hexo 这个东西介绍给大家，本博客目前也是使用这个方案同步语雀的文章。

当然，关于 Hexo 皮肤、评论插件等等玩法也要折腾很久，我就不在这篇文章里面说了。