Files
documentation/mkdocs.yml
Igor 91d3a0fb65 Change logo and modernize main README.md (#788)
* Add files via upload

* Change logo

* Add support for images property and size logo accordingly

* Update README.md
2025-07-18 17:54:20 +02:00

181 lines
7.0 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
edit_uri: edit/main/docs/
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
- navigation.expand
- toc.integrate
extra_css:
- css/armbian-extra.css
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
- attr_list
- md_in_html
- pymdownx.blocks.caption
- footnotes
- mdx_truly_sane_lists
- toc:
permalink: True
- pymdownx.highlight:
auto_title: true
linenums: true
use_pygments: true
anchor_linenums: true
line_spans: __span
pygments_lang_class: true
- pymdownx.inlinehilite
- pymdownx.snippets
- pymdownx.superfences:
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_code_format
- name: custombash
class: custom-bash-block
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':
- 'Introduction': 'index.md'
- 'Getting Started' : 'User-Guide_Getting-Started.md'
- 'Advanced Usage' :
- 'Advanced Configuration': 'User-Guide_Advanced-Configuration.md'
- 'Networking' : 'User-Guide_Networking.md'
- 'Firstboot config': 'User-Guide_Autoconfig.md'
#- 'Device tree overlays' : 'User-Guide_Armbian_overlays.md'
- 'Troubleshooting and Recovery' : 'User-Guide_Troubleshooting.md'
#- 'Recovery' : 'User-Guide_Recovery.md'
- 'FAQ' : 'User-Guide_FAQ.md'
- 'Appendix' :
- 'Changelog' : 'Release_Changelog.md'
- 'Release Model' : 'Process_Release-Model.md'
- 'Unit Test Status' : '/'
- 'ARMBIAN CONFIG':
- 'Overview': 'User-Guide_Armbian-Config.md'
- 'System': 'User-Guide_Armbian-Config/System.md'
- 'Network': 'User-Guide_Armbian-Config/Network.md'
- 'Localisation': 'User-Guide_Armbian-Config/Localisation.md'
- 'ARMBIAN SOFTWARE':
- 'Overview': 'User-Guide_Armbian-Software.md'
- 'Armbian': 'User-Guide_Armbian-Software/Armbian.md'
- 'Backup': 'User-Guide_Armbian-Software/Backup.md'
- 'Containers': 'User-Guide_Armbian-Software/Containers.md'
- 'Database': 'User-Guide_Armbian-Software/Database.md'
- 'Development tools': 'User-Guide_Armbian-Software/DevTools.md'
- 'DNS blockers': 'User-Guide_Armbian-Software/DNS.md'
- 'Downloaders': 'User-Guide_Armbian-Software/Downloaders.md'
- 'Finance': 'User-Guide_Armbian-Software/Finance.md'
- 'Home automation': 'User-Guide_Armbian-Software/HomeAutomation.md'
- 'Management': 'User-Guide_Armbian-Software/Management.md'
- 'Media': 'User-Guide_Armbian-Software/Media.md'
- 'Monitoring': 'User-Guide_Armbian-Software/Monitoring.md'
- 'Music': 'User-Guide_Armbian-Software/Music.md'
- 'Netconfig': 'User-Guide_Armbian-Software/Netconfig.md'
- 'Printing': 'User-Guide_Armbian-Software/Printing.md'
- 'VPN': 'User-Guide_Armbian-Software/VPN.md'
- 'Web hosting': 'User-Guide_Armbian-Software/WebHosting.md'
# - 'Desktops': 'User-Guide_Armbian-Software/Desktops.md'
- 'ARMBIAN BUILD FRAMEWORK' :
- 'Overview' : 'Developer-Guide_Overview.md'
- 'Getting Started' : 'Developer-Guide_Build-Preparation.md'
- 'Build Commands' : 'Developer-Guide_Build-Commands.md'
- 'Build Switches' : 'Developer-Guide_Build-Switches.md'
- 'User Configurations' : 'Developer-Guide_User-Configurations.md'
- 'Extensions Hooks' : 'Developer-Guide_Extensions-Hooks.md'
- 'Building with Multipass' : 'Developer-Guide_Building-with-Multipass.md'
- 'Building with Docker' : 'Developer-Guide_Building-with-Docker.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'
- 'Armbian config': 'Contribute/Armbian-config.md'
- 'Wifi performance tests': 'WifiPerformance.md'
- 'Mirrors' : 'Mirrors.md'
- 'Automation' : 'Process_CI.md'
- 'Board Support Rules' : 'User-Guide_Board-Support-Rules.md'