上一节通过几个简单的命令,我们就搭建了本地Hexo服务。这一节我们看一下配置文件,以及学习如何使用Hexo。
配置
这是上一节新建Hexo文件时,我们得到的目录结构。
├── _config.yml
├── scaffolds
├── source
| └── _posts
└── themes
_config.yml
是Hexo的站点配置文件,一会儿详细说。scaffolds
目录中是文章和草稿的模板,其中只包含Front-matter
,这个词找不到合适的翻译,就把它当做文章头就好了。不用管它,不影响写文章。source
目录下还有一个_posts
目录,用于存放文章。有时也会有另外两个目录,_drafts
和_pages
,分别存放草稿和网页。themes
中存放我们选择的主题。默认主题是landscape
。
我们着重看_config.yml
和themes
。
配置文件
_config.yml
文件包含了大部分配置,但其实很多是不需要修改的。我们详细看一下。
Site
Site下主要是站点信息。不同版本的Hexo可能会多一些或者少一些,没有关系的。
标签 | 描述 |
---|---|
title | 网站标题 |
subtitle | 网站副标题 |
description | 网站描述 |
keywords | 网站关键字 |
author | 作者 |
language | 语言 |
timezone | 时区 |
description
,keywords
都是用于SEO,告诉搜说引擎该站点的描述。如果你想让你的博客被搜索引擎优先展示,那么优化SEO是必不可少的。language
可以设为zh-Hans
,表示中文。timezone
可以不写,默认使用电脑时区。描述和:之间要有空格!
URL
URL下是有关网址的信息。
标签 | 描述 |
---|---|
url | 网址 |
root | 网站根目录 |
permalink | 文章永久链接格式 |
permalink_defaults | 网站描述 |
这里的root
是Hexo站点的根目录。例如你的网站存放在一个子目录 http://yoursite.com/blog
中,那么就把root
设为/blog/
。
永久链接格式默认为:year/:month/:day/:title/
,如果你想把它改成分类地址的话,就是:category/:title/
。永久链接中的变量还可以使用其他变量,但是注意变量:id
。这个id每次在你生成静态网页时,也就是运行hexo g
时都会重新分配。而有些评论插件,就是靠id来识别文章的,id变化之后评论可能出现混乱。BTW,不知道煎蛋网评论时出现的“页面ID错误”是不是这种情况。
Directory
这部分是目录的配置,不要改。
Writing
这部分是文章写作的配置。也没有改动的必要。
Category & Tag
可以在这里添加标签或者分类的别名,但是一般用不上呢。
Date / Time format
默认值也很好了。
Pagination
per_page
这个变量可以随意改,pagination_dir
就不要动了。
标签 | 描述 |
---|---|
per_page | 每页文章数 |
pagination_dir | 分页目录 |
Extensions
这里只有一个标签,就是主题。你的theme
目录下可以存放多个主题,但是只能用一个,就是在这里选择要使用的那一个。
Deployment
用于部署,我们下一节再讲这里。
使用
Hexo的使用其实就是写文章与发文章。对于写文章,官方的方法是通过下面的命令新建文章:
$ hexo new [layout] <title>
这句命令其实就是在文章目录下新建一个markdown文件,和手动添加几乎一样,唯一的区别就是把模板上的Front matter给你写好了。
至于draft
我感觉用处不大,所以就不说了,直接写文章就好。写好了再发布,和草稿不是一样嘛。
小结
除了根目录下的_config.yml
,我们会发现主题文件夹下也有一个_config.yml
,那个是有关主题,更细节的配置。我们第四节再讲。下一节我们讲Hexo部署。