参考教程
下载安装必要的工具
Nodejs 8.9.4 LTS
- 由于 Hexo 是基于 Nodejs 的,所以需要相应的环境。
- 下载地址:Nodejs
- 进入上述网站,找到合适的版本下载,由于我下的是 Windows 的 8.9.4 LTS 版,所以接下来的步骤都是按照这个版本进行的。
- 下载完成后获得一个
.msi
文件(Windows Installer 程序包),双击一路next
安装即可。
- 安装完成后,环境变量应该自动配置好了(我所安装的版本是这样的),如果是旧的版本,可能没有自动配置,就自己去设置一下
PATH
,添加 nodejs 安装路径即可。
Git Bash
- 在 Windows 下,需要这个特殊的命令行工具来操作 git。
- 下载地址:Git Bash
- 直接下载一个最新版本即可,获得安装包后也是一路
next
,安装路径需要更改的就改一下就好。不过在环境配置的那一步,我选了Use Git from Git Bash only
,就是只在 Git Bash 里面使用 Git,因为以前安装的时候用了默认的第二个选项,之后使用 Win7 命令行时候出现了许多不明所以的问题……
MarkDown 编译器
- 通过 hexo 建立的博客文件都是
.md
文件,所以我们需要一个 markdown 编辑器来方便博客的编写与预览。这里我选择的是马克飞象,因为我一直用它和印象笔记来做笔记的。 - 官方地址:马克飞象
- 进入网站后,点击 “账号” 按键,侧边栏出现后点击 “下载桌面客户端” 就可以了。这个安装配置也没什么好说的,也是一路
next
搞定。
安装 Hexo 并搭建博客
- 注意,首先需要打开 Git Bash,之后的操作都会基于它来进行。
安装 Hexo
- 进入之前安装 nodejs 的目录下,再输入命令
npm install -g hexo
安装 hexo。 - 注意,这个安装比较久,不知道是不是因为墙的原因导致下载速度慢,有次我安装要十多分钟才完成,所以这一步可能需要等待较长时间。
搭建一个最基本的博客
到你想保存博客相关文件的目录下,创建一个文件夹并进入。
接下来执行命令:
hexo init
:初始化 hexonpm install
:安装相应的依赖包hexo g
:生成静态页面(以后更新博客或修改配置后,都要使用这个命令更新)hexo s -p 9090
:启动 hexo-server 并设定端口为9090
(随便找个没用到的端口,它默认为4000
,但这个端口总被占用,导致启动成功后总是进不了localhost:4000
的页面)- 在启动 server 时注意一个问题,如果 hexo-server 对博客文件夹没有执行权限,就会导致启动失败并报错。我最初是在 Win7 虚拟机下操作,然后进入到从 Ubuntu 挂过来的网络路径中创建博客文件夹,然后启动 server 时报了一个
EPERM
相关的错误。
- 打开
http://localhost:9090/
即可查看生成的博客的本地预览,看到如下界面就是成功了。
将博客部署到 Git Pages
- 目前为止所得到的都是本地的博客,想要让别人能通过网络访问,就需要进行一些必要的配置了。直接在自己的机子上搭建环境,或者去租个云服务器之类的,也可以,不过这些操作相对来说会比较麻烦。
- 一个很简单有效的方式,就是利用 Git Pages (免费的)来直接部署博客。
- 首先要到 Github 官网注册一个账号,当然如果你有过了就省略这步。
- 新建一个仓库:
- 仓库名称设定必须是
你的Github账户名.github.io
- 记得勾选初始化一个
README
,不然可能之后的一些步骤会有报错。 - 注意:图中仓库名设置出现警告,是因为我已经创建过这个仓库了。
- 仓库名称设定必须是
-
- 仓库建好后,进入其设置界面,查看 Git Pages 相关设置是 OK 的就行。
-
- 打开之前创建的博客文件夹,其目录结构如下,其中的
.yml
文件就是基本配置文件。 - 打开
.yml
文件,修改几处:
- 注意,冒号之后必须带有一个空格。并且建议不要复制粘贴,所有输入纯手打,因为 hexo3 似乎对配置文件内容要求很严格。我原先是把地址复制粘贴进来,导致最终部署时候出现各种各样的问题。
type
:设定为git
repository
:设定为自己的 github 项目地址
branch
:使用master
即可url
:设定为git pages 地址
(如果没设定这个,配置主题后很可能会找不到 js 与 css 文件,导致页面只有文本。)
- 打开之前创建的博客文件夹,其目录结构如下,其中的
-
- 完成配置后,回到 Git Bash,执行下面几个命令:
npm install hexo-deployer-git --save
(这是 hexo3 必须要有的,否则部署时会一直报错)hexo g
- (
hexo s
,可以先本地预览看看效果) hexo d
(部署到 git pages 上)
- 完成后,登陆你的 git pages 地址就能看到最终效果了。
- 完成配置后,回到 Git Bash,执行下面几个命令:
发布新文章
- 原本是用命令
hexo new "New Filename"
来在博客目录下的source/_post
文件夹下生成一个md
文件,然后通过完善该文件来写文章的。 - 但使用马克飞象时,似乎无法直接打开生成的
md
文件,所以就要先在马克飞象中写好文章,然后将文章导出为 Markdown 文件到对应目录即可。 - 注意,导出的 Markdown 格式上可能与
new
出来的那些有些不同,所以需要照着原来的HelloWorld
文件修改一下格式(主要是title
),不然发布后可能会出现文章题目不对之类的问题。 - 完成文章后,回到博客目录下,执行
hexo g -d
即可。
删除文章
- 与发布类似,通过将
source/_post
下的文章对应的md
文件删除,然后执行hexo g -d
即可。
设置博客主题
- 不知道你会不会觉得默认的主题不好看,反正我是觉得比较难看……
- 所以我们可以到 hexo主题 上面去找个心仪的主题来给自己的博客进行美化。
- 我选择的是 Next 主题,我比较喜欢它的简约风格:
- 首先进入主题的 git 页面,记下其项目地址:
https://github.com/iissnan/hexo-theme-next
- 到博客目录下,执行:
git clone https://github.com/iissnan/hexo-theme-next themes/next
- 找个小图当头像,保存到 source/_uploads (新建这个文件夹)下,我这里命名为
first.png
- 修改博客
yml
文件:
theme: next
(设置主题为next
,这个名对应着themes/next
)language: zh-Hans
(设置语言为中文简体)title
(博客名)、author
(你的昵称)、description
(一些描述,如同 QQ 签名一般的存在),这些就按照个人喜好改掉就好。- 在文件最末尾新加一个字段:
avatar: /_uploads/first.png
- 到
themes/next
中修改yml
文件:scheme: Pisces
(这步只是切换风格,不改就是默认的风格) - 重新生成博客:
hexo g
- 本地预览博客:
hexo s -p 9090
- 最终部署博客:
hexo d
- 首先进入主题的 git 页面,记下其项目地址:
- 大功告成。