持久正则表达式高亮

此插件允许你创建将高亮显示所有文档的正则表达式。

安装

手动

将此存储库克隆或复制到包目录中。默认情况下，它们位于

• macOS: ~/Library/Application Support/Sublime Text 2/Packages/
• Windows: %APPDATA%/Roaming/Sublime Text 2/Packages/
• Linux: ~/.config/sublime-text-2/Packages/

或

• macOS: ~/Library/Application Support/Sublime Text 3/Packages/
• Windows: %APPDATA%/Roaming/Sublime Text 3/Packages/
• Linux: ~/.config/sublime-text-3/Packages/

包控制

推荐通过包控制进行安装。它将处理作为可用时更新您的包。要安装，请执行以下操作。

• 在命令面板中，输入Package Control: Install Package
• 搜索PersistentRegexHighlight

配置

设置

regex:

用于确定要高亮的条目标识的哈希条目数组。有关这些条目更多信息，请参阅正则表达式设置。

enabled:

一个布尔值，用于指定是否启用高亮。

on_load:

一个布尔值，指定在视图加载时是否执行高亮。

on_modify:

一个布尔值，指定在修改时是否执行高亮。

disable_pattern:

一个包含忽略文件模式的数组。注意这些使用Unix样式模式。模式将与当前文件的绝对路径进行比较。

max_file_size:

应用于持久正则表达式高亮的文件的最大大小。小于或等于零的任何值都将被视为非限制值。默认值为0。

whitelist_folders:

一个包含绝对路径的列表，指定要运行持久正则表达式高亮的文件夹。空列表将导致持久正则表达式高亮运行在所有文件上（除非由disable_pattern设置限制）。

正则表达式设置

pattern:

表示匹配模式的字符串。请注意，正则表达式设置必须包含 “pattern” 或 “pattern_scope”。如果两者都指定，则使用 pattern。

pattern_scope:

指定用于突出显示的作用域的字符串。这些是在 .tmLanguage 文件中存在的范围。如果正则表达式的设置中包含重叠的作用域，将使用第一个。例如，如果指定了两个条目，具有不同的颜色，一个是 constant.language，另一个是 constant.language.python，则首先出现的将被用于突出显示。请注意，正则表达式设置必须包含 “pattern” 或 “pattern_scope”。如果两者都指定，则使用 pattern。

ignored_scopes:

一个可选参数，其中一个可以指定永远不会被模式匹配的作用域。可以指定多个作用域。它们由空白字符（' '）分隔。

ignore_case:

一个可选的布尔值，指定模式是否应忽略大小写。这仅适用于指定了 pattern 的情况。默认情况下，它设置为 false。

color_scope:

一个可选的参数，指定要使用的颜色范围。请注意，您应指定 “color” 或 “color_scope”。如果两者都指定，则使用 “color_scope” 而不是 “color”。此范围应已在您的颜色方案文件中存在。有关更多信息，请参阅 指定高亮色。

color:

一个可选的参数，指定要使用的高亮色。请注意，您应指定 “color” 或 “color_scope”。如果两者都指定，则使用 “color_scope” 而不是 “color”。此条目的值应符合 RRBBGG 的格式。通过指定此值，将生成一个新的颜色方案文件。有关指定颜色和生成文件的更多信息，请参阅 指定高亮色。

underline:

一个布尔值，指定指定的模式是否应加下划线而不是高亮显示。如果此设置为“False”，条目将高亮显示而不是加下划线。默认值为 False。

underline_style:

一个可选的字符串，指定下划线样式。此值仅在 underline 为 true 时使用。此外，样式仅适用于 Sublime Text 版本 >= 3014。此字段的有效条目是 solid、squiggly 和 stippled。无效条目将回退到 solid。

正则表达式示例条目

指定各种模式的示例。

{
    "regex": [{
        "pattern": "[Ff]oo",
        "color_scope": "color.scope.name",
        "ignore_case": true
    }, {
        "pattern_scope": "constant.language",
        "color_scope": "constant.language"
    }, {
        "pattern": "SomeUnderlinePattern",
        "underline": true
    }]
}

指定颜色范围的示例。

{
    "regex": [{
        "pattern": "[Ff]oo",
        "color_scope": "color.scope.name",
        "ignore_case": true
    }]
}

指定颜色的示例。

{
    "regex": [{
        "pattern": "Bar",
        "color": "00FF00",
        "ignore_case": false
    }]
}

排除作用域的示例。

{
    "regex": [{
        "pattern": "\\t",
        "color": "FF3333",
        "ignore_case": true,
        "ignored_scopes": "text.plain example.scope.name"
    }]
}

项目特定设置

上述所有设置也可以作为项目特定设置的一部分指定。这些值将覆盖由更高级设置（用户和默认设置）设置的任何先前值。例如，指定新的 regex 条目将仅高亮显示作为项目特定设置指定的条目。

"settings":
{
    "PersistentRegexHighlight":
    {
        "enabled": false
    }
}

指定高亮色

您可以通过两种方式指定颜色。您可以使用颜色范围或十六进制颜色。有关颜色格式的信息，请参阅 正则表达式设置。

指定作用域

以下是在主题文件中指定自定义作用的示例条目。作用域 'regex.highlight.one' 用于指定此颜色使用的利用。

<dict>
    <key>name</key>
    <string>Regex Highlight</string>
    <key>scope</key>
    <string>regex.highlight.one</string>
    <key>settings</key>
    <dict>
        <key>foreground</key>
        <string>#75715E</string>
    </dict>
</dict>

指定颜色

为 color 键指定值将生成一个新的颜色方案文件。这将把您当前颜色方案文件的内容写入到 Packages/User/ColorScheme/<color_scheme_name_here>。这样做是为了防止将额外的值污染默认颜色方案。完成之后，您将收到一个对话框，您可以在此对话框中选择是否将颜色方案文件更改为新创建的一个。

故障排除

如果您遇到意外的行为，请毫不犹豫地创建一个问题。在创建问题时，请包括控制台输出，可以通过 查看 -> 显示控制台 或默认的 Ctrl/Cmd + ` 获取。

指定颜色

一些平台上的 Sublime Text 2 所包含的当前库中缺少 pyexpat 模块。为了暂时修复这个问题，您需要将 Python 库放置到 Sublime Text 库目录中。如果您已经有 Python 2.6（例如 ln -s /usr/lib/python2.6 [Sublime Text 2 目录]/lib），则可以这样做。

对于某些平台（在 Ubuntu 12.04 上测试过），Python 2.6 库已不再可用。您可能需要为您自己的平台找到相应的分发包。对于 Ubuntu 用户，您可以访问 Ubuntu 存档。然后，您需要提取文件 dpkg-deb -x python2.6_2.6.5-1ubuntu6_i386.deb python2.6。最后，将提取文件中的 usr/lib/python2.6 移动到 [Sublime Text 2 目录]/lib。