# Authoring

> Author, organize, and style content for an Oink documentation site.

---

LLMS index: [llms.txt](/llms.txt)

---

Start with site-wide [configuration](configuration/), then shape the content
tree, writing conventions, navigation, visual language, media, shortcodes, and
reusable components. These pages focus on authoring choices that remain under
the consuming site's control.

---

Section pages:

- [Configuration](/docs/content/configuration/): Configure Oink with Hugo settings and focused theme parameters.
- [Adding content](/docs/content/adding-content/): Structure and author bilingual documentation and blog content.
- [Organize your content](/docs/content/organize-content/): Structure documentation around reader goals and content types.
- [Hugo authoring tips](/docs/content/writing-guide/): Avoid common pitfalls when writing content for an Oink site.
- [Navigation and menus](/docs/content/navigation/): Configure navigation, language switching, sidebars, and outlines.
- [Look and feel](/docs/content/lookandfeel/): Customize themes, typography, code styles, and page layouts.
- [Code blocks and Code Groups](/docs/content/code-blocks/): Add filenames, exact Copy behavior, wrapping, collapse, and shareable groups to Hugo code examples.
- [Logos and images](/docs/content/iconsimages/): Configure logos, page icons, favicons, and images.
- [Shortcodes](/docs/content/shortcodes/): Use OINK's local-first content components safely and accessibly.
- [Content components](/docs/content/components/): Use Oink's local, reusable components for richer documentation.
- [Diagrams and formulae](/docs/content/diagrams-and-formulae/): Add local diagrams, mind maps, and scientific formulae to a page.
- [Taxonomy support](/docs/content/taxonomy/): Organize content with tags, categories, and custom taxonomies.