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

前言

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

什么是 Hexo

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

安装 Hexo

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

Node.js
Git

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

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

代码语言：javascript复制

npm install hexo-cli -g

1. 建立网站

代码语言：javascript复制

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

2. 启动服务器

hexo s 或 hexo server

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

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

代码语言：javascript复制

.
├── _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

新建文章

代码语言：javascript复制

$ hexo new [layout] <title>

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

生成静态文件

generate 该命令可以简写为

代码语言：javascript复制

$ hexo g
或 $ hexo generate

-d, --deploy 文件生成后立即部署网站
-w, --watch 监视文件变动

部署 deploy 命令

deploy 该命令可以简写为

代码语言：javascript复制

$ hexo d
或 $ hexo deploy

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

clean 命令

清除缓存文件 (db.json) 和已生成的静态文件 (public)。
在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令。

list 命令

列出网站资料

代码语言：javascript复制

$ hexo list
Usage: hexo list <type>

Description:
List the information of the site.

Arguments:
  type  Available types: page, post, route, tag, category

写作

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

代码语言：javascript复制

$ hexo new [layout] <title>

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

默认布局为post

代码语言：javascript复制

default_layout: post

布局（Layout）

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

文件名称

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

front-matter

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

代码语言：javascript复制

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

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

参数	描述	默认值
layout	布局	-
title	标题	-
date	建立日期	文件建立日期
updated	更新日期	文件更新日期
comments	开启文章的评论功能	true
tags	标签（不适用于分页）	-
categories	分类（不适用于分页）	-
permalink	覆盖文章网址	-

hexo 插件

git 自动部署插件

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

代码语言：javascript复制

$ npm install hexo-deployer-git --save

总结

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

hexo http 腾讯云开发者社区 node.js

0 人点赞