# Pluma 手册

## 简介

pluma 允许您创建和编辑文本文件。

pluma 的目标是，实现一个简单易用的文本编辑器。更强大的功能可以通过不同的 插件，来实现执行各种文字编辑相关的任务。

## 快速入门

### 启动 pluma

可以通过以下方式启动 pluma：

应用程序 菜单

- 选择 附件文本编辑器。

命令行

- 执行以下命令： `pluma`

默认情况下，当您在文件管理器中打开一个文本文件，pluma 会自动运行，显示这个文档。

### pluma 窗口

在启动 pluma 时，系统会显示下面的窗口。

#### pluma 窗口

Shows pluma main window.

该 pluma 窗口包含以下元件：

菜单栏

- 菜单栏上的菜单包含您在 pluma 中处理文件所需的所有命令。

工具栏

- 工具栏包含您可以从菜单栏访问的命令的子集。

显示区域

- 该区域包含您正在编辑的文件的文本。

状态栏

- 状态栏显示关于当前 pluma 活动的信息和菜单项的相关信息。状态栏也显示下面的信息：

  - 光标位置：显示光标所处的行号和列号。

  - 编辑模式：如果编辑器处于插入模式，则该状态栏显示 插入。如果编辑器处于覆盖模式，状态栏显示 覆盖。按 Insert 键切换两种编辑模式。

侧栏

- 侧栏中显示打开文档的列表，其他信息取决于您启用了哪些插件。

  默认侧边栏没有显示，要显示它，点菜单 查看侧边栏。

底部面板

- 底部面板用于一些编程工具，像 Python 控制台 插件，在这儿显示输出。

  默认底部栏不显示，要显示它，点菜单 查看底部栏。

当在 pluma 窗口中右击时，应用程序将会显示一个弹出菜单。该弹出菜单包含最常用的文本编辑命令。

Like other MATE applications, actions in pluma can be performed in several ways: with the menu, with the toolbar, or with shortcut keys. Shortcuts keys common to all applications are listed in the User Guide.

### 从命令行运行 pluma

您可以从命令行运行 pluma，并且打开一个文件或多个文件。要从命令行打开多个文件，请键入下面的命令，然后按下回车键：

`pluma `file1.txt file2.txt file3.txt``

另外，您也可以指定一个 URI 作为文件名。

更多运行 pluma 的相关信息，请参阅：

pluma

1。

## 文件操作

### 创建新文档

要创建一个新文件，点菜单 文件新建。在 pluma 窗口中，就会显示一个新的空白文档。

### 打开文件

要打开文件，点菜单 文件打开，出来一个 打开文件 对话框。选择要打开的文件，然后点 确定。该文件就会显示在 pluma 窗口中。

The application records the paths and filenames of the five most recent files that you edited and displays the files as menu items on the File menu. You can also click on the Shows Recent Files menu icon. icon on the toolbar to display the list of recent files.

您可以在 pluma 中打开多个文件。程序将为每个打开的程序在窗口里增加一个标签。更多相关信息，请参阅：pluma-tabs。

### 保存文件

您可以使用以下几种方法来保存文件：

- 要保存一个已经存在的文件，点菜单 文件保存 命令。

- To save a new file or to save an existing file under a new filename, choose File Save As . Enter a name for the file in the Save As dialog, then click Save.

- To save all of the files that are currently open in pluma, choose Documents Save All .

To close all of the files that are currently open in pluma, choose Documents Close All .

### 从 URI 打开文件

要通过统一资源标识符 (URI) 打开文件，请执行以下步骤：

1. Choose File Open Location to display the Open Location dialog.

2. 输入您想打开文件的 URI。

3. 在 字符编码 下拉列表中，可以选择适当的字符编码。

4. 点 打开。

有效的 `URI` 包括 `http:`、`ftp:`、`file:` 和所有 `mate-vfs` 支持的格式。

某些类型的 URI 会以只读方式打开，当您更改后必须另存到其他位置。 HTTP 只允许读取文件。从 FTP 上打开的文件一般也是只读，因为并不是所有 FTP 服务器能够处理远程保存文件。

保存到远程服务器，可以通过 配置编辑器 来启用，设置 `/apps/pluma/preferences/editor/save/writable_vfs_schemes`，但这可能导致错误发生。

### 标签操作

当打开多个文件时，pluma 在上边为每个文档显示一个 tab，要切换文档，点击标签即可。

要移动文档到另外的 pluma 窗口，只要把这个文档标签拖过去即可。

To move a document to a new pluma window, either drag its tab to the desktop, or choose Documents Move to New Window .

## 文本操作

### 编辑文本

您可以通过以下方法来编辑文件中的文本：

- 通过键盘来输入文字。光标插入点 指示新的文本将输入到这里。要插入到别处，可以用方向键或鼠标点击来改变光标插入点位置。

- To copy the selected text to the clipboard, choose Edit Copy .

- To delete the selected text from the file and move the selected text to the clipboard, choose Edit Cut .

- To permanently delete the selected text from the file, choose Edit Delete .

- To insert the contents of the clipboard at the cursor position, choose Edit Paste . You must cut or copy text before you can paste text into the file, either from pluma or another application.

- To select all of the text in a file, choose Edit Select All .

### 撤销和重做

To undo a change you have made, choose Edit Undo . To reverse this action, choose Edit Redo .

## 查找和替换文本

在 pluma 中，有两种方法搜索文本。您可以使用 查找 对话框来搜索指定的一段文字，也可以使用 增量搜索 高亮匹配您输入的文本。

### 查找文本

要在文件中搜索文本字符串，请按以下步骤操作：

1. Choose Search Find to display the Find dialog.

2. 在 搜索框 里输入您要查找的字符串，可以包括换行符和制表符，请参阅：pluma-find-escapes。

3. 点击 查找 就可以从当前位置开始搜索字符串。如果 pluma 找到了该字符串，就会选中第一个匹配项，其他的匹配项则会高亮显示。

4. To find the next occurrence of the string, click Find or choose Search Find Next . To find the previous occurrence of the text, choose Search Find Previous .

After you have closed the Find dialog, you can still move the selection to other occurrences of the text by choosing Search Find Next and Search Find Previous .

To remove the highlighting from the text, choose Search Clear Highlight .

### 增量搜索

增量搜索会高亮匹配文档中，您要查找的文本。(这个特性类似于一些网页浏览器中的搜索功能。)

To start an incremental search, choose Search Incremental Search . The search box appears at the top of the display area.

输入后，文档中匹配的文本都会高亮显示，第一个匹配项也会被选中。

要想跳到第二个匹配项，按组合键 Ctrl G。按 Ctrl Shift G 回到前一个匹配项。

您也可以使用上下方向键或鼠标滚轮，在各个匹配项之前切换。

### 替换文本

要在文件中搜索一个字符串，并用另一个字符串替换该字符串，请执行以下步骤：

1. Choose Search Replace to display the Replace dialog.

2. 在 搜索框 中输入您想查找的字符。还可以输入特殊字符，像换行符或制表符，请参阅： pluma-find-escapes。

3. 在 替换为 文本框中输入用来替换查找到的字符串的字符串。

在替换之前如果想检查一下，点击 查找，如果 pluma 找到对应的字符，将会选中它，然后点 替换，就可以替换找到的字符。要查找下一个匹配项，继续点 查找。

要替换文档中的所有匹配项，点 替换全部。

### 查找和替换选项

查找 对话框和 替换 对话框，都有下面的这些选项：

- 选中 区分大小写 选项，仅查找完全匹配大小写的字符串。例如，选中 区分大小写， “TEXT”和“text”是不一样的。

- 选中 匹配整个单词 选项，只是查找那些与您键入文本的整个单词相同的字符串。例如，选中了 匹配整个单词 选项，“text”和“texture”是不匹配的。

- 选中 反向搜索，就会向着文件开头的方向搜索。

- 选中 回到头部继续搜索 选项，当搜索到文件尾以后，接着从文件开头继续搜索。

### 特殊的字符

您可以在查找或替换文本中，包括下列转义字符：

`\n`

- 插入一个新行。

`\t`

- 插入一个 Tab 制表符。

`\r`

- 插入一个回车符

`\\`

- 反斜杠转义字符在搜索时会被忽略。例如如果您想查找文字 "`\n`" ，您需要在 搜索框 里输入 "\\n"。或者如果您要查找连续的反斜杠，您必须输入两个反斜杠来搜索它。

### 将光标定位到指定的行

To position the cursor on a specific line in the current file, choose Search Go to Line . The line number box appears at the top of the display area.

输入您想转到的行，文档会自动跳转到这一行显示。

要去掉这个文本框，并将光标移到指定行，按一下 回车键。

## 打印

### 设置页面选项

To set the page options, choose File Page Setup to display the Page Setup dialog.

页面设置 对话框允许您设定下面这些打印选项：

#### 常规标签

Print syntax highlighting

- 选中此项，打印高亮语法格式。更多相关信息，请参阅：pluma-set-highlightmode。

Print page headers

- 如果选择此选项，系统会在打印时打印每页的页眉。您不能配置页眉。

Line Numbers

- 选中 打印行号 选项，打印文件时也包括行号。

  在 每几行打印一次行 微调按钮框中，设定多久打印一次行号，例如每 5 行打印一次，每 10 行 打印一次，等等。

Text Wrapping

- 选中 允许文本换行，当您打印一个文件时，将自动换行文本字符。程序在统计行数时，将折行还是算作一行。

  选中 不将一个单词拆在两行 选项，会将整个单词换到下一行，当您打印文件时，将自动换行文本单词。

#### 字体

Body

- 单击此按钮可以选择打印文件正文文本所用的字体。

Line numbers

- 单击此按钮可以选择打印行号所用的字体。

Headers and footers

- 单击此按钮可以选择打印文件页眉、页脚所用的字体。

要在 pluma 中，将打印字体恢复到默认字体，点击 恢复为默认字体。

### 打印文档

您可以使用 pluma 来执行以下打印操作：

- 用打印机来打印文档。

- 将打印命令的输出打印到文件中。

如果是打印到文件中，pluma 会将该文件的输出发送到一个印前格式的文件中。最常用的印前格式是 PostScript 格式和可移植文档格式 (PDF)。

To preview the pages that you want to print, choose File Print Preview .

To print the current file to a printer or a file, choose File Print to display the Print dialog.

打印 对话框允许您指定以下打印选项：

#### 任务区段

Print range

- 选择以下一个选项，以确定要打印的页数：

  - All

    如果选择该选项，将打印文件中的所有页。

  - Lines

    选中此项，仅打印指定行。使用 从 和 到 微调按钮框，指定打印行的范围。

  - Selection

    如果选择该选项，将只打印选定的文本。该选项只有在选定了文本时才可用。

Copies

- 点击 副本数 微调按钮框，指定您想打印的份数。

  如果您要该文件的多个副本，则可以 顺序 选项中指定副本打印的顺序。

#### 打印机标签段

Printer

- 点击下拉列表，选择您想要用来打印文件的打印机。

Settings

- 点击下拉列表，设定打印机选项。

  要配置打印机，点 配置。例如，你可以启用或禁用双面打印，或放入打印队列中，如果打印机支持此项功能。

Location

- 点击下拉列表，选择下面一个打印目标：

  CUPS

- 将文件打印到 CUPS 打印机。

  如果选择的打印机是一个 CUPS 打印机，CUPS 是下拉列表中的唯一一项。

lpr

- 将文件打印到打印机。

File

- 将文件打印输出到一个 PostScript 文件中。

  点 另存为 出来一个对话框，您可以指定 PostScript 文件保存的位置和文件名。

Custom

- 使用指定的命令来打印文件。

  在文本框中输入命令的名称，包括所有的命令行参数。

State

- 在这个版本的 pluma 中，不支持这个功能。

Type

- 在这个版本的 pluma 中，不支持这个功能。

Comment

- 在这个版本的 pluma 中，不支持这个功能。

#### 纸张标签段

Paper size

- 使用此下拉列表可以选择您用来打印该文件的纸张的大小。

Width

- 点击微调按钮框指定纸张宽度，在旁边的下拉列表中可以更改用度量单位。

Height

- 使用此微调按钮框可以指定纸张高度。

Feed orientation

- 使用此下拉列表可以选择打印机中的纸张方向。

Page orientation

- 使用此下拉列表可以选择纸张方向。

Layout

- 使用此下拉列表可以选择纸张布局。您选择的每个布局的预览会显示在 预览区域中。

Paper tray

- 点下拉列表，选择纸盘。

## 程序特性

pluma 的一些特性由插件提供。例如，标记列表插件提供一个不同标记语言的常用标记列表：请参阅 pluma-tag-list-plugin。

### 高亮语法格式

高亮语法格式，将不同部分文本显示不同颜色，使得源代码更容易阅读。

pluma chooses an appropriate syntax highlighting mode based on a document's type. To override the syntax highlighting mode, choose View Highlight Mode , then choose one of the following menu items:

Normal

- 不显示高亮语法格式

Sources

- 显示编辑源代码的高亮语法格式。在 源代码 子菜单中，再选择源代码类型。

Markup

- 显示标记语言的高亮语法格式。在 标记语言 子菜单中选择一种标记语言类型。

Scripts

- 显示编辑脚本语言的高亮语法格式。在 脚本语言 子菜单中，选择一种脚本语言类型。

Others

- 显示编辑其他代码的高亮语法格式。在 其他 子菜单中选择一种代码类型。

### 通过管道命令输出到文件

您可以使用 pluma 将命令的输出输送到文本文件中。例如，要将 `ls` 命令的输出输送到一个文本文件中，输入 `ls | pluma`，然后按 回车键。

`ls` 命令的输出就会显示在 pluma 窗口的一个新文件中。

另外，您也可以使用外部工具 插件，把命令输出到当前文件。

## 快捷键

使用快捷键执行常用任务，比用鼠标和菜单要快。下表列出了 pluma 的常用快捷键。

For more on shortcut keys, see the Desktop User Guide.

制表符

标签快捷键：

快捷键 | 命令
Ctrl + Alt + PageUp | 切换到左边的标签页。
Ctrl + Alt + PageDown | 切换到右边的标签页。
Ctrl + W | 关闭标签页。
Ctrl + Shift + L | 保存全部标签页。
Ctrl + Shift + W | 关闭全部标签页。
Alt + n | 跳到第 n 个标签页(n 是数字)。

文件

文件操作的快捷键：

快捷键 | 命令
Ctrl + N | 创建新文件
Ctrl + O | 打开文档。
Ctrl + L | 打开位置。
Ctrl + S | 保存当前文档。
Ctrl + Shift + S | 用一个新的文件名保存当前文档。
Ctrl + P | 打印当前文档。
Ctrl + Shift + P | 打印预览。
Ctrl + W | 关闭当前文档。
Ctrl + Q | 退出 Pluma。

编辑

编辑文档的快捷键：

快捷键 | 命令
Ctrl + Z | 撤销上一次操作。
Ctrl + Shift + Z | 重做最上一次的撤销操作。
Ctrl + X | 剪切选中的文本或区域，并放到剪贴板中。
Ctrl + C | 复制选中的文本或区域，并放到剪贴板中。
Ctrl + V | 从剪贴板中粘贴内容。
Ctrl + A | 全选
Ctrl + D | 删除当前行。
Alt + Up | 将选中的行上移一行。
Alt + Down | 将选中的行下移一行。

面板

显示和隐藏面板的快捷键：

快捷键 | 命令
F9 | 显示/隐藏侧边栏。
Ctrl + F9 | 显示/隐藏底边栏。

搜索

搜索的快捷键：

快捷键 | 命令
Ctrl + F | 查找字符串。
Ctrl + G | 查找下一个匹配的字符串。
Ctrl + Shift + G | 查找前一个匹配的字符串。
Ctrl + K | 交互式搜索。
Ctrl + H | 查找并替换
Ctrl + Shift + K | 清除高亮显示。
Ctrl + I | 跳转到行。

工具

工具快捷键：

快捷键 | 命令
Shift + F7 | 检查拼写(使用插件)。
Alt + F12 | 删除尾部空格(使用插件)。
Ctrl + T | 缩进(使用插件)。
Ctrl + Shift + T | 清除缩进(使用插件)。
F8 | 在当前文件夹运行“make”命令(用插件)。
Ctrl + Shift + D | 文件夹列表(使用插件)。

帮助

帮助的快捷键：

快捷键 | 命令
F1 | 打开 pluma 的用户手册。

## 首选项

To configure pluma, choose Edit Preferences . The Preferences dialog contains the following categories:

- pluma-prefs-view

- pluma-prefs-editor

- pluma-prefs-fontsandcolors

- pluma-prefs-plugins

### 查看

Text Wrapping

- 选中 允许文本换行 选项，长的文本行会折行，而不是跑到文本窗口外边。这就不需要使用水平滚动条。

  选中 不将一个单词拆在两行 选项，会将整个单词换到下一行，使文本更容易阅读。

Line Numbers

- 选中 显示行号，在 pluma 窗口的左侧显示行号。

Current Line

- 选中 高亮显示当前行 选项，光标所在的行会高亮显示。

Right Margin

- 选中 显示右边距 选项，显示一条竖线指示右边距。

  在 右边距位于列 微调按钮框，指定竖线所在的列号位置。

Bracket Matching

- 选中 高亮显示匹配的括号 选项，当光标位于括号位置时，高亮显示匹配的另一个括号。

### 编辑器

Tabs

- 在 Tab 宽度 微调按钮框里，指定当您按下 Tab 键时，pluma 插入的空格宽度。

  选中 插入空格替代制表符，指定当您按下 Tab 键时，pluma 插入空格而不是制表符。

Auto Indentation

- 选中 启用自动缩进，指定下一行在缩进后再开始。

File Saving

- 选中 在保存之前创建一个文件备份，在每次保存文件的时候创建文件的备份副本。备份文件的文件名的末尾包含一个 ~。

  选中 自动保存，每隔...分钟，在指定的时间间隔后，会自动保存当前文件。使用微调按钮框可以指定多久保存一次文件。

### 字体和颜色选项

Font

- 选中 使用默认主题字体， 该选项，将在 pluma 文本窗口中使用默认系统字体来显示文本。

  编辑器字体 显示 pluma 用来显示文本的字体。 单击该按钮可以指定文本使用的字体、样式和大小。

Color Scheme

- 您可以从颜色方案列表中选择一种颜色方案。默认情况下，安装有下面的颜色方案：

  Classic

- 基于 gvim 颜色方案的经典颜色方案。

Cobalt

- 蓝色主题颜色方案。

Kate

- 用于 Kate 文本编辑器的颜色方案。

Oblivion

- 用于 Tango 调色板的黑色主题方案。

Tango

- 用于 Tango 的颜色方案。

您可以通过点击 添加...，选择一个颜色方案文件，来添加一个新的颜色方案

您可以通过点击 删除，删除选中的颜色方案

### 插件

通过插件给 pluma 添加扩展特性。更多相关信息，请参阅：pluma-plugins-overview。

#### 启用一个插件

要启用一个 pluma 插件，请安下面的步骤操作：

1. Choose Edit Preferences .

2. 点击 插件 标签。

3. 选中您想启用的插件名称旁边的复选框。

4. 点 关闭 按钮，关闭 首选项 对话框。

#### 禁用一个插件

当您退出了 pluma，但插件仍保持启用状态。

要禁用一个 pluma 插件，请按下面的步骤操作：

1. Choose Edit Preferences .

2. 点击 插件 标签。

3. 不选中插件名称旁边的复选框，就可以禁用它。

4. 点 关闭 按钮，关闭 首选项 对话框。

## 插件

### 使用插件

您可以通过启用 插件 为 pluma 添加扩展特性。插件是一个额外的小程序，可以增强应用程序的功能。插件会在 pluma 中增加新的菜单项，提供新的特性。

pluma 内置了一些插件，您也可以安装更多，pluma website 中，列出了第三方开发的插件。

要启用或禁用一个插件，或者查看当前启用了哪些插件，请使用 插件选项。

下面的插件是 pluma 内置的插件。

- 改变大小写 允许您更改选中文本的大小写。

- 文档统计 显示文档的行数、单词数和字符数。

- 外部工具 允许您在 pluma 中激活外部的命令。

- 文件浏览器 允许您在侧边栏浏览文件和文件夹。

- 行缩进 为选中的行添加或清除缩进。

- 插入日期/时间 在文档中插入当前的日期和时间。

- Modelines 允许您为特殊的文档设置编辑器选项，支持 Emacs、Kate 和 Vim 风格的 modelines。

- Python 控制台 运行您在 python 编程语言中运行命令。

- 片段 允许您存储常用的文本片段，并快速插入到文档中。

- 排序 按字母顺序排列选定的行。

- 拼写检查 检查选定文本的拼写正确性，或者标记文档中的错误。

- 标记列表 允许您从侧栏中插入常用的 HTML 或其他语言标记。

关于创建插件的更多信息，请参阅：pluma 网站。

### 更改大小写插件

更改大小写 插件更改选中文本的大小写状态。

当 改变大小写 插件启用后，下面的项将添加到 编辑 菜单：

菜单项 | 操作 | 举例
Edit Change Case All Upper Case | 把字符都改成大写字母。 | `This text` 将变成 `THIS TEXT`
Edit Change Case All Lower Case | 把字符都改成小写字母。 | `This Text` 将变成 `this text`
Edit Change Case Invert Case | 把小写字母改成大写，把大写字母改成小写。 | `This Text` 将变成 `tHIS tEXT`
Edit Change Case Title Case | 每个单词的第一个字母改成大写。 | `this text` 将变成 `This Text`

### 文档统计插件

文档统计插件 统计当前文件的行数、单词数、字数(含空格)、字数(不含空格)、字节数。该插件将结果显示在一个文档统计信息 对话框中。 要使用文档统计插件，请按以下步骤操作：

1. Choose Tools Document Statistics to display the Document Statistics dialog. The Document Statistics dialog displays the following information about the file:

   - 当前文档中的行数。

   - 当前文档中的字数。

   - 当前文档中的字符数（包括空格）。

   - 当前文档中的字符数（不包括空格）。

   - 当前文档中的字节数。

2. 在 文档统计信息 对话框打开时，您可以继续在 pluma 里编辑文件。 要刷新 文档统计信息 对话框的内容，点击 更新 按钮。

### 外部工具插件

The External Tools 允许您在 pluma 中运行外部命令。您可以通过管道命令来编辑它们的输出(例如 sed)，或者启动一个预编译命令(如 make)。

使用 外部工具管理器 来创建和编辑命令。要运行一个外部命令，点 工具 菜单。

#### 内置命令

下面的命令由 外部工具 插件提供：

Build

- 在当前文档的文件夹下，运行 make 命令。

列出文件夹

- 在一个新文档中，列出当前文件夹的内容。

环境变量

- 在底部面板显示环境变量。

Grep

- 使用匹配模式，在当前文件夹中的全部文件中搜索匹配项。结果显示在底部面板。

删除尾部空格

- 删除文档中每一行的尾部空格。

#### 定义一个命令

要添加一个外部命令，点菜单 工具外部工具。

在 外部工具管理器 窗口中，点 新建。您可以指定命令的下面内容细节：

说明

- 当选中菜单命令时，这个描述将显示在状态栏。

快捷键

- 输入此命令的快捷键。

命令

- 要运行的命令。一些 pluma 环境变量可以传递给命令，请参阅 pluma-external-tools-plugin-variables。

输入

- 这个内容将传递给命令(像 `stdin`)：当前文档的全部文本、段、行或词。

输出窗口

- 输出这个命令做了什么：显示在底部面板、放入一个新文档，或者放到当前文档，放在文档尾部、光标位置，或者替换这一段、替换整个文档。

适用性

- 确定哪一类文档会被这个命令影响，例如是否保存，本地还是远程。

#### 编辑和删除工具

要编辑一个工具，在列表中选中它，然后更改它的属性。

要重命名一个工具，在列表中再点击它一次。

要恢复您已经改变了的内置工具，点 还原 按钮。

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

#### 变量

在 命令 文本框中，您可以使用下面的变量：

- PLUMA_CURRENT_DOCUMENT_URI

- PLUMA_CURRENT_DOCUMENT_NAME

- PLUMA_CURRENT_DOCUMENT_SCHEME

- PLUMA_CURRENT_DOCUMENT_PATH

- PLUMA_CURRENT_DOCUMENT_DIR

- PLUMA_DOCUMENTS_URI

- PLUMA_DOCUMENTS_PATH

### 文件浏览器插件

文件浏览器 插件，在侧栏中显示您的文件和文件夹，允许你快速打开文件。

To view the File Browser, choose View Side Pane and then click on the tab showing the File Browser icon at the bottom of the side pane.

#### 浏览文件

文件浏览器标签开始只显示文件管理器书签。要浏览每一项的内容，在标签上双击。

要显示上一级父目录，在下拉列表中选择，或者点文件管理器工具栏的向上箭头。

要显示您当前工作的文件夹中包含的内容，在文件列表中点右键，选 当前文件夹设定为根目录。

#### 打开文件

要在 pluma 里打开一个文件，在文件列表中双击它。

#### 创建文件和文件夹

要在当前文件夹中创建一个新的空文本文件，在文件列表里点右键，选 新建文件。

要在当前文件夹中创建一个新的文件夹，在文件列表里点右键，选 新建文件夹。

### 缩进行插件

缩进行 插件，在行的开头添加或清除空白缩进。

要对文本使用缩进或取消缩进，请按下面的步骤操作：

1. 选择所需缩进行。要对单行进行缩进或取消缩进，请将光标放在该行的任意位置上。

2. - To indent the text, choose Edit Indent .

   - To remove the indentation, choose Edit Unindent .

空白的数量，或者是否使用 Tab 制表符，使用空格字符，取决于编辑器首选项中的 制表符 设置，请参阅：pluma-prefs-editor。

### 插入日期/时间插件

插入日期/时间 插件可以在文档中插入当前的日期和时间。 要使用插入日期/时间插件，请按以下步骤操作：

1. Choose Edit Insert Date and Time .

   如果您还没配置“插入日期/时间”插件配置为不提示格式自动插入方式，pluma 将显示插入日期和时间 对话框。在列表中选择合适的日期/时间格式。单击 插入，关闭 插入日期和时间 对话框；pluma 将在光标的位置插入日期/时间。

   如果您已经配置了 pluma 使用一种指定的日期/时间格式，就不会显示插入日期和时间 对话框，在当前光标位置处自动插入日期/时间。

#### 配置插入日期/时间插件

要配置插入日期/时间插件，请执行以下步骤：

1. Choose Edit Preferences .

2. 点击 插件 标签。

3. 选择 插入日期/时间插件。

4. 点 配置插件 按钮，出来一个 配置插入日期/时间插件 对话框。

5. 如下所述，选择其中一个选项：

   - 要在每次插入日期/时间时，都指定日期/时间的格式，请选择 提示输入格式 选项。

   - To use the same pluma-provided date/time format each time you insert the date/time, select the Use the selected format option, then select the appropriate format from the list. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

   - To use the same customized date/time format each time you insert the date/time, select the Use custom format option, then enter the appropriate format in the text box. For more information about how to specify a custom format, see

     strftime

     3. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

6. 单击 确定，关闭 配置插入日期/时间插件 对话框。

7. 要关闭 首选项 对话框，请单击 关闭。

### Modelines 插件

Modelines 允许您为特殊的文档设置选项。modeline 是在文档开头或结束的一行文本，可以由 pluma 识别。

使用 modelines 设置的选项，会覆盖在首选项对话框里设定的选项。

您可以用 modelines 设定下面的选项：

- Tab 制表符宽度

- 缩进宽度

- 插入空格而不是制表符

- 文本换行

- 右边距宽度

Modelines 支持其他文本编辑器的子选项，像 Emacs、Kate 和 Vim。

#### Emacs Modelines

为 Emacs modelines 扫描文档开头的两行。

支持 Emacs 的制表符宽度、缩进量、缩进模式和自动换行。更多相关信息，请参阅：GNU Emacs 手册。

#### Kate Modelines

为 Kate modelines 扫描文档开头和最后十行。

支持 Emacs 的制表符宽度、缩进量、空格缩进、单词换行和单词列换行。更多相关信息，请参阅： Kate 网站。

#### Vim Modelines

为 Vim modelines 扫描文档开头和最后的三行。

支持 Emacs 的 et、expandtab、ts、tabstop、sw、shiftwidth、wrap 和 textwidth。更多相关信息，请参阅：Vim 网站。

### Python 控制台插件

Python 控制台 插件允许您在 pluma 中运行 python 编程语言中命令。启用该插件会在底部栏添加一个标签。显示最近输出结果和命令提示符域。

命令进入 python 控制台运行前并不检查。因而它可能导致 pluma 挂起，例如输入了一个无限循环。

### 片段插件

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

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

pluma 提供了许多内置的片段，可以被设置。

#### 插入片段

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

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

#### 添加片段

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

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

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

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

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

   名称

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

片段文本

- 在编辑片段 文本框中，输入片段的内容。您可以使用特殊代码，请参阅：pluma-snippets-plugin-syntax。

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

Tab 触发器

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

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

快捷键

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

#### 编辑和删除片段

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

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

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

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

#### 替代片段

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

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

Tab 占位符

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

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

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

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

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

Mirror 占位符

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

End 占位符

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

环境变量

- 环境变量是指像 `$PATH` 和 `$HOME`，可以在片段中替代。下面的变量可以在 pluma 中使用：

  $PLUMA_SELECTED_TEXT

- 当前选中的文本。

$PLUMA_FILENAME

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

$PLUMA_BASENAME

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

$PLUMA_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` 声明它。

### 排序插件

排序 插件，可以按字母顺序排列选中的行。

You cannot undo the Sort operation, so you should save the file before performing the sort. To revert to the saved version of the file after the sort operation, choose File Revert .

要使用排序插件，请执行以下步骤：

1. 选中你想排序的行。

2. Choose Edit Sort . The Sort dialog opens.

3. 设定您想要的排序选项：

   - 要按反向顺序排列文本，选中 逆序顺序 选项。

   - 要删除重复的行，选中 删除重复内容 选项。

   - 要忽略大小写，选中 忽略大小写 选项。

   - 要指定排序的开始位置，请在 起始列 微调按钮框中设定开始排序的字符列。

4. 要执行排序操作，点击 排序 按钮。

### 拼写检查插件

拼写检查 检查选中文本的拼写。您可以在指定的语言里，配置 pluma 自动简单拼写，或者您可以手动检查拼写。语言设置、自动拼写检查属性，应用于每个文档。要使用拼写检查插件，请按下面的步骤操作：

1. Choose Tools Set Language to display the Set language dialog. Select the appropriate language from the list. Click OK to close the Set language dialog.

2. To check the spelling automatically, choose Tools Autocheck Spelling . To unset the automatic spell check, choose Tools Autocheck Spelling again. When automatic spell checking is set, an icon is displayed beside the Autocheck Spelling menu item. Automatic spell checking is unset by default, each time pluma starts.

   未知拼写的词会显示不同的颜色和带有下划线。在词语上点右键，然后从弹出菜单里选择 拼写建议：

   - 要替换未知拼写，从 拼写建议 菜单里选择一项。

   - To add the unknown spelling to your personal dictionary, select Spelling Suggestions Add .

   - To ignore all occurrences of the unknown spelling, so that they are no longer flagged as unknown but are not added to your personal dictionary, select Spelling Suggestions Ignore All . The unknown word is ignored in the current pluma session only.

3. To check the spelling manually, choose Tools Check Spelling .

   如果这儿没有拼写错误，出来一个 信息 对话框，提示没有包含错误拼写。点 确定 关闭这个 信息 对话框。

   如果发现错误拼写，出来一个 检查拼写 对话框：

   - 拼错的词 显示在对话框的顶部。

   - 一个建议的拼写会显示在 更改为 文本框里。您可以在 建议 里，选择其他词语来替换，或者您可以直接输入到 更改为 文本框里。

   - 要检查 更改为 文本框里的拼写，点 检查单词 按钮。如果这是一个已知的词，建议 列表被这个词替换 `(正确拼写)`。如果这个词也未知，新的项出现在 建议 列表中。

   - 要忽略当前的检查，点 忽略。要忽略所有这个未知词的检查，点 全部忽略。在当前 pluma 中不再对这个词检查。

   - 要用 更改为 文本框里的词，替换当前检查的未知词，点 更改 按钮。要把所有这个未知词替换为 更改为 文本框里的词，点 全部更改。

   - 要添加未知单词到您的个人字典，点 添加单词。

   - 要关闭 拼写检查 对话框，点 关闭。

### 标记列表插件

标记列表 插件，允许您从侧栏中插入通用标记。

要使用标记列表插件，请按以下步骤操作：

1. Choose View Side Pane .

2. 默认情况下，侧边栏显示包含打开文档列表的标签。点击侧栏底部一个 + 图标的标签，显示标记列表。

3. 在下拉列表中选择合适的标记种类。例如，HTML - 标记。

4. 卷动该标记列表查找所需的标记。

5. 要在当前文件的光标位置插入标记，请双击标记列表中的标记。您也可以按照如下步骤插入标记：

   - 要在当前文件中插入标记，并将焦点从 标记列表 栏移到工作区，按一下 回车键。

   - 要在当前文件中插入标记，并将焦点仍保留在 标记列表 栏，按 Shift 回车键。