Gitee托管静态博客

上期我们讲到了，如何在本地运行我们Hexo搭建的博客。
这期我们说说如何使用Gitee Pages服务托管我们的博客。

概要

我把步骤大致分为三步。

• 第一步，先去Gitee创建仓库
• 第二步，本地连接Gitee
• 第三步，Hexo配置文件指明部署信息，然后部署

一、新建仓库

1.新建仓库

1.1如图新建一个仓库，为了使pages 首页访问地址不带二级目录，这里仓库名与个性地址同名。

如图，我现在还在使用这个仓库，所以这里提示用户名存在。你们不会提示。

1.2点击创建

2.设置仓库公开

现在gitee创建完仓库之后才能设置公开

二、本地连接Gitee

• 通过ssh方式与Gitee建立连接，ssh公钥配置完成后本地操作远程仓库就无需账号密码

• ssh公钥配置：首先进行全局配置，然后需要在本地生成一段密钥，最后在gitee中进行公钥添加即可。

1.1全局配置

• 本地执行如下命令（配置自己的name，email）

git config --global user.name "cysheng"
git config --global user.email "wy1075650138@163.com"

参考

1.2本地生成密钥

命令行输入：

ssh-keygen -t rsa -C "wy1075650138@163.com"

• Enter file in which to save the key：
  • 指定生成位置，（路径/文件名）。
  • 直接回车表示默认，即括号里的文件路径。（例如我这里C:\Users\86191/.ssh/id_rsa）
• Overwrite(y/n)：是否覆盖（这是我以前创建过，第一次创建不会提示）
• Enter passphrase:输入密码
• Enter same passphrase:确认密码

1.3Gitee添加公钥

1.3.1复制密钥

找到生成密钥的文件夹，用记事本打开”id_rsa.pub”文件。全选文本并复制。

1.3.2Gitee设置

• 如图找到ssh公钥配置，粘贴到公钥位置（标号5）。

• 点击确认后，会有密码确认，输入Gitee账号的密码即可配置成功。

• 标题：粘贴公钥后自动生成

• 公钥：粘贴本地生成后复制的

三、Hexo配置并部署

1.安装部署工具

npm install hexo-deployer-git --save

2.配置部署信息

站点配置文件_config.yml

deploy:
  type: git
  repo: <repository url> # 输入你的仓库地址
  branch: [branch] # 输入分支

以我自己为例

deploy:
  type: git
  repo: git@gitee.com:cysheng/cysheng.git # 输入你的仓库地址
  branch: master # 输入分支

3.部署

hexo clean && hexo g && hexo d

• hexo clean

  • 清除缓存文件 (db.json) 和已生成的静态文件 (public)。

• hexo g

  • hexo解析站点文件夹，生成一个public文件夹（只包含浏览器可以解析的html、css、js），也就是我们需要部署的文件夹。

• hexo d

  • 部署，即将我们的public文件夹推送到我们配置的仓库

4.开启Gitee Pages服务

找到新创建的仓库->【服务】->【Gitee Pages】

• 如图，选择部署分支，部署目录
  • 部署分支，与本地hexo配置一致
  • 部署目录，不填即整个仓库
  • 强制使用https
    • 一个是进行加密，还有一个是我在用next主题时使用http访问会有跨域问题导致图标显示不出来
  • 点击启动
  • 访问给出的网站地址（以我的为例：https://cysheng.gitee.io）

结束

如果一切顺利，你就可以在公网访问到你的网站了！

Hexo官方文档：https://hexo.io/zh-cn/docs/

Gitee Pages：https://gitee.com/help/articles/4136#article-header0