База знаний

[justin (Justin DiRose)]

Спасибо за обратную связь, @tobiaseigen! На этой неделе у меня много других дел, но на следующей я обязательно займусь несколькими из этих вопросов.

[tobiaseigen]

Ещё один момент — этот компонент темы не имеет смысла в сочетании с популярным компонентом темы «Теги», и по какой-то причине настройка исключения категории для этого компонента темы, похоже, не работает у меня, несмотря на многократное обновление браузера. Не знаю, сможете ли вы решить эту проблему в рамках этого компонента темы… чтобы мы всё ещё могли использовать популярные теги в других представлениях и не показывать их здесь.

Я не слишком горд, чтобы раскрыть, как я использую Discourse в качестве своей личной базы знаний — на скриншоте ниже вы видите, как теги отображаются с обеих сторон, даже с категорией howto, настроенной на исключение в компоненте темы «Популярные теги».

[justin (Justin DiRose)]

@tobiaseigen

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

Во-первых, вам стоит гордиться этим. Это действительно экспертное использование Discourse! Discourse идеально подходит для таких задач!

@tobiaseigen

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

Я займусь этим вместе с другими вопросами на следующей неделе.

[tobiaseigen]

Спасибо, Джастин!

Я только что установил это на форуме глобальной сети по правовому расширению возможностей. У нас есть категория базы знаний (KB) и подкатегории внутри неё. У каждой подкатегории есть свои отдельные настройки доступа для групп.

Очень приятно видеть, что включение этого компонента темы в категории KB и её подкатегориях работает! На самом деле всё работает отлично.

Я заметил ещё два момента:

• Меню тегов, похоже, не работает корректно в категории KB. В списке тем из подкатегорий явно видны теги, но меню тегов пустое, поскольку в самой категории KB нет тем.
• Было бы очень полезно видеть список подкатегорий в меню. Не знаю, технически ли это осуществимо. Если да, то, возможно, его можно разместить прямо над меню тегов?

[EGreg (Greg Magarshak)]

Это захватывающе. Не могли бы вы создать пост со ссылкой на тему, где установлена KB, и показать точно, что предлагает KB по сравнению с обычными категориями и темами?

[justin (Justin DiRose)]

Вы можете увидеть это в действии на нашем сайте конструктора тем: https://theme-creator.discourse.org/theme/justindirose/knowledge-base

[justin (Justin DiRose)]

@Sean_R

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

Это было исправлено в этом коммите:

FIX: Auto-enter KB view on subcategory change

---

@TowerBR, тебе случайно удалось выяснить, в чём была проблема? Если нет, напиши мне в личные сообщения, и, возможно, мы сможем разобраться вместе.

[justin (Justin DiRose)]

@tobiaseigen

Этот компонент темы действительно кажется конфликтующим с плагином Knowledge Base от @angus. Я могу подтвердить, что плагин необходимо удалить перед включением этого компонента темы, иначе при просмотре категории базы знаний произойдет следующее. Обратите внимание на странную горизонтальную линию рядом с меню и вращающийся круг.

Это был конфликт именования компонентов, который я устранил.

@tobiaseigen

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

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

@tobiaseigen

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

На данный момент это ожидаемое поведение, так как в этой версии темы мы просто добавляем интерфейс KB к существующему списку тем.

@tobiaseigen

нажмите на заголовок категории тегов в левом меню, и вас перекинет на представление «Последнее» для этой категории. Я бы предложил не делать эту ссылку активной. Также заголовок категории, вероятно, не должен содержать символ #, который отвлекает внимание.

Я считаю это разумным предложением и удалил как ссылку, так и хеш-символ.

@tobiaseigen

• было бы удобно видеть количество тем с каждым тегом в левом меню
• было бы удобно сортировать темы базы знаний по алфавиту или даже в пользовательском порядке

Это в конечном итоге появится в расширенной версии, которая будет реализована в виде плагина.

@tobiaseigen

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

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

@tobiaseigen

• меню тегов, похоже, не работает корректно в категории KB. Элементы, появляющиеся в списке тем из подкатегории, явно имеют теги, но меню тегов пусто, потому что в родительской категории KB нет тем.
• было бы очень полезно видеть список подкатегорий в меню. Не знаю, технически ли это осуществимо. Если да, то, возможно, его можно разместить непосредственно над меню тегов?

Я не совсем понял, в чем именно заключается проблема здесь. Есть ли у категории KB подкатегории, но при этом нет самих тем в родительской категории KB?

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

[TowerBR (Tower)]

@justin

@TowerBR, вам случайно удалось выяснить, в чём проблема? Если нет, напишите мне в личные сообщения, возможно, мы сможем вместе разобраться.

К сожалению, нет, проблема сохраняется. Кнопка KB, кажется, ничего не делает. Я напишу вам в личные сообщения.

[TowerBR (Tower)]

С небольшой помощью от @justin теперь всё работает.

Я не включил tagging_enabled и show_filter_by_tag на тестовом экземпляре.

Спасибо!

[tobiaseigen]

Круто! Здесь много отличных вещей. Спасибо за вашу усердную работу по настройке этого компонента темы. Вы упоминаете продвинутую версию в виде плагина — есть ли где-то дорожная карта по всем этим вопросам, чтобы я мог скорректировать свои ожидания и дать обратную связь? У нас также есть https://meta.discourse.org/t/knowledge-base-plugin/115288 от @angus, который имеет некоторые перекрывающиеся функции, и было бы хорошо знать, на кого мне стоит ставить. Мне нравятся аспекты обоих решений.

Я проведу некоторые тесты и вернусь к вам с результатами.

[justin (Justin DiRose)]

@tobiaseigen

Где-то есть дорожная карта по всем этим вопросам, чтобы я мог скорректировать свои ожидания и дать обратную связь?

К сожалению, нет. Но могу сказать, что плагин, над которым я работаю, имеет совершенно другую направленность — представьте компонент темы, усиленный в разы. Думаю, что и этот плагин, и плагин базы знаний от @angus будут иметь полезные варианты применения.

[justin (Justin DiRose)]

Я внес приятное изменение — настройка kb categories теперь автоматически заполняется категориями. Эта возможность была доступна в нашем API темы всё это время, но я о ней не знал! @tshenry напомнил мне об этом.

Одно уточнение — если вы уже настроили это, вам нужно будет снова добавить свои категории после обновления.

FEATURE: Use category list setting

[tobiaseigen]

Отлично! Это работает хорошо. Теперь у вас будет меньше запросов в поддержку.

Небольшая деталь: я заметил, что настройка kb categories ищет названия категорий, но не короткие имена (слаг).

[justin (Justin DiRose)]

[quote=“tobiaseigen, post:42, topic:121898”]
Небольшое замечание: я заметил, что настройка kb categories ищет названия категорий, но не короткие имена (слаг).[/quote]

Ага, верно — вам больше не нужно беспокоиться о слагах. Компонент темы теперь обрабатывает это сам. Возможно, я забыл обновить какой-то текст…

Редактирование: да, действительно. Внёс исправление в код, чтобы устранить эту проблему.

[tobiaseigen]

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

Вот несколько вопросов, с которыми я сталкиваюсь:

1. Меню тегов отображается на одном из моих сайтов, но не на другом. Мне не удалось найти конфликт. Скорее всего, дело в неофициальном плагине. Есть ли какие-то предложения, где стоит искать?
2. В представлении категории базы знаний (KB) вверху нет кнопки + NEW TOPIC, как это есть для раздела Latest. Было бы удобно иметь такую кнопку для создания новой вики-темы в категории. Сейчас приходится переходить в Latest, чтобы начать тему в категории.
3. Это не большая проблема, но выглядит как баг — воспроизводится на обоих моих сайтах и в Theme Creator:
   • перейдите в представление KB;
   • выберите тег для фильтрации;
   • переключитесь на вкладку TOP в верхнем меню;
   • вернитесь на вкладку KB в верхнем меню;
   • фильтр по тегу всё ещё активен.
4. На том же сайте, где не отображается меню тегов, у меня есть ещё одна странная проблема, которую не удаётся воспроизвести на другом сайте или в Theme Creator. Когда я перехожу в категорию KB через выпадающее меню категорий, меня перекидывает в раздел Latest, хотя по умолчанию должно открываться kb. Выбор kb в меню не даёт эффекта… но если сделать жёсткую перезагрузку страницы в браузере, меня перекидывает в kb.

[tpetrov (Toni Petrov)]

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

1. Теги не отображаются в боковой панели
2. При выборе категории представление базы знаний по умолчанию не отображается (хотя я включил опцию Выбранные категории автоматически показывают представление базы знаний по умолчанию)

Я отключил все остальные компоненты, и у меня включены как tagging_enabled, так и show_filter_by_tag, но эти проблемы всё ещё сохраняются.

[justin (Justin DiRose)]

Вы видите какие-либо ошибки в консоли браузера? И обновляли ли вы страницу после включения этих двух настроек?

[tpetrov (Toni Petrov)]

Вы имеете в виду обновление страницы — конечно, я это сделал?

Я не вижу никаких ошибок, только эти уведомления:

[justin (Justin DiRose)]

Это на публичном форуме? У меня есть некоторые подозрения, но было бы лучше, если бы была возможность взглянуть.

РЕДАКТИРОВАНИЕ: Конечно, проблема №2 вызвана недавними изменениями в маршрутизации категорий. Я работаю над исправлением, но мне ещё предстоит разобраться с некоторыми сложностями.

Проблему №1 мне не удаётся воспроизвести. Скорее всего, вы видите темы из подкатегорий в списке. Поскольку эти темы не находятся в выбранной вами категории, теги не будут отображаться в боковой панели.