hexo | 创建并部署 hexo 博客
安装 hexo
前提条件是必需安装了 nodejs。
安装 hexo,命令行 (推荐用 git bash) 输入:
1 | npm install hexo-cli -g |
初始化博客
初始化博客,myblog 可以替换成你想要的文件夹名字。
1 | hexo init myblog |
1 | cd myblog |
启动本地预览:
注意这个 hexo s 就是开启本地预览,如果你关了之后就看不到了
1 | hexo clean |
进入博客:
显示以下界面即表示成功,这是在本地部署成功。
GitHub 部署
先安装必要的插件:
1 | npm install hexo-deployer-git --save |
新建仓库
打开你个人的 github 仓库主页,新建仓库,我这里使用小号演示。
仓库名 .github.io
前面必须和你的 github 用户名一致。
选择复制 ssh 的地址,最好不要用 http 的。
后面我会演示如何配置 ssh
配置博客
下面有单账户配置和多账户配置,多账户配置适合于你本地有两个 github 账户,然后你想指定某个 hexo 仓库用到指定的 github 账户的话,你可以看看我的多账户配置。
当然,一般都是单账户,所以直接看单账户就好了。
单账户配置
博客根目录下的 _config.yml
里面配置 github url,这里用的是 https://你的用户名.github.io
也是在 _config.yml
最底下找到:
repository 就是前面新建仓库之后的 ssh 地址。
branch 和你仓库默认对应就行,但是我建议改成 main。
1 | deploy: |
如果不用配置多账户,完成这里之后跳到 配置 ssh 模块。
多账户配置 (可以跳过)
也可以用以下配置 (因为我有多个账户,所以我局部配置了一下 git)
1 | deploy: |
我这里配置了两个 ssh,分别属于我两个 github 账户:C:\Users\Birdy\.ssh\config
在博客 .deploy_git/.git
目录下找到 config
在里面加上:
1 | [user] |
配置 ssh
刚才配置完之后 _config.yml
底下是这样的。
然后我们配置一下 ssh。
也可以看我另一篇文章
git bash 打开:
有个 enter file 的提示,提示你保存到哪里,你可以直接按 enter 就是保存到默认路径C:\Users\用户名\.ssh\
,但是我这里自己指定了一下,
1 | ssh-keygen -t rsa -b 4096 -C "你的github用户邮箱" |
比如我的:
1 | ssh-keygen -t rsa -b 4096 -C "[email protected]" |
然后在 C:\Users\用户名\.ssh\
路径下,找到 id_rsa.pub
文件,用记事本之类的打开,待会需要用到
Github 配置 ssh
github 页面打开 settings
点击 New SSH key
,我们将要注册前面生成的 ssh key
复制 id_rsa.pub 里面的内容
粘贴到这里面。
提交。
配置本地 git 账户
单用户直接配置全局的:
1 | git config --global user.name "userName" //你的用户名 |
测试能否正常 ssh 连接。输入完下面这个之后可能会有提示你保存什么东西的,你输入 yes
就可以
1 | ssh -T [email protected] |
部署 hexo
1 | hexo clean |
然后尝试访问 https://你的用户名.github.io
比如我这个:
-> 访问不出来 ctrl + F5
多刷新几次
安装主题
你也可以用别的主题, hexo 官网提供了很多。
安装主题 https://docs.anheyu.com/initall.html
在你的博客 根目录 下,打开 git bash 输入。
1 | git clone -b main https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu |
然后找到刚才克隆下来的文件夹
将博客根目录下的 _config.yml
文件里面的 theme 改为 anzhiyu
打开 git bash 安装插件
1 | npm install hexo-renderer-pug hexo-renderer-stylus --save |
将主题文件(themes/anzhiyu
)下的 _config.yml
复制一份,名字改为 _config.anzhiyu.yml
放到博客根目录下
最后再重新部署一下:
1 | hexo clean |
本地预览:
1 | hexo s |
加载不出来 ctrl + F5 刷新!多刷新几次。效果就可以呈现出来了!