搭建hexo的Mac OS环境

前言

大多数关于使用Hexo构建个人博客的指南都偏向于Windows环境,但在Mac OS下的教程却相对稀缺。令人惊喜的是,事实上在Mac OS环境下完成这一任务要比在Windows下更加轻松愉快。让我们一起探索如何在优雅的Mac OS平台上打造个人博客的奇妙之旅吧!

环境准备

Homebrew:

Git 和 Node.js:

安装

1
brew install git
1
brew install node

测试

1
2
3
4
npm -v
node -v
git --version

下面内容表示已经成功安装

截屏2024-01-12 22.08.57

Hexo

1
npm install -g hexo-cli

等待安装完成后初始化博客:

1
hexo init blog

这个命令的作用是在当前目录(通常是你的主目录)下创建一个名为blog的文件夹。你可以随心更改blog为你喜欢的任何名字。在这个文件夹内,我们将初始化你的博客。在进行下一步之前,请确保你已经进入了这个文件夹,你可以使用命令:cd blog。

当初始化完成后,切换到blog文件夹,这样你就可以开始生成和预览你的博客啦!这是启动记录精彩故事的第一步!

1
2
3
4
cd blog
hexo g
hexo s

执行

1
hexo s

命令后,通过浏览器访问http://127.0.0.1:4000可以预览你的博客,

Github配置

添加SSH Key

生成key

1
2
git config --global user.name "username"
git config --global user.email "[email protected]"

username 是你的用户名,[email protected]是你 Github 的登录邮箱

通过终端命令生成 SSH Key:

1
ssh-keygen -t rsa -C "[email protected]"

如果已经创建过会出现 Overwrite (y/n)? n提示可以输入 n,没有创建过的话三个回车就好,执行完成后会在~/.ssh/id_rsa.pub目录下生成 需要使用的 key,也就是公钥。

添加到Github

到账户主文件夹下同时按Command+Shift+.显示隐藏文件,找到.ssh文件夹,打开id_rsa.pub,将里面的内容全部复制。

打开GitHub_Settings_keys 页面,新建New SSH Key,Title随意填,Key就把刚才复制的内容全都粘贴上去。然后点Add SSH Key即可。

截屏2024-01-12 22.18.56

测试

1
ssh [email protected]

如果输出内容为,表示已经配置完成

1
You've successfully authenticated, 

新建仓库

在Github上新建一个仓库,Repository Name 填你的用户名.github.io,仓库状态设为 Public,点击 Create Repository 创建新的网站仓库。

安装 Hexo 的扩展 hexo-deployer-git,注意一定要在你的博客文件夹下执行:

1
npm install hexo-deployer-git --save

编辑博客安装文件夹下的_config.yml文件,翻到底部,修改deploy部分为:

1
2
3
4
5
deploy:
type: git
repo: [email protected]:你的用户名/你的用户名.github.io.git
branch: master

修改完成后按Command + S保存,此时就可以使用

1
hexo d

把存在本地的博客deploy到Github上。

Blog发布

博客生成

1
hexo new "博客名字"

博客内容编辑

发布

1
hexo g -d

Option:

1
hexo clean &&hexo g -d

域名绑定

首先自行申请一个域名,登陆到域名申请的后台,添加一条CNAME解析记录:

1
你的用户名.github.io

打开存放博客的Github仓库,进入Settings页面在pages选项里的Custom domain里填入你的域名,点击Save,勾选Enforce HTTPS,即可通过自定义域名访问你的博客。

截屏2024-01-12 22.29.48

Hexo 常用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
#注意以下命令需要切换到blog文件夹(cd blog)执行
hexo n "文章名称" => hexo new "文章名称" #这两个都是创建新文章,前者是简写模式,下同,new后面加一个draft可以生成草稿
hexo p => hexo publish #发布草稿
hexo g => hexo generate #生成
hexo s => hexo server #启动服务预览
hexo d => hexo deploy #部署

hexo server #Hexo 会监视文件变动并自动更新,无须重启服务器。
hexo server -s #静态模式
hexo server -p 5000 #更改端口
hexo server -i 192.168.1.1 #自定义IP
hexo clean #清除缓存,网页正常情况下可以忽略此条命令

参考和感谢

Mac OS环境下使用Hexo搭建个人博客@L3ZCの试验田]


搭建hexo的Mac OS环境
http://example.com/2024/01/12/Crafting-Your-Blog-Hexo-on-Mac-OS/
作者
Justin
发布于
2024年1月12日
许可协议