Статические файлы

По умолчанию каталог static/ в проекте сайта используется для всех статических файлов (например, таблиц стилей, JavaScript, изображений). Статические файлы обслуживаются по корневому пути сайта (например, если у Вас есть файл static/image.png, Вы можете получить к нему доступ, используя http://{server-url}/image.png, чтобы включить его в документ, который Вы можете использовать ![Example image](/image.png) ).

Hugo можно настроить так, чтобы он просматривал другой каталог или даже несколько каталогов для таких статических файлов, настроив параметр staticDir в конфигурации сайта. Все файлы во всех статических каталогах образуют объединенную файловую систему.

Эта объединенная файловая система будет обслуживаться из корня Вашего сайта. Таким образом, файл <SITE PROJECT>/static/me.png будет доступен как <MY_BASEURL>/me.png.

Вот пример установки staticDir и staticDir2 для многоязычного сайта:

languages:
  en:
    baseURL: https://example.com
    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.com"
    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.com",
         "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”.

Примечание 1

2 (может быть числом от 0 до 10) в staticDir2 добавляется, чтобы сообщить Хьюго, что вы хотите добавить этот каталог в глобальный набор статических каталогов, определенных с помощью staticDir. Использование staticDir на уровне языка заменит глобальное значение (как видно на примере норвежского сайта).

Примечание 2

Приведенный выше пример - установка нескольких хостов. При обычной настройке все статические каталоги будут доступны для всех сайтов.