HELLO

" HUGO Wiki - удобная база знаний без БД/Админок/Плагинов/Cms :: LinuxLife Blog — Свободный блог о Linux linuxlife About Showcase Поиск по сайту Категории Linux Web About Showcase Поиск по сайту Linux Web HUGO Wiki - удобная база знаний без БД/Админок/Плагинов/Cms 2021-10-16 #selfhosted #wiki #knowledge #документация #Hugo Install gohugo EXTENDED!!! https://github.com/gohugoio/hugo/releases cd /tmp wget https://github.com/gohugoio/hugo/releases/download/v0.88.1/hugo_extended_0.88.1_macOS-64bit.tar.gz tar xvf hugo_extended_0.88.1_macOS-64bit.tar.gz Смотрим где лежит hugo which hugo Проверяем старую версию hugo version Копируем на место старого mv hugo /usr/local/bin/hugo Проверяем снова версию hugo version Configure Hugo https://gohugo.io/getting-started/quick-start/ cd ~ hugo new site hugowiki Add theme Страница темы https://docs.vantage-design.com/ace/ https://github.com/vantagedesign/ace-documentation https://themes.gohugo.io/themes/ace-documentation/ cd hugowiki git init git submodule add https://github.com/vantagedesign/ace-documentation.git themes/ace-documentation Add theme to config hugo echo 'theme = "ace-documentation"' >> config.toml Create post hugo new posts/my-first-post.md vim content/posts/my-first-post.md Заменить на draft: false View post hugo 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.md vim content/_index.md hugo server -D Создадим вложенный пост для проверки вложенности категория в меню слева hugo new devops/my-devops.md vim content/devops/my-devops.md hugo server -D Также попробуем с дочерними страницами Сначала домашняя страница для категории cicd hugo new cicd/_index.md vim content/cicd/_index.md Вставим в шапку домашней страницы категории шорткод дочерних страниц: * ВНИМАНИЕ! УБЕРИТЕ НИЖНЕЕ ПОДЧЕРКИВАНИЕ {_{_< childpages >_}_} ПОСЛЕ как посмотрите - можете решать нужны ли это ссылки в шапке ТЕПЕРЬ ПОПРОБУЕМ 2 ВАРИАНТ: Создаем обычную страницу в категории cicd hugo new cicd/jenkins.md vim content/cicd/jenkins.md А ТЕПЕРЬ создадим вложенную категорию GITLAB с домашней страницей и доп about_gitlab.md hugo new cicd/gitlab/_index.md * Вспоминаем наш шорткод (убрать подчеркивание) {_{_< childpages >_}_}, вставлять или нет - решать вам :) vim content/cicd/gitlab/_index.md hugo new cicd/gitlab/about_gitlab.md vim content/cicd/gitlab/about_gitlab.md И запустим hugo hugo 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 More vim config.toml disableReadmoreNav = true Отключаем сортировку по весу наших статей (будем делать по алфавиту) vim config.toml orderSectionsby = "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-primary Read other posts Calibre Web - домашная библиотека для электронных книг → Please enable JavaScript to view the comments powered by Disqus. comments powered by Disqus linuxlife © 2021 Powered by Hugo Theme created by panr "