联觉

Sublime Text 3插件，用于使用美好颜色突出显示文本。

安装

• 最简单的方法是通过包控制（Shift+Ctrl+P > 安装包 > 联觉）。
• 或者，克隆此仓库到 Packages/synesthesia。

入门

• 打开命令面板（Shift+Ctrl+P）并选择新建突出显示方案。
• 将文件保存为 Hello World.json。
• 从命令面板中选择编译突出显示方案。
• 从命令面板中选择 设置语法：Hello World。瞧！
• 要更改关键词或颜色，只需重新编译即可。

功能

此插件提供了一种快速轻松地将文本用不同颜色突出显示的方法。

它需要一个突出显示方案，这是描述要突出显示的单词及其外观的描述，并为Sublime生成渲染它们的所有必要的配置文件。

这实际上是创建语言定义的抽象，但使用起来更容易：如果只需要在文本中强调几个术语，着色日志文件，等等，无需处理所有这些复杂性。

本README的其他部分详细说明了您可以使用的所有选项。您还可以浏览Packages/synesthesia/include中的示例。

您应该为此插件做什么？

• 临时突出显示文本。此插件是一种快速轻松地将注意力吸引到文本中重要文章的方法。以下是一些例子：
  • 在日志文件中突出显示关键词
  • 在写作中强调字符或位置
  • 颜色可视化（查看Pretty.json）
  • 轻量级标记（有关Markdown，请查看MarkdownEditing）
  • 向现有的语言定义中添加关键词的快速方法
• 此插件并非指定编程语言语法高亮更简便的方式。 一个正则表达式的列表并不是处理大多数编程语言的绝佳方式。使人更容易进行语法高亮是AAAPackageDev插件填补的市场。

颜色

关键字颜色按十六进制形式的RGB指定（#rrggbb）。我们也可以使用颜色名称，如blue或red；这些颜色名称的列表可以在这里找到。

还有两种额外的颜色类型可用：random和auto。使用random将在每次编译时提供随机颜色，而使用auto生成的颜色将是固定的。两者都只会生成漂亮的鲜艳颜色。

{
    'keywords': {
        'roses': '#ff0000',
        'violets': 'blue',
        'lazy?': 'random',
        'no problem!': 'auto'
    }
}

格式和选项

可以使用选项代替颜色名称或值

{
    'keywords': {
        'something': {
            'colour': 'plum',
            'background': 'blue',
            'bold': true,
            'italics': true,
            'whole-word': true,
            'case-insensitive': true
        }
    }
}

• 所有字段都是可选的，包括colour。
• background控制高亮关键字的颜色背景。它是用与颜色相同的用法来使用的。
• whole-word将确保只匹配关键字的全字形式。如果设置为true，则"javascript"中的"java"不会上色。

关键字

关键字使用Oniguruma正则表达式指定，这是Sublime在底层使用的。如果没有熟悉这些表达式，不要担心：字母数字字符串是有效的正则表达式，所以您不需要是专家也能使用此插件。

混合

我们可能会不断地想要高亮相同的事物。例如，我们想要ERROR在大小写字母下均以红色和粗体形式出现。反复定义它可能很麻烦。

这就是本选项的作用。高亮方案可以通过include与其他方案混合，因此我们可以轻松地分离和组合它们。

{
    'include': ['LightMarkdown'],
    'keywords': {
        ...
    }
}

这将导致在编译时将LightMarkdown.json中的关键字和颜色复制到当前方案中。

这是Synesthesia将如何搜索要混合的方案：

• 将首先检查当前方案所在的目录中指定的混合内容。
• 如果无法在那里找到混合内容，接下来将检查Packages/synesthesia/include。
• 依赖项将按指定的顺序以深度优先递归方式解决。循环依赖将被防止。
• 如果关键字已经出现，则在稍后加载的依赖项中再次出现时，不会将其覆盖。

文件扩展名

高亮方案的文件扩展名位于extensions下。这样，在打开此类文件时将自动应用它们。

{
    'extensions': ['txt', 'md'],
    'keywords': {...}
}

默认情况下，将使用txt和md。

自动完成

{
    'autocompletion': true,
    'keywords': {...}
}

如果设置为true，则生成的语言定义中将启用Sublime的自动完成。

其他设置

{
    'keywords': {
        ...
    },
    'settings': {
        'font_face': 'Open Sans'
    }
}

将生成的语言定义的其他设置放在这里。

移除高亮方案

要移除高亮方案，从命令面板中选择移除高亮方案。

不要手动删除文件。Sublime Text将会抱怨这一行为，并且可能需要重新安装包来解决由此产生的错误。

内部工作原理

编译高亮方案将产生三个文件

• 语言定义（.tmLanguage）
• 颜色主题（.tmTheme）
• 设置（.sublime-settings）

前两个文件协同工作，指定一个由用户的关键字组成的迷你语言以及为该迷你语言特别设计的颜色主题。设置文件将它们粘合在一起，使Sublime Text将主题与迷你语言关联起来。所有这些操作都是通过Sublime Text内置的语法高亮功能完成的，因此它是健壮和稳定的。

其他用来高亮任意单词的插件要么通过命名区域，要么通过修改当前颜色主题来完成。

• 第一种方法与实时编辑的交互不好，而且仅限于只更改文本的背景颜色。
• 第二种略有更高的灵活性（例如，可能不需要切换到不同的语言），但在实现上要复杂得多。它也可能不会与所有语言定义和颜色方案很好地工作。

此插件使用的方法虽然静态，但对于实时编辑来说非常方便，也更易于管理。与其他语言定义的交互也变得明确。我认为这是这两种方法之间的折中方案。

许可证

MIT