如何删除表 header 中的空行和 sphinx_rtd_theme 中的多行单元格？

Question

I am trying to make an HTML document in sphinx_rtd_theme. I want to make a table containing a multi-line cell, so I added a code like

+----------+----------+----------+
| header 1 | header 2 | header 3 |
+==========+==========+==========+
| a        | | b1     | c        |
|          | | b2     |          |
+----------+----------+----------+

As a result, I get an HTML file that looks like the following image:

There are blank lines in the header row and the second row. They make the table ugly so I want to remove those empty lines. Is there anything I can do this? Thank you for reading my question.

Answer 1

I solved the problem by adding

html_static_path = ['_static']
def setup(app):
    app.add_stylesheet('custom.css')

in the "conf.py", and

/* Table appearance */
.wy-table-responsive table td, .wy-table-responsive table th {
    /* !important prevents the common CSS stylesheets from
       overriding this as on RTD they are loaded after this stylesheet */
    white-space: normal !important;
}

.wy-table-responsive {
    overflow: visible !important;
}

in the "_static/custom.css", where I think the above code is copied from https://samnicholls.net/2016/06/15/how-to-sphinx-readthedocs/ .

In a way, there was already an answer to my question, but it took some time to realize that due to the lack of my knowledge on html, sphinx, and so on.

Anyway, thanks to Steve Piercy for help in the comment.

Answer 2

Penny for your thoughts, have you considered using list-table directive? It's my favorite and much simpler than grid tables where I have to literally paint the table myself