Sublime Text非官方文档（中文翻译版）¶

Snippets 代码片段 ========

Compatibility with Textmate 与Textmate的兼容性 ***********************

Sublime Text snippets are generally compatible with Textmate snippets. Sublime Text的代码片段与Textmate的代码片段基本兼容。

File Format 文件格式 *******

Snippet files are XML files with the sublime-snippet extension. 代码片段文件是有 sublime-snippet 后缀的XML文件。

<snippet>
    <content><![CDATA[]]></content>
    <tabTrigger></tabTrigger>
    <scope></scope>
    <description></description>
</snippet>

content

Actual snippet content. 实际的代码片段内容。

tabTrigger

Implicit keybinding for this snippet. Last key (implicit) is TAB. 与这段代码片段关联的隐式按键绑定。最后一个（隐式的）按键式 TAB 。

scope

Scope selector to activate this snippet. 适用于这段代码片段的作用域选择子。

description

User friendly description for menu item. 为了菜单项准备的用户友好的说明性文字。

Escape Sequences 转义序列 ************

\$

Literal $.

\$

常量 $ 。

Environment Variables 环境变量 *****************

Fields 字域 **

Mark positions to cycle through by pressing TAB or SHIFT + TAB. 标记代码片段中可以通过 TAB 或 SHIFT + TAB 循环的各个位置。

Syntax: $1 .. $n 语法： $1 .. $n

$0

Exit mark. Position at which normal text editing should be resumed. By default, Sublime Text implicitly sets this mark at the end of the snippet’s content element. 退出标记。当循环到这个标记的时候，编辑器应该返回至正常的编辑模式。默认情况下，Sublime Text在 content 元素内容的结尾位置隐式的添加这个标记。

Fields with the same name mirror each other. 有相同名字的字域互相映射。

Place Holders 站位符 *********

Fields with a default value. 带有默认值的字域。

Syntax: ${1:PLACE_HOLDER} .. ${n:PLACE_HOLDER} 语法： ${1:PLACE_HOLDER} .. ${n:PLACE_HOLDER}

Fields and place holders can be combined and nested within other place holders. 字域和站位符可以遇其他的站位符进行组合和嵌套。

Substitutions 替换 **********

Syntax: 语法：

• ${var_name/regex/format_string/}
• ${var_name/regex/format_string/options}

var_name

The field’s name to base the substitution on: 1, 2, 3… 替换展开所以来的字域的名字：1，2，3……

regex

Perl-style regular expression: See the Boost library documentation for regular expressions. Perl风格的正则表达式：关于`正则表达式 <http://www.boost.org/doc/libs/1_44_0/libs/regex/doc/html/boost_regex/syntax/perl_syntax.html>`_ ，请参考Boost库的文档。

format_string

See the Boost library documentation for format strings. 参考Boost库文档的 格式字符串 内容。

options

Optional. Any of the following: 可选的。可以选择下面的任何一个：

i

Case-insensitive regex. 忽略大小写敏感的正则。

g

Replace all occurrences of regex. 替换所有匹配 regex 的内容。

m

Don’t ignore newlines in the string. 在字符串中不要忽略换行符。

Syntax Definitions 语法定义 ==================

警告：

这部分内容仍处于草稿阶段，并可能包含错误信息。

Compatibility with Textmate 与Textmate的兼容性 ***********************

Sublime Text syntax definitions are generally compatible with Textmate language files. Sublime Text的语法定义内容基本上与Textmate的语法定义文件是相互兼容的。

File Format 文件格式 *******

Syntax definitions are files in the Plist format with the tmLanguage extension. In this reference files, however, JSON is used instead and converted into Plist. 语法定义文件是以 tmLanguage 作为扩展名的Plist（属性列表）文件。然而，在本文档中，我们将使用 JSON文件来进行讲解，然后再将JSON文件转换为Plist文件。

{ "name": "Sublime Snippet (Raw)",
  "scopeName": "source.ssraw",
  "fileTypes": ["ssraw"],
  "patterns": [
      { "match": "\\$(\\d+)",
        "name": "keyword.ssraw",
        "captures": {
            "1": { "name": "constant.numeric.ssraw" }
         },
        "comment": "Tab stops like $1, $2..."
      },
      { "match": "\\$([A-Za-z][A-Za-z0-9_]+)",
        "name": "keyword.ssraw",
        "captures": {
            "1": { "name": "constant.numeric.ssraw" }
         },
        "comment": "Variables like $PARAM1, $TM_SELECTION..."
      },
      { "name": "variable.complex.ssraw",
        "begin": "(\\$)(\\{)([0-9]+):",
        "beginCaptures": {
            "1": { "name": "keyword.control.ssraw" },
            "3": { "name": "constant.numeric.ssraw" }
         },
         "patterns": [
            { "include": "$self" },
            { "name": "string.ssraw",
              "match": "."
            }
         ],
         "end": "\\}"
      },
      { "name": "constant.character.escape.ssraw",
        "match": "\\\\(\\$|\\>|\\<)"
      },
      { "name": "invalid.ssraw",
        "match": "(\\$|\\>|\\<)"
      }
  ],
  "uuid": "ca03e751-04ef-4330-9a6b-9b99aae1c418"
}

name

Descriptive name for the syntax definition. Shows up in the syntax definition dropdown menu located in the bottom right of Sublime Text interface. It’s usually the name of the programming language or equivalent. 所定义语法的描述性名称。这个名称显示在Sublime Text界面右下角的下拉菜单中。通常情况下， name 表示的是 编程语言或其他标记语言的名称。

scopeName

Name of the top-level scope for this syntax definition. Either source.<lang> or text.<lang>. Use source for programming languages and text for everything else. 语法定义文件起效的顶级坐拥域名称。这个名称一般是 source.<语言名称> 或者 text.<语言名称> 。 如果是在定义编程语言的语法，那么就使用 source 这个名称，否则使用 text 作为名称。

fileTypes

And array of file type extensions for which this syntax should be automatically activated. Include the extensions without the leading dot. 记录适用于这个语法文件的文件扩展名的数组。数组中的每项是去掉”.”的文件扩展名称。

uuid

Unique indentifier for this syntax definition. Currently ignored. 这个语法定义的唯一标示符。目前被忽略。

foldingStartMarker

Currently ignored. Used for code folding. 目前被忽略，用于标示折叠内容的开始。

foldingStopMarker

Currently ignored. Used for code folding. 目前被忽略，用于标示折叠内容的结束。

patterns

Array of patterns to match against the buffer’s text. 记录与缓冲区中的文字进行匹配的模式的数组。

repository

Array of patterns abstracted out from the patterns element. Useful to keep the syntax definition tidy as well as for specialized uses like recursive patterns. Optional. 从模式元素中抽象出来的数组。定义这个数组一方面有助于保持语法定义文件整洁，另一方面也能为像 递归模式这样的功能服务。这个内容是可选的。

The Patterns Array 模式数组 **************

Elements contained in the patterns array. 在 patterns 数组中包含的元素。

match

Contains the following elements: 包含下列原素：

match	Pattern to search for.
match	用于搜索的模式。
name	Scope name to be assigned to matches of match.
name	设置被 match 匹配到的内容所具有的作用域。
comment	Optional. For information only.
comment	可选。只是为了提供信息。
captures	Optional. Refinement of match. See below.
captures	可选。是对 match 的精炼。见下文解释

In turn, captures can contain n of the following pairs of elements: captures 内容可以包含 多 组下面要说明的元素对：

0..n	Name of the group referenced.
0..n	被索引的组的名字。
name	Scope to be assigned to the group.
name	组内元素具有的作用域。

Examples: 示例：

// Simple

{ "name": "constant.character.escape.ssraw",
  "match": "\\\\(\\$|\\>|\\<)"
  "comment". "Sequences like \$, \> and \<"
}

// With captures

{ "match": "\\$(\\d+)",
  "name": "keyword.ssraw",
  "captures": {
      "1": { "name": "constant.numeric.ssraw" }
   },
  "comment": "Tab stops like $1, $2..."
}

include

Includes items in the repository, other syntax definitions or the current one. 在仓库中包含其他的语法定义内容或者当前定义的内容。

References:

$self	The current syntax definition.
$self	当前的语法定义。
#itemName	itemName in the repository.
#itemName	仓库中名为 “itemName” 的内容。
source.js	External syntax definitions.
source.js	外部的语法定义。

Examples: 示例：

// Requires presence of DoubleQuotedStrings element in the repository.
{ "include": "#DoubleQuotedStrings" }

// Recursively includes the current syntax definition.
{ "include": "$self" }

// Includes and external syntax definition.
{ "include": "source.js" }

begin..end

Defines a scope potentially spanning multiple lines 定义一个可以跨多行的作用域。

Contains the following elements: 包含下面的一些元素：

begin	The start marker pattern.
begin	模式的开始标志。
end	The end marker pattern.
end	模式的终止标志。
name	Scope name for the whole region.
name	整个区域的作用域名称。
beginCaptures	captures for begin. See captures.
beginCaptures	为 begin 准备的 captures。请参考 captures。
endCaptures	captures for end. See captures.
endCaptures	为 end 准备的 captures。请参考 captures。
patterns	patterns to be matched against the content.
patterns	与正文内容进行配对的 patterns 。
contentName	Scope name for the content excluding the markers.
contentName	除掉标志符之后的内容的作用域名称。

Example: 示例：

{ "name": "variable.complex.ssraw",
  "begin": "(\\$)(\\{)([0-9]+):",
  "beginCaptures": {
      "1": { "name": "keyword.control.ssraw" },
      "3": { "name": "constant.numeric.ssraw" }
   },
   "patterns": [
      { "include": "$self" },
      { "name": "string.ssraw",
        "match": "."
      }
   ],
   "end": "\\}"
}

Repository 仓库 ******

Can be referenced from patterns or from itself in an include element. See include for more information. 在 include 元素中，既可以从 patterns 中饮用，也可以从自身引用。请参考 include 章节来了解更多信息。

The repository can contain the following elements: 仓库可以包含下列元素：

• Simple elements:

  "elementName": {
    "match":  "some regexp",
    "name":   "some.scope.somelang"
  }
  

• Complex elements:

  "elementName": {
    "patterns": [
      { "match":  "some regexp",
        "name":   "some.scope.somelang"
      },
      { "match":  "other regexp",
        "name":   "some.other.scope.somelang"
      }
    ]
  }
  

Examples: 示例：

"repository": {
  "numericConstant": {
    "patterns": [
      { "match":  "\\d*(?<!\\.)(\\.)\\d+(d)?(mb|kb|gb)?",
        "name":   "constant.numeric.double.powershell",
        "captures": {
          "1": { "name": "support.constant.powershell" },
          "2": { "name": "support.constant.powershell" },
          "3": { "name": "keyword.other.powershell" }
          }
      },
      { "match":  "(?<!\\w)\\d+(d)?(mb|kb|gb)?(?!\\w)",
        "name":   "constant.numeric.powershell",
        "captures": {
          "1": { "name": "support.constant.powershell" },
          "2": { "name": "keyword.other.powershell" }
          }
      }
    ]
  },
  "scriptblock": {
    "begin":  "\\{",
    "end":    "\\}",
    "name":   "meta.scriptblock.powershell",
    "patterns": [
      { "include": "$self" }
    ]
  },
}

Escape Sequences 转义序列 ************

Be sure to escape JSON/XML sequences as needed. 请确保对JSON/XML序列内容进行正确的转义。

{
    "cmd": ["python", "-u", "$file"],
    "file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
    "selector": "source.python"
}

``windows``, ``osx`` 以及 ``linux``元素可以帮助你在构建系统中设定平台相关

{
    "selector": "source.python",
    "cmd": ["date"],

    "variants": [

        { "cmd": ["ls -l *.py"],
          "name": "List Python Files",
          "shell": true
        },

        { "cmd": ["wc", "$file"],
          "name": "Word Count (current file)"
        },

        { "cmd": ["python", "-u", "$file"],
          "name": "Run"
        }
    ]
}

${project_name:Default}

${file/\.php/\.txt/}

Key bindings map key presses to commands. 按键绑定为按键与动作建立了映射关系。

File Format 文件格式 *******

Key bindings are stored in .sublime-keymap files and defined in JSON. All key map file names need to follow this pattern: Default (<platform>).sublime-keymap. Otherwise, Sublime Text will ignore them. 对于按键绑定的配置存储于后缀为 .sublime-keymap 的文件中，文件中记录的是JSON内容。所有按键绑定 配置文件都需要按照如下模式命名： Default (<platform>).sublime-keymap 。否则，Sublime Text 将忽略这些文件。

Platform-Specific Key Maps 平台相关的键位设置 ————————–

Each platform gets its own key map: 每一个平台都有它自己的按键配置文件：

• Default (Windows).sublime-keymap
• Default (OSX).sublime-keymap
• Default (Linux).sublime-keymap

Separate key maps exist to abide by different vendor-specific HCI guidelines. 也有针对不同的硬件提供商指定的 HCI 指导文档准备的按键配置文件。

Structure of a Key Binding 一个按键绑定项的结构 ————————–

Key maps are arrays of key bindings. Below you’ll find valid elements in key bindings. 键位表是一个按键绑定项的数组。接下来将要解释的是按键绑定中的有效构成元素：

keys

An array of case-sensitive keys to be pressed. Modifiers can be specified with the + sign. Chords are built by adding elements to the array, e. g. ["ctrl+k","ctrl+j"]. Ambiguous chords are resolved with a timeout. 一组大小写敏感的按键组合。可以用 + 指定修饰符。向数组中添加元素可以设置组合键，例如： ["ctrl+k","ctrl+j"]。

command

Name of the command to be executed. 要执行的命令的名称。

args

Dictionary of arguments to be passed to command. Keys must be the names of parameters to command. 传递给 command 命令的参数字典。字典中键的名称是 command 命令的参数名称。

context

Array of contexts to selectively enable the key binding. All contexts must be true for the key binding to trigger. See context-reference below. 选择性控制按键绑定是否起效的上下文内容数组。只有当所有上下文都为真时，按键绑定才能被触发。 请参考下面的 上下文参考 内容来了解更多内容。

Here’s an example illustrating most of the features outlined above:: 下面是一个说明上面提到的大部分特性的例子:

{ "keys": ["shift+enter"], "command": "insert_snippet", "args": {"contents": "\n\t$0\n"}, "context":
        [
                { "key": "setting.auto_indent", "operator": "equal", "operand": true },
                { "key": "selection_empty", "operator": "equal", "operand": true, "match_all": true },
                { "key": "preceding_text", "operator": "regex_contains", "operand": "\\{$", "match_all": true },
                { "key": "following_text", "operator": "regex_contains", "operand": "^\\}", "match_all": true }
        ]
}

Structure of a Context 上下文的结构 ———————-

key

Name of a context operand to query. 要请求的上下文操作符的名称。

operator

Type of test to perform against key. 对 key 进行测试的类型。

operand

Value against which the result of key is tested. 与 key 的结果进行测试的值。

match_all

Requires the test to succeed for all selections. Defaults to false. 需要多所有选择都进行测试。默认值为 false 。

Context Operands 上下文操作子 ^^^^^^^^^^^^^^^^

auto_complete_visible

Returns true if the autocomplete list is visible. 如果自动不全列表可见就返回 true 。

has_next_field

Returns true if there’s a next snippet field available. 当下一个代码片段域可用时返回 true 。

has_prev_field

Returns true if there’s a previous snippet field available. 当上一个代码片段域可用时返回 true 。

num_selections

Returns the number of selections. 返回当前选中的数目。

overlay_visible

Returns true if any overlay is visible. 当覆盖控件可见时返回 true 。

panel_visible

Returns true if any panel is visible. 当有面板可见时返回 true 。

following_text

Restricts the test to the text following the caret. 限制测试只对脱字号后的文本进行。

preceding_text

Restricts the test to the text preceding the caret. 限制测试只对脱字号前的文本进行。

selection_empty

Returns true if the selection is an empty region. 当没有选中内容的时候返回 true 。

setting.x

Returns the value of the x setting. x can be any string. 返回 x 设置项的值。 x 可以为任意字符串。

text

Restricts the test to the selected text. 限制测试只对选中的文本有效。

selector

Returns the current scope. 返回当前作用域。

Context Operators 上下文操作符 ^^^^^^^^^^^^^^^^^

equal, not_equal

Test for equality. 测试是否相等。

regex_match, not_regex_match

Match against a regular expression. 与一个正则表达式进行匹配。

regex_contains, not_regex_contains

Match against a regular expression (containment). 与一个正则表达式进行匹配（检测是否包含）。

Command Mode 命令模式 ********

Sublime Text provides a command_mode setting to prevent key presses from being sent to the buffer. This is useful to emulate Vim’s modal behavior. Sublime Text提供一个称为 command_mode （命令模式）的设置项，启用这个设置可以阻止按键内容 被送往缓冲区。这个设置项在模拟Vim的模式功能的时候很有用处。

Bindable Keys 可绑定的按键 *********

Keys may be specified literally or by name. Below you’ll find the list of valid names: 按键可以通过字面值或者名字来指定。你可以在下面找到一个有效名称的列表：

• up
• down
• right
• left
• insert
• home
• end
• pageup
• pagedown
• backspace
• delete
• tab
• enter
• pause
• escape
• space
• keypad0
• keypad1
• keypad2
• keypad3
• keypad4
• keypad5
• keypad6
• keypad7
• keypad8
• keypad9
• keypad_period
• keypad_divide
• keypad_multiply
• keypad_minus
• keypad_plus
• keypad_enter
• clear
• f1
• f2
• f3
• f4
• f5
• f6
• f7
• f8
• f9
• f10
• f11
• f12
• f13
• f14
• f15
• f16
• f17
• f18
• f19
• f20
• sysreq
• break
• context_menu
• browser_back
• browser_forward
• browser_refresh
• browser_stop
• browser_search
• browser_favorites
• browser_home

Modifiers 修饰符 ———

• shift
• ctrl
• alt
• super (Windows key, Command key…)
• super （在Windows平台为Windows键，在OS X平台为Command键……）

Warning about Bindable Keys 关于可绑定按键的警告 —————————

If you’re developing a package, keep this in mind: 如果你正在开发一个包，请谨记下面几点：

• Ctrl+Alt+<alphanum> should not be used on any Windows key bindings.
• 在Windows平台上，不要使用 Ctrl+Alt+<alphanum> 进行任何键位绑定。
• Option+<alphanum> should not be used on any OS X key bindings.
• 在OS X平台上，不要使用 Option+<alphanum> 进行任何键位绑定。

In both cases, the user’s ability to insert non-ascii characters would be compromised. 在以上两种情况下，用户都将在插入非ascii字符时遇到问题。

If you are the end-user, you are free to remap those key combinations. 如果你是终端用户，你可以随意重新映射这些按键组合。

Keeping Key Maps Organized 让按键映射井井有条 **********************

Sublime Text ships with default key maps under Packages/Default. Other packages may include their own key map files. The recommended storage location for your personal key map is Packages/User. Sublime Text自带的按键组合存放在 Packages/Default 目录下。其他包组可以包含它们特有的按键 映射文件。对于你自己的键位映射设置而言，推荐的文件存放地址是 Packages/User 目录。

See Merging and Order of Precedence for information about how Sublime Text sorts files for merging. 请参考 排序与优先级顺序 以了解关于Sublime Text排序文件并进行合并的更多信息。

International Keyboards 国际化键盘 *******************

Due to the way Sublime Text maps key names to physical keys, there might be a mismatch between the two. 根据Sublime Text将按键名称与物理按键进行映射的方式，此二者在不同平台上可能有不同的配对。

Troubleshooting 常见问题解答 ***********

See sublime.log_commands(flag) to enable command logging. It may help when debugging key maps. 使用 sublime.log_commands(flag) 开启命令日志。这对于调试按键映射有所帮助。

Global Settings 全局设置项 ===============

Target file: Global.sublime-settings. 对应文件： Global.sublime-settings 。

theme

Theme to be used. Accepts a file base name (e. g.: Default.sublime-theme). 系统使用的主题文件。接受主题文件的名称（例如： Default.sublime-theme ）。

remember_open_files

Determines whether to reopen the buffers that were open when Sublime Text was last closed. 设置Sublime Text启动时是否需要打开上次关闭时打开了的缓冲区。

folder_exclude_patterns

Excludes the matching folders from the side bar, GoTo Anything, etc. 与匹配模式相符的目录将不会出现在侧边栏、快速跳转面板等位置。

file_exclude_patterns

Excludes the matching files from the side bar, GoTo Anything, etc. 与匹配模式相符的文件将不会出现在侧边栏、快速跳转面板等位置。

scroll_speed

Set to 0 to disable smooth scrolling. Set to a value between 0 and 1 to scroll slower, or set to a value larger than 1 to scroll faster. 如果把值设为 0 ，将禁止平滑滚动。取 0 到 1 之间的数值将使滑动变的比较缓慢，取大于 1 的值使得滑动更加迅速。

show_tab_close_buttons

If false, hides the tabs’ close buttons until the mouse is hovered over the tab. 如果设置为 false ，通常情况下就不会显示标签页的关闭按钮，只有当鼠标移动到标签上时才显示。

mouse_wheel_switches_tabs

If true, scrolling the mouse wheel will cause tabs to switch if the cursor is in the tab area. 如果设置为 true ，在标签区域滑动鼠标滚轮会触发标签页之间的切换。

open_files_in_new_window

OS X only. When filters are opened from Finder, or by dragging onto the dock icon, this controls if a new window is created or not. 仅在OS X平台有效。当用户从Finder中开打文件，或者把文件拖拽到dock面板的图标上，这个设置项将决定 是否需要创建一个新窗口。

File Settings 文件设置项 =============

Target files: Base File.sublime-settings, <file_type>.sublime-settings. 对应文件： Base File.sublime-settings， <file_type>.sublime-settings。

Whitespace and Indentation 空格与缩进 **********************

auto_indent

Toggles automatic indentation. 开/关自动缩进选项。

tab_size

Number of spaces a tab is considered to be equal to. 设置tab键对应的空格数。

translate_tabs_to_spaces

Determines whether to replace a tab character with tab_size number of spaces when Tab is pressed. 设置当用户按下 Tab 键时，是否需要用 tab_size 选项所指定数目的空格进行替换。

use_tab_stops

If translate_tabs_to_spaces is true, will make Tab and Backspace insert/delete tab_size number of spaces per key press. 如果 translate_tabs_to_spaces 选项为 true ，设置这个选项就使得每次按下 Tab 与 Backspace 键时，将插入/删除 tab_size 选项所指定数目的空格。

trim_automatic_white_space

Toggles deletion of white space added by auto_indent. 开/关对由 auto_indent 选项自动添加的只有空格的行的检测。

detect_indentation

Set to false to disable detection of tabs vs. spaces whenever a buffer is loaded. If set to true, it will automatically modify translate_tabs_to_spaces and tab_size. 如果设置为 false ，当系统加在缓冲区内容的时候，就会停止对tab与空格的检测。如果设置为 true 则会自动修改 translate_tabs_to_spaces 以及 tab_size 的值。

draw_white_space

Valid values: none, selection, all. 有效值： none， selection， all 。

trim_trailing_white_space_on_save

Set to true to remove white space on save. 将这个选项设置为 true 就会在文件保存时候自动去处行为的空格。

Visual Settings 显示设置项 ***********

color_scheme

Sets the colors used for text highlighting. Accepts a path rooted at the data directory (e. g.: Packages/Color Scheme - Default/Monokai Bright.tmTheme). 设置文本高亮的配色方案。接受从数据目录开始的相对路径（例如： Packages/Color Scheme - Default/Monokai Bright.tmTheme）。

font_face

Font face to be used for editable text. 设置可编辑文本的字体样式。

font_size

Size of the font for editable text. 设置可编辑字体的字体大小。

font_options

Valid values: bold, italic, no_antialias, gray_antialias, subpixel_antialias, directwrite (Windows). 有效值：bold， italic， no_antialias， gray_antialias， subpixel_antialias， directwrite （对Windows平台有效）。

gutter

Toggles display of gutter. 开/关侧边栏选项。

rulers

Columns in which to display vertical rules. Accepts a list of numeric values (e. g. [79, 89, 99] or a single numeric value (e. g. 79). 设置标尺所在的列坐标。接受一个数字值的列表（例如 [79, 89, 99] 或者一个单一的数字值 79）。

draw_minimap_border

Set to true to draw a border around the minimap’s region corresponding to the the view’s currently visible text. The active color scheme’s minimapBorder key controls the border’s color. 如果将这个值设置为 true ，就将根据视图当前可见文本的内容在迷你地图区域画一个边框。当前选中的 配色方案中的 minimapBorder 键对应的值用于控制边框的颜色。

highlight_line

Set to false to stop highlighting lines with a cursor. 将这个值设置为 false 来阻止高亮当前光标所在行。

line_padding_top

Additional spacing at the top of each line, in pixels. 每行文字与上一行的额外距离，以像素为单位。

line_padding_bottom

Additional spacing at the bottom of each line, in pixels. 每行文字与下一行的额外距离，以像素为单位。

scroll_past_end

Set to false to disable scrolling past the end of the buffer. If true, Sublime Text will leave a wide, empty margin between the last line and the bottom of the window. 设置为 false 以关闭超出缓冲区的滚动。如果设置为 true ，Sublime Text将在文本的最后一行 与窗口下边界之间添加一大块空白区域。

line_numbers

Toggles display of line numbers in the gutter. 开/关对行号的显示。

word_wrap

If set to false, long lines will be clipped instead of wrapped. Scroll the screen horizontally to see the clipped text. 如果设置为 false 那么对于内容很多的行，文本将被截取，而不会自动换行。在水平方向拖动滚动条可以 查看被截取的文字。

wrap_width

If greater than 0, wraps long lines at the specified column as opposed to the window width. Only takes effect if wrap_width is set to true. 如果这个值大于 0 ， 系统就会在这个指定的列进行换行切分；否则会根据屏幕的宽度进行换行。这个值 只有在 wrap_width 设置为 true 的时候才有效果。

indent_subsequent_lines

If set to false, wrapped lines will not be indented. Only takes effect if wrap_width is set to true. 如果这个值设置为 false ，被转换的行就不会进行缩进。只有在 wrap_width 为 true 时 才有效。

draw_centered

If set to true, text will be drawn centered rather than left-aligned. 如果设置为 true ，文本将居中对齐，否则为左对齐。

match_brackets

Set to false to disable underlining the brackets surrounding the cursor. 当值设置为 false 时，光标放在括号周围的时候就不会显示下划线。

match_brackets_content

Set to false is you’d rather only highlight the brackets when the cursor is next to one. 设置光标在括号周围时，是否要高亮括号中的内容。

match_brackets_square

Set to false to stop highlighting square brackets. Only takes effect if match_brackets is true. 如果设置项值为 false ，就停止对方括号的配对显示。只有在 match_brackets 值为 true 时有效。

match_bracktets_braces

Set to false to stop highlighting curly brackets. Only takes effect if match_brackets is true. 如果设置项值为 false ，就停止对花括号的配对显示。只有在 match_brackets 值为 true 时有效。

match_bracktets_angle

Set to false to stop highlighting angle brackets. Only takes effect if match_brackets is true. 如果设置项值为 false ，就停止对尖括号的配对显示。只有在 match_brackets 值为 true 时有效。

Automatic Behavior 自动行为设置项 **************

auto_match_enabled

Toggles automatic pairing of quotes, brackets, etc. 开/关自动配对引号、括号等符号。

save_on_focus_lost

Set to true to automatically save files when switching to a different file or application. 如果这个值为真，那么当用户切换到一个不同的文件，或不同的应用程序时，文件的内容将会自动保存。

find_selected_text

If true, the selected text will be copied into the find panel when it’s shown. 如果设置为 true ，那么当打开搜索面板时，当前选中的文字会被自动的复制到搜索面板中。

word_separators

Characters considered to separate words in actions like advancing the cursor, etc. They are not used in all contexts where a notion of a word separator is useful (e. g.: word wrapping). In such other contexts, the text might be tokenized based on other criteria (e. g. the syntax definition rules). 设置在动作中用于分割单词的字符，例如光标跨单词移动的时候来界定单词的分隔符。这个单词分隔符并 不用于所有需要区分单词的情况（例如：换行时不切分单词）。在这种情况下，文本是基于其他标准来界 定的（例如：语法定义规则）。

ensure_newline_at_eof_on_save

Always adds a new line at the end of the file if not present when saving. 如果文本末尾没有空行，那么当保存文件的时候，会自动在文件末尾添加一个空行。

System and Miscellaneous Settings 系统与其他设置项 *****************************

is_widget

Returns true if the buffer is an input field in a dialog as opposed to a regular buffer. 当缓冲区为输入对话框中的输入域的时候，返回 true 。

spell_check

Toggles the spell checker. 开/关拼写检查选项。

dictionary

Word list to be used by the spell checker. Accepts a path rooted at the data directory (e. g.: Packages/Language - English/en_US.dic). You can add more dictionaries. 拼写检查器可选的单词列表。接受从数据目录开始的一个路径（例如： Packages/Language - English/en_US.dic ）。 你也可以 添加更多目录 。

fallback_encoding

The encoding to use when the encoding can’t be determined automatically. ASCII, UTF-8 and UTF-16 encodings will be automatically detected. 控制当无法自动判断编码的时候选用的默认编码。系统可以自动检测的编码包括ASCII，UTF-8以及UTF－16.

default_line_ending

Determines what characters to use to designate new lines. Valid values: system (OS-dependant), windows (CRLF) and unix (LF). 控制系统使用的换行符的字符。有效选项： system （OS相关）， windows （即 CRLF ）以及 unix （ LF ）。

tab_completion

Determines whether pressing Tab will insert completions. 控制按下 Tab 时是否进行补全。

Build and Error Navigation Settings 构建与错误导航设置项 *******************************

result_file_regex

Regular expression used to extract error information from some output dumped into a view or output panel. Follows the same rules as error capturing in build systems.º 用于过滤视图或输出面板中的错误信息的正则表达式。这里的正则表达式遵循与构建系统中的错误捕获相同的规则。

result_line_regex

Regular expression used to extract error information from some output dumpºed into a view or output panel. Follows the same rules as error capturing in build systems. 用于过滤视图或输出面板中的错误信息的正则表达式。这里的正则表达式遵循与构建系统中的错误捕获相同的规则。

result_base_dir

Directory to start looking for offending files in based on information extracted with result_file_regex and result_line_regex. 设置基于 result_file_regex 以及 result_line_regex 抽取出来的信息开始搜索的文件路径。

build_env

List of paths to add to build systems by default. 默认添加到构建系统中的路径列表。

File and Directory Settings 文件与目录设置项 ***********************

default_dir

Sets the default save directory for the view. 设置视图对应的默认保存路径。

Input Settings 输入设置项 **********

command_mode

If set to true, the buffer will ignore key strokes. Useful to emulate Vim. 如果将这个值设为 true ，则缓冲区将忽略用户按键。这对模拟Vim很有帮助。

[
    { "caption": "Project: Save As", "command": "save_project_as" },
    { "caption": "Project: Close", "command": "close_project" },
    { "caption": "Project: Add Folder", "command": "prompt_add_folder" },

    { "caption": "Preferences: Default File Settings", "command": "open_file", "args": {"file": "${packages}/Default/Base File.sublime-settings"} },
    { "caption": "Preferences: User File Settings", "command": "open_file", "args": {"file": "${packages}/User/Base File.sublime-settings"} },
    { "caption": "Preferences: Default Global Settings", "command": "open_file", "args": {"file": "${packages}/Default/Global.sublime-settings"} },
    { "caption": "Preferences: User Global Settings", "command": "open_file", "args": {"file": "${packages}/User/Global.sublime-settings"} },
    { "caption": "Preferences: Browse Packages", "command": "open_dir", "args": {"dir": "$packages"} }
]

Completions 补全 ===========

Completions provide an IDE-like functionality to insert dynamic content through the completions list or by pressing Tab. 补全提供了像IDE那样的使用补全列表或者 Tab 键插入动态内容的功能。

File Format 文件格式 *******

Completions are JSON files with the .sublime-completions extension. 补全信息是以 .sublime-completions 作为扩展名的JSON文件。

Structure of a Completions List 补全列表的结构 ***************************

scope

Determines whether the completions are to be sourced from this file. See Scopes for more information. 控制补全是否应该在这个文件中发挥作用。参考 作用域与作用域选择子 来了解更多信息。

completions

Array of completions. 补全的数组。

Here’s an excerpt from the html completions:: 下面是从html补全列表中截取出来的一部分:

{
        "scope": "text.html - source - meta.tag, punctuation.definition.tag.begin",

        "completions":
        [
                { "trigger": "a", "contents": "<a href=\"$1\">$0</a>" },
                { "trigger": "abbr", "contents": "<abbr>$0</abbr>" },
                { "trigger": "acronym", "contents": "<acronym>$0</acronym>" }

        ]
}

Types of Completions 补全的类型 ****************

Plain Strings 纯文本字符串 ————-

Plain strings are equivalent to an entry where the trigger is identical to the contents:: 当某个补全项 trigger 的内容与 contents 的内容完全一样的时候，纯文本字符串与这个补全项 是等价的。

“foo”

# is equivalent to: # 等价于：

{ “trigger”: “foo”, “contents”: “foo” }

Trigger-based Completions 基于触发内容的补全 ————————-

trigger

Text that will be displayed in the completions list and will cause the contents to be inserted when validated. 在补全列表中显示的文本，在被确认后，对应的 contents 内容被插入到缓冲区中。

contents

Text to be inserted in the buffer. Can use snippet features. 要插入到缓冲区中的文本。可以使用代码片段的特性。

Sources for Completions 补全的来源 *******************

These are the sources for completions the user can control: 用户可以控制的补全来源包括：

• .sublime-completions
• EventListener.on_query_completions()

Additionally, other completions are folded into the final list: 除此之外，其他在最终补全列表中可以显示的内容包括：

• Snippets
• Words in the buffer
• 代码片段
• 缓冲区中的单词

Priority of Sources for Completions 补全来源的优先级 ———————————–

• Snippets
• API-injected completions
• .sublime-completions files
• Words in buffer
• 代码片段
• 使用API插入的补全内容
• .sublime-completions 文件
• 缓冲区中的单词

Snippets will only be automatically completed against an exact match of their tab trigger. Other sources for completions are filtered with a case insensitve fuzzy search instead. 代码片段只有在与设置的tab触发器精确匹配时才会被插入。其他类型的补全则是使用大小写不敏感的模糊 搜索进行匹配。

The Completions List 补全列表 *****************

To use the completions list: 要使用补全列表需要：

• Press Ctrl+spacebar to open
• Optionally, press Ctrl+spacebar again to select next entry
• Press Enter or Tab to validate selection
• 按 Ctrl+空格 来打开补全列表
• 可选的, 再次按下 Ctrl+空格 来选择下一个候选项
• 按下 回车 or Tab 来确认选择

Snippets show up in the completions list following the pattern: <tab_trigger> : <name>. For the other completions, you will just see the text to be inserted. 代码片段以如下形式出现在补全列表中：<tab触发器> : <名称> 。对于其他补全项，你只能看到要被 插入的文本。

If the list of completions can be narrowed down to one choice, the autocomplete dialog will be bypassed and the corresponding content will be inserted straight away according to the priority rules stated above. 当补全列表被缩减到只有一个候选项时，系统就会绕开自动补全对话框，根据之前介绍的优先级，对应内容 会被直接插入。

Enabling and Disabling Tab Completion for Completions 为补全列表启用或禁用Tab补全 *************************************************

The tab_completion setting is true by default. Set it to false if you want Tab to stop sourcing the most likely completion. This setting has no effect on triggers defined in .sublime-snippet files, so snippets will always be inserted after a Tab. tab_completion 选项默认是 true 。如果你想停止 Tab 键对最可能选项的索引功能， 就把这个值设置为 false 。这个设置项对定义在 .sublime-snippet 文件中的触发器没有效果， 因此按下 Tab 时，代码片段一定会被插入。

With tab_completion on, The same order of priority as stated above applies, but, unlike in the case of the completions list, Sublime Text will always insert a completion, even if faced with an ambiguous choice. 当 tab_completion 选项开启的时候，上面介绍的优先级顺序仍然有效，但是，与补全列表不同的是， Sbulime Text总会插入一个补全项，及时选择项存在模糊内容。

Inserting a Literal Tab 插入一个Tab（缩进）字符 ———————–

If tab_completion is true, you can press Shift+Tab after a prefix to insert a literal tab character. 如果 tab_completion 值为 true ，你可以使用 Shift+Tab 来插入一个缩进字符。

Plugins 插件 =======

更多信息请参考：

API参考文档

有关Python API的更详细的信息。

Plugins are Python scripts implementing *Command classes from sublime_plugin. 插件是实现了 sublime_plugin 模块中 *Command 类的Python脚本。

Where to Store Plugins 插件放到哪里 ******************

Sublime Text 2 will look for plugins in these places: Sublime Text 2在以下这些目录中寻找可用插件：

• Packages
• Packages/<pkg_name>
• Packages/<包名称>

Any plugin nested deeper in Packages won’t be loaded. 存放在 Packages 更深层次的目录结构中的插件不会被加载。

All plugins should live inside a directory of their own and not directly under Packages. 任何插件都应该又自己单独的目录，而不应该直接放在 Packages 目录下。

Conventions for Command Names 命令名称的命名规则 *************************

Sublime Text 2 command class names are suffixed by convention with Command and written as CamelCasedPhrases. Sublime Text 2遵循 CamelCasedPhrases 命名规则来定义命令类，同时用 Command 作为后缀。

However, Sublime Text 2 transforms the class name from CamelCasedPhrases to camel_cased_phrases. So ExampleCommand would turn into example and AnotherExampleCommand would turn into another_example. 然而，Sublime Text 2将类名从 CamelCasedPhrases 形式自动转换成 camel_cased_phrases 。 举例来说， ExampleCommand 将被转换为 example ，而 AnotherExampleCommand 将 转换为 another_example 。

For class definition names, use CamelCasedPhrasesCommand; to call a command from the API, use the normalized name (camel_cased_phrases). 对于类定义名称，可以使用 CamelCasedPhrasesCommand 命名方式；要从API中调用一个命令，请使用 标准化后的名称（ camel_cased_phrases ）。

Types of Commands 命令类型 *************

• sublime_plugin.ApplicationCommand
• sublime_plugin.WindowCommand
• sublime_plugin.TextCommand
• sublime_plugin.EventListener

Instances of WindowCommand have a .window attribute pointing to the window instance that created them. Similarly, instances of TextCommand have a .view attribute. WindowCommand 类的实例都有一个 .window 属性，指向创建他们的那个窗口实例。于此类似， TextCommand 类的实例拥有 .view 属性。

Shared Traits for Commands 命令之间的共享特性 ————————–

All commands must implement a .run() method. 所有命令都必须实现一个 .run() 方法。 All commands can receive and arbitrarily long number of keyword arguments, but they must be valid JSON types. 所有命令都可以接受任意长度的关键字参数，但是这些参数一定要是有效的JSON类型。

How to Call Commands from the API 如何利用API调用命令 *****************************

Use a reference to a View or a Window, or sublime depending on the type of command, and call object.run_command('command_name'). In addition, you can pass a dictionary where keys are names of parameters to command_name.

  window.run_command("echo", {"Tempus": "Irreparabile", "Fugit": "."})


Command Arguments
*****************

All user-provided arguments to commands must be valid JSON types. Only
Sublime Text can pass other types of arguments to commands (such as edit
objects, view instances, etc.).

Use a reference to a View or a Window, or sublime depending on the type of command, and call object.run_command('command_name'). 根据命令的类型来选择对 View 、 Window 或者 sublime 的引用，然后通过 object.run_command('command_name') 来调用。 In addition, you can pass a dictionary where keys are names of parameters to command_name. :: 除此之外, 你可以用字典作为参数，字典中的键就是要传给 command_name 的参数名称:

  window.run_command("echo", {"Tempus": "Irreparabile", "Fugit": "."})


Command Arguments
命令参数
*****************

All user-provided arguments to commands must be valid JSON types. Only
Sublime Text can pass other types of arguments to commands (such as edit
objects, view instances, etc.).
用户提供给命令的所有参数都必须是有效的JSON类型。只有Sublime Text可以给命令传递其他类型的参数
（例如修改对象，视图实例等等）。

Text Commands and the edit Object 文本命令以及 修改 对象 *********************************

The two API functions of interest are view.begin_edit(), which takes an optional command name and an optional dictionary of arguments, and view.end_edit(), which finishes the edit. 关于两个文本命令的两个较为重要的API是 view.begin_edit() 和 view.end_edit() 。 其中 view.begin_edit() 可以接受一个可选的命令名称和可选的参数字典；而 view.end_edit() 用来结束编辑过程。

All actions done within an edit are grouped as a single undo action. Callbacks such as on_modified() and on_selection_modified() are called when the edit is finished. 在修改过程中发生的所有动作都被整合成一个单一的撤销动作。当编辑过程结束的时候，类似与 on_modified 和 on_selection_modified() 的回调函数会被触发。

It’s important to call view.end_edit() after each view.begin_edit(), otherwise the buffer will be in an inconsistent state. An attempt will be made to fix it automatically if the edit object gets collected, but that often doesn’t happen when you expect, and will result in a warning printed to the console. In other words, you should always bracket an edit in a try..finally block. 有一点非常重要，每次调用 view.begin_edit() 之后必须调用 view.end_edit() 方法，否则 缓冲将处于一种不一致状态。在不匹配发生时，系统将尝试自动进行修正，但是这种自动修正的发生频率并 没有你想象的那么多，同时会在控制台输出一条警告信息。换句话说，你应该始终使用 try..finally 来包裹代码快。

The command name passed to begin_edit() is used for repeat, macro recording, and for describing the action when undoing/redoing it. If you’re making an edit outside of a TextCommand, you should almost never supply a command name. 传递给 begin_edit() 的命令名称用于重复、宏录制以及撤销/重复过程中的动作描述。如果你在 TextCommand 外面做修改，你就不该指定命令名称。

If you have created an edit object, and call a function that creates another one, that’s fine: the edit is only considered finished when the outermost call to end_edit() runs. 你可以在开始的时候创建一个修改对象，然后调用了一个方法又创建了另外的一个修改对象：只有当最外层 的修改对象执行了 end_edit() 方法之后，系统才认为整个修改都完成了。

As well as grouping modifications, you can use edit objects for grouping changes to the selection, so they’re undone in a single step. 与群组修改类似，你也可以使用修改对象把对选中文本做的修改组合成一个群组，对它们的修改只要一步就 能撤销。

Responding to Events 对事件的响应 ****************

Any subclass of EventListener will be able to respond to events. You cannot make a class derive from both EventListener and any other type of command. 任何 EventListener 的子类都能够响应事件。对于任何一个类，不能同时继承 EventListener 和其他任何的命令类。

Python and the Standard Library Python与标准库 ***************************

Sublime Text ships with a trimmed down standard library. Notable missing modules are the Tkinter, multiprocessing and sqlite3 modules. Sublime Text集成了一个精简版的标准库。被裁剪掉的模块包括 Tkinter ， multiprocessing 以及 sqlite3 。

Automatic Plugin Reload 自动插件重载 *******************

Sublime Text will automatically reload top-level Python modules from packages as they change (perhaps because you are editing a .py file). Note that Python subpackages won’t be reloaded; this can lead to confusion while developing plugins. Generally, it’s best to restart Sublime Text after you’ve made changes to plugin files so all changes take effect. 当你对插件做修改的时候（比如你正在修改一个 .py 文件），Sublime Text会自动加载包中的顶级 Python模块。值得注意的是Python的子模块不会被自动重新加载；这一点在插件开发中可能会产生一些挺 奇葩的问题。一般来说，当你对插件文件做修改之后，最好重启以下Sublime Text，这样能保证你做的修 改能发挥作用。

Multithreading 多线程 **********

Only the .set_timeout() function is safe to call from different threads. 只有 .set_timeout() 方法可以安全的从其他线程调用。

Commands 命令 ****

Overview 概览 ========

This list of commands is a work in progress. 对命令列表的整理仍在进行中。

About Paths in Command Arguments 关于命令参数中的路径信息 ================================

Some commands take paths as parameters. Among these, some support snippet-like syntax, while others don’t. A command of the first kind would take a parameter like ${packages}/SomeDir/SomeFile.Ext whereas a command of the second kind would take a parameter like Packages/SomeDir/SomeFile.Ext. 有些命令把路径作为参数。这些命令中，有些支持代码片段那样的语法，有些则不支持。第一中类型的命令 可以接受类似 ${packages}/SomeDir/SomeFile.Ext 这样的参数，而第二种类型的命令可以接受类似 Packages/SomeDir/SomeFile.Ext 这样的参数。

Generally, newer commands support the snippet-like syntax. 大体上来说，较新引入的命令支持类似代码片段的语法。

Often, relative paths in arguments to commands are assumed to start at the Data directory. 通常情况下，认为命令参数中的相对路径是相对与 数据 目录来说的。

Variables in Paths as Arguments 参数中路径包含的变量 ——————————-

The same variables available to build systems are expanded in arguments to commands. See build-system-variables for more information. 构建系统中使用的变量在参数中也可以使用。参考 构建系统变量 来了解更多信息。

Commands 命令列表 ========

build

Runs a build system. 运行某个构件系统。

• variant [String]: Optional. The name of the variant to be run.
• variant [String]: 可选参数。要运行配置的名称。

run_macro_file

Runs a .sublime-macro file. 运行一个 .sublime-macro 文件。

• file [String]: Path to the macro file.
• file [String]: 宏文件路径。

insert_snippet

Inserts a snippet from a string or .sublime-snippet file. 从字符串或者 .sublime-snippet 文件中插入一个代码片段。

• contents [String]: Snippet as a string to be inserted.
• contents [String]: 要插入的代码片段的字符串内容。
• name [String]: Path to the .sublime-snippet file to be inserted.
• name [String]: 要插入的 .sublime-snippet 文件的路径。

insert

Inserts a string. 插入一个字符串。

• characters [String]: String to be inserted.
• characters [String]: 要插入的字符串内容。

move

Advances the caret by predefined units. 根据指定的单位移动光标。

• by [Enum]: Values: characters, words, word_ends, subwords, subword_ends, lines, pages, stops.
• by [Enum]: 可选值: characters, words, word_ends, subwords, subword_ends, lines, pages, stops 。
• forward [Bool]: Whether to advance or reverse in the buffer.
• forward [Bool]: 在缓冲区中向前或向后移动。
• word_begin [Bool]
• empty_line [Bool]
• punct_begin [Bool]
• separators [Bool]

move_to

Advances the caret to predefined locations. 将光标移动到指定位置。

• to [Enum]: Values: bol, eol, bof, eof, brackets.
• to [Enum]: 可选值: bol, eol, bof, eof, brackets.
• extend [Bool]: Whether to extend the selection. Defaults to false.
• extend [Bool]: 是否扩展选择内容。默认值是 false 。

new_window

Opens a new window. 打开一个新的窗口。

close_window

Closes the active window. 关闭当前活跃窗口。

switch_file

Switches between two files with the same name and different extensions. 在有相同文件名、不同扩展名的两个文件之间进行切换。

• extensions [[String]]: Extensions (without leading dot) for which switching will be enabled.
• extensions [[String]]: 切换可以发生的文件扩展名（不包括点号）。

close

Closes the active view. 关闭当前视图。

close_file

Closes the active view and, under certain circumsances, the whole application. 关闭当前视图，在某些情况下关闭整个应用程序。 XXX Sounds kinda wrong. XXX 看上去好像不对。

toggle_sidebar

Shows or hides the sidebar. 开启或关闭侧边栏。

toggle_full_screen

Toggles full screen mode on or off. 开启或退出全屏模式。

toggle_distraction_free

Toggles distraction free mode on or off. 开启或退出免打扰模式。

left_delete

Deletes the character right before the caret. 删除光标前的那个字符。

right_delete

Deletes the character right after the caret. 删除光标后的那个字符。

undo

Undoes the latest action. 撤销上次操作。

redo

Reapplies the latest undone action. 重做上次撤销的操作。

redo_or_repeat

Performs the latest action again. 再次执行上次的动作。

soft_undo

Undoes each action stepping through granular edits. 先移动到编辑位置再进行撤销操作。

soft_redo

Redoes each action stepping through granular edits. 先移动到编辑位置再进行重做操作。

cut

Removes the selected text and sends it to the system clipboard. Put differently, it cuts. 把当前选中的文字从缓冲区中移除，并送到系统剪贴板中。换句话说，执行剪切操作。

copy

Sends the selected text to to the system clipboard. 把当前选中的文字送到系统剪贴板中。

paste

Inserts the clipboard contents after the caret. 把剪贴板中的内容插入到光标后。

paste_and_indent

Inserts the clipboard contents after the caret and indents contextually. 把剪贴板中的内容插入到光标后同时根据上下文进行缩进。

select_lines

Adds a line to the current selection. 在当前选择的内容中添加一行。

• forward [Bool]: Whether to add the next or previous line. Defaults to true.
• forward [Bool]: 添加下一行还是上一行。默认值是 true 。

scroll_lines

Scrolls lines in the view. 在视图中滚动行。

• amount [Float]: Positive values scroll lines down and negative values scroll lines up.
• amount [Float]: 正值向下滚动，负值向上滚动。

prev_view

Switches to the previous view. 切换到上一个视图。

next_view

Switches to the next view. 切换到下一个视图。

next_view_in_stack

Switches to the most recently active view. 切换到最近的活跃视图。

previous_view_in_stack

Switches to the view that was active before the most recently active view. I don’t think this is very clear or even true. 切换到最近活跃视图的前一个活跃视图。我不认为这种说法非常确切，这么说甚至是不正确的。

select_all

Select the view’s content. 选择视图的全部内容。

split_selection_into_lines

Unsurprisingly, it splits the selection into lines. 不出所料的，把当前的选择切散成不同行。

single_selection

Collapses multiple selections into a single selection. 把多重选择整合成单一选择。

clear_fields

Breaks out of the active snippet field cycle. 跳出活跃代码片段域的选择。

hide_panel

Hides the active panel. 隐藏当前活跃面板。

• cancel [Bool]: Notifies the panel to restore the selection to what it

was when the panel was opened. (Only incremental find panel.) - cancel [Bool]: 当面板打开的时候恢复它之前选择的内容。（仅对增量搜索面板有效。）

hide_overlay

Hides the active overlay. Show the overlay using the show_overlay command. 隐藏覆盖控件。使用 show_overlay 命令打开覆盖控件。

hide_auto_complete

Hides the auto complete list. 隐藏自动补全列表。

insert_best_completion

Inserts the best completion that can be inferred from the current context. XXX Probably useless. XXX 插入根据当前上下文能推断出的最佳补全内容。 XXX 可能没什么用。 XXX

• default [String]: String to insert failing a best completion.
• default [String]: 当没有找到最佳补全内容时插入的字符串。

replace_completion_with_next_completion

XXX Useless for users. XXX XXX 对用户来说没什么用。 XXX

reindent

XXX ??? XXX

（译者注：重新进行缩进操作，常用于整理文件缩进。）

indent

Increments indentation. 增加缩进。

next_field

Advances the caret to the text snippet field in the current snippet field cycle. 将光标移动到下一个代码片段中的可修改区域。

prev_field

Moves the caret to the previous snippet field in the current snippet field cycle. 将光标移动到上一个代码片段中的可修改区域。

commit_completion

Inserts into the buffer the item that’s currently selected in the auto complete list. XXX Probably not useful for users. XXX 向缓冲区中插入自动补全列表中当前选中项的内容。 XXX 对用户来说没很么用。 XXX

unindent

Unindents. 取消缩进。

toggle_overwrite

Toggles overwriting on or off. 开启关闭覆盖插入选项。

expand_selection

Extends the selection up to predifined limits. 将选择内容扩展到预定义的边界。

• to [Enum]: Values: bol, hardbol, eol, hardeol, bof, eof, brackets, line.
• to [Enum]: 可选值: bol, hardbol, eol, hardeol, bof, eof, brackets, line.

find_under_expand

Adds a new selection based on the current selection or expands the selection to the current word. 根据当前选中的内容增加一个新的选择或者把选择项扩展到当前单词。

close_tag

Surrounds the current inner text with the appropiate tags. 为当前内部文本添加适当的标签。

toggle_record_macro

Starts or stops the macro recorder. 开始或关闭宏录制器。

run_macro

Runs the macro stored in the macro buffer. 运行宏缓冲区中存储的宏脚本。

show_overlay

Shows the requested overlay. Use the hide_overlay command to hide it. 显示请求的覆盖控件。使用 hide_overlay 命令来隐藏覆盖控件。

• overlay [Enum]:

  The type of overlay to show. Possible values: 要显示的覆盖控件的类型。可选值：

  • goto: Show the Goto Anything overlay.
  • goto: 显示 Goto Anything（快速跳转） 覆盖控件。
  • command_palette: Show the command palette.
  • command_palette: 显示 命令面板.

• show_files [Bool]: If using the goto overlay, start by displaying files rather than an empty widget.

• show_files [Bool]: 如果显示快速跳转面板，开始的时候显示文件列表，而不是显示一个空的控件。

• text [String]: The initial contents to put in the overlay.

• text [String]: 放到覆盖控件中的初始值。

show_panel

Shows a panel. 显示面板。

• panel [Enum]: Values: incremental_find, find, replace, find_in_files, console
• panel [Enum]: 可选值: incremental_find, find, replace, find_in_files, console
• reverse [Bool]: Whether to search backwards in the buffer.
• reverse [Bool]: 在缓冲区中是否后向搜索内容。
• toggle [Bool]: Whether to hide the panel if it’s already visible.
• toggle [Bool]: 当面板已经可见时，是否隐藏面板。

find_next

Finds the next occurrence of the current search term. 找到当前搜索内容的下一个匹配项。

find_prev

Finds the previous occurrence of the current search term. 找到当前搜索内容的上一个匹配项。

find_under

Finds the next occurrence of the current selection or the current word. 找到与当前选中内容或光标所在位置档次匹配的下一个内容。

find_under_prev

Finds the previous occurrence of the current selection or the current word. 找到与当前选中内容或光标所在位置档次匹配的上一个内容。

find_all_under

Finds all occurrences of the current selection or the current word. 选中与当前选择内容或光标所在位置单词匹配的所有内容。

slurp_find_string

Copies the current selection or word into the “find” field of the find panel. 复制当前选中内容或当前单词到搜索面板中的 “find” 域。

slurp_replace_string

Copies the current selection or word into the “replace” field of the find and replace panel. 复制当前选中内容或当前单词到搜索域替换面板中的 “replace” 域。

next_result

Advance to the next captured result. 移动到下一个搜索到的结果。

prev_result

Move to the previous captured result. 移动到上一个搜索到的结果。

toggle_setting

Toggles the value of a boolean setting. 修改布尔型设置项的值。

• setting [String]: The name of the setting to be toggled.
• setting [String]: 要修改的设置项的名称。

next_misspelling

Advance to the next misspelling 移动到下一个错误拼写的单词的位置。

prev_misspelling

Move to the previous misspelling. 移动到上一个错误拼写的单词的位置。

swap_line_down

Swaps the current line with the line below. 交换当前行与下一行。

swap_line_up

Swaps the current line with the line above. 交换当前行与上一行。

toggle_comment

Comments or uncomments the active lines. 为当前行添加或取消注释。

• block [Bool]: Whether to use a block comment.
• block [Bool]: 是否使用块注释。

join_lines

Joins the current line with the next one. 把当前行与下一行连接起来。

duplicate_line

Duplicates the current line. 重复当前行内容。

auto_complete

Opens the auto comeplete list. 打开自动补全列表。

replace_completion_with_auto_complete

XXX Useless for users. XXX XXX 对用户来说没什么用。 XXX

show_scope_name

Shows the name for the caret’s scope in the status bar. 在状态栏中显示光标所在作用域的名称。

exec

Runs an external process asynchronously. 异步运行一个外部进程。

XXX Document all options. XXX 为所有选项添加文档。

transpose

Makes stuff dance. 移动内容。

sort_lines

Sorts lines. 对行进行排序。

• case_sensitive [Bool]: Whether the sort should be case sensitive.
• case_sensitive [Bool]: 排序时是否考虑大小写。

set_layout

XXX

focus_group

XXX

move_to_group

XXX

select_by_index

XXX

next_bookmark

Select the next bookmarked region. 选择下一个被标记的区域。

prev_bookmark

Select the previous bookmarked region. 选择上一个被书签标记的区域。

toggle_bookmark

Sets or unsets a bookmark for the active region(s). (Bookmarks can be accessed via the regions API using "bookmarks" as the key.) 对活跃区域设置书签或取消书签。（在区域API中使用 "bookmarks" 作为键可以访问书签内容。）

clear_bookmarks

Removes all bookmarks. 清楚所有书签。

select_all_bookmarks

Selects all bookmarked regions. 选择所有被书签标记过的区域。

wrap_lines

Wraps lines. By default, it wraps lines at the first ruler’s column. 环绕行。默认情况下，在第一个标尺所在的列进行环绕。

• width [Int]: Specifies the column at which lines should be wrapped.
• width [Int]: 设置环绕开始的列坐标。

upper_case

Makes the selection upper case. 把选择的内容改成大写。

lower_case

Makes the selection lower case. 把选择的内容改成小写。

set_mark

XXX

select_to_mark

XXX

delete_to_mark

XXX

swap_with_mark

XXX

yank

XXX

show_at_center

XXX

increase_font_size

Increases the font size. 增加字体大小。

decrease_font_size

Decreases the font size. 较少字体大小。

fold

XXX

unfold

XXX

fold_by_level

XXX

context_menu

Shows the context menu. 显示上下文菜单。

Keyboard Shortcuts - Windows/Linux Windows/Linux平台快捷键 ==================================

Editing 编辑 ——-

Navigation/Goto Anywhere 导航/快速跳转 ————————

General 通用快捷键 ————————

Find/Replace 查找/替换 ————————

Tabs 标签页 ————————

Split window 分割窗口 ————————

Bookmarks 书签 ————————

Text manipulation 文本操作 ————————

Keyboard Shortcuts - OSX OSX平台快捷键 ==================================

Editing 编辑 ——-

Navigation/Goto Anywhere 导航/快速跳转 ————————

General 通用快捷键 ————————

Find/Replace 查找/替换 ————————

Tabs 标签页 ————————

Split window 分割窗口 ————————

Bookmarks 书签 ————————

Text manipulation 文本操作 ————————