sphinx-doc / sphinx

The Sphinx documentation generator
https://www.sphinx-doc.org/
Other
6.44k stars 2.1k forks source link

Long tables are not neat in Latex #1898

Open nastasviatoha opened 9 years ago

nastasviatoha commented 9 years ago

Hi,

I have a lot of long tables in my project. They are displayed fine in HTML, for example like the following table: http://prntscr.com/783e6r http://prntscr.com/783ecb

But it is displayed awfully in Latex: https://drive.google.com/file/d/0B4mCq7gApRAgNnRPVmlQLTE2Sm8/view?usp=sharing

gusmd commented 7 years ago

Hi, I'm having the same problem. Based on https://github.com/sphinx-doc/sphinx/issues/2620#issuecomment-275901301 only tables with more than 30 rows use longtable, which would solve our issue -- I've modified the LaTeX myself to make sure.

Looks like number of rows is a very good metric to use since rows can be quite big by themselves, as shown in this issue.

Are there any plans to fix this?

Edit: An workaround is to force Sphinx to use longtable by specifying :class: longtable.