/

Hexo博客框架踩坑记录

开始创建你的博客

先为你的博客创建一个文件夹，这里不建议使用你的git文件夹，因为最终导出文件和这里要用的源文件不一样。

前提条件

确保你的设备上有以下几个软件包

nodejs

npm

vim

如果没有，可以通过下面命令安装

1
apt install //软件包名

安装hexo

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

1
npm install -g hexo-cli

正式开始建站 /逃(

安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

1
2
hexo init //文件夹目录
cd //文件夹目录

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

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

配置hexo

下面开始配置hexo，这里只讲述初次使用者必需的部分，更多内容请访问hexo官方网站。

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

参数 描述
title 网站标题
subtitle 网站副标题
description 网站描述
author 您的名字
language 网站使用的语言
timezone 网站时区（默认根据您当前时区而定，无需设置)

其中，description主要用于SEO，告诉搜索引擎一个关于您站点的简单描述，通常建议在其中包含您网站的关键词。author参数用于主题显示文章的作者。

参数 描述 默认值
url 网址
root 网站根目录
permalink 文章的 永久链接 格式 :year/:month/:day/:title/
permalink_defaults 永久链接中各部分的默认值

网站存放在子目录

如果您的网站存放在子目录中，例如 http://yoursite.com/blog，则请将您的 url 设为 http://yoursite.com/blog 并把 root 设为 /blog/。

创建您的第一条博文

您的所有博文源文件都在/source/_posts/中，都通过ｍｄ语法编写

1
hexo new "这里写博文名"

通过上面命令可以创造一个新的博文，您可以使用ｍｄ语法编写博文

部署网站

通过下面命令部署您的博客到http://localhost:4000

1
hexo server

生成博客静态文件

如果您需要生成静态文件以上传到ｇｉｔｈｕｂ，您可以通过以下命令生成静态文件

1
hexo generate

生成的静态文件将会出现在publish文件夹内，您可以将ｐｕｂｌｉｓｈ文件夹内内容直接复制到ｇｉｔｈｕｂ。

FAQ

目前仅发现一个常见问题：

在 _config.yml 中

如果您的网站存放在子目录中，例如 http://yoursite.com/blog，则请将您的 url 设为 http://yoursite.com/blog 并把 root 设为 /blog/。

关于主题

我使用的主题为hexo-casper，在github star 排行榜中挺靠前，中文文档链接　https://zhih.me/hexo-casper-usage/

使用方法在文档中将会有呈现

完成

至此，您已完成博客构建，感谢观看。