Add interactive data tables

The Sphinx DataTables extension enables interactive tables. Users can sort columns and filter rows. For examples, see the extension’s documentation.

The extension isn’t available by default in the starter pack. To read more about table functionality that is available out of the box, see Tables (MyST) and Tables (reST).

Include the sphinx-datatables extension

To include the extension in your documentation, add sphinx-datatables to docs/requirements.txt.

Then, add sphinx_datatables to the extensions list in docs/conf.py.

Make a table interactive by adding a special CSS class to the directive:

reST

.. csv-table::
   :class: sphinx-datatable
   :file: /reuse/animals.csv
   :header-rows: 1

MyST

```{csv-table}
:class: sphinx-datatable
:file: /reuse/animals.csv
:header-rows: 1
```