2025年1月8日清晨5点11分修订

请注意

Gitee Pages在2024年中旬已经停止服务!

此教程中所展示的通过Gitee Pages部署无法再使用!

Lin-Blog 搭建与维护手册

用到工具(包括编辑):

必须

Gitee

Git

安装

全部安装设置默认即可,在桌面右键菜单出现以下菜单即可:

nodejs

安装

推荐长期维护版本,安装完成后cmd窗口输入node -v返回版本号即可:

可选

编辑器

Notepad++

HBuilder X

可以选择其他编辑器,不需要完全一致!

搭建

主体

创建博客所在文件夹(你的博客所在目录),

在文件夹里右键运行Git Bash Here(Git窗口)

在Git窗口输入

1
npm install hexo-cli -g

再输入

1
hexo init blog

再进入生成的blog文件夹

输入

1
npm install

这时候就已经可以运行了,输入hexo s可以运行博客,默认在4000端口开放预览。

主题

在hexo官网点击主题,找到想要的主题点击(点击图片是预览,点击文字是教程)查看教程!

部署

创建博客容器

首先来到Gitee已弃用)(有账号的就直接下一步,没有就注册一个)确保账号已经实名认证后进行下一步

点击右上角个人主页,记住个人主页地址

点击+号新建一个仓库,名称随便填,路径需要输入个人主页地址

上传博客到容器中

配置云端

找到Git全局设置,复制代码直接在Git窗口中运行

再将以下命令中的“邮箱地址”替换为Gitee注册邮箱

1
ssh-keygen -t rsa -C"邮箱地址"

Overwrite选项选择y,其余全部回车

再输入以下代码获取秘钥

1
cat ~/.ssh/id_rsa.pub

然后复制显示的秘钥,打开刚才创建的仓库,点击右上角菜单中的设置

在左侧点击SSH公钥,名称随便填,然后将复制的秘钥粘贴过来,点击确定,输入密码确认

然后在Git窗口中输入

1
ssh -T git@gitee.com

返回successfully代表成功

配置本地端

来到博客根目录,右键打开config文件

最底部type项输入git

在下一行输入repository:(冒号后面一定要有空格,不然会报错!!!)

来到刚才创建的仓库主页,最顶部点击SSH,复制代码粘贴到刚才repository:后面

这时候不能直接推送,需要安装插件

1
npm install hexo-deployer-git --save

就可以上传了

别忘了把仓库开源

部署

点击服务中的Gitee Pages

勾选强制HTTPS,启动,等待完成后点击链接就可以访问了

维护

常用指令

启动hexo s
加载hexo g
部署hexo d

更新博客

hexo g生成网页

hexo s开启本地服务器预览博客

hexo d上传博客

Gitee Pages点击更新,完成后访问博客刷新或清除缓存访问即可看到更新后的界面

数据丢失(更换系统后搭建)

此方法只适用于文章数据未丢失

首先你要了解为什么直接迁移数据不可运行:

这是由于插件未安装的原因!

首先重新安装Hexo

重新安装主题插件

最重要的几步:

  1. 由于更换了数据导致SSL秘钥失效

再将以下命令中的“邮箱地址”替换为Gitee注册邮箱

1
ssh-keygen -t rsa -C "邮箱地址"

Overwrite选项选择y,其余全部回车

再输入以下代码获取秘钥

1
cat ~/.ssh/id_rsa.pub

然后复制显示的秘钥,打开刚才创建的仓库,点击右上角菜单中的设置

在左侧点击SSH公钥,名称随便填,然后将复制的秘钥粘贴过来,点击确定,输入密码确认

然后在Git窗口中输入

1
ssh -T git@gitee.com

返回successfully代表成功

  1. 验证过期导致上传失败
这个步骤极其容易被忽略,但是这个步骤是必须的!

安装插件

1
npm install hexo-deployer-git --save

就可以了

但是以上只是最重要的几步而已,下面是迁移文章数据

如果你有本地数据就进入blog文件夹内的\source\_posts文件夹,里面存储了全部文章,迁移到新博客根目录的同名文件夹即可

如果么没有本地数据

就大结局了…

开玩笑的,这边建议大家还是做好备份,主题什么丢了都是小事,文章丢了就真的丢了!