st3-theme-kcps

文本和用户界面外观（“主题”）- Sublime Text 3（ST3）源代码编辑器的尺寸、样式、颜色等。Kanone Consulting and Professional Services Inc.的公司标准。

本项目的发布遵循语义版本控制协议2.0.0（SM200 - http://www.semver.org/），其语义内容可以通过SM200中规定的规则推断。

我是Edgar Duncan George，居住在加拿大安大略省。我是一名系统设计工程师，在控制系统、软件设计应用、IT项目管理以及商业再工程领域拥有丰富的学术和职业生涯。我的写作风格模仿1970年代的AT&T贝尔实验室，至今仍位于新泽西州默里山。这种表达风格是由（已故的）Dennis Ritchie和Brian Kernighan在《C程序设计语言》一书中提出的，并在贝尔实验室广泛实践。如果你想了解我的工程实践风格，请准备好仔细阅读以下内容。我不使用社交媒体，所以不会在以下内容中找到140个字符的想法。

在检查Sublime Text 3编辑器默认主题（文本“Monokai.tmTheme”设置）的基础上，我决定我更喜欢白色背景下的深色文本，尽管我已经习惯了在DEC VT100及其后继计算机终端使用vi。对于年轻人来说，这些终端通常配置为标准视频（黑色背景上的白色前景文本），以最大限度地减少CRT磷光屏涂层的激活。所谓反转视频（白色背景上的黑色文本）……好吧，不要陷入这个话题……是在20世纪80年代末随着用户界面设计的科学出现以及人们意识到白色背景上的黑色文本需要额外的脑力来关注文本内容后开始的。到那时，磷光涂层更加耐用，终端价格也降下来了。这些发展导致了苹果和微软的白背景WYSIWYG界面，它以低成本减轻了眼睛的疲劳。

我还想改善几个控件。很多人在ST用户论坛上评论说，ST3的滚动条滑块与滚动条轨道（垂直和水平）之间的对比度不足。有两种方法可以提高对比度。一种是通过使用图形编辑器编辑提供滑块模板的两个图形文件（normal_thumb_vertical.png和normal_thumb_horizontal.png）。在.sublime-theme文件中，这些通过“layer0.texture”属性在“puck_control”对象中引用，且文件名作为值传递给纹理属性。

要访问滑块和其他文件，了解ST3如何组织其各种文件，称为“资源”是有帮助的。以下，我将避免使用ST术语——“资源”、“tmTheme”等——并，为了具体性和与专业程序员通用语言使用的保持一致性，在本文中采用Unix文档语言。然而，以下描述和注解是特定于Windows XP的，因为这是我目前使用的操作系统。最终，st3-theme-kcps及其后续版本将会扩展到其他操作系统。

本README旨在针对那些接触到ST2或ST3的用户，他们可能刚刚安装了它，用一些文本文件玩了几个小时，也许在Sublime论坛或其他提供关于编辑器建议的网站和博客上转了转。对于新手来说，定制ST3可能是一个令人沮丧的经历，因为官方文档非常稀缺，业余人士的建议常常是错误的，而那些存在的优秀的如何操作和好文章大多假设新手还不具备相应的熟悉度。

安装ST2时，它在Windows用户名的Application Data目录中创建一个Packages目录，并在Packages中为每个包含文件包的包创建子目录。然而，ST3在Program Files中的Sublime Text 3目录中创建了Packages目录，那里装有Windows中的应用软件。在这个Packages目录中，你会找到许多名为“packages”的.zip格式存档文件（称为“PKZIP”），并带有.dot后缀“sublime-package”。这些包控制源代码文本的外观、Sublime Text界面外观以及ST3的一些功能。一些包特定于编程和文本编辑语言，名称据此命名：JavaScript.sublime-package，SQL.sublime-package，LaTeX.sublime-package，Python.sublime-package，等等。

现在导航到这个“Packages”目录，并将您的注意力集中在名为“Color Scheme - Default.sublime-package”的存档上。使用WinZip、ExpressZip或类似工具打开它。请注意，一些工具（如ExpressZip）在尝试打开文件之前坚持要求文件名带有.zip后缀，这使得编辑ST3包变得麻烦，因为用户将不断在.sublime-package和.zip后缀之间进行转换。）包并不是什么神奇或新颖的东西；它们只是一包解压缩到存档中的文件。在默认颜色方案存档中，其文件名以.tmTheme结尾。每个文件都是一个XML文件，其中标签指定了源代码文件的各类文本的颜色和字体样式。这些类别的示例包括JavaScript中注释、关键词、库方法、类名、变量等颜色的样式。ST3使用Monokai文本主题作为默认主题。

在“Color Scheme - Default”包中提供的12个半其他主题可以通过将用户首选项中“color_scheme”设置的值替换为存档中另一个主题文件的名称来选择。由于它的流行，ST2 & ST3拥有强大的用户基础，其中许多用户创建了他们自己的文本主题，并在互联网上发布。看看你喜欢什么。

如果你找到了你喜欢的文本主题，以下是安装它的步骤。回想一下我之前提到的ST3在Windows的“Sublime Text 3”应用程序数据目录下为用户空间创建另一个“Packages”目录。在THIS“Packages”目录下，你也会找到子目录“User”。将你的文本主题文件复制到User中。打开ST3，从首选项菜单中选择设置 - 用户。这将打开一个编辑选项卡，或者像ST那样称为“‘Preferences.sublime-settings | User’”。比如说你的文件名为Freesia.tmTheme，目前很受ST用户的喜爱（https://github.com/nilium/st-theme-freesia）。将以下条目复制到编辑区的行上

// Sets the colors used within the text area
 "color_scheme": "Packages/User/Fessia.tmTheme",

（不要忘记末尾的逗号！）。从文件菜单选择保存，或者直接按Ctrl+S。你的文本将立即更改为新颜色方案，如果你没有创建自己的用户设置，会在“Packages/User”中为你创建一个名为“Preferences.sublime-settings”的文件。我将稍后详细介绍如何自定义文本主题。

在继续修改用户界面外观之前，我要注意的是“Packages/User”是保存所有用户自定义的目录。我们刚才修改过的首选项设置中的文件也是在这里，以及任何文本主题。你还可以将用户界面的自定义版本保存在那里的文件中；用户界面是接下来我会关注的话题。但关于“Packages/User”的最后一点。它的重要的是，它的内容在安装Sublime Text编辑器的更新时永远不会被更改。作为一个相对较新的应用程序（由澳大利亚的Jon Skinner于2007年创建），增加功能和纠正错误的功能仍然频繁出现在ST3中——例如，2013年就有11个。在熟悉ST3之后，你可能会积累一些自定义文件，你不想在下一轮更新中被覆盖。所以远离ST3使用的其他目录，并确保你的修改保存在“Packages/User”中。现在让我们来看看用户界面。

尽管ST3受到了来自程序员（无论是专业还是业余的）的喜爱和关注，但关于默认滚动条的赞美之词却未见分晓。正如你所期待的，我猜你现在已经安装并使用过ST3了，你也应该亲身感受到了我所说的内容：垂直和水平滚动滑块几乎与滚动条轨道（或称为“竞速”）难以区分。正如我最初提到的那样，有两种方法可以解决这个问题，而且都很简单。尝试每一种都会有回报，因为它将帮助你更多地了解如何与包一起工作，以及如何修改用户界面以满足你的喜好。

我提到了两个滑块模板文件，分别是normal_thumb_vertical.png和normal_thumb_horizontal.png。他们放在哪里？在“Theme - Default.sublime-package”包中，这个包与程序文件一起安装到“Program Files/Sublime Text 3/Packages”中。在你的压缩工具中打开该包，并将这两个文件提取到工作目录中。这些图片非常简单，因此你可以使用简单的图形编辑器，如Microsoft Paint来编辑它们，这是我所做的。我将图像放大了8倍，以便更容易地编辑单个像素，然后使用三种绿松石色调重新着色图像。保存修改后的文件后，你可以使用你的工具将其添加回压缩文件中。（如果ST3已经打开，你必须先关闭它，因为它会在执行过程中锁定所使用的包。）重新打开ST3后，你会看到新着色的滑块。

你可以用这种方式修改“Theme - Default”文件中的任何图像文件，以适应自己的需求。除非你对高端计算机图形艺术非常感兴趣，否则你可能会觉得这个过程相当麻烦。也许你应该先尝试一些其他ST的ui主题包。大多数都可以在GitHub上找到，并使用ST插件Package Control工具安装。我会稍后展示如何安装和加载这个工具。同时，这里有一个简单的手动解决方案。如果你还没有安装，请在你的工作站上安装Git并打开Git Bash shell。输入

$ cd /path/to/sublime/Packages  (e.g. /Program Files/Sublime Text 3/Packages - whatever your actual path is.)
$ git clone [email protected]:nilium/st-theme-freesia.git

这将把“st-theme-freesia”目录安装到文档中的“Packages”中，一些包含各种界面小部件图像文件的子目录也一起安装。克隆了freesia仓库后，你现在可以编辑你的用户偏好文件，并设置主题键

{
    // other preferences above...
    "theme": "Freesia.sublime-theme"
}

（按Ctrl+S保存更改。）“theme”表示引用包含用户界面在您的显示器上如何显示的全部信息的文件的设置属性。安装后的默认值是“Default.sublime-theme”，这个文件位于“Theme - Default.sublime-theme”包中，其中还包含了所有默认主题的图像文件。你现在已经替换了默认用户界面主题，改为了在“Freesia.sublime-theme”中定义的Freesia用户界面主题。

你喜欢新的外观吗？用另一个主题替换默认主题要比编辑多达二十多个单独的图像文件要快得多；你的ST社区已经完成了大部分艰苦的工作，创建新的外观，测试它们，并根据界面的和谐外观进行微调。社区中的许多人都是从你现在的状态开始的——试图让默认的滚动滑块更加突出，在做这件事的过程中，他们逐渐沉迷于修改用户界面的其他元素，直到他们喜欢上了某个样式。

回顾我上文提到的，有两种方法可以修改滚动条和小滑块的外观（不算整体替换ui主题包:-）。使用您的存档工具将“Default.sublime-theme”文件从“Theme - Default.sublime-theme”包中提取出来。记住，.sublime-theme文件控制用户界面的外观。具有后缀名.tmTheme的文件控制您编辑的源代码的外观或主题。它们都在ST宇宙中被统称为主题，所以一开始这种“主题”一词的共同使用可能会让人困惑。

现在，您可以使用ST3或一些其他编辑器（如Antechinus JavaScript Editor、Notepad++、Wordpad等）打开并修改提取的文件。（由于我在试听编辑器，我用了这三个以便进行比较。）您无疑能认出您正在查看的是JSON源文件。花点时间浏览它并看看模式：每个对象在“class”属性中都有一个名称，很多对象都有各种层属性（layer0.texture, layer0.opacity, layer0.inner_margin等）。由于文本主题文件是用XML编写的，这给了您一个很好的机会来比较这两种编码语法。我发现JSON更加直观，容易理解；我认为Douglas Crawford为那些为互联网编程的人做了很多贡献。

滚动到“puck_control”类

{
    "class": "puck_control",
    "layer0.texture": "Theme - Default/normal_thumb_vertical.png",
    "layer0.opacity": 1.0,
    "layer0.inner_margin": [2, 3],
    "content_margin": [6, 0],
    "blur": true
},

该对象将显示您之前修改的小滑块文件，位于“Theme - Default”包中。现在按以下方式修改对象

{

    "class": "puck_control",
"layer0.texture": "",
"layer0.tint": [192, 32, 32],
"layer0.opacity": 1.0,
"blur": false
},

注意，包含小滑块模板图像的纹理文件不再使用。相反，小滑块被简单地染成中等红色：RGB = [192, 32, 32]。更多信息请访问http://sublimetext.userecho.com/topic/116003-make-the-scrollbar-markerindicator-more-visible/#。这里的注释也描述了如何根据您的喜好使滚动条更宽或更窄。

您还可以更改滚动条轨道的颜色。在“scroll_bar_control”类中，我已经将轨道颜色设为中灰色

{
    "class": "scroll_bar_control",
    "layer0.texture": "",            //Originally: Theme - Default/normal_bar_vertical.png",
    "layer0.opacity": 1.0,
    "layer0.tint": [100, 100, 100],
    "layer0.inner_margin": [0, 6],
    "blur": false
},

（在默认主题文件中，滚动条控制对象位于小滑块控制对象之上。）

文本和ui主题文件都包含相当多的设置。虽然不是不可能被学习的大数，但若要大量自定义您的ST安装，您需要投入一些时间，至少需要两周以上时间（务必留出足够的时间彻底测试和记录您的工作，这些和IT开发一样，对于长期维护这两个方面都极其重要。）这份学习曲线，由于这两种主题设置文档的缺乏，使得批评变得很浅。这是我遇到的关于Sublime Theme的唯一严重批评。

技巧与窍门：1.当修改文本或ui主题的颜色时，一个良好的颜色拾取工具是必不可少的。这允许您查看某个小部件的建议颜色并尝试不同的变化。我使用的是：http://www.colorpicker.com。尽管主题文件使用十六进制来指定颜色，但您可以直接从主题文件中复制并粘贴颜色的十六进制值到colorpicker，它将输出RGB和HSB坐标的颜色。然后您可以调整颜色坐标，直到得到您想要的确切颜色。每次您进行更改时，colorpicker也会给您十六进制值。满意后，只需复制十六进制值并将其粘贴回您正在修改的XML标签或小部件的JSON对象中。

1. 您不必遵守ST规定的文件后缀名：'.tmTheme', '.subime-settings'。"C"编程语言引入了一种习惯，即文件后缀名表示所使用的语法编码：source_code.c，assembler_code.asm，archive.tar（磁带存档）等。对于st3-theme-kcps，我采用了以下文件命名约定

* KCPS_text_theme.xml     (named 'KCPS_text_theme.tmTheme' under ST convention)
* KCPS_ui_theme.json      (named 'KCPS_ui_theme.sublime-settings' under ST convention)

  While the reasoning is obvious, one point deserves mention: the package name specifies the software application, version number, package application and identifying name (Sublime Text, version 3, visual presentation theme and KCPS).  Once a file is assigned to this particular package, the filename does not need to reference the other factors, other than the identifying name, in this case 'KCPS'.

  Keep in mind that if you do drop a loose text theme file (i.e one not in a package suffixed with .sublime-package) into the User or Packages directories, and the file is not suffixed .thTheme, ST will not recognize it for inclusion on the User sub-menu (Preferences/Color Scheme).  However files suffixed otherwise will be recognized as field values in your user settings (see 3. below).

1. 如果您想在用户首选项中使用自定义文本着色方案，请点击“首选项/设置 - 用户”。在编辑面板中输入

   {“color_scheme”:“Packages/st3-theme-kcps/KCPS_text_theme.xml”}

不幸的是，适用于构建 3059（2014 年春季）的 Package Control 将自定义软件包安装到 /Installed Packages 中。正如我上面提到的，您可以手动将您的软件包复制到 /Packages 中。或者，您可以将其放置在 /Packages 中。后一种方法更受欢迎，因为按照惯例，可执行文件路径中的 Packages 目录是保留用于随 ST 一起发布的软件包的（请参阅 https://text.sublime.net.cn/docs/3/packages.html）。无论哪种方式，这都是让 ST3 识别您的文本主题文件的唯一方法，因为

{
    "color_scheme": "st3-theme-kcps/KCPS_text_theme.xml"
}

将会导致错误。人们更喜欢这种形式，其中 ST 会明白去查看 /Installed Packages 中的软件包文件，打开它并在其中找到所引用的主题文件。

1. 散装软件包，即以软件包名称命名的目录，包含图像、主题等资源文件，应位于 /Packages 中。