Удалить пробел в верхней части sphinx pdflatex оглавление

Question

Я строю свою документацию пакета python как HTML и как латексный PDF. Созданный по умолчанию латекс pdf (ручной класс) имеет большое количество пробелов в верхней части оглавления вокруг текста «СОДЕРЖАНИЕ». Я не очень хорошо знаком с латексом, поэтому, когда я смотрю на сгенерированный файл .tex, я не вижу ничего, что подсказывает, как удалить пробелы.

Я искал вокруг и не мог найти латексное решение, которое сработало. Я также попробовал установить :caption: на toctree на пустую строку, но это фактически удаляет весь TOC и весь мой контент.

Может ли кто-нибудь помочь мне с этим?

Answer 1

поведение по умолчанию Сфинкса для английского языка является использование опции Бьярне в LaTeX пакет fncychap для заголовков глав. Но он также загружает пакет titlesec для общепринятых заголовков заголовков. Он не делает специальное определение главы с titlesec, которые просто собирают определение fncychap и обертывают его в собственные крючки. Во всяком случае, делая историю короткой, мы находим

\ttl@save@mkschap #1->\vspace *{50\p@ }{\parindent \z@ \raggedright \normalfont \interlinepenalty \@M \DOTIS {#1} \vskip 40\p@ } 

в логе и это fncychap определение \@makeschapterhead, как сохраняется titlesec в своем макро \ttl@save@mkschap.

fncychap загружается раньше sphinx.sty, не крюк,

редактировать: фактически 'fncychap' Ключа, значение по умолчанию '\\usepackage[Bjarne]{fncychap}' может служить, чтобы добавить некоторый код, чтобы переопределить настройки fncychap для ипа пронумерованных названий глав. Это не то, что отличается от подхода с 'preamble' ключом ниже, за исключением того, что не нужно было знать об titlesec вмешательстве во все это.

но с недавнего времени Sphinx 1.5 вы можете использовать свой собственный шаблон Jinja для содержания латекса. Из внешнего вида вашего contents который мал, я думаю, что у вас есть старая версия Сфинкса, таким образом, я буду идти на LaTeX взлома вариант что-то вроде этого:

latex_elements = { 
    # The paper size ('letterpaper' or 'a4paper'). 
    # 
    # 'papersize': 'letterpaper', 

    # The font size ('10pt', '11pt' or '12pt'). 
    # 
    # 'pointsize': '10pt', 

    # Additional stuff for the LaTeX preamble. 
    # 
    'preamble': r""" 
\makeatletter 
\def\ttl@save@mkschap #1{\vspace *{10\p@ }{\parindent \z@ \raggedright 
    \color{blue}% 
    \normalfont \interlinepenalty \@M \DOTIS {#1} \vskip 10\p@ }} 
\makeatother 
""", 

    # Latex figure (float) alignment 
    # 
    # 'figure_align': 'htbp', 
} 

я добавил \color{blue} там только для демонстрационных целей , и изменили команды \vspace и \vskip, которые вам нужны.

Изображение показывает, однако, что существует некоторый дополнительный источник вертикального пространства между содержимым и содержимым ООС (он остается даже с \vskip 0\p@, но можно сделать \vskip -40\p@ ...), но я думаю, что вы находитесь за верхним пространством над содержимым и уже используя только \vspace*{10pt}, он значительно уменьшил (на скриншоте ниже не видно).