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

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

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

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

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

1. 以下のいずれかの方法で、アプリケーションの実行ダイアログを開きます：

   【パネルから】

     「アプリケーションの実行...」というボタンをパネルの中に追加できます。パネルにボタンを追加する手順については「」をご覧ください。パネルの中にある「アプリケーションの実行...」ボタンをクリックすると、「アプリケーションの実行」ダイアログが開きます。

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

     Alt F2キーを押します。ツールのアプリケーションの実行ダイアログを表示するショートカットキーは、変更することが可能です。

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

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

   ファイルの場所だけを入力した場合、適切なアプリケーションが起動してファイルを開きます。Web ページのアドレスを入力すると、デフォルトの Web ブラウザがそのサイトを開きます。Web サイトのアドレスには、https://mate-desktop.org のように、https:// を前に付けてください。

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

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

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

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

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

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

- 【パネルから】

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

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

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

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

  このツールを使って、既定のショートカット・キーを変更することができます。

- 【メニューバーから】

  アプリケーションアクセサリ スクリーンショットの取得を選択します。

- 【端末から】

  `mate-screenshot` というコマンドを直接使ってスクリーンショットを取得することもできます。`mate-screenshot` コマンドは画面全体のスクリーンショットを撮った後に、「スクリーンショットの保存」ダイアログを開きます。取得したスクリーンショットを保存する際は、このダイアログを利用してください。

  次に示すオプションを `mate-screenshot` コマンドに指定できます:

  オプション | 機能
  --- | ---
  `--ウィンドウ` | フォーカスを持つウィンドウのスクリーンショットを取得します。
  `--遅延=秒` | 指定した時間 (秒) が経過したらスクリーンショットを取得し、「スクリーンショットの保存」ダイアログを開きます。
  `--境界線を含める` | ウィンドウの境界線を含んだスクリーンショットを取得します。
  `--境界線なし` | ウィンドウの境界線なしでスクリーンショットを取得します。
  `--border-effect=shadow` | スクリーンショットを取得し、その周囲に傾斜した影を追加します。
  `--border-effect=border` | スクリーンショットを取得し、その周囲に境界線を追加します。
  `--interactive` | スクリーンショットを取得する前にオプションを設定するためのウィンドウを開きます。
  `--ヘルプ` | このコマンドのオプションの一覧を表示します。

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

## Yelp ヘルプ・ブラウザ

### はじめに

「Yelp ヘルプ・ブラウザ」を使えば、いろいろな書式で記述されている MATE やその他のコンポーネントの文書を閲覧できるようになります。それらの書式には docbook 形式や HTML 形式のヘルプ、man ページや info ページ (これらのサポートは Yelp をコンパイルする際のオプションに依存します) があります。様々な書式をサポートしているにもかかわらず、Yelp は可能な限り統一したスタイルで表示するようになっています。

Yelp ヘルプ・ブラウザは国際化もサポートしているので、いろいろな言語で文書を表示できます。Yelp ヘルプ・ブラウザで文書を閲覧するためには、各言語にローカライズまたは翻訳され、適切にインストールされている必要があります。

### Yelp の起動

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

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

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

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

【コマンドラインから】

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

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

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

##### Yelp ヘルプ・ブラウザのウィンドウ

Yelp ヘルプ・ブラウザは、以下のエレメントをに含んでいます

メニューバー

  ファイル

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

  編集

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

  移動

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

  ブックマーク

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

  ヘルプ

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

ツールバー

  戻る

    閲覧した文書の履歴を表示するとき、このボタンを利用してください。

  進む

    閲覧した文書の履歴を進ませて表示する際に、このボタンを利用してください。

  ヘルプの目次

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

閲覧ペイン

  閲覧ペインは、目次や文書の内容を表示する場所です。必要な文書を探したいとき利用してください。

### Yelp の使い方

#### 文書を開く

Yelp ヘルプ・ブラウザを開くには：

- アプリケーションで、ヘルプ 目次をクリックします。

- 希望する文書に移動するには、目次を利用してください。

- Docbook XML ファイルを Caja から Yelpのウィンドウかランチャにドラッグできます。

- F1 キーを押下してください。

あるいは、特定の文書を表示するのであれば、コマンドラインから Yelp ヘルプ・ブラウザを起動するか、またはファイルを Yelp にドラッグしてください。詳細は「」をご覧ください。

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

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

- ファイル 新規ウィンドウ をクリックします

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

#### この文書について

現在開いている文書に関する情報を表示するには:

- ファイル この文書について をクリックします

このオプションは DocBook 形式の文書でしか利用できません。通常、商標と文書作成に貢献した人達のクレジットは、この項目に記述されています。

#### ページを印刷する

Yelp ヘルプ・ブラウザに表示しているページを印刷するには:

- ファイル このページを印刷 をクリックします

#### 文書を印刷する

文書全体を印刷するには:

- ファイル この文書を印刷 をクリックします

このオプションは DocBook 形式の文書でしか利用できません。

#### ウィンドウを閉じる

Yelp ヘルプ・ブラウザを閉じるには:

- ファイル ウィンドウを閉じる をクリックします

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

#### 設定を変更する

Yelp ヘルプ・ブラウザの設定を変更するには:

- 編集 設定 をクリックします

のような画面が現れます:

##### Yelp ヘルプ・ブラウザの設定ダイアログ

このダイアログで使用できるオプションには、以下の機能があります：

システムのフォントを使う

  このオプションを有効にすると、MATE デスクトップで利用する既定のフォントを使って文書を表示します。

  別のフォントを使って文書を表示するときは、このオプションのチェックを外してを無効にし、可変幅か等幅というラベルの横にあるボタンをクリックしてください。

  可変幅

    これは、固定または等幅のフォントを要求されない時に使用するフォントです。ほとんどの文字列がこの種類に相当します。

  固定幅

    これは、文字をすべて同じ大きさにする必要がある時に使用するフォントです。通常、このフォントはコマンドを表す文字列とか、プログラムのコード、あるいはこれらの類に該当するその他の文字列を表示する際に使用します。

キャレットで閲覧

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

#### 文書の履歴をさかのぼる

文書の閲覧履歴をさかのぼって表示するには:

- 移動 戻る をクリックします

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

- ツールバーの戻るボタンを使います

#### 文書の履歴を進める

文書の閲覧履歴を進めて表示するには:

- 移動 進む をクリックします

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

- ツールバーの進むボタンを使います

#### ヘルプの見出しへ移動する

ヘルプの見出しへ移動するには:

- 移動 ヘルプの見出し をクリックします

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

- ツールバーのヘルプの見出しボタンを使います

#### 前の項目へ移動する

前の項目へ移動するには:

- 移動 前の項目 をクリックします

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

このオプションは DocBook 形式の文書でしか利用できません。

#### 次の項目へ移動する

次の項目へ移動するには:

- 移動 次の項目 をクリックします

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

このオプションは DocBook 形式の文書でしか利用できません。

#### 目次へ移動する

文書の目次へ移動するには:

- 移動 目次 をクリックします

このオプションは DocBook 形式の文書でしか利用できません。

#### ブックマークを追加する

特定の文書をブックマークとして追加するには:

- ブックマーク ブックマークへ追加 をクリックします

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

のような画面が現れます。

##### ブックマークを追加するダイアログ

タイトル入力欄に、希望するブックマークのタイトルを入力します。追加をクリックするとブックマークが追加され、キャンセルをクリックすると操作が取り消されます。

#### ブックマークの編集

ブックマークを編集するには:

- ブックマーク ブックマークの編集... をクリックします

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

のような画面が現れます。

##### ブックマークの編集ダイアログ

この画面を使って、以下の方法でブックマークを管理できます。

開く

  新しいウィンドウの中に、選択したブックマークを表示するときは、このボタンをクリックしてください。

名前の変更

  ブックマークの題名を変更する際は、このボタンをクリックしてください。

削除

  選択したブックマークを削除する際は、このボタンをクリックしてください。

ブックマークの管理が終わったら、閉じるボタンをクリックしてブックマークの編集ダイアログ、を終了します。

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

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

- ヘルプ 目次 をクリックします

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

#### 指定した文書を開く

##### ファイル・マネージャから文書を開く

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

  特定のセクションでヘルプ文書を開きたい場合は、URI の最後に / を付け、その後にセクション ID を付けます。

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

`man:`

  特定の man ページにアクセスしたいときにこの URI を使います。同じ名前の man ページが複数ある場合は、閲覧したい 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 から配布されている文書は、次に示す目的のためにこのユーティリティを利用しています:

- 文書を他の言語に手軽に翻訳できる仕組みを提供するため

- 文書をパッケージ化したり、システムの妥当な場所にインストールし Scrollkeeper を使って全文書の目録に登録するのを支援するため

- DocBook 形式から表示に適した形式に変換するため

Yelp ヘルプ・ブラウザは、DocBook から HTML への変換に MATE XSLT スタイルシートを使用しています。MATE 文書ビルドユーティリティは、アプリケーションの作成者がヘルプシステムに文書をインストールして登録する際に使用します。

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

Yelp ヘルプブラウザの詳細については、文書化プロジェクトのホームページ `http://mate-desktop.org` をご覧いただくか、メーリングリスト `http://ml.mate-desktop.org/listinfo/mate-dev` をご購読ください。

### MATE 文書化プロジェクトに参加する

MATE プロジェクトの文書作成や更新に興味がある方は、文書化プロジェクトのホームページをご覧ください。`http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team`