Skip to content
This repository has been archived by the owner. It is now read-only.
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Emlid docs

This is a repo containing all Emlid docs


We use mkdocs to build the docs and Pipenv to manage the dependencies.

  • python3
  • python3-pip
git clone
pip3 install pipenv
cd emlid-docs
pipenv install

Editing docs with templates

Adding new templates

To add new template you need to create a jinja2 template in emlid-docs/docs/templates/ with .mdx extension and add an entry to 'templates' section of one or several .yml config files in following format.

templates:  # <- this should already be in the file
    destination: '<template-name.mdx>'

Where destination is the name of the file in docs_dir (docs_dir is specified in each .yml file) directory, that is going to be rendered via template.

And template_name name is the name of the actual template file with .mdx extension that must be placed inside emlid-docs/doc/templates directory.

Without these entries template will be ignored.


templates: 'index.mdx' 'power-supply.mdx'

Updating docs after editing templates (Generating markdown)

Template building script takes the path to .yml file as an argument and rebuilds docs from every template specified in .yml. This should be run after making any changes to templates.

cd emlid-docs
pipenv run python <target>
# Where <target> is .yml config file.
# example
pipenv run python reachm-plus.yml 

Generating HTML

cd emlid-docs
pipenv run mkdocs build -f <target>.yml -d <dir>

This will build the <target> and save the generated docs to <dir>.

You can also pipenv run mkdocs serve -f <target>.yml to take a look at the docs on your local machine.

To preview changes in html after rendering templates automatically run pipenv run python <target>.yml. This essentially executes and mkdocs serve -f in one command.