||||
-|-| | Краткое описание | Плагин Discourse Footnote позволяет пользователям создавать сноски в формате Markdown в своих сообщениях. | Руководство по установке | Этот плагин входит в состав ядра Discourse. Отдельная установка плагина не требуется.
Включение сносок
Плагин Footnote включен по умолчанию, но его можно отключить/включить на странице admin/plugins:
Возможности
После включения вы можете добавлять сноски в свои сообщения, вводя их следующим образом:
Предложение, требующее сноски. ^[Сноска]
Еще одно предложение, требующее сноски. ^[Вторая сноска]
Или так:
Предложение, требующее сноски. [^1]
Еще одно предложение, требующее сноски. [^2]
[^1]: Сноска
[^2]: Вторая сноска
Вы можете использовать оба стиля в одном сообщении, а также применять нумерованные и ненумерованные якоря.
Существует два способа отображения сносок, управляемые настройкой администратора display footnotes inline (отображать сноски в строку):
Предложение, требующее сноски[1]
Еще одно предложение, требующее сноски[2]
Варианты отображения в строку совместимы с цитатами и удобны для мобильных устройств.
Настройки
Название | Описание
|-|
enable markdown footnotes | включить синтаксис Markdown для сносок на этом сайте
display footnotes inline | включить раскрытие сносок в строку
Просто предупреждение: похоже, расширение не поддерживает обычный Markdown для сносок с использованием [^1]. Форматированные сноски появляются только при использовании «встроенного» форматирования, например так:
Включение сносок с использованием встроенного форматирования приводит к появлению автоматически нумеруемых сносок, которые затем отображаются ниже поста вместе. При этом включение опции встроенного расширения активирует всплывающую подсказку с троеточием, и сноски не появляются ниже поста. Если у вас включена опция встроенного расширения, окно предварительного просмотра вашего поста будет выглядеть как традиционные нумерованные сноски, но после публикации вы увидите эффект встроенного расширения.
Я ценю автоматически нумеруемые сноски, использующие встроенное форматирование; мне просто потребовалось несколько попыток, чтобы понять, как правильно форматировать Markdown и какие опции заставят их работать как нужно. Надеюсь, этот комментарий поможет кому-то ещё избежать той же путаницы.
Редактирование: опция встроенного расширения определяет, как ваши сноски будут отображаться на мобильных устройствах, независимо от того, включена ли эта опция (также для настольных версий).
Когда вы впервые сталкиваетесь с группой с открытым исходным кодом, это может быть ошеломляющим опытом. Будь то первый пост в рассылке, блог о проекте, над которым вы работаете, или общение в IRC-канале — то, как люди взаимодействуют и чего ожидают друг от друга, сильно отличается от общения в классе или с друзьями и семьёй.
Коммуникация в сообществе с открытым исходным кодом может сильно различаться. Общей ценностью является то, что обмен кодом — это хорошо. Независимо от лицензии, языка или стиля отступов, разработчики с открытым исходным кодом совместно создают, обмениваются и изменяют исходный код.
Работает ли плагин сносок на публичных страницах? В моём конкретном случае мне нужно, чтобы он НЕ работал на публичных страницах и был виден только в обычном просмотре темы (например, для внутренних заметок и т.п.)
Похоже, это было перенесено в ядро 17 часов назад.
Я передам кому-то другому обновление этого сообщения.
Перевод отсутствует: en.Плагин discourse-footnote был интегрирован в ядро Discourse. Пожалуйста, удалите плагин из вашего app.yml и пересоберите контейнер.
Другая проблема заключается в том, что вам больше не нужно устанавливать плагин, и если вы его уже установили, вам не нужно включать команду git clone в ваш файл yml.
Это потрясающе! Я знал, что у вас есть план. Мне следовало просто подождать, так как то, на что я указал, на самом деле было проблемой, которую, в свою очередь, решил кто-то другой, и мне следовало просто проявить терпение, поскольку я знал, что вы собирались это решить. (И это ещё и так красиво!).
Прошло ещё меньше 24 часов, так что, знаете, это тоже довольно неплохо.
Я заметил, что сноски не позволяют использовать многие элементы синтаксиса Markdown внутри скобок сноки^[Пример: Это находится внутри скобок сноки, но макет ломается, когда я добавляю абзацы, заголовки, списки и т. д.
Вот разрыв абзаца.]
Это не критично, но, безусловно, ограничивает функциональность того, что можно поместить в сноску!
Вы можете, главное — используйте отступ минимум в 4 пробела.
Например:
Вот ссылка на сноску[^1], и ещё одна[^longnote].
[^1]: Вот текст сноски.
[^longnote]: Вот пример с несколькими блоками.
Последующие абзацы имеют отступ, чтобы показать, что они
относятся к предыдущей сноске.
* item1
* item 2
**Больше** текста
<em>курсив</em>
| Краткое описание | Плагин Discourse Footnote позволяет пользователям создавать сноски в формате Markdown в своих сообщениях.
| Руководство по установке | Этот плагин входит в состав ядра Discourse. Отдельная установка плагина не требуется.
Хостинг предоставляется нами? Этот плагин доступен на всех тарифах хостинга Footnote | Discourse - Civilized Discussion
Вот снимок обоих для сравнения:
Discourse Footnote теперь включён в ядро Discourse, поэтому этот плагин больше не нужно устанавливать отдельно. 
