Tabletop Simulator API
This is the source of the api documentation in Tabletop Simulator. It uses a modified version of Material-Design for MkDocs.
How it Works
.md files in the
/docs folder are written in Markdown, which is an easy-to-use markup language to add formatting to text. Additionally, some custom CSS is used, as well as a handful of custom images. When making changes, it is possible to live-preview them as you go if you have set up the local files for mkdocs + material design.
Alternatively, you can make modifications to individual pages then submit them for review. The developers will always be the ones to build and publish the site anyway, all you will do is modify the contents of this Git.
The API website is built using MkDocs and several related extensions.
Pull requests are welcome, however in order to preview your changes, you must follow the instructions below:
You will need to ensure Python
3.6 is installed on your system.
We utilise Pipenv and a
Pipfile to ensure builds are consistent. If you don't already have Pipenv installed, please follow the official pipenv install instructions for you platform.
Once've you installed the prerequisites, you must initialize your environment. From command line, this is done with:
You can then "activate" this environment with:
Once your Pipenv environment is activated, you can simply execute:
Then open your browser and navigate to
http://localhost:8000 in order to view your changes.