/

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/中,都通过md语法编写

1
hexo new "这里写博文名"

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

部署网站

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

1
hexo server

生成博客静态文件

如果您需要生成静态文件以上传到github,您可以通过以下命令生成静态文件

1
hexo generate

生成的静态文件将会出现在publish文件夹内,您可以将publish文件夹内内容直接复制到github。

FAQ

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

_config.yml

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

关于主题

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

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

完成

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