Build and edit documentation

minecraft-launcher-lib uses Sphinx for it’s documentation. The documentation is hosted on Read the Docs. You can find the source files for the documentation in doc folder.

Plugins

minecraft-launcher-lib uses the following Sphinx plugins:

These plugins are all completely optional. You can build the documentation without having these plugins installed. The features, that the plugins provide are missing in that case.

Building

First you need to install Sphinx and the Read the Docs theme:

pip install sphinx sphinx-rtd-theme

You can also install the plugins, if you want to e.g. test the dark mode.

To build the documentation open a command line in the doc folder and run:

# Unix based Systems
make html
# Windows
.\make.bat html

Now you can view the documentation by opening _build/html/index.html in your favorite browser.

Examples

The examples are stored in the examples folder. They are added to the documentation during build. Please do not edit anything inside doc/examples. All files in this folder are overwritten during the build.