很早以前发现 hugo server 命令在本地预览时不能显示相文章相对路径下的图片。但是普通web服务器是可以显示的一直都不知道是什么原因，之前也曾花费大量时间翻遍整个hugo论坛，也没有找到解决方案，因为我的 emacs 可以直接预览图片，发布后也能正常显示图片，后来也就不去管它了。但是今天非常偶然的发现原来 hugo server 也可能预览相对路径的下图片。
目前我的文章目录结构如下：
$ tree content/
content/
|-- about.org
`-- posts
`-- Tech
|-- checksum-offload.org
|-- cpu.org
|-- cpu.assets
| |-- core-threads-283x300.jpg
| |-- cores-hand.jpg
| |-- cpu-with-cores.png
| |-- logical-cpu.png
| |-- mainboard-notes.jpg
| |-- mainboard.jpg
| |-- quad-core-processor.jpg
| |-- quad_core_hyperthreading_cpu.png
| |-- single-core-ht.png
| `-- socket-cpu-cores.png
|-- debian.org
`-- x230i.org
如果文章有配图，那么图片资源就会存储到相应的资源目录中，比如文章名称是 cpu.org ，那么资源目录就是 cpu.assets , 在文章中引用图片就可以用相对路径来实现如 ./cpu.assets/mainboard.jpg 。
网上好多都是先把图片上传到图床，然后获取图片的绝对链接再插入文章中。这种情况其实有一些弊端，比如不联网的情况下，就无法预览图片，如果图床挂了，想要迁移文章的图片那就非常困难。而原始文章用相对图片，发布时候可以根据需要采用本地图片，或者是动态替换成指定的图床链接。
大多数情况， 我都是通过命令 =hugo server= 来启动服务，然后通过打 http://localhost:1313 来预览内容，这种情况下却不能显示相对路径下的图片。
今天忽然想看看到底是什么原因导致 =hugo= 不能预览相对路径下的图片，简单看了下 hugo 的参数，发现有 --debug 选项，那么就试一下，看看浏览器请求不到图片的时候 hugo 是不是什么什么报错的日志吧，于是我就用命令 hugo server -debug 来启动 hugo 然后打开浏览器，这个时候，神奇的事情发生了，相对图片竟然显示出来了。而 hugo 程序，并没有任何特殊的输出，这个时候我把 hugo 停掉，又重新输入一遍，并且加上了 -v 参数 hugo server --debug -v , 启动的过程中，明显多输出了一些信息，这个时候我再打开浏览器，刷新页面，突然发现加了 -v 参数后，图片竟然又不显示了。这是什么情况？然后我又把 =-v= 参数去掉，再次输入 hugo server --debug 这个时候，再刷新浏览器，发现图片依然不显示。这就奇怪了，怎么会有这样情况呢？
我翻了一下自己的命令记录，发现了一个问题，那就是我第一次输命令的时候， deubg 前面应该有两个减号 - 结果我输入成了一个，这就变成了 hugo server -debug 和 hugo server --debug 的区别。那么 -debug 和 --debug 有什么区别呢？
-d, --destination string filesystem path to write files to
--debug debug output
原来 -debug 的意思是 -d 选项后接 ebug 这个参数。指定了这个参数后， hugo server -debug 会有一个提示：
Serving pages from D:\Home\nBox\blog.leenzhu.com\ebug
一开始以这个先项有点类似于设定web服务的root目录，但是我本地不存在 =ebug= 这样的目录，我后来又试了在 =-d= 接其它的内容：
hugo server -de
hugo server -dx
hugo server -d.
hugo server -dpublic
发现无论指定什么字符串都没有任何影响，网页浏览正常，图片显示正常。后来打开目录才发现，原来 -d 的作用就是把网站临时发布到其指定的目录中，大概是不指定 -d 先项的情况下，页面的渲染都是在内存中的，所有内存中只有页面数据，不是会有页面同目录的资源数据，而指定渲染目录后， hugo 会把相关资源以及渲染结果都输出到指定目录中，然后以这个目录为 web 服务的根目录，这样就可以正常显示所有相关资源了。
至少目前为止我需要功能能满足了，其它就不管了，也算是一个意外的收获了。
- 附（<2022-11-16 Wed>）
今天测试发现图片竟然不能显示了。发现原来启用 uglyurls = true 和不启用，文件的布局是不一样的。所以除了指定 =-d= 选项外，还需要配置 uglyurls=true