创建并分享配色方案

Discourse 现在支持从远程仓库导入颜色方案。在这里,我将演示如何执行此操作。

导航到“颜色”并添加颜色方案。

在您的站点上访问 /admin/customize/colors 并创建颜色方案。

提示:

  • 我使用了一个 Chrome 插件(颜色选取器)从网络上的现有调色板图像中选取颜色。

  • 如果您创建一个主题,将颜色方案分配给该主题并进行预览,更改将实时反映。

创建包含颜色方案的新 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 文件中填写缺失的信息

  • 导航到您在 GitHub 上的 LICENSE 页面,将该 URL 填写为 license_url

  • 使用 GitHub 项目 URL 或 Discourse 主题 URL 作为 about_url

  • 在您的颜色方案上按 复制到剪贴板,然后将其粘贴到 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。强调药丸右对齐,三个小按钮左对齐。
两行摘要和小按钮在 secondary 上使用 SVG 不透明度;它们
不使用 primary_medium 或 primary_low。
SVG 的回退颜色独立于查看者的活动调色板,代表 Default Light(默认浅色)。

所有预览都包含五个侧边栏菜单项,其中第一个被高亮。普通
侧边栏使用 secondary、primary_low 分隔线和活动项,以及 45% 不透明度的 primary
菜单标记。内容距离侧边栏和右边缘有 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”。