写在前面

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

创建 Hexo 博客

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

  • 安装 Node.js

  • 安装 Hexo 脚手架

    1
    npm install -g hexo-cli
  • 初始化一个博客

    1
    2
    3
    hexo init <folder>
    cd <folder>
    npm install
  • 其他设置和命令见:https://hexo.io/zh-cn/docs/

安装语雀文章下载插件

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
    3
    4
    5
    6
    7
    8
    9
    10
    {
    "name": "your hexo project", //如果原来已经有这个不用再加了,直接加下面的就可以
    "yuqueConfig": {
    "baseUrl": "https://www.yuque.com/api/v2",
    "login": "page",
    "repo": "luan.ma",
    "mdNameFormat": "slug",
    "postPath": "source/_posts/yuque"
    }
    }
  • 如果不是 Hexo 博客,则需要按照上面的文件保存一个 package.json 到博客目录,并且配置 postPath 为正确的文章目录

  • 同步文章

    1
    yuque-hexo sync

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

1
2
3
tags: [Hexo]
categories: 教程
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. 自有服务器:可定制,速度一般 ,支持多种方式部署

写在后面

其实这篇文章干货不多,主要是应某网友的要求,顺便把我的 TenneyBlog 做个了结。核心是把 yuque-hexo 这个东西介绍给大家。这个插件由阿里巴巴的同学开发,我也做了一些微小的贡献。本博客目前也是使用这个方案同步语雀的文章。

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