Перейти к содержанию
ERITKOM
ВебНовость

Hugo 0.170.0 убрал Extended и встроенный LibSass: что меняется в сборке сайтов

Обновление от 13 ноября меняет выбор пакета и обработку Sass. Редакция deploy сохраняется, а параметры командной строки теперь имеют приоритет над переменными окружения.

Ноутбук с кодом стилей на архивной фотографии: тематическая иллюстрация веб-разработки, не экран Hugo 0.170.0
Negative Space, ноутбук с программным кодом, CC0 1.0. Архивная тематическая фотография, не экран или результат испытания Hugo 0.170.0. Изменены размер и формат JPEG→WebP.

Extended больше не служит признаком доступных возможностей

Разработчики Hugo выпустили версию 0.170.0 13 ноября. Из генератора статических сайтов удалён встроенный LibSass, ради которого ранее требовалась отдельная Extended-сборка с поддержкой CGO. Остальные возможности прежней расширенной редакции не исчезают вместе с её названием.

Обычная публикация архивов hugo_extended прекращается. Для наиболее востребованных имён разработчики оставляют совместимые псевдонимы, чтобы не оборвать часть существующих CI-сценариев, но рекомендуют заменить ссылки в скриптах. Это не обещание сохранить любой прежний вариант имени или архитектуры. Сборки extended_withdeploy тоже удалены.

Есть изменение и для шаблонов: hugo.IsExtended теперь всегда возвращает false, а требование hugoVersion.extended в настройках модуля устарело и больше не действует. Поэтому проверка этого флага после обновления уже не отвечает на прежний вопрос о составе бинарника. Она может направить тему по другой ветке, даже если нужная ей возможность осталась доступна.

Компиляция Sass зависит от отдельного инструмента

Актуальный справочник css.Sass указывает единственный допустимый transpiler — dartsass. Если старый шаблон явно передаёт libsass, функция завершится ошибкой; значение нужно заменить либо убрать, оставив новое значение по умолчанию. Поддерживаются обе формы исходников: SCSS и синтаксис Sass с отступами.

Dart Sass должен присутствовать в среде разработки и в среде производственной сборки. Hugo находит его через PATH; активные транспиляторы показывает hugo env. Отдельное исключение — пакет Hugo для Snap, который уже включает этот инструмент. Наличие компилятора на ноутбуке не означает его наличия внутри контейнера или задания CI.

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

Командная строка становится последним уровнем конфигурации

В руководстве по конфигурации теперь закреплён порядок от низшего приоритета к высшему: встроенные значения, настройки проекта, переменные операционной системы и флаги команды. При конфликте выигрывает последний уровень. Например, явный --buildDrafts включает черновики даже при HUGO_BUILDDRAFTS=false в окружении.

То же правило распространяется на выбор среды. Переданный --environment определяет и каталог специальных настроек, и значение, возвращаемое hugo.Environment. Это устраняет ситуацию, когда выбирались файлы одной среды, а шаблоны видели название другой.

Остальные уровни тоже сохраняют значение. Hugo сначала читает config/_default, затем каталог выбранной среды; при списке файлов в --config последующие файлы перекрывают совпадающие ключи предыдущих. Итоговую конфигурацию можно посмотреть командой hugo config. В сборочной системе поэтому важно учитывать одновременно команду запуска и заданные платформой переменные, а не искать окончательное значение только в одном файле репозитория.

Standard и deploy остаются разными вариантами поставки

Документация установки отдельно уточняет: доступны standard и deploy. Вторая редакция добавляет прямое развёртывание сайта в Google Cloud Storage, AWS S3 или Azure Storage. Для проекта, которому эта функция не нужна, предназначена standard. Поддержка кодирования WebP теперь есть в обеих, поэтому ради неё больше не требуется выбирать Extended.

Готовый архив выбирают по редакции, операционной системе и архитектуре. После распаковки исполняемый файл должен быть доступен через PATH и иметь право запуска. Это отдельная проверка от работоспособности темы: неподходящий архив не исправляется настройками шаблонов.

Git и Go при этом не становятся обязательными для каждого сайта только из-за обновления. Руководство связывает их необходимость с конкретными задачами: сборкой Hugo из исходников, работой с модулями, использованием Git-подмодулей или сведений о коммитах. Набор зависимостей определяется выбранным процессом сборки, а не прежним словом Extended в имени скачанного пакета.

Источники

Принципы журнала и исправления.

ERITKOM / НОВЫЙ ПРОЕКТ

Расскажите о задаче и оставьте контакты. Мы свяжемся с вами, чтобы обсудить проект.

  1. 01 Контакты
  2. 02 Ваша задача