用Github建立个人博客的流程记录

环境准备

1、安装git

下载网址:git-scm.com

完成后鼠标右键可见Git Bash Here. 点击打开后,测试是否安装成功:

1
git --version

2、安装node.js

下载网址:nodejs.org/en/download/

测试是否安装成功:

1
git -v

3、安装Hexo

安装:

1
npm install hexo -g

测试是否安装成功:

1
hexo -v

4、安装Hexo依赖

1
npm install --save hexo-deployer-git

5、配置SSH key

生成ssh key:

1
ssh-keygen -t rsa -C "github账号绑定的邮件地址"

在电脑用户文件夹下可以看到生成.ssh文件夹。在.ssh文件夹下,复制id_rsa.pub文件里的所有内容。

打开github主页,在settings中选择SSH and GPG keys,点击右侧New SSH key,将复制内容粘贴,取好Title后add SSH key.

测试是否成功:

1
ssh -T git@github.com

配置用户名和邮箱:

1
2
git config --global user.name "github用户名"
git config --global user.email "github注册邮箱"

搭建博客

1、初始框架

hexo基本命令:

1
2
3
4
5
6
7
8
9
10
hexo init #新建网站
hexo new "title" #新建文章
hexo new page "pagename" #新建页面
hexo g
hexo generate #生成静态文件至public目录
hexo s
hexo sever #预览
hexo d
hexo deploy #将网站部署到github
hexo clean #清除缓存和已生成的静态文件(public)

在本地保存博客的目录,进入Git命令,输入:

1
hexo init

目录会出现多个文件和文件夹。

_config.yml:为网站的配置信息,在此配置网站的参数。

scaffolds:为模板文件夹。当新建文章时,Hexo会根据 scaffold来创建文件。

source:存放用户资源的文件夹。

themes:主题文件夹,Hexo根据主题生成静态页面。

生成静态网页:

1
hexo g

预览:

1
hexo s

2、将网站部署到github

在github上点击新建:new repository

仓库名称:用户名.github.io

选中 Add a README file,点击 Create repository.

编辑本地目录中的_config.yml:

type: git

repository: git@github.com: username/username.github.io

branch: main

(branch需要看自己的github repository是master还是main.)

在git中命令部署:

1
hexo d

访问自己的网站:username.github.io

主题与内容

接下来就是寻找适合自己的网站主题:https://hexo.io/themes/

支持中文、持续更新的主题往往使用起来更加趁手。

我们同样可以在这个网站上寻找合适的插件:https://hexo.io/plugins/

对我而言有用的插件包括嵌入视频网站视频,嵌入音乐播放器等。

参考资料

https://hexo.io/zh-cn/docs/

https://zhuanlan.zhihu.com/p/392994381?utm_psn=1704689009681543169


用Github建立个人博客的流程记录
https://siyublog.github.io/2023/11/05/sharing/workflow/ToStartABlog/
作者
Siyu
发布于
2023年11月5日
许可协议