.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
– 背景颜色fontStyle
–bold
、italic
中的零个或多个,用空格分隔
示例
以下作用域样式规则将所有字符串颜色设置为绿色
<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 颜色
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
金色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
灰色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 灰色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
黄绿色