Skip to content

How to Edit This Site

Our site uses separate frameworks for our main landing page and documentation site. pittsailbot.github.io is built using static HTML/JS/CSS and our documentation is built with mkdocs. This provides flexibility for our web-design and ease-of-use for writing documentation.

Why static and not React/Svelte/X framework? - Our site is not complicated - Pure html minimizes dependencies

Documentation is written in markdown and published through Github pages using mkdocs. If you're unfamiliar with using markdown, check out this handy cheat sheet.

In depth documentation for mkdocs can be found here.

  • Google Analytics for our site can also be viewed here

Install dependencies

  1. In the terminal, install dependencies with:
pip install -r requirements.txt

Making changes

Our documentation is written in markdown and is organized into pages by mkdocs.yml. The main site is a combination of html and css.

  • For editing any pre-existing .md files, changes will be updated automatically

  • If you are adding any new files, then add the file under the mkdocs.yml's nav config like so:

nav:
   - Getting Started: "Getting Started.md"

This will make the file "Getting Started.md" visible on the web page's index

Previewing changes

To preview the documentation site before pushing changes to github:

  1. In the terminal, run:
mkdocs serve
  1. In any web browser navigate to 127.0.0.1:8000