Hexo建站

​ Hexo是基于Node.js的网站框架,出自台湾大学生tommy351之手. 风格大多为极简风格, 可以生成本地静态网页, 同时可以push到github实现外网访问

中文官网

本地环境

  1. 安装Node.js 官网

  2. 命令行安装Hexo

    1
    $ npm install -g hexo-cli
  3. 创建一个目录用于存储Hexo数据, 然后命令行cd到该目录, 执行以下两个命令

    1
    2
    $ hexo init
    $ npm install
  4. 开启服务器

    1
    $ hexo s

然后在浏览器中打开 本地访问

Github网站

接下来将网页push到github上实现能够通过外网访问

  1. 登陆Github新建一个仓库, 仓库名是自定义.github.io,之后网站的访问地址将是这个仓库名

    1. 复制仓库的Clone地址, 不用纠结于和截图不一致

    2. 在你之前创建的文件夹中打开Hexo的站点配置文件_config.yml把从depoly开始后的覆盖为以下代码, 其中respository就是你之前复制的仓库地址

      1
      2
      3
      4
      deploy:
      type: git
      repository: https://github.com/liangjingkanji/liangjingkanji.github.io.git
      branch: master
    3. 执行命令, 将把hexo数据部署到github上, 如果发生ERROR Deployer not found: git错误, 执行npm install hexo-deployer-git --save命令后再次执行以下命令, 之后会让你输入github的用户名和密码

      1
      $ hexo deploy

主题

Hexo支持非常多的插件和主题, 官网可以直接搜索主题

直接下载主题解压放到Hexo的根目录的themes目录下, 然后在_config.yml文件中修改theme, 其中next就是主题目录

具体查看主题提供的配置说明

更新网站

在网站配置或者新建文章后, 如果是开启本地hexo服务http://localhost:4000的方式, 只需要刷新网页即可. 如果被部署到git 服务器上需要执行以下命令.

生成静态文件

1
$ hexo g

推送到服务器上

1
$ hexo d

如果没有网站内容没有更新, 可以尝试清除hexo缓存

1
$ hexo clean

写作

新建文章

“[“和”<”符号都是表示需要替换的参数, 实际命令行中不需要

1
$ hexo new [layout] <title>

layout默认有三种参数, 根据布局参数的不同生成的 md 文件的头信息(Front-matter)也会不一样, 详细自己打开文件看吧.

参数 描述
post 即使不给参数, 默认就是post . 文件路径/source/_posts
page 分页, 文件路径/source/ 分页名
draft 草稿, 文件路径/source/_drafts

草稿

草稿相当于很多博客都有的“私密文章”功能。

1
$ hexo new draft "new draft"

会在source/_drafts目录下生成一个new-draft.md文件。但是这个文件不被显示在页面上,链接也访问不到。也就是说如果你想把某一篇文章移除显示,又不舍得删除,可以把它移动到_drafts目录之中。

如果你希望强行预览草稿,更改配置文件:

1
render_drafts: true

或者,如下方式启动server:

1
$ hexo server --drafts

下面这条命令可以把草稿变成文章,或者页面:

1
$ hexo publish [layout] <filename>

布局模板

在 hexo 的根目录下的scaffolds下存在三个文件draft.mdpage.md以及post.md, 这就是新建文章时的布局模板.

如果想自定义模板可以手动在该目录下创建一个 md 后缀的文件. 使用方式和默认的模板一样.

變數 描述
layout 佈局
title 標題
date 檔案建立日期

Front-matter

Front-matter 是檔案最上方以 --- 分隔的區域,用於指定個別檔案的變數,舉例來說:

1
2
3
4
---
title: Hello World
date: 2013/7/13 20:46:25
---

以下是預先定義的設定,您可在模板中取得這些設定值並加以利用。

設定 描述 預設值
layout 佈局
title 標題
date 建立日期 檔案建立日期
updated 更新日期 檔案更新日期
comments 開啟文章的留言功能 true
tags 標籤(不適用於分頁)
categories 分類(不適用於分頁)
permalink 覆蓋文章網址

监视文件变动

Hexo 能够监视文件变动并立即重新生成静态文件,在生成时会比对文件的 SHA1 checksum,只有变动的文件才会写入。

1
$ hexo generate --watch

完成后部署

您可执行下列的其中一个命令,让 Hexo 在生成完毕后自动部署网站,两个命令的作用是相同的。

1
2
$ hexo generate --deploy
$ hexo deploy --generate