Hexo + Github搭建个人博客

一、环境搭建

在安装Hexo之前,需要先把环境搭建好,首先下载GitNode.js,下载好最新版本进行安装,安装过程中一路默认就可以了,如果有需要也可以自定义安装路径。

安装完成之后,在桌面空白处右键鼠标,点击Git Bash Here,分别输入以下命令并回车:node -vnpm -vgit --version,出现版本号即说明安装成功。

1
2
3
4
5
6
7
8
9
10
11
123@DESKTO ~/Desktop
$ node -v
v16.13.0

123@DESKTOP ~/Desktop
$ npm -v
8.1.0

123@DESKTOP ~/Desktop
$ git --version
git version 2.33.1.windows.1

二、配置Github

1、登录Github

首先登录你的Github,如果没Github账号的话请先注册一个账号并登录,关于Github的访问问题,网上有很多教程,就不多赘述了,登录之后进行下一步。

2、配置密匙

在桌面右键鼠标,点击Git Bash Here,输入以下命令并回车(双引号内的内容,按自己的账号进行填写):

1
git config --global user.name "GitHub 用户名"
1
git config --global user.email "GitHub 邮箱"

输入ssh-keygen -t rsa -C "GitHub 邮箱",然后一路回车。

打开此电脑,进入C盘-Users-用户名-.ssh,在.ssh文件夹里(要勾选显示“隐藏的项目”),用记事本打开 id_rsa.pub 文件并复制里面的内容等会儿要用到。

打开刚刚登录的Github,在主页点击右上角的头像-点击Settings,进入Settings页面,在左侧的内容栏中找到并点击SSH and GPG keys,点击 New SSH key,Title这一栏随便填写,把刚刚从id_rsa.pub文件里复制的内容,粘贴到Key里,然后点击Add SHH Key。

打开Git Bash Here,输入ssh -T git@github.com并回车,出现“Are you sure……”,输入 yes 并回车。

显示 “Hi xxx! You’ve successfully……” 即连接成功。

3、创建 Github Pages 仓库

在Github主页,点击右上角的+号,在弹出的列表里,点击New repository,在Repository name 中输入 用户名.github.io,Description 选填,选择Public,在Initialize this repository with里:勾选Add a README file。

填好后点击 Create repository 创建。

创建后默认自动启用 HTTPS,博客地址为:https://用户名.github.io

三、安装Hexo

首先新建一个文件夹,路径和文件名最好是全英文,新建之后打开该文件夹,右键鼠标,点击Git Bash Here,输入以下命令安装Hexo:

1
npm install -g hexo-cli

因为一些总所周知的原因,导致下载很慢甚至下载安装失败,这时候可以考虑把源换成淘宝源,输入以下命令:

1
2
npm config set registry https://registry.npm.taobao.org
npm config get registry

设置成淘宝源之后,使用cnpm命令安装Hexo:

1
cnpm install -g hexo-cli

换源之后,下载速度很快,十几秒就下载并安装好了。

然后依次输入以下命令:

1
2
hexo init      # 初始化
npm install # 安装组件

完成后分别输入以下命令:

1
2
hexo g   # 生成页面
hexo s # 启动本地预览

当运行hexo s成功之后,用浏览器访问http://localhost:4000,会出现Hexo默认页面,说明博客大致已经搭建好了,只剩下最后一步,把它部署到Github上。

预览完之后,在打开的Git Bash Here窗口里,按下ctrl+c就会退出hexo s了。

四、部署Hexo到Github Pages

首先安装 hexo-deployer-git插件:

1
npm install hexo-deployer-git --save #部署推送

然后在你博客的根目录下找到配置文件**_config.yml**,打开它:

在内容的最后面找到Deployment这一段,把下面的内容修改成如下:

1
2
3
4
deploy:
type: git
repository: https://github.com/Github用户名/Github用户名.github.io.git
branch: main #根据自己的Github设置来更改是main还是master

修改完成后,保存并退出,然后运行hexo d,将博客部署到Github Pages。

在执行hexo d的时候,可能会弹出一个窗口,让你登录Github账号进行认证,自行选择认证方式即可,认证完成即可完成部署,我选择的是输入Token,具体步骤如下:

在Github主页,点击右上角的+号,在弹出的列表里,点击Settings —> developer settings —> personal access tokens —> generate new token —> Note:输入任意名称 —-> Expiration:选择授权时长 —> 然后勾选repo —> 最后点击Generate Token完成设置,然后复制一下Token的值,在弹出的窗口里,选择Token,把刚刚复制的东西粘贴进去就行了。

这一步如果不出意外的话,博客已经成功部署到Github Pages了,这时候打开浏览器,访问https://Github用户名.github.io,就能线上访问你的博客了。

本文章在搭建过程中遇到一些问题,网上找到的教程或多或少和现在最新的搭建情况有点不符合了,所以有了这篇文章,记录一下搭建过程,如果一切顺利的话,整个流程不会超过10分钟。

本文章参考以下文章:

使用 Hexo+GitHub 搭建个人免费博客教程(小白向) - 知乎 (zhihu.com)

Hexo的详细搭建过程——小白的血泪经历QAQ - 橘崽崽啊 - 博客园 (cnblogs.com)

github的token使用方法_chengwenyang的专栏-CSDN博客_github token

打赏
  • 版权声明: 本博客所有文章除特别声明外,著作权归作者所有。转载请注明出处!

扫一扫,分享到微信

微信分享二维码
  • Copyrights © 2020-2023 XuanMing
  • 访问人数: | 浏览次数:

请我喝杯咖啡吧~

支付宝
微信