一、前提
1、注册Gitee账号并创建仓库
Gitee官网
可以在Gitee官网注册账号,注册账号可自行百度,注册后可新建一个仓库
名称与路径可一致,新建仓库截图部分使用 purecodefarmer-test 进行截图使用,本项目是使用purecodefarmer-blog,后续也是使用这个名称。新建完成可点击创建仓库进入目录下
2、下载NodeJs
NodeJs下载地址
下载下来正常步骤安装即可,安装后按windows键+R键,输入cmd
查看nodeJs 与npm的版本,可正常输入版本号说明安装成功
$ node -v
$ npm -v
3、下载Git
Git下载地址
下载结束后按照正常流程安装即可,安装完成后检测是否安装成功
$ git --version
出现版本号表示安装成功
4、仓库公钥配置
cmd后输入命令生成公钥与私钥, “xxxxx@qq.com” 是自己的邮箱,可使用其他邮箱
$ ssh-keygen -t ed25519 -C "xxxxx@qq.com"
之后会在 C:\Users\Administrator 路径下生成 .ssh 文件夹,文件夹下会有公钥(id_ed25519.pub)、私钥(id_ed25519)、hosts文件(known_hosts)
复制公钥(id_ed25519.pub)内容,打开Gitee自己新创建的仓库,点击管理
部署公钥管理–>添加公钥
二、配置Hexo
1、配置国内的镜像源
$ npm config set registry https://registry.npm.taobao.org
2、安装Hexo
$ npm install -g hexo
3、初始化创建 purecodefarmer
# 初始化创建hexo
$ hexo init purecodefarmer
# 创建完成进入文件夹
$ cd purecodefarmer
# 安装hexo需要的文件
$ npm install
4、启动Hexo
# 每次更改数据后都要执行下面三个命令
# 清除缓存文件
$ hexo clean
# 生成静态文件 可简写为 hexo g
$ hexo generate
# 启动服务器 可简写为 hexo s
$ hexo server
在网页上输入 http://localhost:4000/ 即可展示hexo的页面
5、配置文章封面图片
文章封面的图片需要放在 purecodefarmer\source\img 目录下 单独建一个封面文件夹 cover_image
修改md文件头中的 index_img
6、配置 url 地址
增加md文件头 md_url: docs/hexo (可视每个页面进行修改,但docs不变,相当于页面的路径)
修改 _config.yml 文件
permalink: :md_url/:title/
5、配置关于页
执行命令新增 about 页面
$ hexo new page about
添加 about 页面的布局参数
layout: about
更改头像与名称 将head.jpg 放到 img目录下
# 配置头像与名称
avatar: /img/head.jpg
name: "纯码农"
# 配置链接
- { class: "iconfont icon-github-fill", link: "https://github.com", tip: "Github" }
- { class: "iconfont icon-douban-fill", link: "https://douban.com", tip: "豆瓣" }
- { class: "iconfont icon-wechat-fill", qrcode: "/img/favicon.png" }
- { class: "iconfont icon-gitee-fill", link: "https://gitee.com", tip: "Gitee"}
如果要找对应的图标,可参考阿里巴巴iconfont
6、发布到Gitee上
修改 _config.yml 文件 repo是自己的仓库地址
deploy:
type: git
repo: https://gitee.com/purecodefarmer/blog
执行以下命令上传
# 清除缓存文件
$ hexo clean
# 生成静态文件 可简写为 hexo g
$ hexo generate
# 部署网站 可简写为 hexo d
$ hexo deploy
三、发布到Gitee Pages
1、进入Gitee中的仓库点击Gitee Pages
2、进入Gitee Pages 需要申请
申请时需要上传自己的身份证正反面照片与手持身份证照片,一般申请成功后一到两个工作日就会开通
3、申请后可进行部署
如果有代码提交后,需要点击更新才可,开启后的网址:纯码农的博客
四、问题解决
1、本地图片不显示问题
可参考使用OSS解决图片问题
2、发布到Gitee Pages不显示图片与页面404问题
修改 _config.yml
url: https://purecodefarmer.gitee.io
root: /blog