hexo部署到github的一些问题与解决

0. 关于”部署”的官方说明

  • hexo部署到GitHub上的官方说明（中文）
    英文说明
  • 步骤要点：
    • 安装 npm install hexo-deployer-git –save
    • 编辑 _config.yml
    • 部署 hexo clean && hexo deploy # 其实可以直接 hexo g -d
  • 注意事项：
    • 这一切是如何发生的？
      当执行 hexo deploy 时，Hexo会 将 public目录中的文件和目录
      推送至 _config.yml 中指定的 远端仓库和分支中，并且完全覆盖该分支下（默认为master）的已有内容。
    • hexo默认使用master分支（请确认你的仓库默认分支是否为master）。若需要改为其他分支，需要在_config.yml的deploy参数选项下进行指定。

1. 新建的GitHub仓库名，必须按以下格式：

1
2
3
4
5
固定格式：username.github.io  # 比如，我的 ArchiLanter.github.io

# 注1：必须是同名，并且加上后面的 github.io
# 注2：该仓库名就是最后你的博客访问域名，所以大小写不要紧，但必须"同名"。


2. 编辑_config.yml时，要注意

要注意：Win10系统，应该用仓库的SSH地址，如下面这样

1
2
3
4
5
deploy:
  type: git
  repo: git@github.com:ArchiLantern/ArchiLantern.github.io.git
  branch: master  #默认即master；请按需指定。

注：
Mac等系统，可能用https的仓库地址就可以了。
若不行，可以参考这篇文章的几种方式。


3. hexo deploy (简写 hexo d) 时

  • 注意输入 正确的用户名和密码

4. 部署成功后，访问https://你的username.github.io/

  • 这是你可能发现，博客还没能正常启动（旧版GitHub可能可以了）
  • 新版GitHub，还要求你要选择一个”页面主题”。根据页面提示，点击根据它的”read the full documentation“中的说明 QuickStart for Github Pages，进行相关操作即可。
    • 如 该博客仓库的 Settings -> Pages -> Choose a theme

5. 更新博客和部署到远端仓库，需要稍等1分钟，再刷新

  • 如，你在本地新建一篇博文，即 
    1
    hexo -n "xxx新博文"
  • 然后，你修改满意后，可以用下面一条命令生成和部署到GitHub 
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    hexo deploy -g    # 简写：hexo d -g
    # 或者
    hexo generate -d  # 简写：hexo g -d

    # 若有比较多的文件和缓存生成，可以先 执行 
    hexo clean     # Remove generated files and cache.

    # 所以，合起来，即
    hexo clean ; hexo g -d

    这样仓库就会有更新了。博客则要稍等一下。
  • 最后，稍等一分钟，刷新或访问你的 博客地址即可。

主要参考：