Files
dedinit.ru/content/posts/hugo-error-fix/index.md
T

61 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: "Исправление ошибок в Hugo сайте"
date: 2026-01-31T22:45:00+03:00
draft: false
tags: ["hugo", "ошибки", "исправления", "google analytics", "deprecated"]
categories: ["Разработка", "Hugo"]
---
## Проблема
При запуске команды `hugo server` возникала ошибка:
```shell
ERROR html/template:_partials/head.html:153:13: no such template "_internal/google_analytics.html"
```
## Решение
### 1. Исправление ошибки с Google Analytics
В новых версиях Hugo внутренний шаблон `_internal/google_analytics.html` был удален.
Необходимо заменить его использование на частичный шаблон из темы PaperMod:
```html
<!-- Было -->
{{- template "_internal/google_analytics.html" . }}
<!-- Стало -->
{{- partial "google_analytics.html" . }}
```
### 2. Обновление шаблона Google Analytics
В шаблоне `themes/PaperMod/layouts/partials/google_analytics.html` также
потребовалось обновить способ получения ID Google Analytics, так как в новых
версиях Hugo поле `.Site.GoogleAnalytics` было заменено на
`.Site.Config.Services.GoogleAnalytics.ID`.
### 3. Исправление ошибок с устаревшим .Site.Social
В шаблонах `twitter_cards.html` и `opengraph.html` использовались устаревшие
обращения к `.Site.Social`, которые были заменены на `.Site.Params.Social`.
### 4. Исправление путей к частичным шаблонам
Также были исправлены неправильные пути к частичным шаблонам в нескольких файлах:
- `twitter_cards.html`
- `schema_json.html`
- `opengraph.html`
## Результат
После всех исправлений сайт успешно запускается командой `hugo server` и
доступен по адресу <http://localhost:1313/>
## Вывод
При обновлении Hugo или тем важно следить за изменениями в API и устаревшими
функциями. Использование устаревших элементов может привести к ошибкам сборки сайта.