Цей сайт використовує Hugo. В Hugo організація контенту є основним концептом.
hugo server --navigateToChanged для редагування контенту.Бічне меню документації, оглядач сторінок документації тощо формуються за допомогою стандартного порядку сортування Hugo, який сортує за вагою (починаючи з 1), датою (новіші перші), і нарешті за заголовком посилання.
Щоб перемістити сторінку або розділ вверх, задайте вагу у front matter сторінки:
title: My Page
weight: 10
Основне меню Документація формується з розділів, що знаходяться в docs/, з прапорцем main_menu, встановленим у front matter файлу контенту _index.md:
main_menu: true
Зверніть увагу, що заголовок посилання береться з linkTitle сторінки, тому, якщо ви хочете, щоб він був відмінним від заголовка, змініть його у файлі контенту:
main_menu: true
title: Page Title
linkTitle: Title used in links
_index.md у теці розділу.Бічне меню документації формується з поточного дерева розділів в docs/.
Воно відображатиме всі розділи та їх сторінки.
Якщо ви не хочете відображати розділ або сторінку, встановіть прапорець toc_hide в значення true у front matter:
toc_hide: true
Коли ви переходите до розділу, який має контент, показується конкретний розділ або сторінка (наприклад, _index.md). Інакше показується перша сторінка всередині цього розділу.
Оглядач сторінок на домашній сторінці документації формується з усіх розділів і сторінок, які безпосередньо знаходяться нижче розділу docs.
Якщо ви не хочете відображати розділ або сторінку, встановіть прапорець toc_hide в значення true у front matter:
toc_hide: true
Посилання сайту в меню у верхньому правому куті, а також у нижньому колонтитулі, формуються за допомогою перегляду сторінок. Це робиться для того, щоб переконатися, що сторінка дійсно існує. Тому, якщо розділ case-studies не існує на сайті (для мови), він не буде показаний.
Окрім окремих контентних сторінок (файли Markdown), Hugo підтримує Пакети сторінок.
Один приклад — Custom Hugo Shortcodes. Це вважається leaf bundle. Все, що знаходиться нижче теки, включаючи index.md, буде частиною пакета. Це також включає посилання, що є відносними до сторінки, зображення, які можна обробити тощо:
en/docs/home/contribute/includes
├── example1.md
├── example2.md
├── index.md
└── podtemplate.json
Ще один широко використовуваний приклад — пакет includes. Він встановлює headless: true у front matter, що означає, що він не отримує власний URL. Він використовується тільки в інших сторінках.
en/includes
├── default-storage-class-prereqs.md
├── index.md
├── partner-script.js
├── partner-style.css
├── task-tutorial-prereqs.md
├── user-guide-content-moved.md
└── user-guide-migration-notice.md
Декілька важливих приміток до файлів у пакетах:
Resources, і ви можете надавати метадані для кожної мови, такі як параметри і заголовок, навіть якщо це не підтримує front matter (YAML файли тощо). Див. Метадані ресурсів сторінок..RelPermalink Resource є відносним до сторінки. Див. Permalinks.Джерело стилів SASS для цього сайту зберігається у assets/sass і автоматично будується Hugo.