Применить тему «Прекрасный Гюго

Узнайте, как применить тему «Прекрасный Хьюго».

Цель

Ниже приведена схема конфигурации (пример) среды блогов с Hugo + GitLab Pages. Цель здесь — изменить тело темы в репозитории тем/контента GitLab Hugo на Beautiful Hugo, заменить настройки темы/контента на образец Beautiful Hugo, изменить настройки CI/CD для Beautiful Hugo и собрать/опубликовать образец сайта.

Внимание : После этой процедуры настройки темы/контент будут заменены на образец. Если вы хотите сохранить существующие активы, пожалуйста, сохраните их перед продолжением.

Предположения

Это объяснение предполагает, что сервер с Hugo + GitLab Pages, Dev клиент с VSCode реализованы, и что есть серверная среда, построенная в GitLab с шаблоном Pages/Hugo, и клиентская среда разработки с Visual Studio Code.

Также предполагается, что тема не была изменена с момента внедрения сервера с Hugo + GitLab Pages. Если тема была изменена, пожалуйста, повторно внедрите Сервер с Hugo + GitLab Pages и подготовьте новый проект.

Метод применения

Измените тело темы, настройки/содержание темы в Visual Studio Code

1. Откройте Beautiful Hugo’s GitHub в браузере и нажмите Code → Download ZIP.
   • Последний файл темы будет загружен в формате zip.

2. Распакуйте скачанный zip-файл и замените его файлами из активов репозитория Hugo, управляемых Visual Studio Code.

   beautifulhugo-master
   ├ archetypes        → /themes/beautifulhugo/(same name directory)
   ├ data              → /themes/beautifulhugo/(same name directory)
   ├ exampleSite
   │ ├ content         → /(same name directory)
   │ ├ layouts         → /(same name directory)
   │ ├ static          → /(same name directory)
   │ └ config.toml     → /(same name file)
   ├ i18n              → /themes/beautifulhugo/(same name directory)
   ├ images            → /themes/beautifulhugo/(same name directory)
   ├ layouts           → /themes/beautifulhugo/(same name directory)
   ├ static            → /themes/beautifulhugo/(same name directory)
   ├ .gitattributes    → /themes/beautifulhugo/(same name file)
   ├ .gitignore        → /themes/beautifulhugo/(same name file)
   ├ LICENCE           → /themes/beautifulhugo/(same name file)
   ├ README.md         → /themes/beautifulhugo/(same name file)
   └ theme.toml        → /themes/beautifulhugo/(same name file)
   

3. Измените следующее в /config.toml в Visual Studio Code.

   • baseurl : Изменить на корневой URL-адрес сайта-образца.
     • Ссылка : Примеры сайтов проектов — примеры GitLab).
   • title : изменить на любое название, которое вам нравится.

Дополнение : Вместо загрузки zip-файла вы можете использовать подмодуль git для создания символической ссылки на репозиторий Beautiful Hugo и заставить его загружать последний файл с этой ссылки при каждой сборке. Преимуществом является то, что после установки тема будет обновляться автоматически. Недостатком является то, что время сборки увеличивается и может превысить время бесплатного конвейера GitLab (400 минут). Инструкции по выполнению подмодуля см. в разделе Установка — Beautiful Hugo.

Измените настройки CI/CD в Visual Studio Code, чтобы они соответствовали теме

Никаких изменений в /.gitlab-ci.yml не требуется.

Выгрузка изменений, сделанных в Visual Studio Code, в GitLab

Загрузите активы репозитория Hugo, измененные в Visual Studio Code, в GitLab — будет реализован Dev-клиент с VSCode.

Проверьте результаты сборки/публикации, выполненные автоматически в GitLab

Проверьте результаты сборки/публикации, выполненные автоматически в GitLab — будет реализован клиент Dev с VSCode.

Устранение неполадок

«Невозможно оценить поле URL в типе *hugolib.pageState» в Hugo v0.93 или более поздней версии

Phenomenon

Красивое содержимое темы Hugo, развернутое с помощью GitLab Pages, теперь выдает следующую ошибку при сборке с помощью Hugo v0.93 или более поздней версии (по состоянию на 22 марта).

: ERROR 2022/03/20 12:20:23 render of "page" failed: execute of template failed: template: _default/single.html:3:5: executing "_default/single.html" at <partial "head.html" .>: error calling partial: "/builds/ayaco/test2/themes/beautifulhugo/layouts/partials/head.html:33:38": execute of template failed: template: partials/head.html:33:38: executing "partials/head.html" at <.URL>: can't evaluate field URL in type *hugolib.pageState

Причина

Это происходит потому, что тема Beautiful Hugo использует метод Page.URL, который был удален в Hugo v0.93.

Устранение

Примените описанный выше метод Application для обновления темы Beautiful Hugo и включения поддержки несовместимости с Hugo v0.93.