Files
documentation/mkdocs.yml
2024-10-14 16:06:39 +02:00

141 lines
5.4 KiB
YAML

site_name: Armbian Documentation
site_author: "Armbian team"
site_url: https://docs.armbian.com
site_description: Official documentation for Armbian OS and Armbian build framework
copyright: Copyright © 2013 - 2024 Armbian.com
repo_url: https://github.com/armbian/documentation
repo_name: armbian/documentation
theme:
name: material
custom_dir: overrides
logo: images/logo.svg
icon:
repo: fontawesome/brands/github-alt
palette:
- scheme: default
primary: red
accent: red
toggle:
icon: material/toggle-switch-off-outline
name: Switch to dark mode
- scheme: slate
primary: red
accent: red
toggle:
icon: material/toggle-switch
name: Switch to light mode
favicon: images/logo.png
features:
- content.action.edit
- content.action.view
- content.code.copy
- navigation.tabs
- navigation.top
- toc.integrate
extra:
analytics:
provider: google
property: UA-284946-9
social:
- icon: fontawesome/brands/github
link: https://github.com/armbian
- icon: fontawesome/solid/house
link: https://www.armbian.com/
- icon: fontawesome/brands/twitter
link: https://twitter.com/armbian
plugins:
- search
# - with-pdf:
# author: Armbian documentation team
# copyright: © 2024 by Armbian
# cover_title: Armbian documentation
# cover_subtitle: Linux for ARM development boards
markdown_extensions:
- smarty
- footnotes
- mdx_truly_sane_lists
- toc:
permalink: True
- pymdownx.highlight:
auto_title: true
linenums: true
use_pygments: true
- pymdownx.superfences:
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_code_format
- markdown.extensions.admonition # Highlighted warning/info blocks
- markdown.extensions.attr_list # Set custom HTML attributes {: }
- markdown.extensions.footnotes # Footnotes [^1]
- markdown.extensions.meta # Define meta data (page title and description) at the top of the Markdown document
- markdown.extensions.smarty # Automatically convert dashes, underscore, three-dots and quotes to text symbols
- markdown.extensions.tables # Tables
- markdown.extensions.toc: # Add HTML id attribute to headers
permalink: true # Headers are links to themselves
- pymdownx.betterem: # More intuitive emphasis handling
smart_enable: all # Even smarter for both (asterisk and underscore) syntax => GitHub-like
- pymdownx.details # Collapsible details blocks
- pymdownx.emoji:
emoji_index: !!python/name:material.extensions.emoji.twemoji
emoji_generator: !!python/name:material.extensions.emoji.to_svg
- pymdownx.keys # Keyboard key symbols
- pymdownx.magiclink: # Auto-links non angle bracket URLs and email addresses and allows to shorten and visualise Git repo links
repo_url_shortener: true
repo_url_shorthand: true
- pymdownx.superfences # Indented code blocks, e.g. within lists, admonition, details or tabbed blocks, implies pymdownx.highlight
- pymdownx.tabbed: # Tabbed content blocks
alternate_style: true
slugify: !!python/object/apply:pymdownx.slugs.slugify
kwds:
case: lower
combine_header_slug: true
nav:
- 'ARMBIAN OS':
- 'Overview': 'index.md'
- 'Getting Started' : 'User-Guide_Getting-Started.md'
- 'Armbian Config' : 'User-Guide_Armbian-Config.md'
- 'Networking' : 'User-Guide_Networking.md'
- 'Fine Tuning' : 'User-Guide_Fine-Tuning.md'
- 'Basic Troubleshooting' : 'User-Guide_Basic-Troubleshooting.md'
- 'Recovery' : 'User-Guide_Recovery.md'
- 'Advanced Features' : 'User-Guide_Advanced-Features.md'
- 'Device tree overlays' : 'User-Guide_Armbian_overlays.md'
- 'FAQ' : 'User-Guide_FAQ.md'
- 'Release Model' : 'Process_Release-Model.md'
- 'Changelog' : 'Release_Changelog.md'
- 'ARMBIAN BUILD FRAMEWORK' :
- 'Overview' : 'Developer-Guide_Welcome.md'
- 'Build Preparation' : 'Developer-Guide_Build-Preparation.md'
- 'User Configurations' : 'Developer-Guide_User-Configurations.md'
- 'Extensions Hooks' : 'Developer-Guide_Extensions-Hooks.md'
- 'Board Maintainers' : 'Release_Board-Maintainers.md'
- 'Building with Multipass' : 'Developer-Guide_Building-with-Multipass.md'
- 'Build Options' : 'Developer-Guide_Build-Options.md'
- 'Building with Docker' : 'Developer-Guide_Building-with-Docker.md'
- 'Adding Board Family' : 'Developer-Guide_Adding-Board-Family.md'
- 'Extensions' : 'Developer-Guide_Extensions.md'
- 'ARMBIAN COMMUNITY' :
- 'Forums' : 'Community_Forums.md'
- 'Github' : 'Community_Github.md'
- 'Chat' : 'Community_IRC.md'
- 'CONTRIBUTE' :
- 'Contribute' : 'Process_Contribute.md'
- 'Managing_Workflow' : 'Process_Managing_Workflow.md'
- 'Armbian Task Tracking' : 'Process_Armbian-Task-Tracking.md'
- 'Merge Policy' : 'Process_Merge-Policy.md'
- 'Board Support Rules' : 'User-Guide_Board-Support-Rules.md'
- 'Maintainers_Procedures_and_Guidelines' : 'Board_Maintainers_Procedures_and_Guidelines.md'
- 'CI' : 'Process_CI.md'
- 'Review_Procedures_and_Guidelines' : 'Development-Code_Review_Procedures_and_Guidelines.md'