利用Github和hexo搭建自己的个人博客
1 安装Git
官方地址: https://git-scm.com/
- 到Git官网下载与电脑操作系统对应的安装包,进行安装。
- 安装步骤,,之后的步骤直接全部点击下一步,最后点击install。
选择安装路径,安装路径要全英文
添加桌面快捷方式
默认,点击下一步
默认,点击下一步
默认,点击下一步
默认,点击下一步
默认,点击下一步
默认,点击下一步
默认,点击下一步
默认,点击下一步
默认,点击下一步
默认,点击下一步
默认,点击下一步
等待安装
最后这个界面就显示安装完成 - 安装好之后,在电脑桌面鼠标右键选择Open Git Bash Here,出现git窗口。
- 输入:
git --version
,出现版本信息,说明安装成功。
2 安装node.js
官方地址: https://nodejs.org/en/download/
- 到官网下载安装包,然后点击运行安装。
来到node.js安装界面
点击同意
更改路径
下一步
下一步
最后点击install。
等待安装
显示安装成功,点击finish。 - 安装好之后,配置环境变量
右键点击“此电脑”,点击属性。
点击高级系统设置
点击环境变量
在系统变量中点击新建
填写变量名,变量值为node.js的安装路径。
最后点击确认就完成了环境变量的配置。 - 在Git终端里面输入:
node -v
出现版本号说明安装成功了。
3 安装hexo
3.1 安装cnpm
- cnpm 是 中国版的 npm(Node Package Manager),解决国内用户访问官方 npm 仓库速度慢的问题。
- 安装命令:
npm install -g cnpm --registry==https://registry.npm.taobao.org
- 测试命令:
cnpm -v
出现版本号说明安装成功。
3.2 安装hexo
- 安装命令:
cnpm install hexo-cli -g
- 测试命令:
hexo -v
出现这样的界面说明安装成功
4 hexo搭建本地博客测试
4.1 搭建博客
- 新建一个Blogs的文件夹,进入文件夹,右键选择Open Git Bash Here,进入Git终端。
- 初始化hexo命令:
hexo init
。
初始化成功后,Blogs文件夹下出现许多文件 - 安装hexo相关依赖
命令:npm install
命令2:npm install hexo-deployer-git --save
- 启动hexo命令:
hexo s
。先不要ctrl+c,不然就会停止服务 - 在浏览器访问 http://localhost:4000/ ,就可以看到hexo默认的页面。
4.2 修改主题
hexo主题官网: https://hexo.io/themes/
- 选择amazing主题
主题下载及安装教程: https://github.com/removeif/hexo-theme-amazing
主题预览: https://dogzi.fun/
下载主题的命令:git clone https://github.com/removeif/hexo-theme-amazing.git themes/amazing
。
ok,这样就下载好了。
在Blogs的themes目录下就可以看到amazing主题文件夹。 - 安装 semver 模块
命令:npm install semver --save
- 安装缺失的依赖
命令:npm install --save bulma-stylus@0.8.0 hexo-component-inferno@^3.1.2 hexo-renderer-inferno@^1.0.2 inferno@^8.2.3 inferno-create-element@^8.2.3
- 安装主题依赖
命令:npm install hexo-renderer-pug hexo-renderer-stylus --save
。 - 配置amazing主题
以下步骤为个人主观配置,具体配置步骤请参考文章: https://github.com/removeif/hexo-theme-amazing 。
- 打开
D:\Blogs\_config.yml
文件, 找到theme部分,将landscape改为amazing。 - 在
D:\Blogs\amazing\
目录下创建_config.amazing.yml
文件,把\amazing\_config.yml
文件里面的内容复制到_config.amazing.yml
文中。 - 后续修改博客的配置只需修改
_config.amazing.yml
文件。
4.3 预览主题
- 使用
hexo clean
命令清除缓存 - 使用
hexo g
命令生成静态网页,生成 public 文件夹 - 使用
hexo s
命令启动hexo - 在浏览器访问 http://localhost:4000/ ,就可以看到amazing主题的页面。
接下来就是将hexo部署到GitHub
5 git配置SSH key
可以免密的将本地的源码和资源上传到github,无需要每次都输账号和密码。
5.1 没有Github账号的,要先注册
5.2 生成ssh key
- 命令:
ssh-keygen -t rsa -C "邮件地址"
- 注意:邮箱地址为注册GitHub时使用的邮箱地址。
输入命令后连续按三次回车。
- 注意:邮箱地址为注册GitHub时使用的邮箱地址。
2. 在用户文件夹下可以看到一个.ssh文件夹
3. 进入文件夹,打开id_rsa.pub文件,复制里面的内容
5.3 添加ssh key到GitHub
- 打开github主页,点击右上角个人头像,再点击Settings
- 进入到个人设置页面后,点击左侧的SSH and GPG keys选项,再点击New SSH key
- title自定义,key为id_rsa.pub文件复制的内容。
最后点击 Add SSH key - 测试是否添加成功
命令:ssh -T git@github.com
出现You've successfully authenticated, but GitHub does not provide shell access.
,说明添加成功。 - 配置账号和密码
命令1:git config --global user.name "yourname"
,yourname为GitHub用户名
命令2:git config --global user.email "youremail"
,youremail为GitHub注册邮箱
6 搭建个人博客
6.1 创建博客文件夹
在4 hexo搭建本地博客测试
中已经创建过了
6.2 创建仓库
- 在右上角个人头像附近有个+,点它,然后再点New repository
- 给仓库命名,进行其他设置,点击创建
仓库名称格式:用户名.github.io - 打开
D:\Blogs\_config.yml
文件,拉到最后。
找到deploy这部分,替换为以下内容:
1 | deploy: |
name为GitHub用户名和仓库名,branch要看仓库是main还是master。
修改后的
6.3 发布到github
- 命令:
hexo d
出现Deploy done: git,说明上传成功。 - 在浏览器访问 https://kukual.github.io/
出现以下界面,说明访问成功
6.4 其他
hexo搭建博客详细教程请查看 https://hexo.io/zh-cn/docs/index.html
本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 kukual&blog!