- 搭建在Github Pages的小破站 学习Hexo
- 记录些Hexo建站过程中遇到的问题,学习如何解决方法,优化思路
- 本站有使用 CloudFlare Pages 托管,保证在任何地方都可以访问
Hexo 是一个快速、简洁且高效的博客框架。 Hexo 使用 Markdown(或其他标记语言)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
设置 Hexo 只需几分钟。 如果您遇到问题,并且在这里找不到解决方案,请提交 GitHub 问题,我们将提供帮助。
安装 Hexo 相当简单,只需要先安装下列应用程序即可:
Node.js (Node.js 版本需不低于 10.13,建议使用 Node.js 12.0 及以上版本) Git 如果您的电脑中已经安装上述必备程序,那么恭喜您! 你可以直接前往 安装 Hexo 步骤。
如果您的电脑中尚未安装所需要的程序,请根据以下安装指示完成安装。
Windows:下载并安装 git。 Mac:使用 Homebrew, MacPorts 或者下载 安装程序。 Linux (Ubuntu, Debian):sudo apt-get install git-core Linux (Fedora, Red Hat, CentOS):sudo yum install git-core
Mac 用户 如果在编译时可能会遇到问题。 请先到 App Store 安装 Xcode。 Xcode 完成后,启动并进入 Preferences -> Download -> Command Line Tools -> Install 安装命令行工具。
Node.js 为大多数平台提供了官方的 安装程序。
其它的安装方法:
Windows:通过 nvs(推荐)或者 nvm 安装。 Mac:使用 Homebrew 或 MacPorts 安装。 Linux(DEB/RPM-based):从 NodeSource 安装。 其它:使用相应的软件包管理器进行安装。 可以参考由 Node.js 提供的 指导。 对于 Mac 和 Linux 同样建议使用 nvs 或者 nvm,以避免可能会出现的权限问题。
Windows 使用 Node.js 官方安装程序时,请确保勾选 Add to PATH 选项(默认已勾选)
Mac / Linux 如果在尝试安装 Hexo 的过程中出现 EACCES 权限错误,请遵循 由 npmjs 发布的指导 修复该问题。
Linux 如果您使用 Snap 来安装 Node.js,在 初始化 博客时您可能需要手动在目标文件夹中执行 npm install。
所有必备的应用程序安装完成后,即可使用 npm 安装 Hexo。
$ npm install -g hexo-cli对于熟悉 npm 的进阶用户,可以仅局部安装 hexo 包。
$ npm install hexo安装以后,可以使用以下两种方式执行 Hexo:
npx hexo <command>Linux 用户可以将 Hexo 所在的目录下的 node_modules 添加到环境变量之中即可直接使用 hexo :
echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile安装 Hexo 只需几分钟时间,若您在安装过程中遇到问题或无法找到解决方式,请 提交问题,我们会尽力解决您的问题。
如果你坚持使用旧的 Node.js,你可以考虑安装 Hexo 的过去版本。
请注意,我们不提供对过去版本 Hexo 的错误修复。
我们强烈建议永远安装 最新版本 的 Hexo,以及 推荐的 Node.js 版本。
| Hexo 版本 | 最低版本 (Node.js 版本) | 最高版本 (Node.js 版本) |
|---|---|---|
| 8.0+ | 20.19.0 | latest |
| 7.0+ | 14.0.0 | latest |
| 6.2+ | 12.13.0 | latest |
| 6.0+ | 12.13.0 | 18.5.0 |
| 5.0+ | 10.13.0 | 12.0.0 |
| 4.1 - 4.2 | 8.10 | 10.0.0 |
| 4.0 | 8.6 | 8.10.0 |
| 3.3 - 3.9 | 6.9 | 8.0.0 |
| 3.2 - 3.3 | 0.12 | 未知 |
| 3.0 - 3.1 | 0.10 或 iojs | 未知 |
| 0.0.1 - 2.8 | 0.10 | 未知 |
- 清除缓存文件 (db.json) 和已生成的静态文件 (public)。
$ hexo clean
- 生成静态文件。
$ hexo generate
- 启动服务器。 默认情况下,访问网址为: http://localhost:4000/。
$ hexo server