旧Lin-Blog手册
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
重新安装主题插件
最重要的几步:
- 由于更换了数据导致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 | npm install hexo-deployer-git --save |
就可以了
但是以上只是最重要的几步而已,下面是迁移文章数据
如果你有本地数据就进入blog文件夹内的\source\_posts文件夹,里面存储了全部文章,迁移到新博客根目录的同名文件夹即可
如果么没有本地数据
就大结局了…
开玩笑的,这边建议大家还是做好备份,主题什么丢了都是小事,文章丢了就真的丢了!