Я использую DiscoTOC уже давно, и до недавнего обновления он отлично работал с заголовками на китайском языке.
Если в посте есть несколько заголовков на китайском языке (без символов ASCII), то при клике на элемент навигации в правой части страницы переход осуществляется только к первому заголовку одного уровня. Я полагаю, что проблема в том, что DiscoTOC генерирует элементы навигации с одинаковыми идентификаторами (поскольку все заголовки на китайском языке). Следовательно, селектор запросов находит только первый заголовок.
В качестве эксперимента я сделал форк репозитория GitHub и добавил небольшой коммит:
Похоже, это работает на моём сайте. Если команде это решение подойдёт, я могу создать pull request, либо эту ошибку нужно исправить другим способом.
Прежде всего, это очень полезный компонент темы для длинных постов!
Однако есть проблема с этим компонентом темы на мобильных устройствах (по крайней мере, на iOS). Когда я открываю большое оглавление, прокрутка по оглавлению не работает на мобильных устройствах так, как на компьютере.
Список содержит заголовки A–H, но я не могу прокрутить его
Кажется, что список прокручивается, но событие touchstart препятствует прокрутке списка. Отключение слушателя события touchstart для элемента d-toc, похоже, решает проблему.
Я не могу увидеть версию компонента темы, которая используется на нашем форуме, и не могу протестировать это на локальной установке (так как я не могу загрузить её на телефон). Поэтому, если есть исправление, о котором я не знаю, или если есть что-то, что мне следует сделать, пожалуйста, дайте мне знать.
@pmusaraj, возможно, я что-то настроил неправильно, но я установил тему, и оглавление, которое я настроил для темы, не отображается на версии discourse-docs, хотя в основной теме оно появляется.
Исправление проблемы с прокруткой на мобильных устройствах теперь включено в основную ветку. Я также добавил исправление совместимости для представления Docs в Discourse; вы можете увидеть его в действии здесь на meta.
В следующий раз, когда вы обновите DiscoTOC, вы, скорее всего, заметите, что мы добавили кнопку для переключения между временной шкалой темы и оглавлением… сообщите нам, если вы столкнётесь с какими-либо проблемами или у вас есть отзывы об этой новой функции!
Я только что внес небольшое обновление в эту тему, которое игнорирует требование к уровню доверия для учётных записей сотрудников; это больше соответствует тому, как работают настройки в Discourse.
Этот компонент отлично работает для первого поста, спасибо за него…
Интересно, возможно ли сделать авто-оглавление также для постов ниже? Это кажется распространённым случаем, когда пытаешься документировать что-то в одном посте с комментариями ниже…
Например, при просмотре основного поста или ответов ниже, если в посте/ответе определены заголовки/подзаголовки, автоматически показывается его оглавление, иначе — стандартная временная шкала.
Я не читал эту длинную ветку, сделал быстрый поиск, похоже, это не обсуждалось…
Не знаю почему, но я не вижу кнопку переключения между контентом и оглавлением.
То же самое происходит с официальным disco-toc и форком от @Moin…
Есть ли для этого какая-то настройка? Похоже, что нет… хм…
Моя система работает на Discourse 3.2.1
Да, основные версии выпускаются гораздо реже, поэтому в противном случае вам, возможно, придётся ждать новые функции и обновления безопасности месяцами. По умолчанию мы рекомендуем всегда использовать наши бета-версии. Подробнее здесь: Understanding Discourse release channels