Переход к настройке сайта в стиле единой категории

[blake (Blake Erickson)]

Обновления Discourse, выпущенные 2023-11-13T05:00:00Z или позже, будут включать это изменение.

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

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

Если вы используете стиль категорий отличный от стандартного (с маркерами), у нас есть новый компонент темы, который вы можете безопасно установить прямо сейчас. В этом случае ваш сайт продолжит использовать текущую настройку стиля категорий даже после того, как мы в конечном итоге удалим эту настройку из ядра (до финального выпуска версии 3.2).

Если вы не привязаны к своему нестандартному стилю категорий, мы рекомендуем вернуться к стилю по умолчанию (с маркерами), чтобы избежать необходимости использовать дополнительный компонент темы на вашем сайте. Вот как это сделать:

Для возврата к стандартному стилю с маркерами ничего устанавливать не нужно.

Найдите административную настройку category_style и измените её значение на “bullet”, чтобы это выглядело так:

Вот шаги:

1. Перейдите на /admin вашего сайта
2. Выберите пункт SETTINGS в меню
3. Найдите “category style”
4. В выпадающем списке “category style” выберите “bullet” (или выберите RESET, чтобы вернуть значение по умолчанию, которое — bullet)

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

Вскоре на панели администратора появится уведомление для всех сайтов, не использующих стандартный стиль категорий, с информацией о том, что необходимо установить компонент темы Category Badge Styles.

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

[Firepup650 (Firepup Sixfifty)]

Как это повлияет на компоненты темы, такие как этот?

Category Icons

This theme component is deprecated and should no longer be used. Its features are now in Discourse Core (see: Bringing popular features to Discourse). For private category icon customization, refer to this topic. Summary Category Icons allows category badge links to have icons next to the category name. Preview Preview on Discourse Theme Creator Repository Link https://github.com/discourse/discourse-category-icons …

[manuel (Manuel Kostka)]

Тот же вопрос: при использовании иконок категорий стиль категории обычно устанавливается в none, иначе сейчас отображаются и иконка, и маркер:

Будет ли это объединено в компонент «Иконки категорий» или нам понадобятся два компонента (или пользовательские стили) для простого стиля с иконками?

Ещё один отзыв:

@blake

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

Сейчас стили боковой панели выглядят как значок-маркер, но это не один и тот же класс элемента, объявленный одним и тем же стилевым объявлением. Неясно, будут ли также унифицированы классы и стилевые объявления?

Например, это показано, когда вы хотите иметь круглые маркеры:

Это можно сделать простым объявлением для значков-маркеров:

.badge-wrapper.bullet .badge-category-bg {
  border-radius: 10px;
  width: 9px;
}

Показ тех же простых цветных круглых маркеров в боковой панели становится сложнее. (по умолчанию они смешивают цвета родительской и дочерней категорий в градиентном объявлении) Например, я недавно сделал следующее:

.sidebar-section-link-prefix > span {
// переместить фоновый цвет потенциальной родительской категории за пределы видимости
  background-size: 15px 15px !important;
  background-position: right center !important;
}
.sidebar-section-link-wrapper .sidebar-section-link-prefix .prefix-span {
  width: 0.5em;
  height: 0.5em;
  border-radius: 50%;
}

[PrettyGirl]

Итак, официальный сайт с дискуссиями (этот, meta.discourse.org) тоже вернется к маркированному списку? (Я заметил, что некоторые ваши категории тоже используют «стиль блоков»). Я не понимаю, зачем убирать полностью рабочие функции. Слишком сложно поддерживать код? Или это просто способ продвигать/продавать те же компоненты тем в будущем?

[JammyDodger]

Настройка «Стиль категории» отвечает за внешний вид значков категорий, а не за макет страницы категории:

Это версия в виде «блока»:

В отличие от стандартной версии с «маркерами»:

@PrettyGirl

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

С появлением элементов sidebar и hashtag-autocomplete эти стили теперь хуже отображаются на всех элементах интерфейса. Поскольку большинство сайтов используют настройки по умолчанию, логично создать отдельный компонент темы для тех, кто всё ещё хочет использовать эти стили, и убрать эту настройку из ядра, чтобы упростить систему в целом.

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

[tobiaseigen]

Если я правильно понял Блейка в первом посте, здесь ничего не будет изъято, и вы сможете настроить свой сайт так, чтобы он работал как сейчас, используя новый компонент темы GitHub - discourse/discourse-category-badge-styles: Adds the box and bar style for Discourse categories · GitHub. Просто установите его и задайте стиль категории как none. Это можно сделать прямо сейчас, даже если пока это не имеет эффекта, пока существует настройка сайта category style.

Вот как выглядит настройка компонента темы:

[Firepup650 (Firepup Sixfifty)]

Это, кстати, поднимает другой вопрос: поскольку категории в настоящее время отключают выбор цвета для стиля отображения none, будет ли TC вести себя аналогично или всё же позволит выбирать цвета? Если выбор цветов разрешён, то настройка цветов для категорий значительно упростится.

[Nacho_Caballero]

Я только что проверил это на своём сайте и заметил существенную разницу в оформлении для опции ‘box’.

Вот как это выглядит без компонента темы:

А с компонентом темы (большие отступы от .badge-wrapper.box и синий шрифт от var(--category-badge-text-color)):

[tobiaseigen]

Я протестировал это и смог воспроизвести проблему.

[TheDarkWizard]

Планируется ли удаление или изменение настройки «стиль страницы категории для рабочего стола»?

[awesomerobot (Kris)]

@Nacho_Caballero

Я только что попробовал это на своём сайте и заметил значительную разницу в стилизации для опции «box».

Этот компонент темы не будет работать корректно, пока изменения, удаляющие альтернативные стили, не будут объединены в Discourse. В настоящее время наша работа ведётся в ветке: https://github.com/discourse/discourse/tree/category-bullet-only…, и компонент темы работает с ней. Это всё ещё находится в процессе разработки.

@Firepup650

Как это повлияет на такие компоненты темы, как этот?

Компонент иконок категорий потребуется рефакторить; мы можем заняться этим до того, как произойдёт это обновление.

@manuel

Будет ли это объединено в компонент «Иконки категорий», или нам понадобятся два компонента (или пользовательские стили) для простого стиля с иконками?

Для стиля категорий по умолчанию с маркерами и иконками это должно обрабатываться компонентом… но для дополнительных стилей «box»/«bar» потребуются оба компонента.

@manuel

Так что интересно, будут ли также унифицированы классы и объявления стилей?

Это также относится к упоминаниям, таким как #announcements — мы изучали этот вопрос, и результат показал, что использование общего компонента слишком сложно… но я могу ещё раз взглянуть на то, насколько близко мы можем привести HTML и CSS между вариациями.

@PrettyGirl

Это слишком обременительно с точки зрения поддержки кода? Или просто для продвижения/продажи тех же компонентов темы в будущем?

Есть несколько причин, но стиль категорий по умолчанию с маркерами используется подавляющим большинством размещаемых нами сайтов, и по мере внедрения новых функций, таких как боковая панель и упоминания категорий (как это: #announcements), наличие нескольких стилей усложняет ситуацию.

Поддержка нескольких вариаций означает, что нам приходится учитывать и тестировать всё в 3–4 раза больше. Это становится трудно оправдать, когда функция носит исключительно визуальный характер и используется лишь небольшим процентом сайтов. Перенос чего-то подобного в компонент темы позволяет немного упростить Discourse, продолжая при этом поддерживать сайты, использующие альтернативные стили.

Мы обычно не продаём компоненты темы, но создаём пользовательские компоненты для наших корпоративных клиентов. Планов изменить это нет.

@TheDarkWizard

Есть ли планы по удалению или изменению настройки desktop category page style?

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

[ecki (Bernd)]

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

[tobiaseigen]

@Bernd

Как именно вернуть настройки по умолчанию, чтобы убрать предупреждение? Изменив стиль значка категории на маркер?

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

[Jagster (Jakke Flemming)]

И этот вспомогательный компонент в какой-то момент начнет работу и скроет маркеры? Потому что сейчас он оставляет маркеры без изменений и также отображает иконки (у меня — иконки none и category).

[blake (Blake Erickson)]

@Nacho_Caballero

Я только что попробовал это на своём сайте и заметил значительную разницу в оформлении для опции «box».

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

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

[Firepup650 (Firepup Sixfifty)]

Я сбросил наш форум к стандартному виду и компонент темы на «нет», но маркеры списка всё ещё отображаются. Это намеренно?

[blake (Blake Erickson)]

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

[Nacho_Caballero]

Теперь всё работает идеально. Спасибо за быстрое обновление!

[ecki (Bernd)]

Спасибо, пули помогли. На самом деле выглядит даже нормально, я помню, что раньше пули были меньше, поэтому я использовал линии. (Но, возможно, это изменилось в моей теме, не знаю).

[brianTRC (Brian Lockwood)]

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