个人博客搭建（二）

环境搭建好了之后，就可以开始写文章了。文章内容以 markdown 形式保存，而后由 Hexo 自动生成网页文件。 markdown 的语法不再赘述，网上相应教程、简易 wiki极多。 重要的是怎么使用 hexo。 前置文章： 个人博客搭建（一）

写作

新建文章

CLI 命令

通常新建文件的命令为：

1

hexo new [layout] <title>

• layout 代表文章的布局，已经预先定义在文章内容之外，只需选择对应布局进行调用即可
• title 代表文件名，有特殊字符时可以使用引号包裹

注意：要在 hexo 工作目录下使用此命令

Hexo 有三种默认布局：post、page 和 draft，它们分别对应不同的存储路径，而自定义的其他布局和 post 相同，都将储存到 source/_posts 文件夹。

一般的使用方式为 hexo new post "我的新 blog 文章"，而后在 source/_posts 目录找到相应文件进行编辑即可。

常用 metadata

文章需要指定标题、副标题、类别、标签等，应该在 md 文件的开头使用一对分割线包裹相应设置项目，如本文的设置为：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

---
title: 个人博客搭建（二）
subtitle: 基本使用与自定义配置
date: 2017-01-18 21:15:34
categories:
- 日常
tags:
- Hexo
- oschina
---

一般 date 项会自动生成，不用自己填写

草稿

Hexo 有一种特殊布局：draft，这种布局在建立时会被保存到 source/_drafts 文件夹，可通过 publish 命令将草稿移动到 source/_posts 文件夹（发布为正式文章），该命令的使用方式与 new 十分类似，也可在命令中指定 layout 来指定布局。

1

hexo publish [layout] <title>

草稿默认不会显示在页面中，可在执行时加上 --draft 参数，或是把 render_drafts 参数设为 true 来预览草稿。

其他

这里列出最基本、最常用的命令，其他详细的内容，应该参考 Hexo 官方文档。

记得撰写文章保存后使用 hexo g 生成页面

主题

可从官方主题库选择自己喜欢的主题，或者在 GitHub 上搜索。

安装

主题的安装方法非常简单：

1. 下载主题文件夹到 hexo 工作目录的子目录 themes
2. 将 hexo 工作目录的 _config.yml 文件的 theme 选项修改为对应主题文件夹名称，如：

1

theme: next

3. 参考对应主题的说明文档进行个性化设置

推荐

Hexo 的主题功能与组织方式大同小异，只要弄明白一个，其他的也就很容易通晓了。入门之选自然应该选择说明最详实的，因此，推荐使用 next 主题，使用人数多，并且文档极为详细，功能齐全。 GitHub 地址为：https://github.com/iissnan/hexo-theme-next 主题文档地址为：http://theme-next.iissnan.com/

如果出现显示效果不完整，或者文章内容不完整，可以尝试清理 hexo 的内容缓存再重新生成页面，即

1
2

hexo clean
hexo g

其他

RSS

Hexo 默认关闭 RSS 功能，需要下载插件并手动开启服务 插件下载：

1

npm install hexo-generator-feed --save

打开服务需要编辑博客的 _config.yml 文件，加入如下条目：

1
2
3
4

feed:
  type: atom
  path: atom.xml
  limit: 20

RSS 功能还可选择 rss2 类型，即：

1
2
3
4

feed:
  type: rss2
  path: rss2.xml
  limit: 20

插入图片

1. 打开对每篇文章分别保存图片的功能，修改博客 _config.yml 文件设置为：

1

post_asset_folder: true

2. 将图片移动到 source/_posts 目录中的和当前文档名称完全相同的目录中

3. 而后通过如下格式插入图片

1

![name> [title]](<file)

其中文件名项 file name 必须包含扩展名，而且包括大小写都必须完全匹配，图片名 title 可选。