# 工具和实用程序

Christopher Meng
i@cicku.me
2012-2013
Christopher Meng
ravix
dr.neemous@gmail.com
2013
ravix
Dianjin Wang
1132321739qq@gmail.com
2012
Dianjin Wang
Cravix
dr.neemous@gmail.com
2013
Cravix
nyanyh
rebuilty@gmail.com
2013
nyanyh
liulitchi
xingzuo88@qq.com
2013
liulitchi
玉堂白鹤
yjwork@qq.com
2015
玉堂白鹤
Mingye Wang
arthur200126@gmail.com
2015-2016
Mingye Wang
白铭骢
jeffbai@aosc.xyz
2015-2016
白铭骢
刘子兴
liushuyu@aosc.xyz
2015-2016
刘子兴

This section describes some tools and utilities in the MATE Desktop.

## 运行应用程序

运行应用程序 对话框可让您访问命令行。当您在 运行应用程序 对话框中运行命令时，您无法得到命令的输出。

要从命令行运行命令，请按以下步骤操作：

1. Open the Run Application dialog in any of the following ways:

   From a panel

     You can add the Run Application button to any panel. See . Click on the Run Application panel button to open the Run Application dialog.

   Using shortcut keys

     Press Alt F2. You can change the shortcut keys that display the Run Application dialog in the tool.

   显示 运行程序 对话框。

2. 在空白处输入您想运行的命令，或者在已知程序列表中选择。

   If you enter only the location of a file, an appropriate application will launch to open it. If you enter a web page address, your default web browser will open the page. Prefix the web page address with https://, as in https://mate-desktop.org.

   选择一个您先前运行的命令，点击命令栏旁边的向下箭头按钮，然后选择要运行的命令。

   您还可以点击 带文件运行 按钮，选择一个文件放在命令后面。例如，您可以输入 emacs 作为命令，然后选择一个文件来编辑。

   打勾选中 在终端里运行 选项，可以在终端窗口中运行程序或命令。如果一个程序或命令不能以窗口方式运行时，请选中此项。

3. 在 运行应用程序 对话框中点击 运行 按钮。

## 屏幕抓图

您可以通过以下方式对屏幕抓图：

- 从任何面板

  您可以添加 抓图 按钮到任何面板。相关操作请参阅： 。点击 抓图 按钮来抓取整个屏幕。

- 使用快捷键

  要对屏幕抓图，请使用下列快捷键：

  默认快捷键 | 功能
  --- | ---
  Print Screen | 获得整个屏幕的抓图
  Alt Print Screen | 对活动窗口截图。

  You can use the tool to modify the default shortcut keys.

- 从菜单栏

  Choose Applications Accessories Take Screenshot.

- 从终端

  您可以使用 `mate-screenshot` 命令来抓图。`mate-screenshot` 命令抓取整个屏幕并显示 保存图像 对话框。使用 保存图像 对话框来保存图像。

  您也可以像下面这样，在 `mate-screenshot` 命令中使用选项参数。

  选项 | 功能
  --- | ---
  `--window` | 对当前窗口截图。
  `--delay=seconds` | 在预先设定的秒数后截图并且显示 保存图像 对话框。使用 保存图像 对话框来保存抓图。
  `--include-border` | 包含窗口边框。
  `--remove-border` | 不包含窗口边框。
  `--border-effect=shadow` | 抓图并在图片四周添加立体阴影效果。
  `--border-effect=border` | 抓图并在图片四周添加边框效果。
  `--interactive` | 进行屏幕抓图前打开一个窗口以便您设置选项。
  `--help` | 显示命令的选项。

当您抓图时，保存图像 对话框会打开。要保存抓图为一个图片文件，请输入文件名并且在下拉菜单中为它选择一个保存位置。

## Yelp 帮助浏览器

### 介绍

Yelp 帮助浏览器 程序允许您以多种格式查看关于 MATE 和其他组件的文档。这些格式包括 docbook 文件、HTML 帮助页面、man 页以及 info 页面（对于 man 和 info 页面的支持可以作为可选组件编译进去）。尽管支持多种不同格式，Yelp 尽可能提供统一的阅读界面。

Yelp Help Browser is internationalized, meaning that it has support to view documents in different languages. The documents must be localized or translated for each language and installed properly for Yelp Help Browser to be able to view them.

### 启动 Yelp

#### 要启动 Yelp 帮助浏览器

您可以通过以下方式启动 Yelp 帮助浏览器：

系统 菜单

  选择 帮助

命令行

  执行下列命令：`yelp`

#### 界面

当您启动 Yelp 帮助浏览器 时，您将看到下列窗口。

##### Yelp Help Browser Window

Yelp Help Browser contains the following elements in

菜单栏

  File

    使用这个菜单来打开新窗口、查看关于这个文档页面、打印当前文档或者关闭窗口。

  Edit

    使用这个菜单来复制贝、全选、搜索... 或者可以设置程序的首选项。

  Go

    使用这个菜单来后退、前进、以及进入帮助主题页面。当查看一个 DocBook 文档时，使用这个菜单导航到下一个章节、前一个章节或者到达目录。

  Bookmarks

    使用此菜单添加或编辑书签。

  Help

    通过关于 菜单项来查看关于 Yelp 帮助浏览器和对项目有贡献者的信息。使用 内容 菜单项或者按下 F1 键来打开这个文档。

工具栏

  Back

    使用此按钮在您的文档历史中后退。

  Forward

    在文档历史中使用这个按钮来向前导航。

  Help Topics

    使用这个按钮回到目录(在 中显示)。

Browser Pane

  您将在浏览栏看到目录或者文档。使用目录导航到您想查看的文档。

### 使用 Yelp

#### 打开文档

To open a document in Yelp Help Browser:

- In an application, click Help Contents

- Use the Table of Contents to navigate to the desired document.

- You can drag a Docbook XML file from Caja to the Yelp window or launcher.

- Press the F1 key.

或者，您也可以通过命令行调用 Yelp 帮助浏览器或者将文件拖至 Yelp 来查看一个特定的文档。更多相关信息，请参阅：。

#### 打开新窗口

要打开新窗口：

- Click File New Window

- 使用组合键 Ctrl N

#### 关于此文档

查看关于当前已打开文档的信息：

- Click File About This Document

这个选项只对 DocBook 文档有效。法律声明和文档贡献者常在这个部分列出。

#### 打印页面

打印任何您在 Yelp 帮助浏览器 中浏览的页面：

- Click File Print this Page

#### 打印文档

要打印整个文档：

- Click File Print this Document

这个选项只对 DocBook 文档有效。

#### 关闭窗口

要关闭 Yelp 帮助浏览器的一个窗口，操作如下：

- Click File Close Window

- 使用组合键 Ctrl W

#### 设定首选项

要在 Yelp 帮助浏览器 中设置相关参数选项：

- Click Edit Preferences

A window will appear that looks like :

##### Yelp Help Browser Preferences Window

The options that are available in this dialog have the following functions:

Use system fonts

  选中此项，使用 MATE 桌面默认字体来显示文档。

  要选择您自己的字体来显示文档，去掉这个选项前面的勾，并点击 非等宽字体 或 等宽字体 旁边的按钮。

  Variable Width

    这是在不需要使用固定或等宽字体时使用的字体。大部分的文本都会是这种字体。

  Fixed Width

    这是在所有文本字符需要使用相同大小时使用的字体。这种字体通常被用来显示命令、程序块或者任何归入这些类别的其他文本。

Browse with caret

  如果您想在中看到光标，请点击这个选项。在文档中显示光标的位置有助于您更容易的浏览文档。

#### 在文档历史中后退

要在文档历史中后退：

- Click Go Back

- 使用组合键 Alt Left

- Use the Back button in the Toolbar

#### 在文档历史中前进

要在文档历史中前进：

- Click Go Forward

- 使用组合键 Alt 右方向键

- Use the Forward button in the Toolbar

#### 转到帮助主题

要转到帮助主题：

- Click Go Help Topics

- 使用组合键 Alt Home 键

- Use the Help Topics button in the Toolbar

#### 回到上前一节

要回到上一节：

- Click Go Previous Section

- 使用组合键 Alt 上方向键

这个选项只对 DocBook 文档有效。

#### 转到下一节

要转到下一节：

- Click Go Next Section

- 使用组合键Alt 下方向键

这个选项只对 DocBook 文档有效。

#### 转到目录

要转到文档的目录：

- Click Go Contents

这个选项只对 DocBook 文档有效。

#### 添加书签

为特定的文档添加书签：

- Click Bookmarks Add Bookmark

- Use the key combination Ctrl D

A window will appear that looks like .

##### Add Bookmark Window

Enter your desired bookmark title in to the Title text entry field. Then click Add to add the bookmark, or click Cancel to cancel the request.

#### 编辑书签

要编辑您收藏的书签：

- Click Bookmarks Edit Bookmarks...

- Use the key combination Ctrl B

A window will appear that looks like .

##### Edit Bookmarks Window

You can manage your bookmarks using this window in the following ways:

Open

  Use this button to open the selected bookmark in a new window.

Rename

  Use this button to rename the title of your bookmark.

Remove

  Use this button to delete the bookmark from your collection.

Once you are finished managing your bookmarks, click the Close button to exit the Edit Bookmarks Window.

#### 获得帮助

To get help to use Yelp Help Browser (and see this document):

- Click Help Contents

### 高级特性

#### 打开指定文档

##### 从文件管理器打开文档

要从文件管理器打开一个文档，比如一个 XML 文件，可以在 Caja 文件管理器中打开文件，或者把文件图标从 Caja 中拖拽到 Yelp 文件面板或启动器上。

##### 使用命令行打开文档

Yelp 帮助浏览器支持从命令行打开文件。有一些 URI (统一资源标识符)可供使用，包括：

`file:`

  使用这个 URI 以用 yelp 打开一个文档，比如：

      yelp file:///usr/share/help/C/mate-control-center/config-mouse.xml

`help:`

  但当您想打开典型的 DocBook 格式的 MATE 帮助文档时请使用这个 URI。

      yelp help:mate-terminal

  If you want to open the help document at a particular section, append a slash to the end of the URI, followed by the section id.

      yelp help:mate-user-guide/yelp-advanced-cmdline

`man:`

  Use this URI when you want to access a particular man page. You can append the section of the man page you would like to view if there are multiple man pages with the same name. The section number should be enclosed in parentheses and therefore it may be necessary to escape the argument so that the shell does not interpret the parenthesis.

      yelp man:mate-panel

  或

      yelp 'man:intro(1)'
      yelp 'man:intro(2)'

`info:`

  当您想访问特定的 GNU info 页时，使用此链接。

      yelp info:make

#### 实时刷新内容

Yelp 帮助浏览器 支持 Ctrl R 快捷键，用于重新载入当前已打开的 DocBook 文档。这使开发者能够查看他们对文档做出的修改。

### 更多信息

This section details some helper applications which Yelp Help Browser uses, and provides resources where you can get more information about Yelp Help Browser.

#### Scrollkeeper

Yelp 帮助浏览器 使用 scrollkeeper 生成 DocBook 和 HTML 文档的目录表，并使每个文档的翻译明了。

#### MATE 文档实用工具

MATE 的文档使用这套通用规则：

- Ease translation of documents to different languages.

- Provide a set of tools to help package and install documentation into the correct location and register the documentation with scrollkeeper.

- Perform conversion from DocBook format to a format suitable for display.

Yelp Help Browser relies on MATE XSLT Stylesheets to perform conversion from DocBook to HTML. MATE Documentation Build Utilities are relied upon by application authors to install and register documentation within the help system.

#### 主页与邮件列表

For further information on Yelp Help Browser, please visit the Documentation Project homepage, `http://mate-desktop.org`, or subscribe to the mailing list, `http://ml.mate-desktop.org/listinfo/mate-dev`.

### 加入 MATE 文档项目

If you are interested in helping produce and update documentation for the MATE project, please visit the Documentation Project homepage: `http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team`