###################################################
Add new page
###################################################

Under the ``docs/source/`` directory create a new page called ``new_page.rst`` file and save it.

Edit ``*.rst`` file
====================================================================

To add or modify content in existing page, edit the ``new_page.rst`` file and save it.

Please refer to ``RST`` documentation for reference on the syntax.

Reference the ``*.rst`` file in ``toctree``
====================================================================

In order for the new page to appear in the left navigation pane, it needs to be referenced in existing ``*.rst`` file under the ``toctree`` section.


.. code-block:: rst

    .. toctree::
        :maxdepth: 5
        :titlesonly:
        :glob:

       New page <new_page.rst.rst>


Rebuild the project and deploy it
====================================================================

.. code-block:: bash

     (.venv) usr1@server:~/sphinx$ sphinx-build -M html docs/source/ docs/build/
     (.venv) usr1@server:~/sphinx$ cp -R -v docs/build/html /var/www/{website directory}/


Go to the url of your website and refresh. You should see the change applied to your page.