Создание сайта на Hugo

Быстрое развертывание сайта на GitHub Pages с помощью генератора статического html Hugo.

1 Установка программного обеспечения для Hugo

1.1 Необходимое программное обеспечение

• Необходим сам hugo.
• Есть две сборки: Hugo и Hugo Extended.
• Hugo Extended отличается от Hugo поддержкой SASS/SCSS.
• Часть тем (например, Wowchemy — Hugo. Шаблон для научных работников) требует наличия Hugo Extended.
• Поскольку hugo использует модули golang, то следует установить и его.
• Также может понадобиться NodeJS.

1.2 Установка в различных операционных системах

1.2.1 Linux

• Ubuntu:

  sudo apt-get install go hugo
  

• Fedora:

  sudo dnf install go hugo
  

• Gentoo:

  emerge dev-lang/go net-libs/nodejs dev-vcs/git
  USE="sass" emerge www-apps/hugo
  

1.2.2 Windows

• Chocolatey:

  choco install hugo-extended git go nodejs
  

• Scoop:

  scoop install hugo-extended git go nodejs
  

1.2.3 Ручная установка

• Если устанавливаемая в системе версия hugo меньше необходимой, тогда следует установить программу вручную.
• Версию hugo можно посмотреть при помощи команды:

  hugo version
  

• Следует скачать архив с репозитория: https://github.com/gohugoio/hugo/releases

1.3 Видео: Программное обеспечение для Hugo

2 Структура сайта

• Будем считать, что сайт находится в локальном каталоге:

  ~/work/blog/blog
  

• Структура сайта
  • archetypes Каталог, содержащий шаблоны новых md-файлов, которые создаёт Hugo с помощью команды hugo new.
  • config.toml Основной конфиг сайта
  • content Каталог данных, из которых Hugo будет генерировать сайт
  • data Каталог дополнительных данных, которые непосредственно не участвуют в генерации сайта
  • docs Корень генерируемого сайта. Этот каталог не создается Hugo, мы его получили при заведении репозитория на GitHub и ниже мы его пропишем в файле config.toml
  • layouts Содержит шаблоны сайта
  • static Каталог для статических данных (изображения, CSS, JavaScript и т.д.)
  • themes Каталог для тем оформления сайта

3 Установка темы (внешнего вида) сайта

3.1 Видео: Установка темы сайта Hugo

4 Настройка сайта

5 Публикация сайта

• Hugo. Развёртывание на базе страниц GitHub

6 Добавление контента

• Org-roam. Экспорт в Hugo