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/


# Multi-Language Support

Hugo Book supports Hugo's [multilingual mode](https://gohugo.io/content-management/multilingual/) with content translation by directory.

## Configuration

Define languages in your site config

```toml {filename=hugo.toml}
[languages]
[languages.en]
  label = 'English'
  contentDir = 'content.en'
  weight = 1

[languages.zh]
  label = 'Chinese'
  contentDir = 'content.zh'
  weight = 2

[languages.he]
  label = 'Hebrew'
  contentDir = 'content.he'
  direction = 'rtl'
  weight = 3
```

A language selector dropdown appears automatically when multiple languages are configured.

## RTL Support

Set `direction = 'rtl'` on a language to enable right-to-left layout. The entire page layout, including the sidebar menu, mirrors automatically.

## Translation Dropdown

By default, all configured languages appear in the selector. To only show languages that have a translation for the current page

```toml {filename=hugo.toml}
[params]
  BookTranslatedOnly = true
```