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

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

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

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

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

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 Keyboard Shortcuts preference tool.

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

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

   ここで、もしコマンドが格納されているフォルダしか入力しなかった場合は、そのフォルダを開く妥当なアプリケーションが起動されます。もしウェブ・ページのアドレスを入力した場合は、デフォルトのウェブ・ブラウザでそのページを開きます。ウェブ・ページを入力する際は、http://www.gnome.org のように、先頭に http:// を付けてください。

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

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

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

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

Run Application dialog, using

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

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

- 【パネルから】

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

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

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

  デフォルトのショートカット・キー | 機能
  --- | ---
  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` | このコマンドのオプションの一覧を表示します。

スクリーンショットを取得すると、「スクリーンショットの保存」ダイアログが開きます。スクリーンショットを画像ファイルとして保存するには、そのファイル名を入力して保存先をドロップダウンリストから選択し「保存」ボタンをクリックしてください。「クリップボードにコピーする」ボタンを利用してクリップボードに画像をコピーすることやドラッグ・アンド・ドロップによって他のアプリケーションに転送することもできます。

screenshots, taking

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

Menubar

  File

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

  Edit

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

  Go

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

  Bookmarks

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

  Help

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

Toolbar

  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 を押下するか、あるいは

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

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

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

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

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.

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

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

- Click Help Contents

### いろいろな拡張機能

#### 指定したドキュメントを開く

##### ファイル・マネージャからドキュメントを開く

To open a document, such as an XML file, from the file manager, open the document in Caja File Manager, or drag the icon from Caja to the Yelp document pane or launcher.

##### コマンドラインからドキュメントを開く

Yelp ヘルプ・ブラウザはコマンドラインからドキュメントを指定して開くことができます。いろいろな URI (Uniform Resource Identifier) の種類をサポートしています。例えば:

`file:`

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

      yelp file:///usr/share/mate/help/gcalctool/C/gcalctool.xml

`help:` または `mate-help:`

  MATE のヘルプ・ドキュメント (基本的に DocBook 形式) を開く際は、この URI を指定してください。例えば:

      yelp help:gcalctool

  ヘルプ・ドキュメントの特定のセクションを直接開きたいのであれば、URI の最後に? (クエスチョン・マーク) を追加してから、セクションの ID を指定してください。例えば:

      yelp help:user-guide?yelp-advanced-cmdline

`man:`

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

      yelp man:gcalctool

  または

      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.

#### ホームページとメーリング・リスト

Yelp ヘルプ・ブラウザに関する他の情報をお探しの方は、是非、ドキュメンテーション・プロジェクトのホームページをご覧になってみてください。ホームページは http://live.gnome.org/Yelp です。または、mate-doc-devel-list@gnome.org というメーリング・リストを購読してみてください。

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

MATE プロジェクトのドキュメントを作成したり更新するお手伝いを希望する方は、ドキュメンテーション・プロジェクトのホームページである http://live.gnome.org/DocumentationProject をご覧になってみてください。

Yelp