Установить

Установить или демонтировать Hugo

Редакции приложения Hugo

Hugo доступен в трёх редакциях:

стандартной, представляющей основные функции;
расширенной, в которой к основным функциям добавлены дополнительные;
расширенной и развёртываемой, в которой к расширенной версии добавлены функции развёртывания в облачных сервисах Google Cloud Storage, AWS S3, Azure Storage.

Для совсем простых вебсайтов достаточно стандартной редакции. Для всех остальных — расширенной редакции.

Встроенные функции Hugo, позволяющие развёртывать вебсайт в облачных сервисах Google Cloud Storage, AWS S3, Azure Storage для российских компаний нецелесообразные, а порой неприменимые. Для развёртывания статического вебсайта в сервисах российского хостинга следует писать собственные скрипты.

Начальный набор программ

Обычно совместно с Hugo используют:

Git — приложение управления версиями;
Go — язык программирования;
Dart Sass — язык проектирования стилей CSS.

Настоятельно рекомендуем установить эти программы.

Приложение управления версиями Git применяют для:

сборки Hugo из исходного кода;
установки и управления модулями Hugo;
установки темы вебсайта как модуля Git;
доступа вебсайта к данным локального репозитория Git;
размещения вебстайта в сервисах CloudCannon, Cloudflare Pages, GitHub Pages, GitLab Pages и Netlify.

Язык программирования Go применяют для:

сборки Hugo из исходного кода;
использования модулей Hugo.

Язык Dart Sass используют для проектирования стилей CSS.

Установить рекомендованные программы

Первым следует установить Dart Sass, а только затем остальные пакеты. Дело в том, что в режиме проектирования (development mode) в определённых платформах возникают конфликты окружения. Опыт показал, что гораздо проще первым установить Dart Sass, чем потом искать причину конфликта и восстанавливать работоспособность стека приложений.

Самый простой способ установки Dart Sass в GNU/Linux — это использовать управление пакетами Snap

sudo snap install dart-sass

Установить Git и Go можно из репозитория GNU/Linux. В новейших версиях нет необходимости и вполне подойдут стабильные версии.

sudo apt install git-all
sudo apt install golang -y

Из репозитория Snap установить Go можно

sudo snap install --classic go

Установить Hugo

Существуют следующие способы установки подходящей версии Hugo:

вручную установить готовые файлы;
использовать управление пакетами Snap;
вручную компилировать Hugo из исходных кодов;
установить пакет из репозитория дистрибутива GNU/Linux.

У каждого способа есть свои достоинства и недостатки. Однако при сопоставлении их между собой можно сделать выводы о том, что:

Пакет Hugo из дистрибутивов GNU/Linux неработоспособны, т.к. слишком устарели. Для проектирования необходима самая последняя стабильная версия Hugo. В противном случае возникнут ошибки в модулях и темах.
Ручная установка пакета или компилирование приложения Hugo из исходных кодов не позволяет автоматически обновлять пакет. Довольно быстро Hugo устареет, возникнут конфликты с новейшими модулями, темами, плагинами и т.п. Ручная установка потребует регулярного ручного обновления.
Cамый удобный в настоящее время способ установки и автоматического обновления — управление пакетами Snap.

Установить готовые файлы

На официальном вебсайте Hugo в разделе Assets доступны готовые исполняемые файлы для различных операционных систем и архитектур. Они уже откомпилированы. Для установки:

Выберите подходящую архитектуру и требуемую редакцию. Рекомендуем выбирать расширенную редакцию, файлы с наименованием hugo_extended.
Загрузите установочный пакет.
Распакуйте архив.
Скопируйте распакованные файлы в любой удобный каталог.
Проверьте права доступа к каталогу с Hugo.
Добавьте путь к каталогу с Hugo в переменные окружения PATH.

О том, как изменить переменные окружения смотрите в документации используемой операционной системы. Пример для Debian GNU/Linux:

Скопировать установочные файлы Hugo в каталог ~/bin/hugo.
Открыть в редакторе файл настройки (в зависимости от редактора файл ~/.bash_profile, ~/.bashrc, ~/.zshrc).
Добавить или продолжить существующую строку:

export PATH=$PATH:~/bin/hugo

Сохранить файл.
Перезагрузить терминал (закрыть и открыть заново). Или запустить команду:

source ~/.bashrc

Компилировать из исходных кодов

Прежде чем собирать приложение Hugo:

Установите приложение управления версиями Git.
Установите язык программирования Go.
Установите компилятор языка C. Например GCC или Clang.
Обновите переменные окружения для языков C и Go как это указано в документации(https://go.dev/doc/code#Command).

Важно! Переменные окружения GOPATH и GOBIN указывают на каталог установки Hugo. Если задана переменная GOBIN исполняемые файлы размещают непосредственно в указанный каталог. Если задана переменная GOPATH, исполняемые файлы размещают в подкаталог /bin верхнего каталога в списке GOPATH.

Для компилирования приложения в стандартной редакции:

go install github.com/gohugoio/hugo@latest

Для компилирования приложения в расширенной редакции:

CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@latest

Установить с помощью Snap

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

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

Команда установки расширенной версии Hugo:

sudo snap install hugo

Для того, чтобы включить автоматическое обновление следует добавить:

sudo snap refresh --unhold hugo

Для отключения автоматического обновления:

sudo snap refresh --hold hugo

Проверить установку

Проверьте отсутствие ошибок установки. Наберите команды:

git version
go version
hugo version

Все программы должны выдать номера установленной версии.

Дополнительно для проверки установки Hugo из репозитория snap выполните команду:

which hugo

Команда отобразит путь к установленному пакету: /snap/bin/hugo.

Демонтировать приложения

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

Демонтаж Go

Процедура демонтажа пакета с языком Go из операционный системы GNU/Linux зависит от способа установки.

Если пакет Go установлен из репозитория, то следует выполнить команду:

sudo apt purge --auto-remove golang-go

Команда purge удалит не только пакет, но и файлы настройки.

Флаг auto-remove удалит все автоматически установленные программы, связанные с Go.

Если пакет Go установлен вручную, следует удалить вручную не только пакет, но и переменные окружения. Обычно Go устанавливают в каталог ‘/usr/local/go’:

sudo rm -rf /usr/local/go

Для удаления рабочего пространства Go выполнить:

rm -rf ~/go

Демонтаж Git

Если пакет Git установлен из репозитория, то следует выполнить команду:

sudo apt purge --auto-remove git

Команда purge удалит не только пакет, но и файлы настройки.

Флаг auto-remove удалит все автоматически установленные программы, связанные с Git.

Демонтаж Hugo

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

Удалить переменную окружения PATH.
Удалить каталог Hugo и всё его содержимое.

Для удаления установленного в Snap пакета выполнить команду:

snap list
sudo snap remove hugo

Настроить