重装系统后,发现把环境配置的知识都忘光了,写个教程教未来的自己,如果能帮到其他人就再好不过了。
本文大量参考了 Argvchs 的Hexo 博客搭建教程 I, 事实上这篇文章的标题也是参考而来的。
同时也参考了 Kaitaku 的从零搭建 hexo 博客
0. 前言#
Hexo 是一个快速,简单和强大的博客框架,Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
Markdown 相关教程如下
- Markdown 官方教程
- github 官方文档:基本撰写和格式语法
1. 本地安装 Git & Node.js & Hexo CLI#
- Git
https://git-scm.com/downloads
安装完成后在桌面或任意文件夹右键会出现 git bash here 单击打开 git 终端用git --version
命令检查。
(以下如无特殊说明则命令均在 git 终端完成) - Node.js
https://nodejs.org
一般选择 LTS(长期支持版本),安装一路确认即可。
使用 Node.js 官方安装程序时,请确保勾选 Add to PATH 选项(默认已勾选)
完成后使用node -v
和npm -v
两个命令检查。 - Hexo CLI
输入命令npm install hexo-cli -g
并用hexo -v
检查 - 安装插件
部署插件:pnpm add hexo-deployer-git
,安装后可使用hexo -d
部署 Blog 到 Github。
2.Github 相关设置#
- 配置 Github SSH 密钥
使用ssh-keygen -t rsa -C "[email protected]"
命令生成 SSH 密钥,(注意,填入的是自己注册 Github 的邮箱)
使用notepad %USERPROFILE%\.ssh\id_rsa.pub
命令打开本地 SSH 密钥文件并复制,当然你也可以从文本管理器里打开
点击 Github 页面右上角的头像进入 Settings 页面,点击左侧的 SSH and GPG keys,点击右上角的 New SSH key,粘贴 SSH 密钥到 key 中,Title 不用写,点击 Add SSH key 添加密钥。
在本地键入如下命令,绑定 Git 和 Githubgit config --global user.name "<user>" git config --global user.email "<email>"
- 配置分支
在 Github 中新建一个仓库作为 Blog 的仓库,仓库名称为<user>.github.io
,例如我的用户名:janblank499,则仓库名称为janblank499.github.io
,并确保该仓库是公开的(pubilc)
打开分支设置,第一个输入框里就是默认分支,(旧版为 master 新版为 main)
打开你博客根目录的_config.yml
,设置参数。注意branch:**
要与默认分支一致deploy: type: 'git' repository: ** branch: **
以上,搭建 Blog 前的设置全部完成,下一步就是在本地生成 Blog 并部署了。
下一篇:Hexo Blog 搭建教程 Ⅱ