Hexo 官方文档https://hexo.io/zh-cn/docs/ (有简体中文哟)

1.下载并安装 Node.js 以及 Git

如果官网下载太慢了,可以到马云爸爸那里去下载:https://developer.aliyun.com/mirror/

2.注册 GitHub 账号

https://github.com/

3.在 GitHub 新建仓库(Repo)

仓库名字如下:<你的用户名>.github.io

4.安装 Hexo

在任意位置打开命令行工具,例如 CMD 或者是 PowerShell,输入以下命令,等待安装完成。

1
npm i -g hexo hexo-server hexo-deploy-git

这三个包分别是 hexo 本体、hexo 开发服务器以及 hexo 的 git 部署工具。

5.初始化 hexo

在电脑上找一个你看的顺眼的位置,新建一个文件夹,例如“my-blog”,进入你准备放置博客的文件夹,输入:hexo init

它会下载需要的文件,等待下载完成。

6.写博客

文件夹source/_post/内以.md结尾的文件就是你的博文,采用Markdown 语法。(Markdown 是什么自行百度)

在命令行输入hexo new <name>可以以“name”为标题新建一篇博客,当然直接在source/_post/文件夹新建文件也可以新建博客。(但是不建议这样做,命令行会帮你自动规范文件格式,如果你自己新建的文件格式不正确容易出现阴间 bug)

7.博客设置

请阅读官方文档

8.预览你的网站

在命令行输入:hexo server

hexo 将会在本地为你配置一个预览服务器,当看到配置成功的提示后,打开浏览器访问 http://localhost:4000 可以预览你的博客。

9.发布到 GitHub

修改_config.yml文件最底下的内容:

1
2
3
4
deploy:
type: git
repo: git@github.com:<你的用户名>/<你的用户名>.github.io.git
branch: master

然后在命令行依次输入:

1
2
3
hexo clear # 清理缓存文件防止抑郁
hexo generate # 渲染博客文件
hexo deploy # 部署上线

如果这是你第一次部署,可能会提示输入你的 GitHub 用户名和邮件地址以及密码,填写后按下回车即可。

10.大功告成

访问 https://<你的用户名>.github.io

作者的话

想让自己的博客变得更好看,请看官方文档

这是一篇面向小白的建议教程,包教不包会,因为我也不懂编程,都是跟着文档来的,遇到问题请复制粘贴错误代码,然后扔进百度,如果不喜欢百度,也可以用必应或者搜狗

当你更深入研究 Node.js 以及 GitHub 后,也许可以尝试持续集成自动部署的博客,这样就不需在每次更新博客时都要手动输入指令了。

但这些都是后话了,这部分的教程随缘更新,因为我更喜欢在博客里分享我喜欢的东西,而不是撰写令人头秃的技术文章。