片段插件

片段 插件,允许您存储常用的文本片段,称作片段,可以很方便地插入文档中。

片段指定到了当前语言格式。例如,当您在 HTML 下操作,您可以从片段列表中选择有用的 HTML 片段。另外,一些片段是全局的,可用于所有的文档。

gedit 提供了许多内置的片段,可以被设置。

10.10.1. 插入片段

要在文档中插入一个片段,输入它的 Tab 触发器,然后按 Tab。片段触发器通常是片段的开头几个字符,或者是一些其他短的好记的字符。

另外,按 Ctrl+Space 键,查看您可以使用的片段列表。

10.10.2. 添加片段

要创建一个新片段,请按下面的步骤操作:

  1. 点菜单 工具 ▸ 管理片段,出来一个 片段管理器 窗口。

  2. 片段列表按语言分组。选择您想添加片段的语言,或者那个语言的片段组。要为所有语言添加片段,点列表顶部的全局。默认显示您当前编辑文档的格式。

  3. 新建,列表中出来一个新的片段。

  4. 为新片段输入下面的信息:

    名称

    在文本框中输入片段的名称。片段名称仅仅是它作用的提示。您可以通过点击它来改变名称。

    片段文本

    编辑片段 文本框中,输入片段的内容。您可以使用特殊代码,请参阅:第10.10.4节 ― 替代片段

    您可以切换到文档窗口,复制里面的文本,而不需要关闭 片段管理器 窗口。

    Tab 触发器

    为片段输入标记触发器。这个文本是您输入后按 Tab 键,就会插入片段。

    标记必须是单个由字母组成的词,或者是单个字符。Tab 触发器 会用红色高亮显示,表示输入了一个触发器。

    快捷键

    输入用来插入片段的快捷键。

10.10.3. 编辑和删除片段

要编辑一个片段,在列表中选中它,然后更改它的文本和激活属性。

要重命名一个片段,在列表中再次点击它。

要恢复您更改了的内置片段,点 复原 按钮。

要删除一个片段,在列表中选中它,然后点 删除。您不能删除内置的片段,只能删除您自己创建的片段。

10.10.4. 替代片段

除了插入已经存储的文本,片段可以包括自定义文本,或者标记空格,您可以添加自己文本。

您可以在片段文本中使用下面的占位符代码:

Tab 占位符

$n 定义一个 tab 占位符,n 是从 1 开始的数字。

${n:default} 用默认值定义一个 tab 占位符。

tab 占位符在片段文本中标记一个区域,您可以在插入片段后添加额外的文本。

要使用 tab 占位符,像平常一样插入片段。光标定位于第一个 tab 占位符。输入文本,然后按 Tab 到下一个 tab 占位符。占位符的序号定义了在文本中各个 tab 的位置。

Shift+Tab 返回到上一个 tab 占位符。当再没有占位符时,按 Tab 键结束片段,或者到最后一个占位符,如果它存在的话。

Mirror 占位符

重复 tab 占位符,将会映像已经定义的占位符。这就可以让您输入一次而重复多次这个片段。

End 占位符

$0 定义最后占位符。这就允许您完成片段操作,而不是光标停在最后一个片段文本。

环境变量

环境变量是指像 $PATH$HOME,可以在片段中替代。下面的变量可以在 gedit 中使用:

$GEDIT_SELECTED_TEXT

当前选中的文本。

$GEDIT_FILENAME

文档的完整名称,对于还没有保存的问道,是一个空字符串。

$GEDIT_BASENAME

文档文件名的基本名,对于还没保存的文档,是一个空字符串。

$GEDIT_CURRENT_WORD

文档里光标所在位置的词。当使用这个变量时,当前词将会被片段替代。

Shell 占位符

$(cmd) 会被 shell 里运行的 cmd 结果替换。

$(n:cmd) 允许您给这个占位符一个索引,这儿的 n 是一个从 1 开始的数字。使用 $n,用一个 shell 的输出,作为另一个的输入。

Python 占位符

$<cmd> 在 python 解释器里,用结果值来替换。

$<a:cmd> 指定另一个 python 占位符作为附属,a 给出它在片段里的顺序。这就允许您在另一个片段里使用 python 的功能定义。要指定几个附属,用逗号分隔开: $<a,b:cmd>

要在所有 python 片段里使用变量,用 global 声明它。