.tmTheme 颜色方案

从 Sublime Text 版本 3149 开始,引入了新的颜色方案格式 .sublime-color-scheme,以便更轻松地编辑、自定义和添加新功能。新格式的文档可在主 颜色方案文档 中找到。

此页面记录了 Sublime Text 对旧版 .tmTheme 格式的实现。为了向后兼容,将继续支持此旧版格式,但新功能将仅添加到 .sublime-color-scheme 格式中。

.tmTheme 格式由 TextMate 创建。它是一种 XML 格式,分为全局设置和范围样式。

示例

以下是一个 .tmTheme 文件格式的示例。完整的颜色方案将包含更多范围样式,以涵盖标准范围名称。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>name</key>
    <string>Example Color Scheme</string>
    <key>settings</key>
    <array>
        <!-- Global settings -->
        <dict>
            <key>settings</key>
            <dict>
                <key>background</key>
                <string>#222222</string>
                <key>foreground</key>
                <string>#EEEEEE</string>
                <key>caret</key>
                <string>#FFFFFF</string>
            </dict>
        </dict>
        <!-- Scope styles -->
        <dict>
            <key>name</key>
            <string>Comment</string>
            <key>scope</key>
            <string>comment</string>
            <key>settings</key>
            <dict>
                <key>foreground</key>
                <string>#888888</string>
            </dict>
        </dict>
        <dict>
            <key>name</key>
            <string>String</string>
            <key>scope</key>
            <string>string</string>
            <key>settings</key>
            <dict>
                <key>foreground</key>
                <string>#FFD500</string>
            </dict>
        </dict>
        <dict>
            <key>name</key>
            <string>Number</string>
            <key>scope</key>
            <string>constant.numeric</string>
            <key>settings</key>
            <dict>
                <key>foreground</key>
                <string>#7F00FF</string>
            </dict>
        </dict>
    </array>
</dict>

颜色

颜色方案中的颜色可以使用三种格式指定:十六进制 RGB、十六进制 RGBA 或(X11)命名。

十六进制 RGB 格式由前两个字符表示红色通道,后两个字符表示绿色,最后两个字符表示蓝色。要以十六进制 RGB 指定红色,请写入 #FF0000

十六进制 RGBA 格式与十六进制 RGB 格式相同,但添加了第四对十六进制字符来控制不透明度。要以十六进制 RGBA 指定 50% 不透明度的红色,请写入 #FF000080

命名颜色使用 X11 颜色名称请注意,虽然有些颜色名称与 CSS 命名颜色相同,但实际颜色往往不同。

全局设置

以下全局设置位于第一个 <dict> 中,并使用 <key>/<string> 对指定。

background
默认背景颜色
foreground
文本的默认颜色
caret
光标的颜色
lineHighlight
包含光标的行背景颜色。仅在 highlight_line 设置启用时使用。

Accents

misspelling
用于绘制在拼写错误的单词下方波浪形下划线的颜色。
minimapBorder
在设置 draw_minimap_border 启用时,绘制在小地图视口区域周围的边框颜色。请注意,视口通常仅在悬停时可见,除非 always_show_minimap_viewport 设置启用。
accent
主题可用的颜色。默认主题使用此颜色在 highlight_modified_tabs 设置启用时突出显示已修改的选项卡。

CSS

CSS 应用于通过 API 公开的弹出窗口和幻影功能创建的 minihtml 内容。支持的 CSS 属性在 minihtml CSS 参考 中讨论。

使用 minihtml 的插件鼓励在生成的 HTML 的 <body> 标签上设置唯一的 id 属性,以便颜色方案可以覆盖默认的插件样式。

popupCss
传递给弹出窗口的 CSS。
phantomCss
传递给幻影的 CSS。如果未指定,则使用 popupCss

Gutter

gutter
边距的背景颜色
gutterForeground
边距中行号的颜色

Selection

selection
选定文本的背景颜色
selectionForeground
将覆盖选定文本的基于范围的文本颜色的颜色
selectionBorder
选定区域边框的颜色
inactiveSelection
当前未聚焦的视图中选定区域的背景颜色
inactiveSelectionForeground
将覆盖当前未聚焦的视图中选定区域的基于范围的文本颜色的颜色

Find

highlight
在查找面板中选择“突出显示匹配项”选项时,用于“其他”匹配项的边框颜色。还用于突出显示“在文件中查找”结果中的匹配项。
findHighlight
查找面板匹配的文本的背景颜色
findHighlightForeground
将覆盖查找面板匹配的文本的基于范围的文本颜色的颜色

Guides

指南由 draw_indent_guides 设置全局控制。

guide
用于绘制缩进指南的颜色。仅在设置 indent_guide_options 中存在选项 "draw_normal" 时使用。
activeGuide
用于绘制包含光标的缩进级别的缩进指南的颜色。仅在设置 indent_guide_options 中存在选项 "draw_active" 时使用。
stackGuide
用于绘制包含光标的缩进级别父缩进级别的缩进指南的颜色。仅在设置 indent_guide_options 中存在选项 "draw_active" 时使用。

括号

括号匹配由 match_brackets 设置全局控制。

bracketsOptions

光标位于括号旁边时如何突出显示括号。接受以下内容的空格分隔列表

  • underline
  • stippled_underline
  • squiggly_underline
  • foreground
bracketsForeground
绘制 bracketsOptions 指定的样式时使用的颜色。
bracketContentsOptions

光标位于一对括号之间时如何突出显示括号。接受以下内容的空格分隔列表

  • underline
  • stippled_underline
  • squiggly_underline
  • foreground
bracketContentsForeground
绘制 bracketsContentsOptions 指定的样式时使用的颜色。

标签

标签匹配由 match_tags 设置全局控制。

tagsOptions

光标位于标签内部时如何突出显示标签。接受以下内容的空格分隔列表

  • underline
  • stippled_underline
  • squiggly_underline
  • foreground
tagsForeground
绘制 tagsOptions 指定的样式时使用的颜色。

阴影

shadow
用于显示文本区域可以水平滚动的阴影的颜色
shadowWidth
阴影的宽度,以设备无关像素为单位

范围样式

配色方案通过作用域与文件中的文本进行交互。作用域通过语法设置为代码或散文标记。作用域是点分隔字符串,从最不具体到最具体指定。例如,PHP 中的 if 关键字可以通过作用域名称 keyword.control.php 指定。

匹配

配色方案通过匹配点分隔标签(从第一个开始)将颜色和字体样式应用于作用域。前缀匹配是配色方案应用于多种语法的标准方法。大多数配色方案不会匹配 keyword.control.php,而是将颜色分配给 keyword。匹配作用域中的第一个或两个标签是最常见的。除非需要语法特定的覆盖,否则包含最后一个标签(语法名称)并不常见。

命名

语法的作者可以将他们想要的任何作用域分配给给定标记。再加上数百个社区维护的语法,这意味着可能很难知道要针对哪些作用域。为了帮助语法和配色方案作者使用通用集,从而实现更好的互操作性,建立了官方作用域命名指南配色方案中的用法 部分提供了一组基线作用域,配色方案作者应努力处理这些作用域。

样式规则

每个作用域样式规则都包含一个 <dict> 标签,其中包含三对 <key>/<string> 标签,具有以下键

  • name – 作用域规则的(任意)名称
  • scope – 要应用设置的作用域
  • settings – 设置的 <dict>

settings <dict> 标签可以包含以下一个或多个 <key> 标签

  • foreground – 文本颜色
  • background – 背景颜色
  • fontStylebolditalic 中的零个或多个,用空格分隔

示例

以下作用域样式规则将所有字符串颜色设置为绿色

<dict>
    <key>name</key>
    <string>Strings</string>
    <key>scope</key>
    <string>string</string>
    <key>settings</key>
    <dict>
        <key>foreground</key>
        <string>#00FF00</string>
    </dict>
</dict>

要将所有数字样式设置为粗体、斜体红色,请使用

<dict>
    <key>name</key>
    <string>Numbers</string>
    <key>scope</key>
    <string>constant.numeric</string>
    <key>settings</key>
    <dict>
        <key>foreground</key>
        <string>#FF0000</string>
        <key>fontStyle</key>
        <string>bold italic</string>
    </dict>
</dict>

附录:X11 颜色

  aliceblue
  antiquewhite
  antiquewhite1
  antiquewhite2
  antiquewhite3
  antiquewhite4
  aquamarine
  aquamarine1
  aquamarine2
  aquamarine3
  aquamarine4
  azure
  azure1
  azure2
  azure3
  azure4
  几乎脸红
  米色
  淡黄色
  淡黄色1
  淡黄色2
  淡黄色2
  淡黄色3
  淡黄色4
  黑色
  杏仁色
  蓝色
  蓝色1
  蓝色2
  蓝色3
  蓝色4
  蓝紫色
  棕色
  棕色1
  棕色2
  棕色3
  棕色4
  黄褐色
  黄褐色1
  黄褐色2
  黄褐色3
  黄褐色4
  暗蓝色
  暗蓝色1
  暗蓝色2
  暗蓝色3
  暗蓝色4
  焦糖色
  黄绿色
  黄绿色1
  黄绿色2
  黄绿色3
  黄绿色4
  巧克力色
  巧克力色1
  巧克力色2
  巧克力色3
  巧克力色4
  珊瑚色
  珊瑚色1
  珊瑚色2
  珊瑚色3
  珊瑚色4
  矢车菊蓝
  玉米色
  玉米色1
  玉米色2
  玉米色3
  玉米色4
  深红色
  青色
  青色1
  青色2
  青色3
  青色4
  深蓝色
  深青色
  暗金黄色
  暗金黄色1
  暗金黄色2
  暗金黄色3
  暗金色4
  暗灰色
  深绿色
  深灰色
  暗卡其色
  暗洋红
  暗橄榄绿
  暗橄榄绿1
  暗橄榄绿2
  暗橄榄绿3
  暗橄榄绿4
  暗橙色
  暗橙色1
  暗橙色2
  暗橙色3
  暗橙色4
  暗紫罗兰色
  暗紫罗兰色1
  暗紫罗兰色2
  暗紫罗兰色3
  暗紫罗兰色4
  暗红色
  暗鲑鱼色
  暗海绿色
  暗海绿色1
  暗海绿色2
  暗海绿色3
  暗海绿色4
  暗深蓝色
  暗深灰色
  暗深灰色1
  暗深灰色2
  暗深灰色3
  暗深灰色4
  暗深灰色
  暗绿松石色
  暗紫色
  深粉色
  深粉色1
  深粉色2
  深粉色3
  深粉色4
  深天蓝色
  深天蓝色1
  深天蓝色2
  深天蓝色3
  深天蓝色4
  暗淡灰色
  暗淡灰色
  亮蓝色
  亮蓝色1
  亮蓝色2
  亮蓝色3
  亮蓝色4
  灰褐色
  淡粉色
  灰白色
  蛋壳色
  远方地平线
  砖红色
  砖红色1
  砖红色2
  砖红色3
  砖红色4
  淡花白色
  森林绿
  霜冻青柠
  霜冻桃色
  银灰色
  幽灵白
  金色
  金色1
  金色2
  金色3
  金色4
  金黄色
  金黄色1
  金黄色2
  金黄色3
  金黄色4
  灰色
  灰色悬崖
  灰色0
  灰色1
  灰色10
  灰色100
  灰色11
  灰色12
  灰色13
  灰色14
  灰色15
  灰色16
  灰色17
  灰色18
  灰色19
  灰色2
  灰色20
  灰色21
  灰色22
  灰色23
  灰色24
  灰色25
  灰色26
  灰色27
  灰色28
  灰色29
  灰色3
  灰色30
  灰色31
  灰色32
  灰色33
  灰色34
  灰色35
  灰色36
  灰色37
  灰色38
  灰色39
  灰色4
  灰色40
  灰色41
  灰色42
  灰色43
  灰色44
  灰色45
  灰色46
  灰色47
  灰色48
  灰色49
  灰色5
  灰色50
  灰色51
  灰色52
  灰色53
  灰色54
  灰色55
  灰色56
  灰色57
  灰色58
  灰色59
  灰色6
  灰色60
  灰色61
  灰色62
  灰色63
  灰色64
  灰色65
  灰色66
  灰色67
  灰色68
  灰色69
  灰色7
  灰色70
  灰色71
  灰色72
  灰色73
  灰色74
  灰色75
  灰色76
  灰色77
  灰色78
  灰色79
  灰色8
  灰色80
  灰色81
  灰色82
  灰色83
  灰色84
  灰色85
  灰色86
  灰色87
  灰色88
  灰色89
  灰色9
  灰色90
  灰色91
  灰色92
  灰色93
  灰色94
  灰色95
  灰色96
  灰色97
  灰色98
  灰色99
  绿色
  绿色薄纱
  绿色1
  绿色2
  绿色3
  绿色4
  黄绿色
  灰色
  灰色0
  灰色1
  灰色10
  灰色100
  灰色11
  灰色12
  灰色13
  灰色14
  灰色15
  灰色16
  灰色17
  灰色18
  灰色19
  灰色2
  灰色20
  灰色21
  灰色22
  灰色23
  灰色24
  灰色25
  灰色26
  灰色27
  灰色28
  灰色29
  灰色3
  灰色30
  灰色31
  灰色32
  灰色33
  灰色34
  灰色35
  灰色36
  灰色37
  灰色38
  灰色39
  灰色4
  灰色40
  灰色41
  灰色42
  灰色43
  灰色44
  灰色45
  灰色46
  灰色47
  灰色48
  灰色49
  灰色5
  灰色50
  灰色51
  灰色52
  灰色53
  灰色54
  灰色55
  灰色56
  灰色57
  灰色58
  灰色59
  灰色6
  灰色60
  灰色61
  灰色62
  灰色63
  灰色64
  灰色65
  灰色66
  灰色67
  灰色68
  灰色69
  灰色7
  灰色70
  灰色71
  灰色72
  灰色73
  灰色74
  灰色75
  灰色76
  灰色77
  灰色78
  灰色79
  灰色8
  灰色80
  灰色81
  灰色82
  灰色83
  灰色84
  灰色85
  灰色86
  灰色87
  灰色88
  灰色89
  灰色9
  灰色90
  灰色91
  灰色92
  灰色93
  灰色94
  灰色95
  灰色96
  灰色97
  灰色98
  灰色99
  蜜瓜色
  蜜瓜色1
  蜜瓜色2
  蜜瓜色3
  蜜瓜色4
  艳粉色
  艳粉色1
  艳粉色2
  艳粉色3
  艳粉色4
  印度红
  印度红1
  印度红2
  印度红3
  印度红4
  靛蓝
  靛蓝2
  象牙白
  象牙色
  象牙白1
  象牙白2
  象牙白3
  象牙白4
  卡其色
  浅卡其色
  淡卡其色
  中卡其色
  深卡其色
  淡紫色
  淡粉红色
  浅淡粉红色
  淡淡粉红色
  中淡粉红色
  深淡粉红色
  草绿色
  柠檬薄纱
  浅柠檬薄纱
  淡柠檬薄纱
  中柠檬薄纱
  深柠檬薄纱
  浅土黄色
  浅沙色
  浅蓝色
  浅浅蓝色
  淡浅蓝色
  中浅蓝色
  深浅蓝色
  淡珊瑚色
  浅青色
  浅浅青色
  淡浅青色
  中浅青色
  深浅青色
  浅金黄色
  浅浅金黄色
  淡浅金黄色
  中浅金黄色
  深浅金黄色
  浅金黄色
  浅灰色
  浅绿色
  浅灰色
  浅粉色
  浅浅粉色
  淡浅粉色
  中浅粉色
  深浅粉色
  浅鲑鱼色
  浅浅鲑鱼色
  淡浅鲑鱼色
  中浅鲑鱼色
  深浅鲑鱼色
  浅海绿色
  浅天蓝色
  浅浅天蓝色
  淡浅天蓝色
  中浅天蓝色
  深浅天蓝色
  浅石板蓝
  浅石板灰
  浅石板灰
  浅钢蓝色
  浅浅钢蓝色
  淡浅钢蓝色
  中浅钢蓝色
  深浅钢蓝色
  浅黄色
  浅黄色1
  浅黄色2
  浅黄色3
  浅黄色4
  鲜绿色
  亚麻色
  洋红色
  洋红色1
  洋红色2
  洋红色3
  洋红色4
  栗色
  栗色1
  栗色2
  栗色3
  栗色4
  中绿宝石色
  中蓝色
  中兰紫色
  中兰紫色1
  中兰紫色2
  中兰紫色3
  中兰紫色4
  中紫色
  中紫色1
  中紫色2
  中紫色3
  中紫色4
  中海绿色
  中石蓝色
  中春绿色
  中绿松石色
  中紫红色
  深蓝色
  薄荷奶油色
  浅玫瑰色
  浅玫瑰色1
  浅玫瑰色2
  浅玫瑰色3
  浅玫瑰色4
  鹿皮色
  晨雾色
  土黄色
  土黄色1
  土黄色2
  土黄色3
  土黄色4
  海军蓝
  深蓝色
  老蕾丝色
  橄榄褐色
  橄榄褐色1
  橄榄褐色2
  橄榄褐色3
  橄榄褐色4
  橙色
  橙色1
  橙色2
  橙色3
  橙色4
  橙红色
  橙红色1
  橙红色2
  橙红色3
  橙红色4
  兰紫色
  兰紫色1
  兰紫色2
  兰紫色3
  兰紫色4
  鸵鸟羽毛色
  淡橄榄色
  淡金黄色
  淡绿色
  淡绿色1
  淡绿色2
  淡绿色3
  淡绿色4
  淡青色
  淡青色1
  淡青色2
  淡青色3
  淡青色4
  淡紫红色
  淡紫红色1
  淡紫红色2
  淡紫红色3
  淡紫红色4
  番木瓜色
  浅橙色
  浅橙色1
  浅橙色2
  浅橙色3
  浅橙色4
  珍珠白
  褐色
  粉红色
  粉红色1
  粉红色2
  粉红色3
  粉红色4
  种植园白
  李子色
  李子色1
  李子色2
  李子色3
  李子色4
  瓷白色
  粉蓝色
  紫色
  紫色1
  紫色2
  紫色3
  紫色4
  红色
  红色1
  红色2
  红色3
  红色4
  玫瑰棕色
  玫瑰棕色1
  玫瑰棕色2
  玫瑰棕色3
  玫瑰棕色4
  宝蓝色
  宝蓝色1
  宝蓝色2
  宝蓝色3
  宝蓝色4
  马鞍棕色
  鲑鱼色
  鲑鱼色1
  鲑鱼色2
  鲑鱼色3
  鲑鱼色4
  沙盒色
  沙棕色
  海绿色
  海绿色1
  海绿色2
  海绿色3
  海绿色4
  贝壳色
  贝壳色1
  贝壳色2
  贝壳色3
  贝壳色4
  SGI 甜菜根色
  SGI 亮灰色
  SGI 亮灰色
  SGI 黄绿色
  SGI 深灰色
  SGI 深灰色
  SGI 灰色0
  SGI 灰色100
  SGI 灰色12
  SGI 灰色16
  SGI 灰色20
  SGI 灰色24
  SGI 灰色28
  SGI 灰色32
  SGI 灰色36
  SGI 灰色4
  SGI 灰色40
  SGI 灰色44
  SGI 灰色48
  SGI 灰色52
  SGI 灰色56
  SGI 灰色60
  SGI 灰色64
  SGI 灰色68
  SGI 灰色72
  SGI 灰色76
  SGI 灰色8
  SGI 灰色80
  SGI 灰色84
  sgigray88
  sgigray92
  sgigray96
  sgigrey0
  sgigrey100
  sgigrey12
  sgigrey16
  sgigrey20
  sgigrey24
  sgigrey28
  sgigrey32
  sgigrey36
  sgigrey4
  sgigrey40
  sgigrey44
  sgigrey48
  sgigrey52
  sgigrey56
  sgigrey60
  sgigrey64
  sgigrey68
  sgigrey72
  sgigrey76
  sgigrey8
  sgigrey80
  sgigrey84
  sgigrey88
  sgigrey92
  sgigrey96
  sgilightblue
  sgilightgray
  sgilightgrey
  sgimediumgray
  sgimediumgrey
  sgiolivedrab
  sgisalmon
  sgislateblue
  sgiteal
  sgiverydarkgray
  sgiverydarkgrey
  sgiverylightgray
  sgiverylightgrey
  sienna
  sienna1
  sienna2
  sienna3
  sienna4
  skyblue
  skyblue1
  skyblue2
  skyblue3
  skyblue4
  slateblue
  slateblue1
  slateblue2
  slateblue3
  slateblue4
  slategray
  slategray1
  slategray2
  石板灰3
  石板灰4
  石板灰
  雪白色
  雪白1
  雪白2
  雪白3
  雪白4
  春绿色
  春绿1
  春绿2
  春绿3
  春绿4
  钢蓝色
  钢蓝1
  钢蓝2
  钢蓝3
  钢蓝4
  柔和白色
  棕褐色
  棕褐1
  棕褐2
  棕褐3
  棕褐4
  淡紫色
  淡紫1
  淡紫2
  淡紫3
  淡紫4
  焦糖蛋白色
  番茄红
  番茄红1
  番茄红2
  番茄红3
  番茄红4
  青绿色
  青绿1
  青绿2
  青绿3
  青绿4
  超纯白色
  紫罗兰色
  紫红色
  紫红1
  紫红2
  紫红3
  紫红4
  暖影
  暖夏
  婚纱白
  小麦色
  小麦1
  小麦2
  小麦3
  小麦4
  白色
  白兰花白
  白帆
  烟白色
  黄色
  黄1
  黄色2
  黄色3
  黄色4
  黄绿色