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

Только что выполнил это — возникла небольшая странная ошибка, но всё, похоже, прошло нормально:

root@spokes-web-only:/var/www/discourse# bundle exec rake doc_categories:build_sidebar
fatal: detected dubious ownership in repository at ‘/var/www/discourse’
Чтобы добавить исключение для этой директории, выполните:

    git config --global --add safe.directory /var/www/discourse

Обработка категории #21 — Спросите кандидатов
⮑ Создано 3 раздела и 55 ссылок

Обработка категории #21 — Спросите кандидатов
⮑ Создано 3 раздела и 55 ссылок

Это нормально?

И нужно ли нам менять способ взаимодействия с темой индекса, или всё осталось без изменений?

4 лайка

Да, всё верно, больше ничего делать не нужно :ok_hand:t2:

Опять да.

В ближайшем будущем (:crossed_fingers:t2:) мы будем работать над улучшением функций, таких как удобная сортировка, перестановка, обновление, возможно, с помощью специального интерфейса. Я не ожидаю, что пользователям, развернувшим систему самостоятельно, придётся выполнять какие-либо дополнительные ручные операции.

3 лайка

Можете ли вы уточнить, к какой версии плагина и/или коммиту это относится?

Я использую Discourse 3.6.0.beta1-dev, и у меня не отображается никаких доступных обновлений для плагина «Категории документации». Плагин имеет версию 0.0.1 с коммитом ba90a37.

1 лайк

Изменения примерно на 7 коммитов новее.

Эти изменения входят в ту же версию Discourse 3.6.0.beta1-dev. В идеале при следующем обновлении самого Discourse вы также получите эти изменения.

В целом я не рекомендую обновлять только плагин, а лучше использовать стандартные методы обновления через интерфейс или команду ./launcher rebuild app.

2 лайка

Меню документации (слева) не отображается в последней версии Discourse (3.6.0.beta2)

Не могли бы вы проверить это снова?

У меня на Meta всё ещё работает.

Вы перестроили индекс, как описано здесь?

2 лайка

Спасибо, с этим всё в порядке:

sudo -E -u discourse bundle exec rake doc_categories:build_sidebar

1 лайк

Пост был разделен на новую тему: Различные предложения по улучшению плагина категорий документации

Всем привет,

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

Можете ли вы подтвердить совместимость? Я получаю эту ошибку:

5 ноября 2025 г., 06:55
/var/www/discourse/plugins/discourse-doc-categories/lib/doc_categories/initializers/add_category_extensions.rb:19:in `apply': undefined method `register_category_update_param_with_callback' for an instance of Plugin::Instance (NoMethodError)
discourse
5 ноября 2025 г., 06:55
** НЕСОВМЕСТИМЫЙ ПЛАГИН **
discourse
5 ноября 2025 г., 06:55
Вы не можете запустить Discourse из-за ошибок в плагине по адресу
discourse
/var/www/discourse/plugins/discourse-doc-categories
discourse
5 ноября 2025 г., 06:55
Пожалуйста, попробуйте удалить этот плагин и снова пересобрать!

Привет, сначала нужно обновить ваш экземпляр Discourse, так как указанный метод доступен только в более новой версии.

Есть ли в образе discourse/discourse:3.5.2 этот обновлённый код? Я использую его и вижу, что обновление было сделано 10 часов назад.

Версия 3.5.2 не будет совместима: вы получите обновления безопасности, но не новые функции. Минимально потребуется версия 3.6.0.beta1.

1 лайк

Вы знаете о какой-либо проблеме с 3.6.0.beta3-latest? Плагин не работает после нашего недавнего обновления с 3.6.0.beta1.

1 лайк

Вы выполнили задачу rake, как описано здесь?

Есть альтернативный вариант (удалите индексную тему в настройках категории, нажмите «Сохранить» и добавьте её снова), если вы не можете выполнить задачу Rake.

4 лайка

Это то, что мне приходилось делать каждый раз после добавления ссылки на индекс с статическим именем в предписанном формате:

* Текст ссылки: https://meta.discourse.org/t/an-example-link/

В противном случае ссылки в боковой панели категории не парсятся в заголовки и остаются в виде полных URL-адресов. Это касается последней версии Discourse (2025.12.0-latest по состоянию на коммит 5817b6c).

1 лайк

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

(Это отличается от ситуации, когда плагин вообще не работает — такое случается, если вы не выполнили задачу rake или не обновили индексную тему. Со мной тоже такое было на форуме, где я забыл это сделать)

1 лайк

У меня это не сработало. Только настройка rake или категории, о которой я цитировал выше.

1 лайк

Спасибо, я предоставлю обратную связь :slight_smile:

2 лайка

Это сработало, большое спасибо!

3 лайка

Недавно вышло обновление, которое может решить эту проблему. Пожалуйста, напишите нам и сообщите, сохраняется ли она.

2 лайка