References
==========

R2T2 works by decorating functions, classes or methods
with ``@add_reference``
where particular algorithms described in a paper are implemented
or data stored in a repository is used.

In Function
-----------

..  literalinclude:: ../examples/minimal.py
    :language: python

In Class
--------

..  literalinclude:: ../examples/minimal-class.py
    :language: python

In Method
---------

..  literalinclude:: ../examples/minimal-method.py
    :language: python

Two or More References
----------------------

..  literalinclude:: ../examples/multiple.py
    :language: python

As Docstring
------------

R2T2 will parse the docstring searching for the DOI.

..  literalinclude:: ../examples/docstring_doi.py
    :language: python

R2T2 will also search for Sphinx's ``cite`` directive.

..  literalinclude:: ../examples/docstring_sphinx_cite.py
    :language: python