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

この章では MATE デスクトップに含まれるツールやユーティリティの類について説明します。

## アプリケーションの実行

「アプリケーションの実行」ダイアログを使うとコマンドラインを直接起動できるようになります。但し、このダイアログからコマンドを実行すると、そのコマンドからの出力を受け取ることはできません。

コマンドラインからコマンドを実行する際の手順は次のとおりです:

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

   From a panel

2. You can add the Run Application button to any panel. See panels-addobject. 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 Keyboard Shortcuts preference tool.

「アプリケーションの実行」ダイアログが表示されます。

- 空白になっている部分に実行したいコマンドを入力するか、または既存のアプリケーション一覧からコマンドを選択してください。

  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 http://, as in http://www.mate-desktop.org.

  以前、実行したコマンドを選択する場合は、コマンドを入力する横に付いている下向きの矢印をクリックし、プルダウン式のリストの中から実行したいコマンドを選択してください。

  「ファイルを引数にして実行」ボタンを利用すると、コマンドラインの引数としてファイルを追加することができます。例えば、コマンドとして emacs を入力した後に、編集するファイルを選択することができます。

  「端末内で起動する」というオプションを有効にすると、端末のウィンドウを開き、その中で指定したアプリケーションまたはコマンドを実行します。このオプションは、ウィンドウを持たないアプリケーションやコマンドラインに対して使用してください。

- ダイアログの左下にある「実行」ボタンをクリックしてください。

## スクリーンショットの取得

次に示す手順のいずれかで、デスクトップのスクリーンショットを取得できます。

- 【パネルから】

  「スクリーンショットの取得」というボタンをパネルの中に追加できます。パネルにボタンを追加する手順については「panels-addobject」をご覧ください。パネルの中にある「スクリーンショットの取得」ボタンをクリックすると、画面全体のスクリーンショットを取得します。

- 【ショートカット・キーを使って】

  スクリーンショットを取得するショートカット・キーは次のとおりです:

  デフォルトのショートカット・キー | 機能
  Print Screen | デスクトップ全体のスクリーンショットを取得する
  Alt Print Screen | アクティブなウィンドウのスクリーンショットを取得する

  これらのデフォルトの設定は「キーボードのショートカット」を設定するツールから変更できます。

- 【メニューバーから】

  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 ヘルプ・ブラウザは国際化もサポートしているので、いろいろな言語でドキュメントを表示できます。翻訳されたドキュメントは、Yelp ヘルプ・ブラウザから参照できる場所にインストールしておいてください。

### Yelp の起動

#### Yelp ヘルプ・ブラウザを起動する

次に示す手順のいずれかで Yelp ヘルプ・ブラウザを起動できます:

【システム・メニューから】

- ヘルプを選択してください。

【コマンドラインから】

- 次のコマンドを実行してください: `yelp`

#### ユーザ・インタフェース

Yelp ヘルプ・ブラウザ を起動すると、次に示すようなウィンドウが開きます。

##### Yelp Help Browser Window

Yelp Help Browser contains the following elements in fig-yelp-window

Menubar

- File

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

Edit

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

Go

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

Bookmarks

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

Help

- 情報メニューから Yelp ヘルプ・ブラウザに関する情報やプロジェクトに貢献してくれた人達を表示できます。このドキュメントは目次メニューを選択するか、または F1 キーで表示できます。

Toolbar

- Back

- 閲覧したドキュメントの履歴をさかのぼって表示する際に、このボタンを利用してください。

Forward

- 閲覧したドキュメントの履歴を進ませて表示する際に、このボタンを利用してください。

Help Topics

- トップ・ページにある目次 (fig-yelp-window に示す内容) に戻る際に、このボタンを利用してください。

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 にドラッグしてください。詳細は「yelp-open-specific」をご覧ください。

#### 新しいウィンドウを開く

新しいウィンドウを開くには:

- 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-preferences:

##### 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

- yelp-browser-pane の中にキャレットまたはカーソルを表示したい場合は、このオプションを有効にしてください。キャレット・モードにしてドキュメントの中にあるカーソルを意識することで、さらにドキュメントが閲覧しやすくなります。

#### ドキュメントの履歴をさかのぼる

ドキュメントの閲覧履歴をさかのぼって表示するには:

- Click Go Back

- キーボードから Alt Left を押下するか、あるいは

- ツールバーにある戻るボタンをクリックしてください。

#### ドキュメントの履歴を進ませる

ドキュメントの閲覧履歴を進ませて表示するには:

- Click Go Forward

- キーボードから Alt Right を押下するか、あるいは

- ツールバーにある進むボタンをクリックしてください。

#### ヘルプのトピックへ移動する

ヘルプのトピックへ移動するには:

- Click Go Help Topics

- キーボードから Alt Home を押下するか、あるいは

- ツールバーにあるヘルプのトピックボタンをクリックしてください。

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

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

- 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 yelp-add-bookmark.

##### 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 yelp-edit-bookmarks.

##### 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.

#### ヘルプを取得する

Yelp ヘルプ・ブラウザ を使ってヘルプを取得する (このページを開く) には:

- 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:`

- 特定の man ページを開く際は、この URI を指定してください。同名の man ページが複数あるような場合は、セクション番号を指定することができます。その際は、セクション番号を括弧の中に入れて指定する必要がありますので、コマンドラインから入力する際はシェルに解釈されないように括弧をエスケープしてやる必要があるかもしれません。

      yelp man:mate-panel

  または

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

`info:`

- GNU の info ページを開く際に、この URI を指定してください。

      yelp info:make

#### オンデマンドで内容を更新する

Yelp ヘルプ・ブラウザでは Ctrl R のショートカット・キーをサポートしているので、現在開いている DocBook 形式のドキュメントを再読み込みし内容を更新できるようになっています。これにより開発者は自分が作成し変更したドキュメントを直ぐに更新し、内容を確認できます。

### その他の情報

この節では、Yelp ヘルプ・ブラウザが利用しているヘルパー・アプリケーションについてその詳細を説明し、Yelp ヘルプ・ブラウザに関するその他の情報を公開している場所を紹介します。

#### 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, , or subscribe to the mailing list, .

### MATE ドキュメンテーション・プロジェクトに参加する

If you are interesting in helping produce and update documentation for the MATE project, please visit the Documentation Project homepage: