Skip to content

Hugo Narrow 支持多种方式引入本地资源如图像:

  • 页面资源(markdown 文件所在目录下)
  • 全局资源(assets 目录下)
  • 静态资源(static 目录下)

TIP

Hugo Narrow 本地资源查找遵循以下顺序:页面资源 > 全局资源 > 静态资源

页面资源

页面资源是指与 Markdown 文件位于同一目录下的资源文件。这是最推荐的图像资源管理方式。

bash
content/
└── posts/
    ├── post-1.md
    ├── post-1.zh-cn.md
    └── post-2/
        ├── index.md
        ├── index.zh-cn.md
        ├── featured.jpg
        └── gallery/
            ├── image-1.jpg
            └── image-2.jpg

在 Markdown 中引用:

markdown
![](featured.jpg)
![](gallery/image-1.jpg)
![](gallery/image-2.jpg)

NOTE

访问 Hugo 文档 了解更多细节。

全局资源

全局资源是放置在站点根目录下的 assets 文件夹: ~/assets/,放置在这个文件夹下的资源在构建时被 Hugo 处理。

bash
my-site/
├── assets/
   └── images/
       └── hero.jpg
├── content/
└── themes/
    └── hugo-narrow/

在 Markdown 中引用:

markdown
![](images/hero.jpg)

NOTE

访问 Hugo 文档 了解更多细节。

静态资源

静态资源是放置在站点根目录下的 static 文件夹: ~/static/,放置在这个文件夹下的资源在构建时不会被 Hugo 处理。

bash
my-site/
├── static/
   └── images/
       └── hero.jpg
├── content/
└── themes/
    └── hugo-narrow/

在 Markdown 中引用:

markdown
![](/images/hero.jpg)

NOTE

访问 Hugo 文档 了解更多细节。

引用区别

位置引入方式
页面资源~/content/posts/post-1/featured.jpgfeatured.jpg
全局资源~/assets/images/featured.jpgimages/featured.jpg
静态资源~/static/images/featured.jpg/images/featured.jpg

NOTE

其中 images 路径不是必须,可以自行更改。