新建博客

在博客目录下右键打开Git Bash,输入hexo new 博客名,即可创建新博客,新建的文件在/source/_posts/博客名.md,使用markdown编辑器编写博客即可。

Front-matter

Front-matter是档案最上方以---分隔的区域,用于指定个别档案的参数。

Page Front-matter

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
---
title 【必需】页面标题
date 【必需】页面创建日期
type 【必需】标籤、分类和友情链接三个页面需要配置
updated 【可选】页面更新日期
description 【可选】页面描述
keywords 【可选】页面关键字
comments 【可选】显示页面评论模块 (默认 true)
top_img 【可选】页面顶部图片
mathjax 【可选】显示 mathjax (当设置 mathjax 的 per_page: false 时,才需要配置,默认 false)
katex 【可选】显示 katex (当设置 katex 的 per_page: false 时,才需要配置,默认 false)
aside 【可选】显示侧边栏 (默认 true)
aplayer 【可选】在需要的页面加载 aplayer 的 js 和 css, 请参考文章下面的音乐 配置
highlight_shrink 【可选】配置代码框是否展开 (true/false)(默认为设置中 highlight_shrink 的配置)
---

Post Front-matter

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
---
title 【必需】文章标题
date 【必需】文章创建日期
updated 【可选】文章更新日期
tags 【可选】文章标籤
categories 【可选】文章分类
keywords 【可选】文章关键字
description 【可选】文章描述
top_img 【可选】文章顶部图片
cover 【可选】文章缩略图 (如果没有设置 top_img, 文章页顶部将显示缩略图,可设为 false / 图片地址 / 留空)
comments 【可选】显示文章评论模块 (默认 true)
toc 【可选】显示文章 TOC (默认为设置中 toc 的 enable 配置)
toc_number 【可选】显示 toc_number (默认为设置中 toc 的 number 配置)
auto_open 【可选】是否自动打开 TOC (默认为设置中 toc 的 auto_open 配置)
copyright 【可选】显示文章版权模块 (默认为设置中 post_copyright 的 enable 配置)
copyright_author 【可选】文章版权模块的文章作者
copyright_author_href 【可选】文章版权模块的文章作者链接
copyright_url 【可选】文章版权模块的文章连结链接
copyright_info 【可选】文章版权模块的版权声明文字
mathjax 【可选】显示 mathjax (当设置 mathjax 的 per_page: false 时,才需要配置,默认 false)
katex 【可选】显示 katex (当设置 katex 的 per_page: false 时,才需要配置,默认 false)
aplayer 【可选】在需要的页面加载 aplayer 的 js 和 css, 请参考文章下面的音乐 配置
highlight_shrink 【可选】配置代码框是否展开 (true/false)(默认为设置中 highlight_shrink 的配置)
---

插入图片

博客中插入图片后,转成静态网页过程中涉及到图片路径问题,暂时选择使用插件解决这个问题。

插件安装

在博客根目录下打开Git Bash,执行

1
npm install hexo-asset-image --save

打开hexo的配置文件_config.yml,找到 post_asset_folder,把这个选项从false改成true。

安装成功后新建博客时会生成和博客名相同的文件夹,将所需的图片放到这个文件夹中,插入图片时按下方格式插入即可,生成静态文件时插件会自动转换路径。

可以配置Typora中的图片路径,用第二种形式可以正常在Markdown中显示图片。

1
2
![图片描述](图片名.jpeg)
![图片描述](文件名/图片名.jpeg)

新建博客步骤

新建一个博客文件

1
2
$ hexo new "My New Post"
$ hexo n "My New Post"

More info: Writing

生成静态文件

1
2
$ hexo generate
$ hexo g

More info: Generating

运行服务器

1
2
$ hexo server
$ hexo s

More info: Server

部署到远程站点

1
2
$ hexo deploy
$ hexo d

More info: Deployment