我的博客搭建笔记


个人博客搭建 hexo

整体参考过程为 CodeSheep 视频:https://www.bilibili.com/video/BV1Yb411a7ty

安装

Node.js & npm

参考链接:https://developer.aliyun.com/article/760687

我选择了 apt 安装

sudo apt update
sudo apt install nodejs npm

版本信息

nodejs --version
v10.19.0
npm --version
6.14.4

版本还是有点老旧

淘宝镜像 cnpm

cnpm 的官方介绍是:cnpm是一个完整 npmjs.or 镜像,你可以用此代替官方版本(只读),同步频率目前为 10分钟 一次以保证尽量与官方服务同步。

安装了 cnpm 就可以使用镜像资源下载包,如果不希望使用镜像资源则换回 npm 命令即可。使用如下命令安装

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

hexo

sudo cnpm install -g hexo-cli

版本信息

hexo -v
hexo-cli: 4.3.0
os: linux 5.4.0-77-generic Ubuntu 20.04.2 LTS (Focal Fossa)

搭建博客

初始化

mkdir blog && cd blog
sudo hexo init

如果哪里出错了,想重来,直接删除 blog 文件夹即可

启动

sudo hexo server

遇到报错

INFO  Validating config
INFO  Start processing
FATAL { err:
   TypeError: line.matchAll is not a function

原因在于 nodejs 版本太低,尝试使用 n 升级 nodejs

sudo npm install -g n
sudo n latest

查看版本

node -v
v16.4.0

成功启动 hexo server,你可以通过 http://localhost:4000 访问你的本地博客啦!

写第一篇文章

sudo hexo new 'Fisrt Blog'

信息

INFO  Validating config
INFO  Created: /home/declan/Documents/blog/source/_posts/First-Blog.md

你的文章位置在上面的路径中可以找到,可以通过 markdown 语法进行书写

生成

清理一些缓存,然后生成我们的页面,同样使用 hexo server 从本地查看效果

hexo clean
hexo generate
hexo server

布属到远端

github

在 github 新建仓库 name.github.io name一定要是你的 github 用户名

在 blog 目录下,下载 git deployer

sudo cnpm install --save hexo-deployer-git

设置 _config.yml

在 blog 目录下打开 _config.yml 文件,在文件最后的 # Deployments 上修改

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: 'git'
  repo: https://github.com/DeclK/declk.github.io.git
  branch: master

Deploy

sudo hexo deploy

现在你的仓库里多了一些文件

以后你就可以通过你的仓库名 *.github.io 来访问你的博客啦!

更换主题

在寻找了许久过后决定使用 hexo-theme-matery

可移植性

如果把 hexo 整个博客项目移到另一台电脑上,依然可以正常运行,可能会遇到一些小困难,但是根据 hexo 的提示命令,很快就能解决


Author: Declan
Reprint policy: All articles in this blog are used except for special statements CC BY 4.0 reprint polocy. If reproduced, please indicate source Declan !
  TOC