Skip to content

Advanced Configuration

Advanced configuration examples and customization techniques.

Theme Customization

Custom Colors

Modify theme colors in mkdocs.yml:

YAML
theme:
  palette:
    - scheme: default
      primary: deep purple
      accent: amber

Custom Fonts

YAML
theme:
  font:
    text: Roboto Slab
    code: Source Code Pro

Plugin Configuration

Fine-tuning Mermaid

YAML
plugins:
  - mermaid2:
      arguments:
        theme: dark
        themeVariables:
          primaryColor: '#1976d2'

MkDocstrings Options

YAML
plugins:
  - mkdocstrings:
      handlers:
        python:
          options:
            show_source: false
            members_order: alphabetical

Let awesome-nav handle it automatically based on folder structure.

Best Practices

  1. Keep configuration organized
  2. Use comments in YAML
  3. Test changes locally
  4. Version control your config