About

Hexo 是一个轻量的静态博客框架。通过Hexo可以快速生成一个静态博客框架,仅需要几条命令就可以完成,相当方便。
而架设Hexo的环境更简单了 不需要lnmp/lamp这些繁琐复杂的环境 仅仅需要一个简单的http服务器即可使用 或者使用互联网上免费的页面托管服务

比如Hexo的官方网站就是托管于github的pages服务上

Hexo配置方法

进去之后加入hexo主程序和安装npm

1
2
hexo init
npm install

目录结构

新建完成后,指定文件夹的目录如下:

1
2
3
4
5
6
7
8
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

_config.yml
网站的 配置 信息,您可以在此配置大部分的参数。

package.json
应用程序的信息。EJS, Stylus 和 Markdown renderer 已默认安装,您可以自由移除。

scaffolds
模版 文件夹。当您新建文章时,Hexo 会根据 scaffold 来建立文件。

source
资源文件夹是存放用户资源的地方。除 posts 文件夹之外,开头命名为 (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。

themes
主题 文件夹。Hexo 会根据主题来生成静态页面。

Hexo全局配置

用文本编辑器修改_config.yml这个文件 大致如下 只需要自行修改几个 其他保持默认即可

通常需要修改站点名称 /URL格式 /归档设置 /disqus评论用户名 /部署配置 这几项就可以了 注意冒号后面都要添加一个半角空格 之后才是设置参数

自定义域名设置 在 source 我文件夹下面新建 CNAME 文件 里面写入你的自定义域名 并设置您的dns配置cname方式到服务提供商的给的地址即可

目录

source_dir 资源文件夹,这个文件夹用来存放内容。 source

public_dir 公共文件夹,这个文件夹用于存放生成的站点文件。 public

tag_dir 标签文件夹 tags

archive_dir 归档文件夹 archives

category_dir 分类文件夹 categories

code_dir Include code 文件夹 downloads/code

i18n_dir 国际化(i18n)文件夹 :lang

skip_render 跳过指定文件的渲染,您可使用 glob 来配置路径。

文章

本地启动server

1
$ hexo server

可以观察命令行的输出,然后通过浏览器打开http://localhost:4000/,成功的情况下则会看到默认的欢迎页面。

部署到github pages

Hexo 提供了快速方便的一键部署功能,让您只需一条命令就能将网站部署到服务器上。

1
$ hexo deploy

在开始之前,您必须先在 _config.yml 中修改参数,一个正确的部署配置中至少要有 type 参数,例如:

1
2
3
4
5
deploy:
type: git
repo: <repository url>
branch: [branch]
message: [message]
1
2
3
4
参数 描述
repo 库(Repository)地址
branch 分支名称。如果您使用的是 GitHub 或 GitCafe 的话,程序会尝试自动检测。
message 自定义提交信息 (默认为 Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }})

我的博客对应的参数设置为

1
2
3
4
5
6
deploy:
type: git
repo: https://github.com/austinxishou/austinxishou.github.io.git
branch: master
name: austinxishou
email: austinxishou@yahoo.com

安装 hexo-deployer-git

1
$ npm install hexo-deployer-git --save

之后依次执行:

1
2
3
$ hexo clean
$ hexo generate
$ hexo deploy

上述命令只要Github的权限校验通过,基本都能成功;

hexo主题

收集主题

  1. Next
  2. Nidigo

写文章

使用草稿

在 source/_drafts 文件夹中 创建的文章为草稿,默认情况下不生成;
可以显示草稿

1
$ hexo --draft

生成sitemap站点地图

安装插件

1
2
npm install -g hexo-generator-sitemap --save
npm install -g hexo-generator-baidu-sitemap --save

修改_config.yml文件

1
2
3
4
5
# auto sitemap
sitemap:
path: sitemap.xml
baidusitemap:
path: baidusitemap.xml