.. highlight:: sh

*******************
Building on Windows
*******************

Converting the RST-files into pretty HTML pages.
There are two ways to run the build process.


.. rubric:: File browser

Run ``make.bat`` in the ``C:\blender_docs`` folder.

.. tip::

   Create a desktop shortcut to ``make``.


.. rubric:: Command prompt

#. Or open a command prompt and change to the repository with ``cd C:\blender_docs``.
#. Build using the following command::

      make

The building process may take several minutes the first time (or after any major changes),
but the next time you build it should only take a few seconds.

.. note::

   If you encounter an error ending with ``TypeError: an integer is required (got type str)``,
   you may need to install an older version of *Babel* (the Python Internationalization Library).

   To do this, simply run::

      pip install sphinx "babel<2.0"


Viewing the Local Manual
========================

Once the docs have been built, all the HTML files can be found inside ``C:\blender_docs\build\html``.
Try opening ``\build\html\index.html`` in your web browser and read the manual.


------------------------

Continue with the next step: :doc:`Editing </about/contribute/editing>`.