Пути работают корректно если картинку поместить в папку страницы или поста – в md разметке страницы или поста картинка вставляется как .
Пути работают корректно если записать в config/_default/config.toml переменную (пример [params] logofinec = "/finec-mgimo-footer.png"). В этой переменной сохраняем название картинки, которая размещается в папке static. Использование картинки в разметке: <img src="{{.Site.BaseURL}}{{ .Site.Params.logofinec }}" class="rounded" alt="логотип ФИНЭК">. Здесь в src указываем переменную .Site.Params.logofinec. Такой способ позволяет размещать картинку в папке static и сама картинка будет корректно отображаться на всех страницах, на всех языковых версиях RU и EN. Удобно для оформления страниц, но никто вроде нас не ограничивает использовать такой способ только для этих целей. Минус это множество переменных с картинками в конфиг файле.
В Hugo есть встроенные инструменты для работы с путями: absURL, relURL, relLangURL. Они корректно работают на уровне html разметки (partials и shortcodes), но не работают на уровне Markdown документа. Вариант решения это переписать shortcode для figure, либо написать свой собственный shortcode, который бы брал картинки из static.
В config.toml указать флаг canonifyURLs как true (по умолчанию стоит false). В таком случае shortcode figure корректно подхватывает baseURL. Есть советы использовать canonifyURLs = true как раз при размещении на Github Pages. Но canonifyURLs = true в нашем случае ломает сайт. Так как из ссылок в левом меню убирается подкаталог (суб-директория) /finec-mgimo-v2/.
Можно также добавить полезные ссылки с перепиской где обсуждались проблемы и пути их решения.
Issue таблетка для памяти.
Не очевидная работа с путями к картинкам при размещении сайта в подкаталоге домена (https://epogrebnyak.github.io/finec-mgimo-v2/) и при использовании двуязычной версии.
.[params] logofinec = "/finec-mgimo-footer.png"). В этой переменной сохраняем название картинки, которая размещается в папке static. Использование картинки в разметке:<img src="{{.Site.BaseURL}}{{ .Site.Params.logofinec }}" class="rounded" alt="логотип ФИНЭК">. Здесь в src указываем переменную .Site.Params.logofinec. Такой способ позволяет размещать картинку в папке static и сама картинка будет корректно отображаться на всех страницах, на всех языковых версиях RU и EN. Удобно для оформления страниц, но никто вроде нас не ограничивает использовать такой способ только для этих целей. Минус это множество переменных с картинками в конфиг файле.canonifyURLsкакtrue(по умолчанию стоитfalse). В таком случае shortcode figure корректно подхватывает baseURL. Есть советы использоватьcanonifyURLs = trueкак раз при размещении на Github Pages. НоcanonifyURLs = trueв нашем случае ломает сайт. Так как из ссылок в левом меню убирается подкаталог (суб-директория) /finec-mgimo-v2/.Можно также добавить полезные ссылки с перепиской где обсуждались проблемы и пути их решения.