Настройка модулей
Конфигурация модуля: Верхний уровень
config.
module:
noProxy: none
noVendor: ""
private: '*.*'
proxy: direct
replacements: ""
[module]
noProxy = "none"
noVendor = ""
private = "*.*"
proxy = "direct"
replacements = ""
{
"module": {
"noProxy": "none",
"noVendor": "",
"private": "*.*",
"proxy": "direct",
"replacements": ""
}
}
- noVendor
- Необязательные пути модуля сопоставления с шаблоном Glob, которые следует пропустить при продаже, например, “github.com/**”
- proxy
- Определяет прокси-сервер для загрузки удаленных модулей. По умолчанию это
direct
, что означает “git clone” и т.п. - noProxy
- Пути соответствия глобальных списков, разделенных запятыми, которые не должны использовать настроенный выше прокси.
- private
- Пути соответствия глобальных списков, разделенных запятыми, которые следует рассматривать как частные.
- replacements
- Разделенный запятыми (или фрагмент) список пути модуля к сопоставлению замены каталога, например,
"github.com/bep/myprettytheme -> ../..,github.com/bep/shortcodes -> /some/path
. Это в основном полезно для временной локальной разработки модуля, а затем имеет смысл установите его как переменную среды ОС, например:env HUGO_MODULE_REPLACEMENTS="github.com/bep/myprettytheme -> ../.."
. Любой относительный путь относится к themesDir, и абсолютные пути разрешены.
Обратите внимание, что приведенные выше термины напрямую соответствуют своим аналогам в модулях Go. Некоторые из этих параметров могут быть естественными для установки в качестве переменных среды ОС. Чтобы настроить прокси-сервер для использования, например:
env HUGO_MODULE_PROXY=https://proxy.example.org hugo
Конфигурация модуля: hugoVersion
Если Вашему модулю для работы требуется определенная версия Hugo, Вы можете указать это в разделе module
, и пользователь будет предупрежден, если будет использовать слишком старую/новую версию.
config.
module:
hugoVersion:
extended: false
max: ""
min: ""
[module]
[module.hugoVersion]
extended = false
max = ""
min = ""
{
"module": {
"hugoVersion": {
"extended": false,
"max": "",
"min": ""
}
}
}
Любое из вышеперечисленного можно опустить.
- min
- Минимальная поддерживаемая версия Hugo, например:
0.55.0
- max
- Максимальная поддерживаемая версия Hugo, например:
0.55.0
- extended
- Требуется ли расширенная версия Hugo.
Конфигурация модуля: imports
config.
module:
imports:
- disable: false
ignoreConfig: false
path: github.com/gohugoio/hugoTestModules1_linux/modh1_2_1v
- path: my-shortcodes
[module]
[[module.imports]]
disable = false
ignoreConfig = false
path = "github.com/gohugoio/hugoTestModules1_linux/modh1_2_1v"
[[module.imports]]
path = "my-shortcodes"
{
"module": {
"imports": [
{
"disable": false,
"ignoreConfig": false,
"path": "github.com/gohugoio/hugoTestModules1_linux/modh1_2_1v"
},
{
"path": "my-shortcodes"
}
]
}
}
- path
- Может быть действительным путем к модулю модуля Go, например:
github.com/gohugoio/myShortcodes
или имя каталога для модуля, хранящегося в папке Ваших тем. - ignoreConfig
- Если включено, любой файл конфигурации модуля, например
config.toml
не загружается. Обратите внимание, что это также остановит загрузку любых транзитивных зависимостей модуля. - disable
- Установите значение
true
, чтобы отключить модуль, сохраняя при этом любую информацию о версии в файлахgo.*
.
Конфигурация модуля: mounts
mounts по умолчанию
config.
module:
mounts:
- source: content
target: content
- source: static
target: static
- source: layouts
target: layouts
- source: data
target: data
- source: assets
target: assets
- source: i18n
target: i18n
- source: archetypes
target: archetypes
[module]
[[module.mounts]]
source = "content"
target = "content"
[[module.mounts]]
source = "static"
target = "static"
[[module.mounts]]
source = "layouts"
target = "layouts"
[[module.mounts]]
source = "data"
target = "data"
[[module.mounts]]
source = "assets"
target = "assets"
[[module.mounts]]
source = "i18n"
target = "i18n"
[[module.mounts]]
source = "archetypes"
target = "archetypes"
{
"module": {
"mounts": [
{
"source": "content",
"target": "content"
},
{
"source": "static",
"target": "static"
},
{
"source": "layouts",
"target": "layouts"
},
{
"source": "data",
"target": "data"
},
{
"source": "assets",
"target": "assets"
},
{
"source": "i18n",
"target": "i18n"
},
{
"source": "archetypes",
"target": "archetypes"
}
]
}
}
- source
- Исходный каталог монтирования. Для основного проекта это может быть как относительная к проекту, так и абсолютная и даже символическая ссылка. Для других модулей он должен относиться к проекту.
- target
- Где он должен быть смонтирован в виртуальной файловой системе Хьюго. Он должен начинаться с одной из папок компонентов Хьюго:
static
,content
,layouts
,data
,assets
,i18n
илиarchetypes
. Например:content/blog
. - lang
- Код языка, например: “en”. Применимо только для монтирования контента
content
иstatic
статического монтирования в режиме мультихоста.