适用平台：Microsoft Windows
关键词： GoodHexo，Hexo绿色版，Hexo便携版，Hexo配置，Hexo，U盘携带，GitHub Hexo

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

但是就像很多教程里面写的那样，搭建 Hexo 本地环境，需要安装 Node.js、Git 以及使用 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部署完整记录。

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

备注

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