DiscoTOC — автоматическое оглавление

Привет! Вы имеете в виду содержимое? Вы можете нажать на кнопку в таймлайне темы:

2 лайка

Привет! Было бы здорово, если бы при клике на пункт оглавления URL страницы менялся на соответствующий якорь заголовка, как это происходит при клике на ссылку-якорь слева от заголовка. Тогда можно было бы делиться ссылкой на конкретный раздел с другими людьми, даже если они не знают о существовании ссылок-якорей слева. Это уже рассматривалось?

1 лайк

Привет, короткий вопрос:
Ограничен ли уровень вложенности 5, или я что-то сделал неправильно?

Это интересно — я только что протестировал и могу подтвердить, что в оглавлении поддерживается только пять уровней, тогда как в Markdown поддерживается шесть. Я подозреваю, что это было сделано намеренно, так как шесть уровней могут быть неудобны для навигации.

2 лайка

Известны ли проблемы совместимости между DiscoToC и плагином Documentation Categories?
ToC отлично работает в обычных темах, но совершенно не работает в моих документах :confused:

2 лайка

Здравствуйте! Я заметил одну особенность, касающуюся кнопки переключения перевода темы при включенном плагине DiscoTOC.

Действительно, была добавлена кнопка для переключения между переводом темы на язык клиента и исходным текстом темы.

Вот как выглядит обычная тема с переводом без DiscoTOC:

А вот как выглядит тема с боковой панелью DiscoTOC:

Отсутствие кнопки настроек не является проблемой, поскольку те же самые функции доступны в нижней части темы. Однако таким же образом невозможно реализовать переключение перевода…

Можно ли рассмотреть возможность отображения этой кнопки даже при включенном DiscoTOC, поскольку она является стандартной кнопкой темы Discourse?

2 лайка

Не мог бы кто-нибудь объяснить, как добавить атрибут id к заголовку? Я попробовал метод, описанный здесь: Extended Syntax | Markdown Guide, добавив {#custom-id} в конец строки заголовка. Я также просто использовал HTML-теги h1 и добавил id. Ни один из этих способов не сработал.

Может быть, документация больше не актуальна? Если возможно добавить собственные идентификаторы, это решило бы проблему, с которой я столкнулся здесь, при условии, что эти идентификаторы работают в различных ситуациях с якорными ссылками.

3 лайка

да, это больше не актуально (я удалю это), теперь компонент использует якорные ссылки вместо идентификаторов заголовков… при добавлении заголовков в сообщения Discourse автоматически создает якорные ссылки, и они используются для оглавления

1 лайк

Спасибо!

Понимаю, что это, возможно, не строго связано с компонентом оглавления, но знаете ли вы, есть ли способ получить постоянные идентификаторы для заголовков? Автоматически генерируемые идентификаторы чрезвычайно ненадёжны. Даже добавление ещё одного заголовка в документ может изменить все идентификаторы.

Кстати… Есть ли способ с помощью этого плагина задать текст оглавления, отличный от заголовка в документе? Такой сценарий возникает, когда заголовок в документе длинный, а в оглавлении лучше использовать сокращённый вариант. Похожая функция есть в плагине для документации, где в индексе категорий можно указывать произвольный текст. Хотя это совершенно другая система.

1 лайк