Категории документации Discourse

5 сообщений были перенесены в новую тему: Подсветить текущую тему документации в боковой панели по их слагам в индексе

Нормально ли, что после использования категорий документов, при просмотре темы в этой категории в боковой навигации исчезает ссылка на админ-панель? Мне это довольно раздражает, но я не знаю, является ли это общей проблемой или спецификой моей настройки. Мне кажется, что доступ к «административным функциям» должен быть в стабильном месте для администраторов сайта?

1 лайк

Да, это нормально. Обычная боковая панель заменяется на панель «Категории документации». Административные элементы находятся в стабильном месте… как только вы вернетесь назад:

1 лайк

Правильно — есть ли способ настроить боковую панель «Категории документов»? Мне очень нравится список документов, но то, что обычно присутствующие элементы боковой панели, такие как «Мои сообщения» и т. д., внезапно исчезают, сбивает с толку, особенно потому, что остальной дизайн практически не меняется. Думаю, если бы при просмотре «Категорий документов» общий вид сильно отличался, это не вызывало бы такой путаницы. Я знаю, что когда я впервые попал на Meta, вся эта система документации сбила меня с толку, и я какое-то время избегал её :face_with_peeking_eye: (я думал: «О боже, где я сейчас?»).

3 лайка

Немного CSS может придать боковой панели документации уникальный цвет фона — возможно, это поможет?

.discourse-docs-sidebar-panel {
background-color: darkmagenta;
}

5 лайков

Отличная идея, спасибо! Я подробнее изучу различные селекторы для части макета страницы Discourse. Думаю, где-то есть справка.Не помню, задавал ли я этот вопрос раньше, но можно ли применить правило CSS в зависимости от группы или уровня доверия (TL), к которому принадлежит пользователь?

3 лайка

Я создал отдельную тему с подсказками: Finding CSS selectors for page layout, user groups

4 лайка

На будущее: я только что выполнил чистую установку, следуя всем инструкциям, но всё равно пришлось добавить и удалить файл индекса, используя шаги «добавить индекс → сохранить индекс → удалить индекс → добавить индекс обратно», чтобы категория Docs отображалась корректно.

Возможно, это или задачу Rake стоит упомянуть в инструкции по установке плагина как отдельное примечание.

4 лайка

Привет :smiley:
Всё отлично работает с этим плагином, спасибо за него! :heart:
Только одна маленькая деталь… он как бы «ломает» поведение якорных ссылок внутри темы.
Переход от А к В происходит верно, но вместо обычного плавного прокручивания страницы вверх и вниз происходит перезагрузка страницы (в правильной якорной позиции).

Есть ли способ это исправить?

Можно ли отображать темы в категории документации в виде «карточек», как карточки категорий? (см., например, в Google Drive, когда вы выбираете вид карточек вместо списка для своих документов)

Есть ли ветка, которую мне следует использовать для этого плагина, чтобы он был совместим с самообслуживаемым экземпляром, работающим на версии v2026.1 Extended Support Release? Я вижу ветки d-compat для версий 2026.5, 2026.4, 2026.3 и 2026.2.

Спасибо за любую помощь!

Пока плагин не поддерживает вид карточек. :smiley:

Скорее всего, это можно реализовать с помощью пользовательского компонента темы, но, насколько мне известно, готового решения «из коробки» нет.

Мы перешли на использование веток совместимости после вашего релиза, но плагин использует зафиксированный хеш коммита в файле .discourse-compatibility:

2 лайка

Я только что установил этот плагин и включил его, но я вообще не вижу раздел «режим документации» на странице настроек категории. Он должен быть прямо под настройками электронной почты или где-то ещё?

Я выполнил db:migrate и rake-задачу, о которых говорилось в этой теме.

Изменение: нашёл — конечно же, нужно было повторно выполнить assets:precompile

2 лайка

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

Есть ли планы на то, чтобы добавить простой режим для мобильных устройств?

1 лайк

Неужели вы не могли бы рассмотреть возможность открытия ссылок на внешние сайты в фрейме на сайте, чтобы мне не пришлось пересоздавать все документы, которые я создал на своём старом сайте xwiki?

Когда я добавляю ссылку, она нормально отображается в боковой панели, но при клике заменяет текущую страницу, и приходится возвращаться назад, чтобы снова просмотреть индекс…

1 лайк

Не могли бы вы подробнее рассказать о вашем сценарии использования? Я разработал решение, которое сохраняет индекс по тегам, и оно подходит для задач, похожих на те, которые вы описываете.

Текущее официальное поведение — отображать боковую панель индекса только на страницах индекса. Для большинства приложений этого достаточно, но некоторым из нас было интересно немного расширить эту функциональность.

1 лайк

Что вы имеете в виду? На мобильных устройствах всё должно работать нормально.

Думаю, вариант для внешних ссылок может иметь смысл. Все внешние ссылки в индексе или по отдельности?

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

1 лайк

Понял. Я думал, ты имел в виду, что по умолчанию посты не должны скрываться.

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

1 лайк