快速开始
安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。
$ hexo init $ cd $ npm install
新建完成后,指定文件夹的目录如下:
. ├── _config.yml ├── package.json ├── scaffolds ├── source | ├── _drafts | └── _posts └── themes
指令
init
代码语言:javascript复制$ hexo init [folder]
新建一个网站。如果没有设置 folder
,Hexo 默认在目前的文件夹建立网站。
new
代码语言:javascript复制$ hexo new [layout] <title>
新建一篇文章。如果没有设置 layout
的话,默认使用 _config.yml 中的 default_layout
参数代替。如果标题包含空格的话,请使用引号括起来。
generate
代码语言:javascript复制$ hexo generate
生成静态文件。
选项 | 描述 |
---|---|
-d, --deploy | 文件生成后立即部署网站 |
-w, --watch | 监视文件变动 |
该命令可以简写为
代码语言:javascript复制$ hexo g
publish
代码语言:javascript复制$ hexo publish [layout] <filename>
发表草稿。
server
代码语言:javascript复制$ hexo server
启动服务器。默认情况下,访问网址为: http://localhost:4000/
。
选项 | 描述 |
---|---|
-p, --port | 重设端口 |
-s, --static | 只使用静态文件 |
-l, --log | 启动日记记录,使用覆盖记录格式 |
deploy
代码语言:javascript复制$ hexo deploy
部署网站。
参数 | 描述 |
---|---|
-g, --generate | 部署之前预先生成静态文件 |
该命令可以简写为:
代码语言:javascript复制$ hexo d
render
代码语言:javascript复制$ hexo render <file1> [file2] ...
渲染文件。
参数 | 描述 |
---|---|
-o, --output | 设置输出路径 |
migrate
代码语言:javascript复制$ hexo migrate <type>
从其他博客系统 迁移内容。
clean
代码语言:javascript复制$ hexo clean
清除缓存文件 (db.json
) 和已生成的静态文件 (public
)。
在某些情况(尤其是更换主题后),如果发现您对站点的更改无论如何也不生效,您可能需要运行该命令。
list
代码语言:javascript复制$ hexo list <type>
列出网站资料。
version
代码语言:javascript复制$ hexo version
显示 Hexo 版本。
选项
安全模式
代码语言:javascript复制$ hexo --safe
在安全模式下,不会载入插件和脚本。当您在安装新插件遭遇问题时,可以尝试以安全模式重新执行。
调试模式
代码语言:javascript复制$ hexo --debug
在终端中显示调试信息并记录到 debug.log
。当您碰到问题时,可以尝试用调试模式重新执行一次,并 提交调试信息到 GitHub。
简洁模式
代码语言:javascript复制$ hexo --silent
隐藏终端信息。
自定义配置文件的路径
代码语言:javascript复制$ hexo --config custom.yml
自定义配置文件的路径,执行后将不再使用 _config.yml
。
显示草稿
代码语言:javascript复制$ hexo --draft
显示 source/_drafts
文件夹中的草稿文章。
自定义 CWD
代码语言:javascript复制$ hexo --cwd /path/to/cwd
自定义当前工作目录(Current working directory)的路径。
写作
你可以执行下列命令来创建一篇新文章。
代码语言:javascript复制$ hexo new [layout] <title>
您可以在命令中指定文章的布局(layout),默认为 post
,可以通过修改 _config.yml
中的 default_layout
参数来指定默认布局。
布局(Layout)
Hexo 有三种默认布局:post
、page
和 draft
,它们分别对应不同的路径,而您自定义的其他布局和 post
相同,都将储存到 source/_posts
文件夹。
布局 | 路径 |
---|---|
post | source/_posts |
page | source |
draft | source/_drafts |
如果你不想你的文章被处理,你可以将 Front-Matter 中的layout:
设为 false
。
文件名称
Hexo 默认以标题做为文件名称,但您可编辑 new_post_name
参数来改变默认的文件名称,举例来说,设为 :year-:month-:day-:title.md
可让您更方便的通过日期来管理文章。
变量 | 描述 |
---|---|
:title | 标题(小写,空格将会被替换为短杠) |
:year | 建立的年份,比如, 2015 |
:month | 建立的月份(有前导零),比如, 04 |
:i_month | 建立的月份(无前导零),比如, 4 |
:day | 建立的日期(有前导零),比如, 07 |
:i_day | 建立的日期(无前导零),比如, 7 |
草稿
刚刚提到了 Hexo 的一种特殊布局:draft
,这种布局在建立时会被保存到 source/_drafts
文件夹,您可通过 publish
命令将草稿移动到 source/_posts
文件夹,该命令的使用方式与 new
十分类似,您也可在命令中指定 layout
来指定布局。
$ hexo publish [layout] <title>
草稿默认不会显示在页面中,您可在执行时加上 --draft
参数,或是把 render_drafts
参数设为 true
来预览草稿。
模版(Scaffold)
在新建文章时,Hexo 会根据 scaffolds
文件夹内相对应的文件来建立文件,例如:
$ hexo new photo "My Gallery"
在执行这行指令时,Hexo 会尝试在 scaffolds
文件夹中寻找 photo.md
,并根据其内容建立文章,以下是您可以在模版中使用的变量:
变量 | 描述 |
---|---|
layout | 布局 |
title | 标题 |
date | 文件建立日期 |