Hugo使用记录

Posted by zengchengjie on Tuesday, February 8, 2022

hugo使用命令记录

  • 新建站点:

    • hugo new mysite

    • cd mysite

    • hugo new about.md

    • hugo new post/first.md (在hugo项目目录下执行)

    • 启动: Hugo server -t hugo-theme-cleanwhite

      或者:Hugo server –theme=hyde –buildDrafts –watch

    • 浏览器打开:http://localhost:1313 (在本地修改的文件保存后页面上会实时显示修改的内容)

  • 图片上传建议使用ipic或者其他图床工具上传图片链接,若使用本地文件则会引起跨平台阅读文件的不便问题。

问题1:post文件中的标题,如果带有特殊字符,如+号,则本地没有问题,发布线上以后会有异常问题,点击博客后显示404

问题2:config.toml文件中,配置featured_tags模块,按照作者的解释,如果featured_condition_size=1则需要一篇文章使用后才能显示,其实不是,应该是1篇以上的文章使用过才会显示到页面中

出现的问题

代码高亮问题

使用主题cleanWhite Hugo theam,出现本地代码高亮,但是发布后代码并没有高亮,像作者提了issue,作者建议升级hugo版本至0.71.4后生效,其实就是vercel上默认的hugo版本过低造成的,升级至最新版本即可,目前最新版本为0.92.1

draft:true不生效
  • 现象

文章中设置了draft: true,本地hugo server不会看到该文章出现在本地调试的博客中,通过Vercel部署后文章出现在线上的站点中。

  • 原因

有关Vercel对Hugo的处理,可以看看这篇官方文章

打开Vercel项目的settings,可以看到Build & Development Settings下的hugo指令带有-D参数,这个参数会忽略draft这个标记,导致为编辑完的草稿也被编译、出现在博客中。

  • 解决
选项
BUILD COMMAND hugo

开启BUILD COMMAND中的OVERRIDE按钮,手动修改编译命令,由于我的hugo没有其他额外的依赖,直接改成hugo,问题解决。

解决方案参考