使用GitHub Pages托管你的博客

标签：GitHub hexo 博客 github 文件夹 git 安装 Pages

必备条件

1. 在Node.js官网下载软件并安装
2. 在Git官网下载软件并安装
3. 一个GitHub账号，可以在GitHub进行注册

安装hexo

所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。

1. 安装好之后在盘中创建文件夹，并右键使用Git Bash Here打开文件夹

2. 输入以下命令进行安装Hexo

   npm install -g hexo-cli
   

3. 在安装完成以后输入下方代码检查是否安装成功

   hexo -v && git -v && node -v
   

   若输出版本号相关表示安装成功

4. 复制下方命令，进行初始化博客文件夹

   // hexo init 博客文件夹  若为空表示在当前文件夹
   hexo init blog
   // 或
   hexo init
   

5. 复制下方命令，安装hexo的扩展插件

   npm install
   

配置ssh

1. 打开git bash终端。

2. 设置user.name和user.email。

   git config --global user.name "你的GitHub用户名"
   git config --global user.email "你的GitHub注册邮箱"
   

3. 生成ssh密匙

   ssh-keygen -t rsa -C "你的GitHub注册邮箱"
   

4. 此时，在用户文件夹下就会有一个新的文件夹.ssh，里面有刚刚创建的ssh密钥文件id_rsa和id_rsa.pub。

   将公匙添加到github上

   用户头像→Settings→SSH and GPG keys→New SSH key→将id_rsa.pub中的内容复制到Key文本框中，然后点击Add SSH key(添加SSH)按钮。

创建仓库

在GitHub中创建一个仓库，将仓库的名字更改为 yourname.github.io，例如我的仓库名是zsuh.github.io

初探Hexo

当在第一次使用hexo时，在本地创建服务器使用

# 生成静态页面
hexo generate
# 开启本地服务器
hexo s

根据提示，使用ctar + 左键单击进入链接应该就可以看到刚刚创建的博客了

部署至GitHub

修改配置文件blog/_config.yml，修改deploy项的内容，如下所示：

# Deployment 注释
## Docs: https://hexo.io/docs/deployment.html
deploy:
  # 类型
  type: git
  # 仓库
  repo: https://github.com/zsuh/zsuh.github.io.git
  # 分支
  branch: main

注意事项：

• 在冒号后面有一个空格，没有会报错
• 将repo的地址更换为自己的仓库地址

输入下面的命令将hexo博客部署到github中：

# 清空静态页面
hexo clean
# 生成静态页面
hexo generate
# 部署 
hexo deploy
#可以简写为
hexo clean && hexo g -d && hexo s

疑难杂症

1. hexo每次上传后都需要重新配置自定义域名

   在sourcce下创建文件CNAME在其中填入你的自定义网址 如 zsuh.cc

   注意事项：

   • 文件没有后缀
   • 文件命名必须是大写
   • 网址不要带协议

2. 第一次部署时无法上传至GitHub

   由于hexo不自带上传插件，安装Git上传插件即可

标签：GitHub,hexo,博客,github,文件夹,git,安装,Pages
From： https://www.cnblogs.com/zsuh/p/NewHexo.html