Markdown 拓展-Hexo 搭建博客(上)

前言

一直想搭建个人网站, 当我了解到 hexo 是一款快速、简洁且高效的博客框架，我就迫不及待想尝试下。

什么是 Hexo

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

安装 Hexo

在安装前，您必须检查电脑中是否已安装下列应用程序：

• Node.js

• Git

Node.js 版本限制

我们强烈建议永远安装最新版本的 Hexo，以及 推荐的 Node.js 版本。

如果您的电脑中已经安装上述必备程序，那么恭喜您！接下来只需要使用 npm 即可完成 Hexo 的安装。

npm install hexo-cli -g

1. 建立网站

# 新建一个网站。如果没有设置 folder ，Hexo 默认在目前的文件夹建立网站。
$ hexo init <folder> 
$ cd <folder>
$ npm install

2. 启动服务器

hexo s 或 hexo server

启动服务器。默认情况下，访问网址为： http://localhost:4000/

新建完成后，指定文件夹的目录如下：

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

配置

您可以在 _config.yml 中修改大部分的配置。

独立的 _config.[theme].yml 文件

该特性自 Hexo 5.0.0 起提供

我们强烈建议你将所有的主题配置集中在一处。如果你不得不在多处配置你的主题，那么这些信息对你将会非常有用：Hexo 在合并主题配置时，Hexo 配置文件中的 theme_config 的优先级最高，其次是 _config.[theme].yml 文件，最后是位于主题目录下的 _config.yml 文件。

顺序: theme_config > _config.[theme].yml > 主题目录下的_config.yml

新建文章

$ hexo new [layout] <title>

新建一篇文章。如果没有设置 layout 的话，默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话，请使用引号括起来。

示例hexo new "My New Post"

生成静态文件

generate 该命令可以简写为

$ hexo g
或 $ hexo generate

• -d, --deploy  文件生成后立即部署网站

• -w, --watch   监视文件变动

部署 deploy 命令

deploy 该命令可以简写为

$ hexo d
或 $ hexo deploy

• -g, --generate    部署之前预先生成静态文件

clean 命令

• 清除缓存文件 (db.json) 和已生成的静态文件 (public)。

• 在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令。

list 命令

列出网站资料

$ hexo list
Usage: hexo list <type>
Description:
List the information of the site.
Arguments:
  type  Available types: page, post, route, tag, category

写作

你可以执行下列命令来创建一篇新文章。

$ hexo new [layout] <title>

您可以在命令中指定文章的布局（layout），默认为 post，可以通过修改 _config.yml 中的 default_layout 参数来指定默认布局。

默认布局为post

default_layout: post

布局（Layout）

Hexo 有三种默认布局：post、page 和 draft，它们分别对应不同的路径，而您自定义的其他布局和 post 相同，都将储存到 source/_posts 文件夹。

文件名称

Hexo 默认以标题做为文件名称，但您可编辑 new_post_name 参数来改变默认的文件名称，举例来说，设为 :year-:month-:day-:title.md 可让您更方便的通过日期来管理文章。

front-matter

Front-matter 是文件最上方以 --- 分隔的区域，用于指定个别文件的变量，举例来说：

title: Hello World
date: 2013/7/13 20:46:25
---

以下是预先定义的参数，您可在模板中使用这些参数值并加以利用。

hexo 插件

git 自动部署插件

需要安装 hexo-deployer-git。详细使用请点击链接进行查看。

$ npm install hexo-deployer-git --save

总结

完整的教程可以参照 Hexo官网 进行实践。