Создание и обмен цветовой схемой

Discourse теперь поддерживает импорт цветовых схем из удаленных репозиториев. Здесь я покажу, как это сделать.

Перейдите в раздел цветов и добавьте цветовую схему.

Перейдите на /admin/customize/colors на вашем сайте и создайте цветовую схему.

Советы:

  • Я использовал плагин Chrome (color picker), чтобы выбирать цвета из существующего изображения палитры в интернете.

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

Создайте новый git-репозиторий с цветовой схемой

mkdir my-awesome-scheme
cd my-awesome-scheme
git init .
vim about.json

Для about.json добавьте базовый файл конфигурации

{
  "name": "My awesome color schemes",
  "about_url": "",
  "license_url": "",
  "color_schemes": {}
}

Добавьте файл LICENSE, я обычно использую MIT

vim LICENSE

Отправьте изменения на GitHub

Зафиксируйте все изменения:

git add LICENSE
git add about.json
git commit -am "first commit"

Создайте аккаунт на GitHub.com и затем создайте новый репозиторий.

(Необязательно) Создайте тему на Discourse как место для обсуждения ваших цветов

В идеале вам следует создать тему в категории Theme с несколькими скриншотами вашей цветовой схемы. Вы будете использовать эту ссылку как about_url

Заполните недостающую информацию в вашем файле about.json

  • Перейдите на страницу LICENSE вашего проекта на GitHub, вставьте этот URL как license_url

  • Используйте либо URL проекта на GitHub, либо URL темы на Discourse как about_url

  • Нажмите Copy to Clipboard (Скопировать в буфер обмена) в вашей цветовой схеме и вставьте это в раздел color_schemes

В конце процесса ваш файл about.json будет выглядеть примерно так:

{
  "name": "Solarized",
  "about_url": "https://github.com/SamSaffron/discourse-solarized",
  "license_url": "https://github.com/SamSaffron/discourse-solarized/blob/master/LICENSE",
  "color_schemes": {
    "Solarized Light": {
      "primary": "586E75",
      "secondary": "EEE8D5",
      "tertiary": "268BD2",
      "quaternary": "CB4B16",
      "header_background": "002B36",
      "header_primary": "93A1A1",
      "highlight": "B58900",
      "danger": "CB4B16",
      "success": "859900",
      "love": "DC322F"
    }
  }
}

Зафиксируйте изменение и отправьте его на GitHub

git commit -am "added more details"
git push

Протестируйте правильность вашей цветовой схемы

  • Удалите вашу локальную цветовую схему
  • На экране admin/customize/theme импортируйте тему из GitHub

  • Посетите admin/customize/colors и убедитесь, что ваша цветовая схема выглядит правильно.

:confetti_ball:

Теперь вы можете легко делиться вашей цветовой схемой с другими!

Предпросмотр палитр цветов

Карточки палитр и выборщик палитр используют SVG из файла
frontend/discourse/app/components/svg/single-color-palette-placeholder.gjs.
Иллюстрация демонстрирует цвета палитры, а не воспроизводит макет темы.

Элемент Цвет палитры Непрозрачность
Фон secondary 100%
Верхняя полоса header_background 100%
Заголовок темы primary 75%
Фрагмент текста primary 45%
Акцентная плашка tertiary 100%
Маленькие кнопки primary 35%
Иконки шапки и аватар header_primary 32.5%

ColorPalettePreview предоставляет выбранные цвета палитры как свойства --<name>--preview,
заменяя подчеркивания на дефисы. Верхняя полоса использует
header_background. Акцентная плашка выровнена по правому краю, а три маленькие кнопки — по левому.
Две строки фрагмента текста и маленькие кнопки используют непрозрачность SVG поверх secondary; они не используют primary_medium или primary_low.
Резервные цвета SVG представляют Default Light независимо от активной палитры пользователя.

Все предпросмотры содержат пять пунктов бокового меню, с выделением первого.
Обычные боковые панели используют secondary, разделитель primary_low, активный элемент,
а также primary для маркеров меню с непрозрачностью 45%. Контент имеет отступ 24 единицы от боковой панели и правого края;
строки меню разделяются расстоянием в 18 единиц.

Когда тема по умолчанию использует макет боковой панели с оттенками, заголовок и боковая панель
делят цвет, производный от tertiary: oklch(from tertiary 96% calc(c * 0.125) h) для светлых палитр и
oklch(from tertiary 10% 0.025 h) для темных палитр. Этот вариант зависит от темы сайта по умолчанию,
а не от темы, выбранной администратором.
Затонированный вариант использует selected для активного пункта меню (с резервным tertiary_low)
и закругляет угол контента.

Карточки палитр в админке показывают светлые и темные палитры вместе:

На узких экранах карточки складываются вертикально:

См. также:


Последняя проверка выполнена @SaraDev 2022-06-03T01:00:00Z


Этот документ находится под контролем версий — предлагайте изменения на github.

23 лайка

Кажется, туда можно добавить ещё два поля: hover и selected.