Skip to content

Help with Arlon Documentation

Prerequisites

Documentation for Arlon is written in Markdown format, and generated using the mkdocs site generator. The theme mkdocs-material has been used, and docs from the main branch are published to a GitHub pages site.

  • Install Python 3.x (3.8 or later recommended. 3.11 has been tested)
  • Install the pip python package manager for Python 3.
  • Install the Python modules mentioned in docs/requirements.txt
  • Run mkdocs serve to test any local changes to docs, and commit them using git workflow

Help with MkDocs

Welcome to Arlon documentation with MkDocs

For full documentation, visit mkdocs.org.

Commands

  • mkdocs new [dir-name] - Create a new project.
  • mkdocs serve - Start the live-reloading docs server.
  • mkdocs build - Build the documentation site.
  • mkdocs -h - Print help message and exit.

Project layout

mkdocs.yml    # The configuration file. 
              # Contains the navigation structure 
docs/
    index.md  # The documentation homepage.
    ...       # Other markdown pages, images and other files.