Github+hexo搭建博客详细记录

全部搭建过程参考文章:https://blog.csdn.net/yaorongke/article/details/119089190

SSH设置:https://github.com/pengwenwu/skill-tree/blob/master/Hexo/hexo%20%2B%20github%E6%90%AD%E5%BB%BA%E4%B8%AA%E4%BA%BA%E5%8D%9A%E5%AE%A2%E6%95%99%E7%A8%8B.md

一、准备工作

1. 注册GitHub账号

首先需要有一个GitHub账号,没有的话到先到GitHub官网注册(https://github.com/)。

注册可参考GitHub申请账号教程https://blog.csdn.net/yaorongke/article/details/119086305

2. 安装Git

在自己电脑上安装好Git,hexo部署到GitHub时要用。参考 Git安装(网址:https://blog.csdn.net/yaorongke/article/details/119085413?fromshare=blogdetail&sharetype=blogdetail&sharerId=119085413&sharerefer=PC&sharesource=weixin_62431476&sharefrom=from_link)

3. 安装NodeJS

在自己电脑上安装好NodeJS,Hexo是基于NodeJS编写的,所以需要安装NodeJS和npm工具。可参考NodeJS安装及配置(Windows)——

https://blog.csdn.net/yaorongke/article/details/119084295?fromshare=blogdetail&sharetype=blogdetail&sharerId=119084295&sharerefer=PC&sharesource=weixin_62431476&sharefrom=from_link

我的安装具体步骤:

(1)下载安装包

NodeJS官网下载地址:https://nodejs.org/zh-cn/download/


下载安装包后双击安装包开始安装,一路点击Next即可,安装完成后,msi格式的安装包会自动添加环境变量。

安装finish后打开cmd,执行命令node -v查看node版本

在安装node的同时也安装了npm,执行 npm -v 查看npm版本

成功查看后就安装完成可以正常使用了,参考文章内还有讲解修改全局包配置,但我不需要这个所以省略后半部分,有需要可访问步骤3的网址。

二、创建仓库

1. 在GitHub上创建一个新的代码仓库用于保存我们的网页。点击Your repositories,进入仓库页面。


2. 点击New按钮,进入仓库创建页面。

3. 填写仓库名(必须与用户名一致),格式必须为<用户名>.github.io,然后点击Create repository。

4. 点击creating a new file创建一个新文件,作为我们网站的主页。


5. 新文件的名字必须为index.html,内容先随便写一个简单的,填写之后点击Commit new file提交。


填写内容示例如下:


6. 在仓库页面,从上方导航栏进入“Settings”-“Pages”,找到主页的地址,示例为 https://yaorongke.github.io/


7. 接下来直接访问查询到的主页地址https://yaorongke.github.io/,可以看到一个比较简陋的网页:

三、安装Hexo

Hexo 是一个基于NodeJS的静态博客网站生成器,使用Hexo不需开发,只要进行一些必要的配置即可生成一个个性化的博客网站,非常方便。Hexo官网https://hexo.io/zh-cn/

1. 安装hexo

注意,第一个坑来了!——自行创建一个WorkSpace-blog目录,在该目录下安装hexo,安装hexo命令以官网为准npm install hexo-cli -g,参考文章内的命令不知道为啥不可用,归结为坑(bushi)

npm install hexo-cli -g

  1. 安装成功后查看版本

hexo -v

  1. 创建一个项目 hexo-blog 并初始化,

hexo init blog

cd blog

npm install

  1. 本地启动

hexo g

hexo server


这里有个踩过的坑:

启动失败了,原因是4000端口被占用,使用hexo s -p 8080命令更换端口.( 启动时需要在hexo-blog目录下)以自己的目录为准。

​ 更换为8080端口即可成功启动

​ 启动失败,4000端口被占用

四、更换主题

1. 下载Fluid主题

进入Fluid官网安装主题,点击“最新 release 版本”下滑找到“Assets”部分。

下载压缩包并解压到 “hexo-blog” – “themes” 目录,并将解压出的文件夹重命名为 fluid

2. 指定主题

如下修改hexo-blog目录中的 _config.yml文件的them和language(用vscode软件打开hexo-blog目录会非常好修改,后续需要执行的命令行也可以直接在vscode终端执行):

我的vscode修改界面:

  1. 创建「关于页」

首次使用主题的「关于页」需要手动创建

hexo new page about

创建成功后,编辑博客目录下 /source/about/index.md,添加 layout 属性

修改后的文件示例如下:

五、发布到GitHub Pages

1. 安装hexo-deployer-git

  1. 修改 hexo-blog目录下的config.yml,配置 GitHub 相关信息

坑!

配置.yml文件时,注意空格!!!否则报错

接下来两个推送方式:

(1)参考文章内(如下)的配置方式部署不知道为什么一直没成功,放弃了。。。。。


这个问题暂时没解决,推送换了ssh连接

(2)换成ssh推送继续往下肝,这里开始参考开头提到的第二篇文章:[**https://github.com/pengwenwu/skill-tree/blob/master/Hexo/hexo%20%2B%20github%E6%90%AD%E5%BB%BA%E4%B8%AA%E4%BA%BA%E5%8D%9A%E5%AE%A2%E6%95%99%E7%A8%8B.md**](https://github.com/pengwenwu/skill-tree/blob/master/Hexo/hexo %2B github搭建个人博客教程.md)



以上步骤非常清晰,浅提几个点:

l 一开始没有.ssh目录,执行了命令ssh-keygen -t rsa -C “my email”命令,这里我是在c:/用户/username/目录下执行的,生成完成后用记事本打开id_ras.pub文件,然后Ctrl-A复制所有内容。

l 接下来的github->头像->Settings→SSH kyes→Add SSH key,粘贴复制的内容。对应图片放这里:

l 最后的url配置的就是步骤二-7中的主页地址

l repo的内容在仓库页面-code-SSH可以直接复制

l 全部修改完配置保存后执行hexo g -d,部署完成后就可以打开主页:


再附上之前我自己写的注意事项,记录点东西确实还是能帮上忙哦!

  1. Node下载,注意看是否直接下载安装程序,压缩包还不会使用。
  2. 在npm运行,就是Node,下载好了cmd到folder,执行npm命令就行。
  3. 注意.ignore文件,否则上传一大堆。
  4. github分支很重要,默认执行分支main,这就会出现部署到master分支,本地能成功执行hexo,但是github访问不到,去setting切换分支即可。
  5. github pages没有实时更改内容是很正常的,发布前先hexo s -p 8080,本地执行没问题,先使用 hexo clean 清除本地缓存,然后hexo g -d提交。
  6. 新建文章很简单,hexo new name 即可。
  7. 发布照片时,要把生成的照片文件夹放到source下的img静态资源文件夹,养成良好习惯,放在post里面无法访问。

  1. 稍微有一些地方没设置成功,都无法访问。今天的情况是,都部署成功了,githubPages能看得到第一篇文章,但是后续发布的文章一直没法看到,github代码也显示push成功。出了什么问题呢?确保 GitHub Pages 设置正确:

在仓库的 Settings > Pages 中,设置发布来源为 GitHub Actions 自动生成的文件。直接上图,真的shit,好在终于成功啦!


以上是我帮ie家族一员Winnie配置时遇到的问题,尽管9月份我已经配置过了,苦于没有留下详细的说明文档,导致这次踩坑很多还是要不停搜索。于是我们两人决定写一份说明文档,当然,这份保姆级别教程要感谢Winnie~ Jessie主要是技术支持哈哈哈。Winnie会来看我的主页吗,不知道,祝她找工作顺利!可爱善良的女孩呀,幸福会来敲门的!


Github+hexo搭建博客详细记录
http://chenjessiee.github.io/2024/11/05/Github-hexo搭建博客详细记录/
Author
Jessie
Posted on
November 5, 2024
Licensed under