这是我参与「第三届青训营 -后端场」笔记创作活动的第4篇笔记。
快速、简洁且高效的博客框架
安装
安装所需
- Node.js
- Git
安装完上述必备软件后，只需使用npm即可完成Hexo的安装。
$ npm install -g hexo-cli
Mac用户
在编译时可能会遇到问题，请先到 App Store 安装 Xcode，Xcode 完成后，启动并进入 Preferences -> Download -> Command Line Tools -> Install 安装命令行工具。
同时，在使用 npm 的
-g参数时可能会遇到一些权限相关的问题。请遵循 由 npmjs 发布的指导 修复该问题，并且不要使用 root、sudo 等方法覆盖权限。
建站
安装Hexo完成后，请执行下列命令，Hexo会在指定文件夹中新建所需要的文件。
$ hexo init <folder> // folder is the name of the blog
$ cd <folder> // open the folder
$ npm install
指定文件夹的目录如下：
.├── _config.yml
├── package.json
├── scaffolds
├── source
└── _posts
└── themes
_config.yml
网站配置信息，你可以在这配置网站的大部分参数。
source
资源文件夹。存放所有用户资源的地方，博客文章也放在这（位于_posts文件夹中）。
themes
主题文件夹。你可以在此处安装其他主题，Hexo会根据网站配置信息来确定你使用的主题。
配置
你可以在 _config.yml 中修改网站的配置。
网站
| 参数 | 描述 |
|---|---|
| title | 网站标题 |
| subtitle | 网站副标题 |
| description | 网站描述 |
| keywords | 网站的关键词。使用半角逗号 , 分隔多个关键词。 |
| author | 您的名字 |
| language | 网站使用的语言 |
| timezone | 网站时区。Hexo 默认使用您电脑的时区。 |
网址
| 参数 | 描述 |
|---|---|
| url | 网址 |
| root | 网站根目录 |
| permalink | 文章的永久链接格式 :year/:month/:day/:title/ |
常用指令
初始化
$ hexo init [folder]
新建一个网站。如果没有设置 folder ，Hexo 默认在目前的文件夹建立网站。
新建
$ hexo new [layout] <title>
新建一篇文章。如果没有设置 layout 的话，默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话，请使用引号括起来。
$ hexo new "post title with whitespace"
| 参数 | 描述 |
|---|---|
-p, --path | 自定义新文章的路径 |
-r, --replace | 如果存在同名文章，将其替换 |
生成
$ hexo generate
生成静态文件。
| 选项 | 描述 |
|---|---|
-d, --deploy | 文件生成后立即部署网站 |
该命令可以简写为
$ hexo g
启动服务器
$ hexo server
启动服务器。默认情况下，访问网址为： http://localhost:4000/。
| 选项 | 描述 |
|---|---|
-p, --port | 重设端口 |
部署
$ hexo deploy
部署网站。
| 参数 | 描述 |
|---|---|
-g, --generate | 部署之前预先生成静态文件 |
该命令可以简写为：
$ hexo d
清除
$ hexo clean
清除缓存文件 (db.json) 和已生成的静态文件 (public)。
在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令。
