HELLO
" HUGO Wiki - удобная база знаний без БД/Админок/Плагинов/Cms :: LinuxLife Blog — Свободный блог о Linux linuxlifeAboutShowcaseПоиск по сайту Категории LinuxWebAboutShowcaseПоиск по сайтуLinuxWebHUGO Wiki - удобная база знаний без БД/Админок/Плагинов/Cms 2021-10-16 #selfhosted #wiki #knowledge #документация #Hugo Install gohugo EXTENDED!!!https://github.com/gohugoio/hugo/releasescd /tmpwget https://github.com/gohugoio/hugo/releases/download/v0.88.1/hugo_extended_0.88.1_macOS-64bit.tar.gztar xvf hugo_extended_0.88.1_macOS-64bit.tar.gzСмотрим где лежит hugowhich hugoПроверяем старую версиюhugo versionКопируем на место старогоmv hugo /usr/local/bin/hugoПроверяем снова версиюhugo versionConfigure Hugohttps://gohugo.io/getting-started/quick-start/cd ~hugo new site hugowikiAdd themeСтраница темыhttps://docs.vantage-design.com/ace/https://github.com/vantagedesign/ace-documentationhttps://themes.gohugo.io/themes/ace-documentation/cd hugowikigit initgit submodule add https://github.com/vantagedesign/ace-documentation.git themes/ace-documentationAdd theme to config hugoecho 'theme = "ace-documentation"' >> config.tomlCreate posthugo new posts/my-first-post.mdvim content/posts/my-first-post.mdЗаменить на draft: falseView posthugo server -DПереходим в браузер http://localhost:1313/Ace просматривает структуру вашего файла и автоматически превращает ее в меню.Структура выглядит следующим образом:/content├── _index.md ├── page-top.md└── /level-one ├── _index.md ├── page-1-one.md ├── page-1-two.md └── /level-two ├── _index.md ├── page-2-one.md ├── page-2-two.md └── /level-three ...Ваша “домашняя страница” для каждого уровня - это _index.md файл.Подстраницы (например, page-1-one.md) автоматически добавляются в меню как дочерние страницы.Создадим домашнюю страницуhugo new _index.mdvim content/_index.mdhugo server -DСоздадим вложенный пост для проверки вложенности категория в меню слеваhugo new devops/my-devops.mdvim content/devops/my-devops.mdhugo server -DТакже попробуем с дочерними страницамиСначала домашняя страница для категории cicdhugo new cicd/_index.mdvim content/cicd/_index.mdВставим в шапку домашней страницы категории шорткод дочерних страниц:* ВНИМАНИЕ! УБЕРИТЕ НИЖНЕЕ ПОДЧЕРКИВАНИЕ{_{_< childpages >_}_}ПОСЛЕ как посмотрите - можете решать нужны ли это ссылки в шапкеТЕПЕРЬ ПОПРОБУЕМ 2 ВАРИАНТ:Создаем обычную страницу в категории cicdhugo new cicd/jenkins.mdvim content/cicd/jenkins.mdА ТЕПЕРЬ создадим вложенную категорию GITLAB с домашней страницей и доп about_gitlab.mdhugo new cicd/gitlab/_index.md * Вспоминаем наш шорткод (убрать подчеркивание) {_{_< childpages >_}_}, вставлять или нет - решать вам :)vim content/cicd/gitlab/_index.mdhugo new cicd/gitlab/about_gitlab.mdvim content/cicd/gitlab/about_gitlab.mdИ запустим hugohugo server -DКастомизация темыОткрыть dev tool и показать как менять всеКопируем файл к себе ace.min.css в static/style.css. Тем самым мы перезапишем стилиКод файла https://pastebin.linuxlife.page/wataquqala.plДобавим также в config.toml [params] custom_css = ["style.css","style.css"]Кастомизация на максималкахЭКСПЕРИМЕНТИРУЕМ С ДОМАШНЕЙ СТРАНИЦЕЙvim content/_index.mdОтключаем Read Morevim config.tomldisableReadmoreNav = trueОтключаем сортировку по весу наших статей (будем делать по алфавиту)vim config.tomlorderSectionsby = "title"Читаем интересные shortcodes темыhttps://docs.vantage-design.com/ace/shortcodes/Используем childpages в шапке поста{_{_< childpages >_}_}Шорт код для кода с выбором языка* ВНИМАНИЕ - убрать нижнее подчеркивание!{_{_< code lang="LANG" >_}_} [your code] {_{_< /code >_}_}Список LANG можно посмотреть здесьhttps://gohugo.io/content-management/syntax-highlighting/#list-of-chroma-highlighting-languagesДабл код* ВНИМАНИЕ - убрать нижнее подчеркивание!{_{< doublecode lang="LANG" >_}_} [your code] {_{_< /doublecode >_}_}Выделение абзаца* ВНИМАНИЕ - убрать нижнее подчеркивание!{_{_< lead >_}_} [content] {_{_< /lead >_}_}Отделить информацию от основной части с помощью “панели”* ВНИМАНИЕ - убрать нижнее подчеркивание!{_{_< panel title="TITLE" style="STYLE" >_}_} [content] {_{_< /panel >_}_}Стили primary, secondary, danger, warning, success, infoТаблица* ВНИМАНИЕ - убрать нижнее подчеркивание!* {_{_< table style="STYLE" >_}_}| Tables | are | cool || ------------- |:-------------:| -----:|| col 3 is | right-aligned | $1600 || col 2 is | centered | $12 || zebra stripes | are neat | $1 |{_{_< /table >_}_}*Стили table-striped, table-dark, table-bordered, table-hoverАлерты* ВНИМАНИЕ - убрать нижнее подчеркивание!{_{< alert style="STYLE" >_}_} [content] {_{_< /alert >_}_}Стили danger, warning, success, infoКнопки{_{_< button style="STYLE" link="https://yourwebsite.com" >_}_} [content] {_{_< /button >_}_}Стили primary, secondary, danger, warning, success, infoЕсли нужна кнопка без заполнения, то используем вместе со словом outline-primaryRead other postsCalibre Web - домашная библиотека для электронных книг→Please enable JavaScript to view the comments powered by Disqus.comments powered by Disquslinuxlife© 2021 Powered by HugoTheme created by panr"