首次创建博客,网上也查了不少资料,Hexo框架应该是目前个人博客用得最多的了,还有很多主题、插件的支持。只是网上的资料大多已经老旧,一些配置因为版本更替的原因也发生了变化,所以接着自己搭建博客的机会,重新整理了一个系列,把个人博客的搭建过程分享给大家。
这一期文章包括以下内容:
- 使用Hexo框架创建个人博客
- 应用Matery主题
- 开始你的第一篇博客
- 提交代码到github仓库
- 发布到Cloudflare Pages
使用Hexo框架创建个人博客
安装nvm管理nodejs
因为Hexo框架是基于nodejs的,所以你需要先安装nodejs,如果使用的是linux系统,建议使用 nvm 进行nodejs的版本管理,当然你也可以选择跳过这一步自行安装nodejs版本。
# 一键安装脚本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/$(curl -s https://api.github.com/repos/nvm-sh/nvm/releases/latest | grep '"tag_name":' | sed 's/.*"tag_name": *"\([^"]*\)".*/\1/')/install.sh | bash
source ~/.bashrc
# 显示安装版本
nvm --version
安装好以后你就可以通过nvm来管理你的nodejs版本,推荐使用18以上版本来构建。
# 显示当前版本
nvm current
# 安装20.x的版本
nvm install 20
# 如果已安装,可以直接切换版本
nvm use 20
国内对github的访问向来是时断时续的,如果安装失败可以等一等,或者使用科学上网工具,这里推荐可以 注册 一个,目前有免费流量可以薅羊毛。
手动安装nodejs
你可以选择从 官网下载,如果是linux系统也可以用自带的包管理器安装。
# for debian / ubuntu
apt-get install nodejs
# for redhat / centos / fedora
yum install nodejs
# 显示安装版本
node -v
安装hexo创建博客
# 安装命令行工具
npm install hexo-cli -g
# 显示安装版本
hexo v
# 创建博客
hexo init blog
cd blog
# 启动本地服务
hexo s
这一步做完你已经可以访问 http://localhost:4000 访问你的本地博客了,里面包含了一个hello world页面。
生成与发布
Hexo是使用Markdown文件来写博客的,在发布前需要将md转换成静态html文件。
hexo cl && hexo g
这会在你博客项目的根目录下创建一个 public
目录,里面就是生成的博客网站的静态资源,你可以将它们上传到你自己的服务器上,或者按后面的教程直接发布到Cloudflare Pages上。至于发布到Github Pages,因为国内的限制这里就不推荐了,大家要是有兴趣的话可以自行搜索,有很多文章介绍的。
应用Matery主题
hexo-theme-matery 是一个成熟度比较高的主题,而且对中文的支持也很好,能同时适配PC和手机浏览,配置说明也比较详细。
安装主题
# 进入主题目录
cd themes
# 安装hexo-theme-matery主题
git clone https://github.com/blinkfox/hexo-theme-matery.git
cd hexo-theme-matery
# 删除git文件
rm -rf .git
使用主题
安装完博客项目有两个 _config.yml
文件,一个在博客项目根路径下是全局的配置文件,一个在主题目录下是主题相关的配置。首先需要将全局配置里的 theme
值改为 hexo-theme-matery
。
theme: hexo-theme