个人博客搭建指南 | Hexo篇

准备

安装 nodejs，git

> sudo pacman -Syu nodejs git

配置 git

通用配置

> vim ~/.gitconfig
[user]
	name = <username>
	email = <email-address>
	password = <personal-access-token>
[credential]
	helper = cache --timeout <seconds>
[core]
	editor = /usr/bin/vim

安装 Hexo

创建 Blog 文件夹

来到你home的路径下（就是有Documents, Pictures, Downloads 的那个目录下）

> cd /home/<user>

创建 Blog 文件夹并进入

> mkdir Blog
> cd Blog/

安装

国外安装

通过 npm 安装 hexo，其中 -g 表示 global 意思是 全局安装；hexo-cli 就是 hexo 本体了。

> npm install -g hexo-cli

国内安装

> npm install -g cnpm --registry=https://registry.npm.taobao.org
> cnpm install -g hexo-cli

因为网速或其他的原因，使用 国外安装 的方法在国内可能会安装失败。
我们先用 npm 安装淘宝的镜像源 cnpm，再用 cnpm 来安装 hexo.

检查安装

> hexo -v

使用 Hexo

快速开始

初始化

> hexo init

hexo 在 Blog 文件夹里初始化运行框架所需的文件，请等待一小会儿。
初始化之后会生成一个 hello world 的样本博客可供参考。

启动

> hexo s

启动之后，终端提示网页已生成在 localhost:4000。
打开浏览器，在地址栏输入 localhost:4000 就能看到你的博客界面。

添加博客

新建博客

回到终端，键盘按下 ctrl+c 来停止博客运行。
新建文章。

> hexo n "MyFirstBlog"

n 表示 new 意思是 新建

编写博客

进入文章保存文件夹

> cd source/_post

进入到博客本体，在这里你会看到你刚刚创建的博客，文件名是你刚刚取的。
hello_world.md 是之前初始化的时候生成的，你在浏览页面的时候应该也看到了。

随便写点东西。支持markdown格式

> vim MyFirstBlog.md

生成博客

> hexo clean && hexo g && hexo s

• clean: 清理浏览器缓存的作用，并删除 public 下的文件
• g: generate, 在 public 下生成 html
• s: start, 启动

预览博客

打开浏览器，在地址栏输入 localhost:4000
你应该就能看到，刚刚编写的的博客了

添加 README.md

# 新建 README.md
> touch source/README.md
> echo "# blog supported by [Hexo](https://hexo.io/)" > source/README.md

# 找到 skip_render 参数，并添加 README.md
> vim _config.yml
skip_render: README.md

部署到远端服务器

部署到 github pages

安装插件

> npm install --save hexo-deployer-git

option 1: 部署到主文件夹 github.io

新建仓库

仓库名设置为

<username>.github.io

更改 _config.yml 文件

在 Blog 文件夹下

> vim _config.yml

找到 deployment 的设置，添加缺失的内容

deploy:
	type: git
	repo: https://github.com/<username>/<username>.github.io.git
	branch: main

部署

> hexo clean && hexo d

浏览

浏览器访问

<usrname>.github.io

option 2: 部署到子文件夹 github.io/blog

注意:

前提是，可以访问 <username>.github.io

新建仓库

仓库名设置为 blog, 或者其他名字

更改 _config.yml 文件

在 Blog 文件夹下，找到 deployment 的设置，添加缺失的内容

> vim _config.yml
deploy:
	type: git
	repo: https://github.com/<username>/<刚刚新建的仓库名称>.git
	branch: gh-pages

部署

> hexo clean && hexo d

浏览

浏览器访问

<usrname>.github.io/<刚刚新建的仓库名称>

注意:

由于 github 的延迟，等待 2-3 分钟之后，才能看到。

迁移

TODO

参考资料

手把手教你从0开始搭建自己的个人博客 |无坑版视频教程| hexo_哔哩哔哩 (゜-゜)つロ 干杯~-bilibili
font-family: Monaco, Consolas, “Andale Mono”, “DejaVu Sans Mono”, monospace;