Romych в 11:44, 22 березня 2020

2020-03-22T11:44:31Z

Нова сторінка

←[[Hugo]]

<div class="red">'''Работает плохо. Ждем, когда появится проверенная инструкция.'''</div>

* [https://gohugo.io/hugo-modules/use-modules/ Use Hugo Modules]
* [https://gohugo.io/hugo-modules/configuration/ Configure Modules]

== Кеш модулей ==

При скачивании модулей они сохраняются в кеш <code>/tmp/hugo_cache</code>.

Путь к нему можно узнать так:

<source lang="bash">
printenv | grep hugo
OLDPWD=/tmp/hugo_cache
</source>

Подробнее: https://gohugo.io/getting-started/configuration/#configure-file-caches

== hugo-mod-bootstrap-scss-v4 ==

* [https://github.com/gohugoio/hugo-mod-bootstrap-scss-v4 GitHub - gohugoio/hugo-mod-bootstrap-scss-v4: Bootstrap SCSS v4 packaged as a Hugo Module]

Инициализируем модуль:

hugo mod init github.com/gohugoio/hugo-mod-bootstrap-scss-v4

Добавим в <code>config.toml</code>:

<source lang="javascript">
[module]
[[module.imports]]
path = "github.com/gohugoio/hugo-mod-bootstrap-scss-v4"
</source>

Запустим Hugo и проверим кеш — там появится файл:

/tmp/hugo_cache/modules/filecache/modules/pkg/mod/github.com/gohugoio/hugo-bootstrap-scss-v4@v0.0.0-20200224171633-fc89315b7997/assets/scss/bootstrap/_vendor/_rfs.scss

Создадим папку:

mkdir -p assets/scss/bootstrap

Создадим файл стилей и в нем импортируем стили Bootstrap:

vim assets/scss/main.scss

<source lang="sass">
@import "bootstrap/bootstrap";
$not-so-white: FloralWhite;
body {
background-color: $not-so-white;
}
</source>

Подключите компиляцию CSS в основной шаблон <code>layouts/_default/baseof.html</code>:

<source lang="html">
{{ $style := resources.Get "scss/main.scss" | toCSS }}
<link rel="stylesheet" href="{{ $style.RelPermalink }}">
</source>

== bep/my-modular-site ==

На примере https://github.com/bep/my-modular-site

hugo mod init github.com/bep/my-modular-site

После запуска Hugo будут скачаны все модули, указанные в <code>config.toml</code>:

<source lang="javascript">
[[module.imports]]
path="github.com/bep/hugotestmods/mymounts"
disabled=false
[[module.imports.mounts]]
source="myassets/subfolder"
target="assets/images"
[[module.imports.mounts]]
source="mydata/subfolder"
target="data/datakey"
[[module.imports]]
path="github.com/bep/hugotestmods/mypartials"
disable=false
[[module.imports]]
path="github.com/spf13/hyde"
disable=false
[[module.imports]]
path="github.com/bep/hugo-fresh"
disable=true
[[module.imports]]
path="in-themesdir"
</source>

=== Пример монтирования ===

https://github.com/bep/hugotestmods/tree/master/mypartials/static/images — это папка с картинками

Импортируется как модуль здесь:

<source lang="javascript">
[module]
[[module.imports]]
path="github.com/bep/hugotestmods/mypartials"
</source>

Загружается сюда:
/tmp/hugo_cache/modules/filecache/modules/pkg/mod/github.com/bep/hugotestmods/mypartials@v1.0.7/static/images$

Монтируется сюда (виртуально):

static/images

== Создание собственного модуля ==

* По инструкции [https://craftsmandigital.net/blog/hugo-modules/ Hugo modules • Jon Arne Viksås]

Создадим модуль, который будет монтировать произвольный репозиторий GitHub.

Добавим в <code>config.toml</code> строки:

<source lang="javascript">
[module]
[[module.imports]]
path = "github.com/twbs/bootstrap"
</source>

Инициализируем модуль:

hugo mod init test-bootstrap

Будет создан файл <code>go.mod</code>.

== Ссылки ==

* [https://gohugo.io/hugo-modules/configuration/ Configure Modules | Hugo]

* [https://www.elt.ink/blog/2019-11-09-project-documentation/ Geert Eltink – Project documentation with Hugo Modules]
* [https://discourse.gohugo.io/t/working-example-of-hugo-modules-and-bootstrap-scss-files/23090 Working example of Hugo Modules and Bootstrap .scss files? - support - HUGO]

[[Категория:Hugo]]

Hugo Modules - Історія редагувань

Romych в 11:44, 22 березня 2020