Вам не нужно указывать плагину Docs категорию — этот плагин заменяет плагин Docs. Возможно, именно это вызывает у вас проблемы, так как это может привести к конфликту, когда один плагин переопределяет другой.
Вам нужно лишь убедиться, что включена опция doc categories enabled, а затем создать индексную тему в категории, добавив её в поле «Индексная тема» в настройках категории. Если в настройках старого плагина Docs всё ещё указана категория, удалите её оттуда.
Эта ссылка ведёт к индексу раздела Documentation на Meta. Ваша назначенная тема должна выглядеть похоже на неё, чтобы индекс мог быть сгенерирован. Судя по вашим скриншотам, я думаю, вы что-то неправильно поняли или прочитали. Прочитайте отсюда.
Кстати, немного не по теме, но всё же: нужен ли мне плагин темы боковой панели, чтобы индекс также отображался справа? Или это происходит автоматически? Спасибо!
Понял, вы имели в виду разделы заголовков/подзаголовков? Я искал это в редакторе, но для меня (по крайней мере) не было очевидно, нужны ли мне заголовки вроде HTML
и тому подобное. Еще раз спасибо за быстрые ответы!
Заголовки — h1, ссылки оформлены в виде маркированного списка. Вы можете просто скопировать и вставить мета-индекс — это должно дать вам пример для начала, если вы испытываете трудности.
Спасибо. Я скопировал часть индекса документации выше, как предоставил @MarcP, но не вижу бокового индекса, что странно, если только я снова что-то упускаю…
Да. Если вы видите что-то подобное в Composer (не обращайте внимания на довольно странный язык, суть должна быть понятна):
Это используется в меню-гамбургере для отображения 20 самых реактивных тем в категории #koiramaailma. Что-то вроде рекламного окна.
## Топ-20 самых реактивных тем
* Что, чёрт возьми, происходит в ветеринарии 🤬: https://foorumi.katiska.eu/t/mita-helvettia-elainlaakinnassa-tapahtuu/6772
* Реклама сухого корма: Смешные реальные случаи: https://foorumi.katiska.eu/t/kuivamuonamainokset-hassut-aidot-tapaukset/479
Обычно боковая панель находится слева (красная). Боковая панель документации просто заменяет содержимое по умолчанию. Справа (фиолетовая) вы видите оглавление, которое добавляется компонентом темы DiscoTOC - automatic table of contents.
Не уверен, но ваши скриншоты нечеткие. Вы делаете скриншот, и боковая панель вообще не отображается? Не отображается ли боковая панель документации? Или боковая панель не отображается вообще (она не просто скрыта, попробуйте нажать =)
Редактирование: подумав об этом, вы должны четко указать, у вас ли проблемы с discoTOC (оглавление для автора оригинала) или с doc-categories (боковая панель индекса документации)
Так что DiscoTOC работает. Я вернулся и перепроверил — действительно, после того как зайти в настройки и вставить TOC, как указано в инструкции, создаётся боковое оглавление.
Все мои скриншоты включают боковую панель, поэтому я показываю открытый ландшафт без отображения каких-либо боковых панелей.
У меня просто есть странное чувство, что это очень простое исправление, но я пока не дошёл до него
Я не вижу боковых панелей на ваших скриншотах — на всех показан только контент сообщения. Не могли бы вы опубликовать скриншот полного экрана Discourse, когда вы находитесь в категории, где должен отображаться индекс?