Key

範例

假設這是網站配置:

hugo.
     
baseURL: https://example.org/docs/
baseURL = 'https://example.org/docs/'
{
   "baseURL": "https://example.org/docs/"
}

以及這段範本:

  {{ with resources.Get "images/a.jpg" }}
    {{ with resources.Copy "foo/bar/b.jpg" . }}
      {{ .Key }} → foo/bar/b.jpg

      {{ .Name }} → images/a.jpg
      {{ .Title }} → images/a.jpg

      {{ .RelPermalink }} → /docs/foo/bar/b.jpg
    {{ end }}
  {{ end }}

我們使用 resources.Copy 函數來更改發佈路徑。Key 方法返回更新後的路徑,但請注意,它與 RelPermalink 返回的值不同,因為 RelPermalink 值包含網站配置中 baseURL 的子目錄部分。

Key 方法對於當你需要在不發佈資源的情況下獲取資源的發佈路徑時非常有用。與 PermalinkRelPermalinkPublish 方法不同,調用 Key 不會發佈資源。