# いろいろなツールとユーティリティ

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 ページ (これらのサポートは Yelp をコンパイルする際のオプションに依存します) があります。様々な書式をサポートしているにもかかわらず、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

    新しいウィンドウを開く時や「このドキュメントについて」のページを表示する時、あるいはドキュメントを印刷したり、ウィンドウを閉じる際に、このメニューを利用します。

  編集

    選択した文字列をコピーする時やドキュメントの内容をすべて選択する時、あるいはドキュメントの内容を検索したり、Yelp の設定を変更する際に、このメニューを利用します。

  Go

    前に閲覧したページに戻る時や進む時にこのメニューを利用してください。DocBook 形式のドキュメントを閲覧する際は、このメニューを使って次のセクションや前のセクションへ移動したり、目次へジャンプすることができます。

  Bookmarks

    現在閲覧しているページをブックマークに追加したり、既に登録したブックマークを編集する際に、このメニューを利用してください。

  ヘルプ

    情報メニューから 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 Right を押下するか、あるいは

- 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 Up を押下してください。

このオプションは DocBook 形式のドキュメントでしか利用できません。

#### 次のセクションへ移動する

次のセクションへ移動するには:

- Click Go Next Section

- キーボードから Alt Down を押下してください。

このオプションは 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 (Uniform Resource Identifier) の種類をサポートしています。例えば:

`file:`

  Yelp からファイルを開く際は、この URI を指定してください。例えば:

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

`help:`

  MATE のヘルプ・ドキュメント (基本的に DocBook 形式) を開く際は、この 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 ページを開く際に、この URI を指定してください。

      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`