csv-table форматирование через преамбулу?

Question

Попытайтесь, как я мог, я не могу понять, как изменить формат таблицы по умолчанию в pdf-выходе из sphinx.

Я мог бы отредактировать файл .tex или исходный код writer.py ... но обе эти функции выглядят как плохие.

Есть ли какие-либо вещи, которые могут быть переданы в преамбулу, чтобы выполнить это?

Answer 1

В зависимости от того, что вы пытаетесь выполнить, изменив формат таблицы. Например, если вы хотите определить цвета строк и соответственно изменить таблицы в документе, вы можете использовать пакет xcolor и переопределить, как табличные дескрипторы, которые находятся в точке определения, изменяя табличную среду.

Таким образом, в преамбуле вы могли бы сделать

\usepackage[table]{xcolor} 
\definecolor{foo}{RGB}{236,137,29} 
\definecolor{bar}{RGB}{232,108,31} 

\let\newtabular\tabular 
\let\newendtabular\endtabular 
\renewenvironment{tabular}{\rowcolors{2}{foo}{bar}\newtabular}{\newendtabular} 

Это перезапишет среду табличный по умолчанию и применить Foo и бар цвета строк по всему документу, начиная со второго ряда.

Для получения дополнительных указаний, относящихся к таблицам. Вы должны посмотреть на sphinxtr

В Jeff Terrace есть несколько отличных расширений, но два основных для использования: numfig и figtable. Вы можете обернуть таблицу csv в figtable.

.. figtable:: 
    :label: my-csv-label 
    :caption: My CSV Table 
    :nofig: 

    .. csv-table:: 
    :file: data/foo.csv 
    :header-rows: 1 

Изменение стандартного формата таблицы с заголовком ниже, а не сверху. Тогда у вас также есть дополнительное преимущество в том, что вы можете напрямую ссылаться на эту таблицу, используя: num :.

:num:`Table #my-csv-label` 

Он автоматически присваивает номер, не ссылаясь на название этикетки. Вы также можете использовать

.. figtable:: 
    :spec: {r l r l} 

Чтобы лучше определить, как вы хотите, чтобы ваша таблица появлялась.