记一遍hexo的使用教程.md

记一遍hexo的使用教程

常用命令:

1、写文章：
    hexo new [layout] "postName" # 新建文章
 备注：[layout]:指的是scaffolds下面的文件名，默认是post，
      也可以选择其他的格式。

2、本地查看调试
    hexo g #生成
    hexo s #启动本地服务，进行文章预览调试
 备注：也可以直接使用组合命令：hexo d -g每次变更_config.yml文件或者上传文件都可以先用此命令调试。

3、对网站进行整体的设置，只需要修改项目目录的_config.yml就可以了   

4、写文章的流程
    hexo n "文章名"    #直接写名称即可，默认生成的是md格式。
    写完以后推送到服务器上，执行：
    hexo g # 生成
    hexo d  #部署

5、设置侧边栏头像
在编辑站点的 _config.yml，新增字段 avatar， 值设置成头像的链接地址。
对应的属性值： /uploads/avatar.jpg 需要将你的头像图片放置在 站点的 source/uploads/（可能需要新建uploads目录）
6、侧边栏添加搜索栏目 [本地搜索]
 先安装搜索模块：npm install hexo-generator-search --save，在/themes/next/_config.yml添加 
 1
2
3 search: 
path: search.xml
field: post

 在menu_icons中添加search: search，[此处的icon是一种[fontawesome][http://fontawesome.io/icons/]图标]

7、设置侧边栏的分类
按照[官方文档指示][http://theme-next.iissnan.com/theme-settings.html#categories-page],分类栏目是要自己创建的，
首先在根路径下执行：hexo new page categories，并在新生成的文件中添加 type: "categories"，
然后在主题文件的yml文件中添加 menu: categories: /categories

8/

The Writing FLow With It

1
2
3
4
5
6 1、首先创建草稿文件 hexo new draft "文件名"
2、写完以后变成正式文章 hexo publish [layout] <title> 例如：hexo publish post reactNative 
3、生成静态页面   hexo g
4、开启预览      hexo server
5、部署到github  hexo deploy

备注：在此过程中可能会生成报错信息：

1 2	YAMLException: cannot read a block mapping entry; a multi line key may not be an implicit key at line 5, column 1: # Site

这个问题的出现可能是你的文章开头部分，缺少空格，每一个属性的后面都要有空格。