Enclosed Files

Sphinx does not recognize files which are referenced in a non-Sphinx syntax, e.g. in raw-html:

.. spec::

    Some text: :raw-html:`<img src="folder/image1.png" />`

.. spec::

    Implement the following:
    :raw-html:`<a href="table.xlsx">download table</a>`

To make these files available in the output folder, add an enclosed directive to the RST-file:

.. enclosed::

    folder/image1.png
    table.xlsx

Add one file per line without comma or bullet points.

Note

This directive is a workaround if you need to generate RST files from HTML sources. If possible, use regular Sphinx syntax instead to avoid this workaround.