https://mediawiki.zina.run/index.php?action=history&feed=atom&title=Hugo_Minimal_Bootstrap_Theme 2026-10-12T09:33:23Z Історія редагувань цієї сторінки в вікі MediaWiki 1.44.2 https://mediawiki.zina.run/index.php?title=Hugo_Minimal_Bootstrap_Theme&diff=811&oldid=prev 2020-03-23T14:37:58Z

<p></p> <p><b>Нова сторінка</b></p><div>←[[Hugo]]<br /> <br /> Сборка простого сайта на Hugo с минимальной темой Bootstrap: <br /> <br /> * https://gitlab.com/romychvk/hugo-minimal-bootstrap<br /> <br /> В теме используется сборка CSS и JS с помощью Hugo Pipes, поэтому нужна Extended версия Hugo.<br /> <br /> Главные файлы темы:<br /> <br /> # &lt;code&gt;&#039;&#039;&#039;config.toml&#039;&#039;&#039;&lt;/code&gt; — основной конфигурационный файл<br /> # &lt;code&gt;themes/minimal-bootstrap-zina/&#039;&#039;&#039;layouts/_default/baseof.html&#039;&#039;&#039;&lt;/code&gt; — главный шаблон<br /> <br /> == SASS и Bootstrap ==<br /> <br /> Настроены два варианта подключения JS и CSS — в &lt;code&gt;config.toml&lt;/code&gt; в параметрах &lt;code&gt;includeJS&lt;/code&gt; и &lt;code&gt;includeCSS&lt;/code&gt;:<br /> <br /> * &lt;code&gt;&#039;&#039;&#039;cdn&#039;&#039;&#039;&lt;/code&gt; — подключение ссылкой на CDN Bootstrap, работает по умолчанию.<br /> * &lt;code&gt;&#039;&#039;&#039;local&#039;&#039;&#039;&lt;/code&gt; — подключение сборкой из локальной версии Bootstrap (нужно установить, см. [[Hugo + Bootstrap]]).<br /> <br /> Редактируются эти подключения в шаблонах:<br /> <br /> themes/minimal-bootstrap-zina/&#039;&#039;&#039;layouts/partials/css/head.html&#039;&#039;&#039;<br /> themes/minimal-bootstrap-zina/&#039;&#039;&#039;layouts/partials/js/footer.html&#039;&#039;&#039;<br /> <br /> Там же настроено включение Source Maps только при режиме локальной разработки (когда запущен &lt;code&gt;hugo server&lt;/code&gt;).<br /> <br /> Основной файл стилей — &lt;code&gt;assets/scss/main.scss&lt;/code&gt;. При режиме &#039;&#039;&#039;cdn&#039;&#039;&#039; он компилируется в &lt;code&gt;css/main.css&lt;/code&gt; и подключается после Bootstrap. При режиме &#039;&#039;&#039;local&#039;&#039;&#039; итоговый &lt;code&gt;css/main.css&lt;/code&gt; собирается из &lt;code&gt;assets/scss/main-bootstrap.scss&lt;/code&gt; — а уже в нем после Bootstrap инклюдится основной файл &lt;code&gt;assets/scss/main.scss&lt;/code&gt;.<br /> <br /> Файлы стилей можно держать как в папке темы &lt;code&gt;themes/minimal-bootstrap-zina/assets/scss/&lt;/code&gt;, так и в основной папке проекта &lt;code&gt;assets/scss/&lt;/code&gt;.<br /> <br /> == Два режима меню ==<br /> <br /> Включены два варианта формирования основного меню:<br /> <br /> * &lt;code&gt;themes/minimal-bootstrap-zina/&#039;&#039;&#039;layouts/partials/menu/section.html&#039;&#039;&#039;&lt;/code&gt; — меню на основе секций (разделов, папок) сайта. Порядок определяется весом секций (&lt;code&gt;weight&lt;/code&gt; в &lt;code&gt;_index.html&lt;/code&gt; каждой папки).<br /> * &lt;code&gt;themes/minimal-bootstrap-zina/&#039;&#039;&#039;layouts/partials/menu/nav.html&#039;&#039;&#039;&lt;/code&gt; — меню на основе таксономии &lt;code&gt;&lt;nowiki&gt;[[menu.nav]]&lt;/nowiki&gt;&lt;/code&gt; в &lt;code&gt;config.toml&lt;/code&gt;. Порядок задается тоже в &lt;code&gt;config.toml&lt;/code&gt;.<br /> <br /> Меню задается в стандартном для Bootstrap шаблоне navbar:<br /> <br /> themes/minimal-bootstrap-zina/&#039;&#039;&#039;layouts/partials/navbar.html&#039;&#039;&#039;<br /> <br /> == Режим отладки ==<br /> <br /> В &lt;code&gt;config.toml&lt;/code&gt; в параметре &lt;code&gt;devMode&lt;/code&gt; можно включить режим отладки, при котором будут показаны значения основных параметров и переменных.<br /> <br /> Если &lt;code&gt;devMode = true&lt;/code&gt;, то учитываются еще и значения двух других параметров:<br /> <br /> * &lt;code&gt;devVarsShow&lt;/code&gt; — показать дополнительные списки переменных<br /> * &lt;code&gt;devVarsList&lt;/code&gt; — какие именно списки переменных<br /> <br /> Шаблоны devMode со списками переменных лежат здесь:<br /> <br /> themes/minimal-bootstrap-zina/&#039;&#039;&#039;layouts/partials/dev&#039;&#039;&#039;<br /> <br /> [[Категория:Hugo]]<br /> [[Категория:Bootstrap]]</div>

Romych