Links, Citations and Bibliography
---------------------------------

To link an url:

.. code-block:: rst

    `link text <url>`_

The references are defined in  ``.bib`` files listed in the ``conf.py`` file. 
A reference example:

.. code-block::

    @article{knuth:1984,
      title={Literate Programming},
      author={D. E. Knuth},
      journal={The Computer Journal},
      volume={27},
      number={2},
      pages={97--111},
      year={1984},
      publisher={Oxford University Press}
    }

To cite:

.. code-block:: rst

    :cite:`key`

To make the bibliography:

.. code-block:: rst

    .. bibliography::