Documentation is written in markdown and stored in the
docs/ subfolder. Images go in
This repo is meant for storing and quick glances. Official output is http://docs.armbian.com.
Armbian Documentation is available in the following formats:
- mkdocs site http://docs.armbian.com.
- PDF user guides (in progress)
Armbian Documentation relies on a file naming convention:
Parent-Topic-Name and Child-Topic-Name are separated by an underscore
- are automatically converted to spaces.
Please try to avoid creating new parent topics unless absolutely necessary.
Current Parent Topics:
- Developer Guide
- User Guide
For easier testing and commits
.gitignore is configured to ignore
mkdocs.yml should probably be added, but we can commit for now
The documentation build process will require the following packages:
Install these on the development host using:
sudo apt-get install -y -qq git python-jinja2 mkdocs
generates mkdocs.yml file based on contents of
- command-line options for input and output directories
- requires the python-jinja2 module which may not be installed by default
- not needed unless making changes to the structure of the documentation
mkArmbianDocs.py -hfor help
The following capabilities are not yet available.
- html2doc output to PDF user manual
- automated mkdocs deployment to http://docs.armbian.com
From the parent folder of the repo, run:
tools/mkArmbianDocs.py && mkdocs build
This will generate the mkdocs.yml configuration file and then generate the mkdocs site to the
To preview locally, execute the preview server
mkdocs serve. You will be able to make edits to existing files and observe the results in real time.
After changing text in an existing file, use this command to rebuild and view the documentation:
mkdocs build --clean && mkdocs serve
After adding a new file, either hand-edit
mkdocs.yml, or rerun
pip install mkdocs git clone https://github.com/armbian/documentation #vim docs/[Parent Topic Example]-child-topic-example.md #generate config, build, launch local preview server tools/mkArmbianDocs.py && mkdocs build --clean && mkdocs serve git add docs/*.md git commit -m "added new howto on exampling" git push