Как сделать стилизованное окно (для заметки / предупреждения /) в Gitbook?

Могу ли я каким-то образом создать <div> в выводе HTML Gitbook с именем класса, описанным в уценке. Я бы хотел сделать это для того, чтобы информационные блоки стояли отдельно от основного текста, что довольно часто встречается в технической литературе.

Я не хочу встраивать HTML в саму уценку, поскольку это в первую очередь испаряет весь смысл использования уценки.

В систему создания документов Sphinx, похоже, встроена такая поддержка. Вот образец:

.. NOTE:: If you are reading this as HTML, please read `<cheatsheet.txt>`_ instead to see the input syntax examples!

введите описание изображения здесь

Примечание. Это дубликат Могу ли я определить класс имя в абзаце с использованием Markdown? и Как установить атрибут класса HTML в Markdown?

Тем не менее, я думаю, что оставлю это здесь, поскольку акцент делается немного выше чисто технических. Хотел бы попробовать создать плагин для gitbook, чтобы обеспечить это.


markdown gitbook github-flavored-markdown
person akauppi    schedule 31.12.2015    source источник
comment
Спасибо за редактирование, @mzjn. Я все равно не решался с тегом Sphinx. Сейчас удалено.   -  person akauppi    schedule 31.12.2015
comment
Admonition Extension для Python-Markdown добавляет дополнительный синтаксис, который выводит HTML-вывод reStructeredText в формате HTML. . Фактически, вы можете использовать тот же CSS для его стилизации.   -  person Waylan    schedule 02.01.2016
comment
Я не хочу встраивать HTML в саму уценку, так как это испаряет весь смысл использования уценки ... Нет, не делает, по крайней мере, согласно его создателю. Прочтите первые три абзаца раздела HTML правил синтаксиса.   -  person Waylan    schedule 02.01.2016
comment
@Waylan Верно, но встраивание HTML - это улица с односторонним движением. Некоторые средства визуализации поддерживают markdown="1" для обработки внутренних частей как уценки. Это могло бы быть решением для меня, но gitbook, похоже, его не поддерживает.   -  person akauppi    schedule 03.01.2016

Ответы (1)


arrow_upward
1
arrow_downward

Вы можете попробовать использовать синтаксис цитаты и отредактировать CSS, чтобы он больше походил на примечание / предупреждение. Например:

Примечание.

Если вы сделаете это, могут случиться неприятности.

Это то, что GitLab делает в своей документации.

person ostrokach    schedule 05.01.2017
comment
Умная. Вероятно, можно использовать начало цитаты, чтобы различать разные типы (примечание / предупреждение / и т. Д.) - person akauppi; 06.01.2017