diff --git a/README.md b/README.md index 754c038e..d0c04254 100644 --- a/README.md +++ b/README.md @@ -69,11 +69,21 @@ On Windows, you need to: * Install Python. Don't forget to check the "Add Python to PATH" box. * Use the above `pip` commands. -Building is still done at the root folder of this repository, but with this command line instead: +Building is still done at the root folder of this repository using the provided `make.bat`: +```sh +make.bat html +``` + +Alternatively, you can build with this command instead: ```sh sphinx-build -b html ./ _build ``` +Note that during the first build, various installation prompts may appear and ask to install LaTeX plugins. +Make sure you don't miss them, especially if they open behind other windows, else the build may appear to hang until you confirm these prompts. + +You could also install a normal `make` toolchain (for example via MinGW) and build the docs using the normal `make html`. + ### Building with Sphinx and virtualenv If you want your Sphinx installation scoped to the project, you can install it using virtualenv.