内容管理

静态文件

默认情况下，网站项目中的 static/ 目录用于存放所有 静态文件（例如样式表、JavaScript、图片）。这些静态文件将在网站根路径上提供服务（例如，如果您有文件 static/image.png，可以使用 http://{服务器URL}/image.png 访问它，在文档中引用它可以使用 ![示例图片](/image.png)）。

Hugo可以通过配置 站点配置 中的 staticDir 参数来查找不同的目录，甚至可以为这些静态文件配置多个目录。所有静态目录中的所有文件都将形成一个联合文件系统。

这个联合文件系统将从您的网站根路径提供服务。因此，文件 <站点项目>/static/me.png 将可以通过 <我的基本URL>/me.png 访问。

以下是一个为多语言网站设置 staticDir 和 staticDir2 的示例：

hugo.
      
languages:
  en:
    baseURL: https://example.org/
    languageName: English
    staticDir2: static_en
    title: In English
    weight: 2
  "no":
    baseURL: https://example.no
    languageName: Norsk
    staticDir:
    - staticDir_override
    - static_no
    title: På norsk
    weight: 1
staticDir:
- static1
- static2

staticDir = ['static1', 'static2']
[languages]
  [languages.en]
    baseURL = 'https://example.org/'
    languageName = 'English'
    staticDir2 = 'static_en'
    title = 'In English'
    weight = 2
  [languages.no]
    baseURL = 'https://example.no'
    languageName = 'Norsk'
    staticDir = ['staticDir_override', 'static_no']
    title = 'På norsk'
    weight = 1

{
   "languages": {
      "en": {
         "baseURL": "https://example.org/",
         "languageName": "English",
         "staticDir2": "static_en",
         "title": "In English",
         "weight": 2
      },
      "no": {
         "baseURL": "https://example.no",
         "languageName": "Norsk",
         "staticDir": [
            "staticDir_override",
            "static_no"
         ],
         "title": "På norsk",
         "weight": 1
      }
   },
   "staticDir": [
      "static1",
      "static2"
   ]
}

在上面的示例中，未使用任何主题：

  • 英语网站将获取由 “static1”、“static2” 和 “static_en” 组成的联合静态文件。在文件重复的情况下，以最右边的版本为准。
  • 挪威语网站将获取由 “staticDir_override” 和 “static_no” 组成的联合静态文件。
Note 1
staticDir2 中的 2（可以是 0 到 10 之间的数字）是为了告诉 Hugo 您想要将该目录 添加 到使用 staticDir 定义的全局静态目录集中。在语言级别使用 staticDir 将替换全局值（可以看到在挪威语网站上的情况）。
Note 2
上述示例是一个 多主机设置。在常规设置中，所有静态目录将对所有站点都可用。

See also

Last updated: November 23, 2023: first release (332dc4cd7)
Improve this page