hexo doc

文档解析

安装

安装hexo的前提是要有Node.js以及Git，至于什么是Git和Node以及如何安装他们可以自行搜索了解。

安装完Node以及Git后，通过下面的命令安装Hexo:

npm install -g hexo-cli

启动

在电脑中找个目录，并进入目录，执行下面几个命令，hexo就准备就绪了。

hexo init // 初始化目录
npm install // 安装运行hexo的一些必要的组件

运行完，你会看到你的当前目录下，会自动创建一些目录，如下：

.
├── _config.yml
├── package.json
├── scaffolds/
├── scripts/
├── source/
|   ├── _drafts
|   └── _posts
└── themes/

各个文件或者目录的用途：

• _config.yml站点配置文件，很多全局配置都在这个文件中。
• package.json 应用数据。从它可以看出hexo版本信息，以及它所默认或者说依赖的一些组件。
• scaffolds 模版文件。当你创建一篇新的文章时，hexo会依据模版文件进行创建，主要用在你想在每篇文章都添加一些共性的内容的情况下。
• scripts 放脚本的文件夹， 就是放js文件的地方
• source 这个文件夹就是放文章的地方了，除了文章还有一些主要的资源，比如文章里的图片，文件等等东西。这个文件夹最好定期做一个备份，丢了它，整个站点就废了。
• themes 主题文件夹。

配置

主要配置就是_config.yml这个文件了

（1）首先是Site部分，也就是站点的一些参数设置：

• title 站点名字，也就是html的title，会显示在浏览器标签上。
• subtitle 站点副标题，会显示在首页上，可以不填。
• description 站点描述，可以不填。
• author 作者
• language 语言
• timezone 站点时区，默认是电脑时间

（2）接下来是URL部分设置：

• url 站点网址
• root 站点根目录
• permalink 文章的永久网址链接，默认是:year/:month/:day/:title/，指的什么意思？比如我一篇叫『love』的文章是在2012年1月1日写的，那么它对应的链接就是http://yoururl/2012/01/01/love/，
• permalink_default

如果网址是次级目录，比如：http://example.com/blog，那么就要设置url为http://example.com/blog，并且root要设置为/blog/。

（3）再接下来就是目录配置：

• source_dir source目录，默认值为source
• public_dir public目录，静态网站生成的地方，默认值为public
• tag_dir tag目录
• archive_dir Archive目录
• category_dir 分类目录
• code_dir 代码目录
• i18n_dir i18n目录
• skip_render 不想被渲染的路径
  上面这一部分的值，我基本上没有改过，默认的就行了。

（4）接着是写作配置了：

• new_post_name 新建文章默认文件名，默认值为 :title.md，比如你执行命令hexo new hello，就会默认在_post目录下创建一个hello.md的文件。
• default_layout 默认布局
• titlecase
• external_link 在新标签中打开一个外部链接，默认为true
• filename_case 转换文件名，1代表小写；2代表大写；默认为0，意思就是创建文章的时候，是否自动帮你转换文件名，默认就行，意义不大。
• render_drafts 是否渲染_drafts目录下的文章，默认为false
• post_asset_folder 是否启用Asset
• Folder，默认为false，至于什么是Asset Folder，后面有讲解。
• future 是否显示未来日期文章，默认为true
• highlight 代码块设置
  这一部分也可以基本不变，默认值就行。

（5）接下来是分类和标签的设置：

• default_category 默认分类，默认为无分类，当然你可以设置一个默认分类。
• category_map 分类，不明白其作用
• tag_map 标签，不明白其作用

（6）日期和时间格式配置：

Hexo使用的Moment.js来处理时间的。

• data_format 日期格式，默认为MMM D YYYY，不过我将它改成了YYYY-MM-DD，符合个人口味，其他格式模版可以查看Moment.js
• time_format 时间格式，默认为H:mm:ss

（7）分页设置：

• per_page 一页显示多少篇文章，0 为不分页，默认值为 10
• pagination_dir 分页目录，默认值为page

（8）最后就是扩展配置：

• theme 主题配置，此处填上主题名就OK了，当然在themes目录下一定要有你配置的主题文件夹。
• deploy 部署配置，将本地public目录也就是网站部署到服务器上的配置。如何部署？Docs文档『基础用法』部分有说明。

命令

• hexo init [folder]，使用该命令初始化一个站点，不加目录参数，就初始化当前目录
• hexo new [layout] <title>，创建一篇文章，如果不指定layout，那么就使用_config.yml中default_layout的值，标题中如果有空格，将整个title放到引号中。比如，hexo new "hello world"创建一篇叫hello world的文章。
• hexo generate，简单的说，这个命令就是将md格式的文章，生成静态网页。这个命令可以简写为hexo g，它有两个参数选项：
  -d,--deploy 生成完后直接部署
  -w,--watch 查看文件的改变
• hexo publish [layout] <filename>，发布一个草稿
• hexo server，启动一个本地服务，可以在本地查看网站，默认启动http://localhost:4000，貌似这个不是默认，运行命令的时候可以查看提示消息。它也有一些参数：
  -p,--port 指定端口
  -s,--static 仅服务静态文件
  -l,--log 开启日志
• hexo deploy 部署站点，可以缩写hexo d，有一个参数，hexo d -g表示在部署前先重新生成一下站点