博客配置

使用github + Hexo, 主题Fluid

Hexo

Hexo文档

初始化

安装hexo:

1
npm i hexo-cli -g

初始化:

1
2
hexo init
npm install

配置

配置文件:_config.yml

配置部署到github page

1
npm install hexo-deployer-git --save

1
2
3
4
deploy:
type: git
repository: https://github.com/pikaball/pikaball.github.io
branch: master

写作

新建post:

1
hexo new post "Title"

编辑source/_posts目录下的markdown文件,默认生成Front-matter

Front-matter 是文件最上方以 --- 分隔的区域,用于指定个别文件的变量

参数 描述 默认值
layout 布局 config.default_layout
title 标题 文章的文件名
date 建立日期 文件建立日期
updated 更新日期 文件更新日期
comments 开启文章的评论功能 true
tags 标签(不适用于分页)
categories 分类(不适用于分页)
permalink 覆盖文章的永久链接,永久链接应该以 / 或 .html 结尾 null
excerpt 纯文本的页面摘要。
disableNunjucks 启用时禁用 Nunjucks 标签 {{ }}/{% %} 和 标签插件 的渲染功能 false
lang 设置语言以覆盖自动检测 继承自 _config.yml

生成、部署

markdown源文件渲染为静态html:

1
hexo g

部署到服务器:

1
hexo d

部署到本地端口:

1
hexo s

Theme: Fluid

Fluid文档

Release下载,解压到themes目录下,命名为fluid,在Hexo的_config.yml中指定:

1
2
theme: fluid 
language: zh-CN

封面&首部图片

front-matter:

1
2
index_img: /img/example.jpg
banner_img: /img/post_banner.jpg

摘要

1
excerpt: 

启用MathJAX

themes/fluid/_config.yml

1
2
3
4
5
post:
math:
enable: true
specific: false
engine: mathjax