Wiki Infrastructure Overview

The wiki is built using the static site generator Sphinx from source written in reStructured Text markup and hosted on Github here.

The wiki has several sections:

  • Common holds pages that are common to all vehicles like the Optional Hardware section of the wikis. The pages all have the common- prefix and are stored in the /common/source/docs/ directory. Common images are in the images directory. Common configuration information for the Wiki Sphinx build is stored in /common_conf.py.
  • Each vehicle or ground station has a separate folder in the repository (e.g. ‘/copter’, ‘/plane’) which contains its own source and configuration files (conf.py). Corresponding images are stored in the /images/ subfolder.

The update.py build script copies the common topics into specified (in source) target wikis directories and then build them.

The Vagrantfile can be used by Vagrant to set up a local build environment independent of your host system. This allows you to edit the source in your host computer but manage the build inside Vagrant. You can also manually set up a build environment (just inspect the Vagrantfile for dependencies).

The wikis use a common theme that provides the top menu bar.