# How to Build the Documentation from a Sphinx project¶

Briefly:

make html


Load the file index.html into your browser and examine the results. The file path is different depending if you have an in-source or out-of-source configuration.

in-source path:
_build/html/index.html
out-of-source path:
build/html/index.html

## Test¶

For our testing purposes, we’ll document the aalength.mac macro file from the Install section. Edit the new file index.rst and add this line at line 14. Make sure it lines up at the left in column 1:

.. autospecmacro:: ../specdomain/doc/aalength.mac


Build the HTML documentation:

make html


View the documentation using a web browser such as firefox:

firefox _build/html/index.html &


You should see a page that looks like this, if nothing went wrong.