Hugo Book

- Introduction: https://book.alxs.dev/docs/getting-started/introduction/
- Create a Site: https://book.alxs.dev/docs/getting-started/create-a-site/
- Configuration: https://book.alxs.dev/docs/getting-started/configuration/
- Organisation: https://book.alxs.dev/docs/content/organisation/
- Pages: https://book.alxs.dev/docs/content/pages/
- Menus: https://book.alxs.dev/docs/content/menus/
- Blog: https://book.alxs.dev/docs/content/blog/
- Multi-Language: https://book.alxs.dev/docs/content/multilingual/
- Shortcodes: https://book.alxs.dev/docs/content/shortcodes/
- Asciinema: https://book.alxs.dev/docs/content/shortcodes/asciinema/
- Buttons: https://book.alxs.dev/docs/content/shortcodes/buttons/
- Columns: https://book.alxs.dev/docs/content/shortcodes/columns/
- Details: https://book.alxs.dev/docs/content/shortcodes/details/
- Images: https://book.alxs.dev/docs/content/shortcodes/experimental/images/
- OpenAPI: https://book.alxs.dev/docs/content/shortcodes/experimental/openapi/
- Hints: https://book.alxs.dev/docs/content/shortcodes/hints/
- Mermaid: https://book.alxs.dev/docs/content/shortcodes/mermaid/
- Steps: https://book.alxs.dev/docs/content/shortcodes/steps/
- Tabs: https://book.alxs.dev/docs/content/shortcodes/tabs/
- KaTeX: https://book.alxs.dev/docs/content/shortcodes/katex/
- Styles: https://book.alxs.dev/docs/customization/styles/
- Inject Partials: https://book.alxs.dev/docs/customization/inject-partials/


# Page Frontmatter

Every page can use these [frontmatter](https://gohugo.io/content-management/front-matter/) parameters to control its behavior in the theme.

{{< tabs >}}
{{% tab "YAML" %}}
```yaml
---
title: My Page
weight: 10
bookToC: true
bookCollapseSection: true
---
```
{{% /tab %}}

{{% tab "TOML" %}}
```toml
+++
title = 'My Page'
weight = 10
bookToC = true
bookCollapseSection = true
+++
```
{{% /tab %}}

{{% tab "JSON" %}}
```json
{
  "title": "My Page",
  "weight": 10,
  "bookToC": true,
  "bookCollapseSection": true
}
```
{{% /tab %}}
{{< /tabs >}}

## Navigation

These parameters control how the page appears in the sidebar menu. Set in page frontmatter.

| Parameter | Default | Description |
| --- | --- | --- |
| `weight` | | Menu ordering. Lower values appear first. Without weight, pages are sorted alphabetically. |
| `bookHidden` | `false` | Hide the page from the sidebar menu. The page is still accessible by URL. |
| `bookCollapseSection` | `false` | Make a section collapsible in the sidebar. Subsections are hidden until clicked. |
| `bookFlatSection` | `false` | Display subsection pages at the same level instead of nesting them. |
| `bookHref` | | Override the menu link with an external URL. |
| `bookIcon` | | Display an icon next to the menu entry. |

## Content Display

These parameters control page content rendering. Set in page frontmatter.

| Parameter | Default | Description |
| --- | --- | --- |
| `bookToC` | | Show or hide the table of contents. Overrides the site-level `BookToC` setting. |
| `bookComments` | | Show or hide comments. Overrides the site-level `BookComments` setting. |
| `bookSearchExclude` | `false` | Exclude this page from the search index. |

See [Blog](/docs/content/blog/) for post-specific frontmatter.