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
,问题解决。