Сфинкс, reStructuredText показывают/скрывают фрагменты кода
Я документировал пакет программного обеспечения с помощью Сфинкса и reStructuredText.
В рамках моих документов существуют некоторые длинные фрагменты кода. Я хочу смочь иметь их скрытый как значение по умолчанию с небольшой кнопкой "Show/Hide", которая развернула бы их (Пример).
Существует ли стандартный способ сделать это?
18
задан tshepang 16 March 2013 в 12:38
поделиться
1 ответ
Я думаю, что самый простой способ сделать это - создать собственную тему Sphinx, в которой вы указываете определенным элементам html наличие этой функции. Небольшой JQuery здесь поможет.
Однако, если вы хотите указать это в разметке reStructuredText, вам потребуется либо
- включить такую вещь в сам Sphinx, либо
- реализовать ее в расширении Sphinx / documenttils ... а затем создайте тему Sphinx, которая знает об этой функциональности.
Это потребует немного больше работы, но даст вам больше гибкости.
6
ответ дан 30 November 2019 в 06:22
поделиться
Другие вопросы по тегам: