python - How can I adjust alignment in a sphinx PDF table? - Stack Overflow

admin管理员组

文章数量:1345452

I want to control the vertical and horizontal alignment of the cells in a table generated with sphinx and texlive, and I want to be able to force a new line in my csv file. I'm using python==3.13.2 and sphinx==8.2.3

I was able to figure out the horizontal alignment, but I haven't been able to figure out the vertical alignment or how to add a new line in the csv file. I've tried adding \newline (and variations with more slashes) to try and force the column labeled "column header" to be split across multiple rows. For example, column\\\\newlineheader in the csv file didn't work.

table.csv:

run,column header,really long center column header,really long left column header,really long left column header,really long right column header,small
1,1,1,1,1,1,1
2,2,2,2,2,2,2
3,3,3,3,3,3,3
4,4,4,4,4,4,4
5,5,5,5,5,5,5

Sphinx syntax:

.. tabularcolumns:: |>{\centering\arraybackslash}\X{1}{12}|>{\raggedleft\arraybackslash}\X{2}{12}|>{\centering\arraybackslash}\X{2}{12}|>{\raggedright\arraybackslash}\X{2}{12}|>{\raggedright\arraybackslash}\X{2}{12}|>{\raggedleft\arraybackslash}\X{2}{12}|>{\center\arraybackslash}\X{1}{12}|

.. csv-table:: My CSV Table with X{}
   :file: _static/table.csv
   :header-rows: 1
   :align: center

The above code produces the image below. What I want is for the column "column header" to be split across multiple rows like "column\nheader" and all of the cells should be vertically centered. For some reason it looks like the "small" column isn't top aligned, but the rest are.

本文标签： pythonHow can I adjust alignment in a sphinx PDF tableStack Overflow