主页
文章
分类
系列
标签
关于
避坑指南
发布于: 2022-11-14   更新于: 2022-11-14   收录于: web
文章字数: 543   阅读时间: 2 分钟   阅读量:

关于使用主题的一些问题汇总。

  1. 当开启 hugo server 预览网站时,修改文件并刷新网站后不能达到预期效果,在浏览器里查看源代码发现还是之前的代码,并不是修改后的代码(一般是修改 js 或者 css 后会有这种问题,但也并不是每次刷新都会有。总之,如果修改原文件(图片等)后没有刷新都可以采用以下方法)。

success 方法1:浏览器强制刷新,Mac:Command + Shift + R,Windows:Ctrl + Shift + R

success 方法2:关闭hugo server,再重新开启,再刷新网站。

这里不推荐通过设置浏览器禁用缓存或者其他自动清理缓存的脚本,这些方法每次刷新时都会重新下载源文件,所以会有点耗时,而在调试阶段又需要经常刷新,如果每次刷新都要多等上几秒,还是挺难受的。这里还是推荐上述方法,按需使用。

  1. 下载完主题,hugo.toml文件里的theme参数也已经改成'NewBee',可还不能使用主题

success 一般从 github 下载完主题后,文件名是NewBee-main,复制到/themes文件夹后,请重命名为NewBee

  1. 侧边栏作者头像显示不全

success 头像图片尺寸请保持 1:1 的比例。

  1. 写文章时某些字符被错误渲染

success 使用转义符\,详情请移步:Markdown 转义字符语法。

  1. 语法高亮有显示问题

success 浅色模式对syntax.css进行修改,深色模式则修改syntax-dark.css