hexo + linux + gitee 搭建

环境准备

基于 Ubuntu20.04

nodejs 的安装

由于 hexo 基于 nodejs,因此需要先安装 nodejs 框架,选取最新的的 nodejs 版本,可从官网 http://nodejs.cn/download/ 上直接获取 linux 二进制文件,下载后进行解压,之后建立软链接,使其成为全局设置,即

1
ln -s 下载到的地址/bin/npm /usr/local/bin/npm

之后使用

1
npm -v

打印版本即可验证是否成功

cnpm 的安装

由于 npm 的速度很慢,因此可以使用 cnpm 来进行替换(来自官网:“这是一个完整 npmjs.org 镜像,你可以用此代替官方版本(只读),同步频率目前为 10分钟 一次以保证尽量与官方服务同步。”)

先配置淘宝镜像(有的帖子说不需要,但是我这里没有这一步是不行的)

1
npm config set registry https://registry.npm.taobao.org

这一点可以用

1
npm config get registry

打印查看是否配置成功

此时再使用

1
npm install -g cnpm --registry=https://registry.npm.taobao.org

安装 cnpm 即可,按理说应该是全局安装了的,但是还是需要建立软链接后全局设置才能生效(???)

1
ln -s 下载到的地址/bin/cnpm /usr/local/bin/cnpm

此处“下载到的地址”为执行安装 cnpm 命令后显示的地址,一般就是上面的 npm 处下载的地址

可以用

1
cnpm -v

打印查看是否配置成功

git 的安装

由于之后将其推到远端服务器上需要 git 因此先提前进行安装

1
apt-get install git

安装完成可以顺便完成身份设置(git config)

1
2
$ git config --global user.name "YourName"
$ git config --global user.email xxxxx@example.com

hexo 安装

环境配置好后,hexo 安装就变得较为容易,直接执行

1
npm install hexo-cli -g

即可进行安装,相信有了之前的两次经历,使用软链接将其进行全局设置也并不是什么难事

安装完成后同样可打印版本信息查看是否安装成功

博客的创建

在完成以上安装后,就可以创建博客了,在想要建立博客的目录下执行

1
hexo init 想叫啥叫啥

创建完成后便能在目录下找到 “想叫啥叫啥” ,作为你的博客文件夹,里面有一些博客的基础性文件:
.
├── node_modules # 项目所有的依赖包和插件
├── scaffolds # 文章模板
├── source # 博文和其他源文件
| └── _posts # 博文
├── themes # 主题
├── _config.yml # 全局配置文件
└── package.json # 项目依赖信息

之后若想要新建博文,可以直接在对应文件夹下新建 .md 文件或执行

1
hexo new "文章名称"

更改内容则直接修改 .md 文件即可

之后执行

1
2
3
hexo clean
hexo g
hexo s

(后两行 g 和 s 的意思为 generate 和 server)
即可在本地建立好博客,访问 localhost:4000 就能看到默认的博客了

部署至 gitee

现在博客已经能在本地访问了,要想让别人看到你的博客,就需要将其部署至 gitee 或 github,此处以速度较快的 gitee 为例,先创建一个 gitee 仓库,注意仓库名称(路径)必须是你的用户名,否则最后会 404.

在博客文件夹下执行命令

1
npm install --save hexo-deployer-git

便可安装部署服务,若出现报错 optional install error: Package require os(darwin) not compatible with your platform(linux),
执行

1
cnpm rebuild node-sass

重新安装 sass loader 后再执行命令。

完成后在项目配置文件 _config.yml 内完成

1
2
3
4
5
6
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: 仓库地址
branch: master

的补充即可(仓库地址为 gitee 库内点击 克隆/下载 后 https 项文本框内的地址)

之后执行

1
hexo d

即可在输入用户名和密码后将其部署,部署后在仓库内点击 服务、Gitee Pages,再点击最下面的按钮即可,之后便能访问网站地址了。