hexo+github.io博客搭建

前言

以前曾经使用过hexo博客,但没有坚持下去(可能是看极简风格看腻了23333),之后也尝试过自己搭建(想要个花里胡哨的),最后感觉还是hexo和segementFault或许会比较方便(可能会有人看吧)。

参考:
hexo中文文档 hexo_doc.

概述

安装前提

如文档中所说:
安装 Hexo 相当简单。然而在安装前,您必须检查电脑中是否已安装下列应用程序:
Node.js Node.js. (Should be at least nodejs 6.9)
Git Git.
如果您的电脑中已经安装上述必备程序,那么恭喜您!接下来只需要使用 npm 即可完成 Hexo 的安装。
$ npm install -g hexo-cli

建站

新建

在git bash中运行如下命令,<folder>是指定文件夹

1
2
3
$ hexo init <folder>
$ cd <folder>
$ npm install
  • _config.yml 网站的配置信息
  • package.json 应用程序信息
  • scaffolds 模板文件夹
  • source 资源文件夹是存放用户资源的地方
  • themes 主题文件夹

安装完成之后,我们可以先hexo server,在浏览器中打开,预览一下

配置主题

hexo主题参考 hexo_theme.

一些人气比较高的主题:

我以前用的是第二个,现在比较喜欢五彩斑斓的,目前使用的是(人气高的主题基本上会功能更完善)
TKL TKL

在theme文件夹下打开gitbash

1
git clone https://github.com/SuperKieran/TKL.git

更改主目录文件夹下的_config.yml

1
2
3
4
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: TKL

然后ng server一下就好啦。更多配置请参考文档。

GithubPages

GithubPages

  1. 在github创建仓库, 仓库名为:<Github账号名称>.github.io
  2. 在博客文件夹项目下运行npm install hexo-deployer-git --save
  3. 修改_config.yml
1
2
3
4
5
6
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: git@github.com:<Github账号名称>/<Github账号名称>.github.io.git
branch: master
  1. 运行
1
2
hexo g
hexo d
  1. 访问https://<Github账号名称>.github.io
  • 成功的基础是你的github已经配置好了ssh-key

命令

常用命令

  • new

新建一篇文章。如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。

1
2
3
$ hexo new [layout] <title>

// $ hexo new "post title with whitespace"
  • generate & deploy

hexo generate生成静态文件,可以简写为hexo g
hexo deploy生成静态文件,可以简写为hexo d

也可以连起来使用 hexo g -d或者hexo d -g。有些时候可能要等上一分钟。

  • hexo clean

如果发现您对站点的更改无论如何也不生效,您可能需要运行hexo clean

其他问题

如何保存主题?

当我用github来存储hexo文件夹时,我从另一台电脑拉代码时候才发现,我修改过的主题文件夹并没有被push。解决方案如下:

保存主题保存主题

每次点开链接太烦了,在这里简单的记录一下git subtree的操作

1
2
3
4
git fetch TKL master
git subtree pull --prefix=themes/TKL TKL master --squash

git subtree push --prefix=themes/TKL TKL master

看板娘

看伴娘看板娘

评论功能

livere使用教程livere

访问次数功能

不蒜子不蒜子

  • 本地显示的事后可能数据过大不准确,部署到线上就可以了。