Hugo + Github Pages 踩坑指南
记录一下本人在使用Hugo + Github Pages搭建个人网站过程中的诸多困难
  • 记录一下本人在使用Hugo + Github Pages搭建个人网站过程中的诸多困难。
  • 开发环境: Ubuntu 18.04 in WSL2

安装

Deploy到Github Pages

  • 最初按照官方指南所讲述的方法配置了[actions-gh-pages],放在另外一个repositoryHugoSiteBlog当中。能观察到,部署等步骤都一切正常,通过所有检查,但是进入根目录却只有404页面
  • 解决方法是使用hugo命令生成静态页面后(存放在./public文件夹中),将该文件夹推送到个人页面仓库username.github.io当中,即可正常访问。(参考:https://w01fb0ss.github.io/2020/010/ )

无法加载CSS格式

  • 使用的theme为“diary”
  • 在本地使用hugo server生成的网页格式一切正常,但是上传到github.io后不能正常显示,检查网页后发现错误如下:
Mixed Content: The page at 'https://magshadow.github.io/' was loaded over HTTPS, but requested an insecure stylesheet 'http://magshadow.github.io/scss/dark-mode.min.c0082f0b082177f6fb3768ff91439a097de49689bd26f4d49f76d94ebb81e02d.css'. This request has been blocked; the content must be served over HTTPS.
  • 仔细检查后,将’config.toml’中的baseURLhttp改为https,即解决问题

WSL2无法访问本地页面

插入图像

  • 使用![image](/XX/image.jpg),需将图像文件保存在'/static/XX’文件夹下。
  • 自动适配网页宽度,但没有标题

Last modified on 2021-07-16