Неправильный рендеринг блоков кода по readthedocs + mkdocs

У меня проблема с отрисовкой блоков кода в проекте документации с использованием Mkdocs с темой readthedocs. Кажется, что блоки кода неправильно анализируют новые строки, поэтому весь код в блоке кода отображается как одна строка.

Репо можно использовать для воспроизведения примера: https://github.com/segrelab/comets-manual < / а>. Рендеринг можно увидеть в https://segrelab.github.io/comets-manual/.

Единственная подсказка, которую я нашел в Google, - это this, но похоже, что это не так. предоставление любого решения, помимо определения того, что проблема связана с css (действительно, я пробовал другие темы, и блоки кода отображаются правильно).

Кто-нибудь знает, как это решить?


css markdown documentation read-the-docs mkdocs
person retrot    schedule 31.07.2020    source источник

Ответы (1)


arrow_upward
1
arrow_downward

Прежде всего, убедитесь, что ваш инструмент обновлен (я не могу воспроизвести неправильную отрисовку блоков кода):

pip install --upgrade mkdocs

Если проблема не исчезнет, ​​вы можете решить ее с помощью extra.css (кстати, extra.css и extra.js должны находиться в docs/css/extra.css и docs/js/extra.js; см. this). Если предположить, что страница отображается в текущий момент, следующее должно работать:

/* docs/css/extra.css */

code, .rst-content tt, .rst-content code {
  white-space: pre;
}

который каким-то образом установлен на white-space: nowrap; на отображаемой странице.

person tueda    schedule 10.08.2020