Старт

Быстрый старт

Для тех, кто впервые создаёт проект статического вебсайта и использует Hugo в качестве генератора, приводим простейшую последовательность действий.

Установить Hugo

Прочтите о том, как установить Hugo. Выберите подходящий вариант и выполните необходимые действия.

Создать структуру

Для создания начальной структуры будущего вебсайта:

В локальной файловой системе выберите место расположения будущего проекта.
Создайте каталог нового проекта my-site и перейдите в него.

hugo new site my-site

Hugo автоматически создаст:

каталог my-site
все необходимые подкаталоги.

Описание первичной и дополнительной структуры вебсайта приведено в справочнике Hugo.

Установить тему

На официальном вебсайте Hugo можно найти почти тысячу различных тем.

Если тема выбрана, её следует установить. Например, установим тему Ananke.

cd my-site
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke

Команда Git загрузит все необходимые файлы в каталог theme/ananke и выдаст сообщение похожее на:

Получение объектов: 100% (4070/4070), 6.26 МиБ | 13.73 МиБ/с, готово.
Определение изменений: 100% (1967/1967), готово.

Настроить вебсайт

На предыдущем шаге вы уже перешли в корневой каталог проекта ‘my-site’.
Откройте файл настройки в любом удобном текстовом редакторе:

nano hugo.toml

Измените заполнители строк на собственные значения:

(обязательно) для переменной baseURL указать URL адрес будущего вебсайта;
(обязательно) для переменной languageCode указать основной язык текстов будущего вебсайта;
(обязательно) для переменной title указать наименование будущего вебсайта;
(необязательно) если принято решение об использовании темы, следует указать наименование темы.

Пример:

baseURL = 'https://example.ru/'
languageCode = 'ru-RU'
title = 'Мой новый сайт'
# Наименование темы
theme = 'ananke'

Проверить отсутствие ошибок в настройках:

hugo --gc

Если сообщений ERROR нет, значит всё установлено и настроено нормально.

Добавить вебстраницу

Все вебстраницы следует помещать в каталог content.

Добавьте главную страницу:

hugo new content content/_index.md

Откройте созданную вебстраницу в любом текстовом редакторе.

nano content/_index.md

Вы увидите метаданные, которые Hugo добавил автоматически.

content/_index.md

+++
date = '2025-09-26T20:46:26+03:00'
draft = true
title = ''
+++

Добавьте наименование страницы в значение title.

content/_index.md

+++
date = '2025-09-26T20:46:26+03:00'
draft = true
title = 'Главная страница'
+++

Обратите внимание!

Hugo создаёт новые вебстраницы как черновики (draft=true). Эти черновики Hugo не включает в состав публикуемого вебсайта. Для перевода черновика в статус публикации следует сменить значение на: draft=false (не черновик).

Ниже метаданных введите содержание страницы в формате Markdown.

content/_index.md

+++ 
date = '2025-09-26T20:46:26+03:00'
draft = false
title = 'Главная страница'
+++

## Приветствие

Привет Веб!

Читайте [свежие новости!](news)

Сохраните изменения файла и выйдите из редактора.
Добавьте вебстраницу новостей (news.md).

hugo new content content/news.md

Отредактируйте созданную вебстраницу:

Откройте в редакторе:

nano content/news.md

И внесите изменения:

content/news.md

+++ 
date = '2025-09-26T20:46:26+03:00'
draft = true
title = 'Новости'
+++

## Свежие новости

Первая свежая новость.

Сохраните изменения файла и выйдите из редактора.

В результате получили следующую структуру нового проекта.

━━■ Каталог проекта
	┣━■ archetypes
	┣━■ content
	┃   ├─□ _index.md
    ┃   └─□ news.md
	┣━■ data
	┣━■ layouts
	┣━■ data
	┣━■ static
	┣━■ public
	┣━■ resources	
	┣━■ themes
	┃   └─□ ananke
	┗─□ hugo.toml

Для просмотра черновиков следует запустить одну из следующих команд:

hugo server --buildDrafts
hugo server -D

Проектная версия вебсайта доступна в браузере по адресу: http://localhost:1313.

Опубликовать сайт

Для генерации публикуемой версии вебсайта выполните:

hugo --gc --minify

Содержимое готового сайта будет размещено в каталоге public. Это содержимое развёртывают (копируют) на сервере хостинга.

Первый вебсайт готов!