Структура каталогов

Скелет нового сайта

Запуск генератора hugo new site из командной строки создаст структуру каталогов со следующими элементами:

.
├── archetypes
├── config.toml
├── content
├── data
├── layouts
├── static
└── themes

Объяснение структуры каталогов

Ниже приводится общий обзор каждого из каталогов со ссылками на каждый из соответствующих разделов в документации Hugo.

archetypes

Вы можете создавать новые файлы содержимого в Hugo, используя команду hugo new. По умолчанию Hugo будет создавать новые файлы содержимого с как минимум date, title (выводится из имени файла) и draft = true. Это экономит время и обеспечивает единообразие для сайтов, использующих несколько типов контента. Вы также можете создавать свои собственные архетипы с настраиваемыми предварительно настроенными полями вступительного документа.

assets

Хранит все файлы, которые необходимо обработать Hugo Pipes. В каталог public будут опубликованы только те файлы, для которых используются файлы .Permalink или .RelPermalink. Примечание: каталог ресурсов по умолчанию не создается.

config

Hugo поставляется с большим количеством директив конфигурации. В каталоге конфигурации эти директивы хранятся в виде файлов JSON, YAML или TOML. Каждый объект корневых настроек может быть отдельным файлом и структурирован по средам разработки. Проекты с минимальными настройками и не требующими внимания к среде могут использовать один файл config.toml в своем корне.

Многим сайтам может потребоваться небольшая настройка или вообще ее не нужно, но Hugo поставляется с большим количеством [директив конфигурации][] для более подробных указаний о том, как Вы хотите, чтобы Hugo создавал Ваш сайт. Примечание: по умолчанию каталог config не создается.

content

Весь контент Вашего сайта будет находиться внутри этого каталога. Каждая папка верхнего уровня в Hugo считается раздел содержимого. Например, если на Вашем сайте три основных раздела — blog, articles и tutorials — у Вас будет три каталога в content/blog, content/articles и content/tutorials. Хьюго использует разделы для назначения по умолчанию типов контента.

data

Этот каталог используется для хранения файлов конфигурации, которые могут быть использованы Хьюго при создании Вашего сайта. Вы можете записать эти файлы в формате YAML, JSON или TOML. В дополнение к файлам, которые Вы добавляете в эту папку, Вы также можете создавать шаблоны данных, которые извлекаются из динамического содержимого.

layouts

Сохраняет шаблоны в виде файлов .html, которые определяют, как представления Вашего контента будут отображаться на статическом веб-сайте. Шаблоны включают страницы списков, Вашу домашнюю страницу, шаблоны таксономии, частичные, одностраничные шаблоны и многое другое.

static

Хранит весь статический контент: изображения, CSS, JavaScript и т.д. Когда Hugo создает Ваш сайт, все ресурсы внутри Вашего статического каталога копируются как есть. Хороший пример использования папки static для подтверждения права собственности на сайт в Google Search Console, где Вы хотите, чтобы Хьюго скопировал полный HTML-файл без изменения его содержимого.

resources

Кеширует некоторые файлы для ускорения генерации. Может также использоваться авторами шаблонов для распространения встроенных файлов SASS, поэтому Вам не нужно устанавливать препроцессор. Примечание: каталог ресурсов по умолчанию не создается.