Оглавление в уценке для Николы
Я использовал Sphinx для своего личного веб-сайта в течение последних лет и понял, что у меня больше блогов с сообщениями и несколькими страницами, и в последние дни я сделал преобразование в Nikola. Я также воспользовался возможностью переключиться на Markdown, поскольку использую его с R и stackru, а также везде.
Я установил в своей теме Sphinx локальное оглавление на боковой панели. Есть несколько очень длинных (более 10 тысяч слов) сообщений, для которых было бы полезно использовать локальное оглавление. Я видел, что руководство Nikola написано на reST и используетcontents
директива. Я хотел бы использовать это также в этих сообщениях.
Я мог бы преобразовать эти несколько сообщений обратно в reST и использовать директиву contents, но я бы хотел этого избежать. Можно ли как-нибудь этого добиться?
2 ответа
Обновлено
С помощью [TOC]
это функция расширения, включенного по умолчанию. Мой первый ответ был неправильным толкованием вашего вопроса.
Первый ответ
При использовании Nikola, возможно, вас заинтересует вариант "архивировать". Это страница по умолчанию, которая включает все ваши сообщения (необязательно, сгруппированы по дате). Пример в моем блоге: https://www.cosmoscalibur.com/archive.html.
Никола по умолчанию использует Python-Markdown. Он поддерживает расширение TOC, которое можно включить вconf.py
. Тогда можно использовать[TOC]
маркер в любом месте документа, чтобы получить локальное оглавление.