适用平台:Microsoft Windows
关键词: GoodHexoHexo绿色版Hexo便携版Hexo配置HexoU盘携带GitHub Hexo

Hexo是一个快速、简洁且高效的博客框架,支持 Markdown 的绝大部分功能;具有超快生成速度,让数百个 MarkDown 源文件在几秒内快速渲染成全站 HTML 页面;还拥有各式各样的插件支持功能扩展。

但是就像很多教程里面写的那样,搭建 Hexo 本地环境,需要安装 Node.jsGit 以及使用 npm 进行安装和配置。这对于毫无经验的新手来说,是一个很大的挑战。同时,由于这些环境的存在,导致如果需要更换计算机的时候,重新安装配置一个新的Hexo环境,又得花费一些功夫。

所以呢,我们整合了一个 Hexo 便携版,来简化本地环境的部署,这就是我们的GoodHexo。

当你重装系统后,只要GoodHexo目录还在,直接接着用即可;
当你想换个电脑,只需要将GoodHexo目录移到新电脑上即可。甚至,你可以将这个文件夹装到U盘里,走哪插哪就行。

软件介绍

那么所谓的便携版到底是什么?便携版就是将 Hexo 本地环境所需要的各种依赖环境的整合到一起,做成不需要安装的版本。
当然,目前只有Windows版。

本便携版当前版本所包含的软件如下:

  • Git: 2.7.4
  • Nodejs: 12.16.2
  • Npm: 6.14.4
  • Hexo: 4.2.0

为了便携的需要,不能配置固定的环境变量,所以除此之外还有相应的批处理脚本,下文将详细介绍。

GoodHexo下载地址

每列提取码与链接对应,如为空表示直接点进去链接不需要提取码,无链接则表示对应软件只需要提取码即可

项目 地址一 地址二 地址三
链接 百度网盘 备用网盘1 备用网盘2
提取码 good 8vsm

压缩包40多M,推荐从备用网盘下载
如果百度网盘慢,可以用这个第三方不限速的百度网盘下载器

从零开始,一分钟使用 GoodHexo 写作环境

说了这么多,我们这就开始教你如何在1分钟内,从零开始使用 GoodHexo 写作环境!

目录结构

该订制的GoodHexo包基本上已经包含了Hexo博客所需的所有依赖,添加新主题新功能缺依赖的照提示去安装更新即可。
上面的压缩包下载解压后,其目录结构如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
GOODHEXO
| 1.新建文章.bat #要新建文章运行此批处理,填文件名建议别用中文
| 2.本地测试.bat #写完文章可以启动本地服务端测试预览效果
| 3.渲染并部署.bat #确定文章写完了,那么就运行此批处理发布
| README.md #本便携包说明文档
| 启动命令行.bat #给有经验的人用,直达bash界面
| 清理旧文件后部署.bat #部署也没报错,但博客就是没更新或者其他异常,那么用这个来部署试试
|
+---hexo #hexo程序工作目录
| | .gitignore #指定Git提交时忽略的文件规则,一般也不要动
| | db.json #不要动
| | package.json #不要动
| | _config.yml #hexo的主配置文件,定义标题,作者,导航菜单等
| |
| +---node_modules #hexo的依赖环境,不要动
| +---scaffolds #文章模板
| +---source #网站根目录
| | \---_posts #你所有的文章都存在这个目录底下,通过批处理新建文章会自动建到这个目录下
| | | hello-world.md #示例文章源文件,该MarkDown文件会被hexo渲染成HTML页发布
| |
| +---themes #主题存放目录
| | \---landscape #默认主题
| |
|
\---support #便携程序包,包含nodejs和Git,不要动

开始使用

详细个性化设置

拿到这个包,一些基础配置和基本的主题设置等院长都已经给你做好了,只需要自行对博客网站进行个性化详细设置即可。

个性化设置主要有两个地方:

  1. Hexo目录下的_config.yml ,详见相应的参数注释,按要求填写,不想写就默认
  2. 主题目录下的_config.yml ,主题不同设置项不同,所以请参考主题对应的文档进行修改设置

依次打开就能看个大概了,根据自己的需要及主题帮助完成自己要的个性化设置。更深入的个性化基本上需要在主题上做文章,请自行查看主题帮助,或者研究主题源代码即可完成。
修改的时候请注意格式,否则会导致错误而无法正常使用,比如 : 要是英文的且后面有内容的话至少要跟一个空格,配置内容跟后面的 # 注释之间至少要有一个空格,具体错误可以启动命令行输入 hexo s --debug 查看。

写一篇自己的文章

设置好后,就可以动手写自己的文章了。

step1.新建文章

运行1.新建文章.bat,按提示填写文章名称,建议不要使用中文。

回车确认后会在hexo目录下的对应目录新建个.md文件,文件名以刚才输入的文章名称命名,注意提示的文件路径和新创建的文件名,如hexo\source\_posts\2017-09-start-with-good-hexo.md

step2. 编辑文章MarkDown文件

使用任意文本编辑器打开你刚新建的文章MarkDown源文件,写你想写的内容即可,推荐编辑器首选用Atom或者vscode,关于编辑器以下文章可以阅读下:

  1. vscode-跨平台,绿色免费,基本接近完美的编辑器
  2. MarkDown编辑器推荐这篇文章
  3. 基于Moeditor修改集成Hexo功能的编辑器

如果不依赖MarkDown编辑器,那么你需要掌握基本的MarkDown语法,然后就可以用任意文本编辑器【当然,Windows系统自带的记事本还是不推荐用】,按MarkDown语法写文档了。MarkDown语法可以参考这个教程

需要额外注意的是:Hexo对MarkDown文档头有规范,就是在文档开始两个 --- 中间的那部分,官方称之为 Front-matter

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
---
title: 'Hexo,从此开始...' #文章标题,新建文章的时候填的会自动写到这里
date: 2018-1-12 17:19:27 #文章创建时间
categories: #分类,可以直接跟在这后面,也可以如下一行这样换行后写分类
- 搞软件 #这是个分类名称
tags: #标签
- 晒酷软 #这是个标签
toc: true #是否显示目录,false不显示,true显示,需要主题支持
top: #填数字,值越大的文章在首页就越置顶,本包已集成
comments: true #是否允许评论,需要主题支持
keywords: '' #文章关键词,需要主题支持
description: '文章摘要,可以是一大段,
可以换行,用英文引号括起来' #不填则根据主题设计截取对应字数
---
上面部分是规定的头部信息,这行开始就是文章内容了...

以上参数除了title:都不是必须的,请根据自己的需求填写,注意每一个参数的:或者-后,都需要至少留一个空格,如果不填值就无所谓,或者将参数行删除都行,就是不能不留空格直接写,否则会报错。
如果参数值中间涉及特殊字符或者空格等,请使用英文的单引号 '' 将你的内容括起来,就如上面的示例一样。

更多 Front-matter 参数详见官方文档:https://hexo.io/zh-cn/docs/front-matter.html

文章参数设置完后,就可以在 --- 下一行写自己想写的任何内容了,以下都属于你文章的内容。

step3.渲染并发布

文章写好保存,那就运行3.渲染并部署.bat,该批处理会将你的MarkDown源文件套用主题模板渲染成HTML静态页,并把静态页部署到网站空间,最后提示 deploy done:git 就表示已部署完成,要不了半分钟,访问你的网站地址就能看到效果了。

以上步骤请仔细阅读,再写新文章,重复以上步骤即可。

使用过程中可能会遇到一些问题,请参考我整理的:GoodHexo使用常见问题及解决办法

进阶教程

如果你喜欢折腾,Hexo进阶部署使用可以参考Hexo博客Git-VPS部署完整记录

使用过程中如需帮助,欢迎评论交流。

备注

  • 本文所有权归 搜百谷 所有;
  • 本便携版由 凹凸曼 维护并提供技术支持;