将hexo搭建的个人博客部署到GitHub


一、新建仓库

🎯 上一篇如何使用hexo搭建个人博客中准备环境有提到要注册GitHub/GitLab账号
今天我们要登录GitHub新建博客仓库,准备将博客部署到GitHub Pages

1.登入 github 账号
2.New repository 在 github 新建一个名为:username用户名.github.io 的 Repository(我这里在用户名下建了一个与本地博客同名的目录)
3.注意要公开仓库,私有库是无法访问的(GitHub Pages 在公共存储库中可用)
4.建议选择使用 README 初始化此存储库

二、配置博客

copy GitHub博客仓库的地址 https://username.github.io/MyBlog
在博客根目录下的 _config.yml 中配置 GitHub 仓库地址(博客部署/访问的地址)

1.博客部署地址相关配置

url: https://username.github.io/
root: /BlogName
permalink: :title/
permalink_defaults:
pretty_urls:
  trailing_index: true # 是否在永久链接中保留尾部的 index.html,设置为 false 时去除
  trailing_html: true # 是否在永久链接中保留尾部的 .html, 设置为 false 时去除 (对尾部的 index.html无效)
# 配置博客静态文件部署地址,分支
deploy:
  type: git
  repo: git@github.com: username/BlogName
  branch: gh-pages

2.博客样式相关配置

# 中文链接转拼音
permalink_pinyin:
  enable: true
  separator: '-'

# 添加emoji表情支持
githubEmojis:
  enable: true
  className: github-emoji
  inject: true
  styles:
  customEmojis:

# 博客搜索
# 安装搜索插件:npm install hexo-generator-search --save
search:
  path: search.xml
  field: post

# 安装动画插件:npm install live2d-widget-model-z16 -D
# 安装具体的动画人物:npm install --save hexo-helper-live2d 
# 配置博客动漫人物(动画跟不蒜子统计会有冲突,建议两者不要一起使用)
live2d: 
  enable: true 
  scriptFrom: local 
  pluginRootPath: live2dw/ 
  pluginJsPath: lib/ 
  pluginModelPath: assets/ 
  tagMode: false 
  log: false 
  model: 
    use: live2d-widget-model-tororo # live2d-widget-model-shizuku # live2d-widget-model-z16
  display: 
    position: right 
    width: 150 
    height: 300 
  mobile: 
    show: true 
    react: 
      opacity: 0.7

其他的一些配置根据主题,可能会有些略微不同,大家参考主题下的 README_CN.md 说明文件配置就好啦!

三、上传部署博客

1.将本地的 myblog 与 GitHub仓库关联(配置ssh),将代码提交到仓库的 master分支下
2.在博客仓库下新建 gh-pages 分支,用来存储博客编译后要部署的静态文件
3.在仓库下配置发布源 Settings => Pages 在 GitHub Pages 下设置发布源分支 gh-pages
4.在 _config.yml 中配置博客部署信息

配置博客部署信息

deploy:
  type: git
  repo: git@github.com:username/MyBlog
  branch: gh-pages

search:
  path: search.xml
  field: post

配置好之后,重新构建博客生成静态文件并部署到 GitHub Pages

$ npx hexo clean
$ npx hexo g
$ npx hexo d

部署成功之后就可以直接访问你的博客啦!
https://username.github.io/MyBlog


文章作者: nzgl
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 nzgl !
评论
  目录