从头教你搭建 Hexo 博客
文章目录
本文讲解基础的 hexo、Node.js、git 知识,然后搭建在线编辑器。这不是一个一键安装指南,需要你自己理解每一步到底在干什么。
如果你:
- 希望拥有一个自己的博客
- 受够了了网上博客服务的各种广告
- 受够了 word 和印象笔记的谜之所见即所得
- 希望学习前后端相关 web 开发技术
- 喜欢折腾自己的服务器
- 最重要的,在寻找一款针对 Hexo 开发的在线编辑器
满足了任意一条,那这篇文章就可能对你有用。
什么是 Hexo
Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
简单的来说,Hexo 让你用纯文本写文章然后生成漂亮的博客网站。
使用 Hexo 写博客的流程如下:
- 通过一种纯文本的标记语言(markdown)来表示文章结构,例如章节、列表、图片、重点等,同时不关注文章的具体样式,例如颜色,字形,字号,排列对齐方式等。
- 然后通过 Hexo 将纯文本标记转换为 html 网页,即博客
- 然后将网页上传至服务器,使用服务器提供网页,就像哔哩哔哩提供给我们玩耍的 B 站一样
- 在浏览器访问博客,就像我们在 B 站看视频
1 | 文本 > Hexo > html > 服务器 > 博客页面 |
Hexo 负责将我们写下的文字转换为网页,然后发布到对应的服务器。如果没有 Hexo,我们要自己排版写网页,自己上传文件。
安装 Hexo
在继续之前,请先用你的浏览器打开Hexo 文档/#安装前提。这篇官方指南中提到了 Hexo 需要 Node.js 和 Git
什么是 Node.js:一个运行javascript(JS)
的环境。Hexo 是一个javascript(JS)
语言的程序。一般 JS 运行在浏览器中,但是也有一种非浏览器环境也可以运行 JS。这个环境是Node.js
什么是 Git:一个版本控制软件。Hexo 博客源码由纯文本构成,管理纯文本项目的最好办法之一就是使用Git。还记得 word 里面的历史记录和版本回退功能么?简单的来说,Git 就提供了类似功能,只不过更强大。
安装 Git
对于中国大陆地区用户,可以前往 淘宝 Git for Windows 镜像 下载 git 安装包。
打开后你会看到如下内容,每一行包括了文件信息和发布时间。需要选择时间最新的,文件名中没有 rc 的版本,因为 RC 是预发布版本,你可以理解为游戏内测版。这里选择v2.25.1.windows.1/
。然后在下一级文件夹中选择 Git 下载。一般只需要下载Git-xxx-64-bit.exe
即可。你看到的文件名可能和我的不同,但是要明白下载的是用于64-bit windows
版本的Git
(而不是MinGit
或者PortableGit
,除非你知道自己为什么那么做)
1 | // https://npm.taobao.org/mirrors/git-for-windows/ |
如果你用的是 mac 或者 linux,那你很可能已经拥有 git 了。在终端运行
git --version
查看。
下载后根据安装指引安装,默认即可。
注意!这不意味着你可以无脑下一步,安装指引的英文很简单,如果你能有兴趣自己部署 Hexo,那你一定已经有了足够的英文水平看安装指引!
1 | C:\Users\winwin\Desktop> git --version |
如果你在控制台(命令提示符或者 PowerShell)中输入git --version
后成功看到了 Git 的版本号,则证明你安装成功
安装 Node.js
对于中国大陆地区用户,可以前往 淘宝 Node.js 镜像 下载。
类似于 Git 的下载,我们选择latest-v12.x/
下载,这是一个长期支持版本,使用这个版本可以获得更好的稳定性。请不要尝试其他版本,除非你知道换版本可能导致的问题。这里同样选择使用于 64 位 windows 的安装包node-v12.9.1-x64.msi
同样根据指引安装。不要无脑下一步!
1 | C:\Users\winwin\Desktop> node -v |
同样尝试打印版本号。注意除了node
我们还检查了npm
的版本号。npm 的全称是node package manager
node 包管理器,你可以理解为针对 Node 的 360 软件管家。
安装 Hexo
1 | npm install -g hexo-cli |
上面的命令是告诉 npm 我们需要安装一个包叫做hexo-cli
,-g
意味着我们要将包安装在全局,这样我们无论在什么地方都可以运行 Hexo。
1 | C:\Users\winwin\Desktop> hexo -v |
同样打印版本号验证安装是否成功
如果你发现这一步安装很慢,可以移步这里配置 npm 的加速镜像。
安装 hexo-server
就为了在你的电脑上打开博客看一眼。这是一个在本地预览博客的程序。
1 | myblog > npm install hexo hexo-server |
建站/初始化博客
请打开Hexo 的官方教程,往往官方教程都是很好的,觉得难只是因为初次接触而已。
1 | $ hexo init myblog |
在这你可能发现网速很慢,可以运行下面的代码提升速度。关于为什么可以提升速度,移步这里
1 | myblog > npm config set registry http://registry.npm.taobao.org |
在初始化 hexo 之后还需要初始化 git
1 | C:\Users\winwin\Desktop\myblog> git init |
你的控制台输出可能和我的不太一样,但是应该都有初始化成功的消息。
如果你不需要部署,只在本地写作的话,到目前为止配置环节就结束了
用 git 备份你的文章
在 Github 上新建一个项目作为你的博客源文件的存储路径。然后使用这个项目存储
配置 hexo deploy
本文将博客部署到你自己的服务器上
服务端 SSH 和 Git 配置
参考使用 git hook 部署 hexo 静态博客一文中关于创建 git 服务和初始化 git 仓库的部分
- 注意文件权限的坑
服务端 GitHook 配置
参考使用 Git Hook 自动部署 Hexo 到个人 VPS一文中的第五步
- 注意更改 git 仓库路径和部署路径
安装 hexon
这是我自己写的编辑器,用来在线编辑和部署 hexo 博客