CODEWITHSUNDEEP
python-sphinxrestructuredtext
Pierrick Rambaud
Pierrick Rambaud

Reputation: 2384

Can I create a multi-line cell using list-table?

I'm using sphinx to build my lib diocumentation and serve it via ReadTheDoc website. I'm using the list-table directive to create table of data sources of my project.

I would like the first column to be a multi-line cell, is it possible ?

This does the trick but it's just empty lines not real multi-line cells:

.. list-table:: Title
   :header-rows: 1

   * - Heading row 1, column 1
     - Heading row 1, column 2
     - Heading row 1, column 3
   * - Row 1, column 1
     - Row 1, column 2
     - Row 1, column 3
   * - 
     - Row 2, column 2
     - Row 2, column 3

Note: everything in the second columns of my table is a reference to scientific article (so it's super long) I cannot afford to use the rst table syntax like in this post:

+----------+----------+----------+
| Header 1 | Header 2 | Header 3 |
+==========+==========+==========+
| | Item 1 |          |          |
| | Item 2 |          |          |
+----------+----------+----------+

Upvotes: 2

Views: 4618

Answers (1)

Steve Piercy
Steve Piercy

Reputation: 15045

No. Only grid tables support multi-line cells. Reference: https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#table-directives

Upvotes: 1

Related Questions