# pluma マニュアル

2007 MATE Documentation Project
2002 2003 2004 Sun Microsystems
2000 Eric Baudais
MATE ドキュメンテーション プロジェクト
Joachim Noreiko
MATE Documentation Project
MATE
Hal Canary Added the Shortcut Keys Table
Sun Java Desktop System Documentation Team
Sun Microsystems

    gdocteam@sun.com

Eric Baudais
MATE Documentation Project

     baudais@okstate.edu

Baris Cicek provided information from earlier revisions of the pluma application. Acknowledgements
Ajit George provided information about plugins. Acknowledgements
pluma V1.0
2000

Eric Baudais baudais@okstate.edu

MATE Documentation Project

pluma Manual V2.0
March 2002

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.1
June 2002

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.2
August 2002

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.3
September 2002

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.4
January 2003

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.5
March 2003

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.6
September 2003

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.7
March 2004

Sun GNOME Documentation Team

MATE Documentation Project

pluma Manual V2.8
July 2006

Sun Java Desktop System Documentation Team

MATE Documentation Project

pluma Manual V2.9
July 2006

MATE Documentation Team

MATE Documentation Project

このマニュアルは pluma のバージョン 2.16 について説明します。

フィードバック

To report a bug or make a suggestion regarding the pluma application or this manual, follow the directions in the MATE Feedback Page.

pluma は印刷やスペル・チェック、検索、強調表示といった基本的な機能を兼ね備えた、 MATE デスクトップのテキスト・エディタです。さらに、プラグインを導入することでより強力な機能を利用することもできます。

## 概要

pluma はテキストファイルを作成・編集するためのアプリケーションです。

pluma はより単純に、より簡単に使えるように作られています。テキスト編集に関する複雑な作業については、強力なプラグインを導入することで、補うことができます。

## 基本的な使用方法

### pluma を起動する

以下の方法で pluma を起動してください。

アプリケーションメニュー

  アクセサリテキスト・エディタを選択します。

コマンドライン

  次のコマンドを実行します： `pluma`

初期設定のままファイル・マネージャからテキストドキュメントを開いた場合、pluma が起動し、テキストの内容を表示するでしょう。

### pluma ウィンドウ

pluma を起動すると、次のウィンドウが表示されます。

pluma ウィンドウ

Shows pluma main window.

pluma ウィンドウの構成要素は次のとおりです。

メニューバー

  メニューバー上のメニューには、pluma でファイルを操作するために必要なコマンドがすべて含まれています。

ツールバー

  ツールバーには、メニューバーからアクセスできるコマンドの一部の機能が含まれています。

表示領域

  表示領域には、編集中のファイルのテキストが表示されます。

ステータスバー

  ステータスバーには、pluma で実行中の操作に関する情報や、選択中のメニュー項目に関する説明が表示されます。また、以下の情報も表示されます。

  - カーソルの位置：現在カーソルがある、行番号および列番号を表示します。

  - 編集モード：エディタが挿入モードになっている場合は、ステータスバーに挿入と表示されます。上書きモードになっている場合は、ステータスバーに上書きと表示されます。編集モードを切り替えるには、Insertキーを押してください。

サイド・ペイン

  サイド・ペインには現在開いているドキュメントや、プラグインによるさまざまな情報が表示されます。

  初期設定ではサイド・ペインは表示されていません。これを表示するためには、表示サイド・ペインを選択してください。

ボトム・ペイン

  ボトム・ペインは Python コンソールプラグインのようなプログラミングツールの出力を表示するために使われます。

  初期設定ではボトム・ペインは表示されていません。これを表示するためには、表示ボトム・ペインを選択してください。

pluma ウィンドウ内で右クリックすると、ポップアップメニューが表示されます。 ポップアップメニューからは、使用頻度の高いテキスト編集コマンドを実行できます。

他の MATE アプリケーションと同様に、 pluma のコマンドは、メニューやツールバー、ショートカットキーなどさまざまな方法で実行できます。すべてのアプリケーションで共通なショートカットキーの一覧は、ユーザーガイドに掲載されています。

### コマンドラインから pluma を起動する

コマンドラインから pluma を起動し、単一のファイル、または複数のファイルを開くことができます。コマンドラインから複数のファイルを開くには、次のコマンドを入力して Enter キーを押してください。

`pluma file1.txt file2.txt file3.txt`

ファイル名の代わりに、URI を指定することもできます。

コマンドラインから pluma を実行する方法については、pluma 1 を参照してください。

## ファイルの操作

### 新しいファイルを作成する

新しいファイルを作成するには、ファイル新規を選択します。 pluma ウィンドウに新規の何も書かれていないファイルが表示されます。

### ファイルを開く

ファイルを開くには、ファイル開くを選択してファイルを開くダイアログを表示させます。開きたいファイルを選択して、開くをクリックします。選択したファイルが pluma ウィンドウに表示されます。

The application records the paths and filenames of the five most recent files that you edited and displays the files as menu items on the File menu. You can also click on the

Shows Recent Files menu icon.
icon on the toolbar to display the list of recent files.

pluma では複数のファイルを開くこともできます。その場合、一つのウィンドウ内に複数のタブにわかれて、それぞれのファイルが表示されます。より詳しいことは、を参照してください。

### ファイルを保存する

ファイルの保存方法は次のとおりです。

- 既存のファイルに対する変更点を、同じファイルに保存するには、ファイル保存を選択してください。

- To save a new file or to save an existing file under a new filename, choose File Save As . Enter a name for the file in the Save As dialog, then click Save.

- To save all of the files that are currently open in pluma, choose Documents Save All .

To close all of the files that are currently open in pluma, choose Documents Close All .

### URI からファイルを開く

URI (Uniform Resource Identifier) からファイルを開くには、以下の操作を行います。

1. Choose File Open Location to display the Open Location dialog.

2. 開きたいファイルの URI を入力します。

3. 文字のエンコーディングから、開きたいファイルの文字コードを選択します。

4. 開くをクリックします。

有効な URI は `http:`、 `ftp:`、 `file:`、および `mate-vfs` でサポートしている全ての形式です。

URI の形式によっては、ファイルを読み込み専用として開きます。その場合、変更点を保存する際には、別の場所を指定してください。例えば HTTP はファイルの読み込みのみ可能です。全ての FTP サーバがリモートファイルの保存をサポートしているわけではないので、FTP からファイルを開いた場合も、読み込み専用となります。

設定エディタを利用すればFTP サーバへの保存も利用可能になります。/apps/pluma/preferences/editor/save/writable_vfs_schemes キーを変更してください。ただしこれはエラーの原因にもなります。

### タブを利用する

複数のファイルを開いた場合、pluma は表示領域の上にドキュメントごとのタブを表示します。別のドキュメントを表示するには、このタブをクリックしてください。

あるドキュメントを別の pluma ウィンドウに移動したい場合は、そのドキュメントが表示されているタブを、移動したいウィンドウまでドラッグしてください。

To move a document to a new pluma window, either drag its tab to the desktop, or choose Documents Move to New Window .

## テキストの操作

### テキストを編集する

ファイルのテキストを編集する方法は次のとおりです。

- キーボードから新しいテキストを入力します。点滅している入力カーソルは、新しいテキストが書き込まれる場所を示しています。場所を変更するには、キーボード上の矢印キーで移動するか、マウスを使って入力したい場所をクリックしてください。

- To copy the selected text to the clipboard, choose Edit Copy .

- To delete the selected text from the file and move the selected text to the clipboard, choose Edit Cut .

- To permanently delete the selected text from the file, choose Edit Delete .

- To insert the contents of the clipboard at the cursor position, choose Edit Paste . You must cut or copy text before you can paste text into the file, either from pluma or another application.

- To select all of the text in a file, choose Edit Select All .

### 元に戻すもしくはやり直す

To undo a change you have made, choose Edit Undo . To reverse this action, choose Edit Redo .

## 文字列の検索・置換

pluma には文字列を検索するための二つの方法が存在します。特定の文字列を検索したい場合は検索ダイアログを、入力にあわせて即座に検索したい場合はインクリメンタル検索を利用できます。

### 文字列を検索する

ファイル内の特定の文字列を検索するには、次のようにします。

1. Choose Search Find to display the Find dialog.

2. 検索する文字列フィールドに、検索したい文字列を入力します。改行やタブなど特別な文字も入力できます。詳しいことはを参照してください。

3. 検索をクリックすると、現在のカーソルの位置より後ろにある、入力した文字列と一致する最初の文字列が検索されます。pluma が文字列を発見した場合、最初の文字列を選択状態にします。他の場所で一致した文字列については強調表示されます。

4. To find the next occurrence of the string, click Find or choose Search Find Next . To find the previous occurrence of the text, choose Search Find Previous .

After you have closed the Find dialog, you can still move the selection to other occurrences of the text by choosing Search Find Next and Search Find Previous .

To remove the highlighting from the text, choose Search Clear Highlight .

### インクリメンタル検索

インクリメンタル検索は、キーボードからの文字の入力にあわせてリアルタイムに検索する機能です（いくつかのウェブブラウザに搭載されている検索機能に似ています）。

To start an incremental search, choose Search Incremental Search . The search box appears at the top of the display area.

次に検索したい文字列を入力してください。入力した文字列にあわせて、ドキュメント上で一致した文字列が強調表示され、カーソルの場所から一番最初に一致された文字列が選択状態になります。

インクリメンタル検索ボックスを開いたまま、次の一致文字列に移動したい場合は、Ctrl Gを押してください。Ctrl Shift Gを押すと、一つ前の一致文字列に移動します。

矢印キーやマウスホイールを使っても、一致文字列間を移動できます。

### 文字列を置換する

ファイル内の特定の文字列を検索し、別の文字列に置換するには、次のようにします。

1. Choose Search Replace to display the Replace dialog.

2. 検索する文字列フィールドに、検索したい文字列を入力します。改行やタブなど特別な文字も入力できます。詳しいことはを参照してください。

3. 置換後の文字列フィールドに、検索した文字列の代わりに表示したい文字列を入力します。

一致した文字列ごとに置換するかどうかを確認したい場合は、検索をクリックしてください。pluma が文字列を発見した場合、その文字列が選択状態になります。置換をクリックすれば、選択した文字列が置換されます。次の一致文字列に移動するには、再び検索をクリックしてください。

ドキュメントにある全ての一致文字列を置換するには、全て置換をクリックしてください。

### 検索・置換オプション

検索ダイアログと置換ダイアログでは、以下のオプションを指定できます。

- 大/小文字を区別するオプションを選択すると、入力したアルファベット文字列の大小が一致した文字列のみを表示します。例えば大/小文字を区別するが選択されている状態では、"TEXT" を検索しても "text" に一致しません。

- 単語全体にマッチさせるオプションを選択すると、単語の一部のみ一致した文字列は無視します。例えば単語全体にマッチさせるが選択されている状態では、"text" を検索しても "texture" に一致しません。

- 前方へ検索するオプションを選択すると、現在のカーソル一に対してドキュメントの前の方へ検索を行います。

- 折り返しも対象にするオプションを選択すると、ファイルの最後まで検索を行った後、再びファイルの最初から検索を行います。

### 特殊文字

エスケープ文字を使うことで、検索・置換の際に以下のような特殊文字を使うことができます。

`\n`

  改行を意味します。

`\t`

  タブ文字を意味します。

`\r`

  復帰 (CR: Carriage Return) を意味します。

`\\`

  バックスラッシュ文字を検索したい場合は、それ自身をエスケープする必要があります。たとえば "`\n`" という文字列を検索したい場合は、検索する文字列フィールドに "\\n" と入力してください。もしバックスラッシュからなる文字列を検索したい場合は、倍の数のバックスラッシュを入力する必要があります。

### カーソルを指定行へ移動する

To position the cursor on a specific line in the current file, choose Search Go to Line . The line number box appears at the top of the display area.

移動したい行番号の入力を開始すると、その数字に合わせてドキュメントが自動的にスクロールします。

ボックスを消してカーソルの移動を確定したい場合は、Enterキーを押してください。

## 印刷

### ページオプションを設定する

To set the page options, choose File Page Setup to display the Page Setup dialog.

ページの設定ダイアログでは、以下のオプションを指定できます。

#### 全般タブ

Print syntax highlighting

  このオプションを選択した場合、構文の強調表示も印刷に反映されます。構文の強調表示機能については、を参照してください。

Print page headers

  このオプションを選択した場合、ページごとにヘッダが印刷されます。ヘッダの内容を設定することはできません。

Line Numbers

  行番号を印刷するオプションを選択した場合、ファイルの行番号も併せて印刷されます。

  行番号を付与する間隔では、行番号の印刷頻度、例えば 5 行ごとや 10 行ごとなどを指定できます。

Text Wrapping

  テキストの折り返しを有効にするオプションを選択した場合、印刷する際に、必要に応じて文字単位で文字列の改行を行います。行番号を印刷する場合は、改行の前後を含めて 1 行として扱います。

  単語を二行以上に分割しないオプションを選択すると、印刷時に単語単位で折り返しを行います。

#### フォント

Body

  このボタンをクリックして、ドキュメント本文の印刷に使用するフォントを選択します。

Line numbers

  このボタンをクリックして、行番号の印刷に使用するフォントを選択します。

Headers and footers

  このボタンをクリックして、ファイルのヘッダとフッタの印刷に使用するフォントを選択します。

pluma からファイルを印刷するときに使用するフォントを初期設定に戻したい場合は、デフォルトに戻すをクリックしてください。

### ドキュメントを印刷する

pluma を使って、次の印刷操作を実行できます。

- ドキュメントをプリンタで印刷する。

- 印刷コマンドの実行結果をファイルに出力する。

ファイルに出力する場合、pluma は印刷用のフォーマットをファイルに送信します。最も一般的なフォーマットは、PostScript と PDF (Portable Document Format) です。

To preview the pages that you want to print, choose File Print Preview .

To print the current file to a printer or a file, choose File Print to display the Print dialog.

印刷ダイアログでは、次の印刷オプションを指定できます。

#### ジョブタブ

Print range

  次のいずれかのオプションを選択して、出力するページ数を指定します。

  - All

    ファイルの全ページを出力します。

  - Lines

    指定した行のみを出力します。From と To にて、出力する行範囲を指定します。

  - Selection

    選択したテキストだけを出力します。 このオプションは、テキストを選択している場合にのみ有効です。

Copies

  コピーの数を使って、出力部数を指定します。

  ファイルを複数の部数出力する場合に、ページを揃えるオプションを選択すると、各部ごとにページ順に並んだ結果が出力されます。

#### プリンタタブ

Printer

  ドロップダウンリストからファイルを出力するプリンタを選択します。

Settings

  ドロップダウンリストからプリンタの設定を選択します。

  プリンタの設定を行うには、設定するをクリックしてください。プリンタがその機能をサポートしていれば、両面印刷、印刷スケジュールなどを設定できます。

Location

  ドロップダウンリストから印刷データの送り先を選択します。

  CUPS

    CUPSプリンタに出力します。

    選択したプリンタがCUPSプリンタの場合、このドロップダウンリストにはCUPSのみが表示されます。

  lpr

    プリンタに出力します。

  File

    PostScript ファイルに出力します。

    別名で保存をクリックし、表示されるダイアログに PostScript ファイルの名前と場所を指定します。

  Custom

    印刷コマンドを直接記述します。

    テキストボックスに、引数も含めたコマンドを入力してください。

State

  現在のバージョンではサポートされていません。

Type

  現在のバージョンではサポートされていません。

Comment

  現在のバージョンではサポートされていません。

#### 用紙タブ

Paper size

  ドロップダウンリストから印刷用紙のサイズを選択します。

Width

  用紙の幅を指定します。用紙サイズの単位を変更するには、隣のドロップダウンリストを使用します。

Height

  用紙の高さを指定します。

Feed orientation

  ドロップダウンリストからプリンタ内の用紙の向きを選択します。

Page orientation

  ドロップダウンリストからページの向きを選択します。

Layout

  ドロップダウンリストからページレイアウトを選択します。プレビュー領域には、選択した各レイアウトのプレビューが表示されます。

Paper tray

  ドロップダウンリストから用紙のトレイを選択します。

## プログラミング機能

pluma プラグインによって、さまざまなプログラミング向け機能が提供されています。例えば、タグの一覧プラグインを使えば、マークアップ言語ごとに、よく使われるタグの一覧を表示してくれます。詳しいことは、を参照してください。

### 構文の強調表示

構文の強調表示を使うと、ソースコードがその構文にしたがって色分けされ、より読みやすくなります。

pluma chooses an appropriate syntax highlighting mode based on a document's type. To override the syntax highlighting mode, choose View Highlight Mode , then choose one of the following menu items:

Normal

  強調表示を行いません。

Sources

  ソースコード向け強調表示を行います。ソースサブメニューから、ソースコードの種類を選択してください。

Markup

  マークアップ言語向け強調表示を行います。マークアップサブメニューから、マークアップ言語の種類を選択してください。

Scripts

  スクリプト言語向け強調表示を行います。スクリプトサブメニューから、スクリプト言語の種類を選択してください。

Others

  その他のファイル向け強調表示を行います。その他サブメニューから、ファイルの種類を選択してください。

### コマンドの出力をファイルにパイプする

pluma を使って、コマンド出力をテキストファイルに直接渡す（パイプする）ことができます。 例えば、`ls` コマンドの出力をテキストファイルに渡すには、`ls | pluma` と入力して、Enter キーを押します。

`ls` コマンドの結果が新しいテキストファイルに出力され、pluma ウィンドウに表示されます。

別の方法として、外部ツールプラグインを使えば、コマンドの出力結果を現在開いているファイルに渡すことができます。

## ショートカットキー

ショートカットキーを使えば、よく使う作業をマウスやメニューを使うよりも素早く実行できます。以下の表は、pluma で利用できるすべてのショートカットキーの一覧です。

ショートカットキーについての詳しいことは、デスクトップユーザーガイドを参照してください。

#### タブ

タブ用のショートカット

ショートカットキー | コマンド
--- | ---
Ctrl + Alt + PageUp | 左のタブに移動します。
Ctrl + Alt + PageDown | 右のタブに移動します。
Ctrl + W | タブを閉じます。
Ctrl + Shift + L | 全てのタブを保存します。
Ctrl + Shift + W | 全てのタブを閉じます。
Alt + n | n 番目のタブに移動します。

#### ファイル

ファイル用のショートカット

ショートカットキー | コマンド
--- | ---
Ctrl + N | 新しいドキュメントを作成します。
Ctrl + O | ドキュメントを開きます。
Ctrl + L | 指定した場所にあるファイルを開きます。
Ctrl + S | 現在のドキュメントをファイルに保存します。
Ctrl + Shift + S | 現在のドキュメントを新しいファイル名で保存します。
Ctrl + P | 現在のドキュメントを印刷します。
Ctrl + Shift + P | 印刷プレビューを表示します。
Ctrl + W | 現在のドキュメントを閉じます。
Ctrl + Q | pluma を終了します。

#### 編集

編集用のショートカット

ショートカットキー | コマンド
--- | ---
Ctrl + Z | 最後に行った作業を元に戻します。
Ctrl + Shift + Z | 最後に元に戻した作業をやり直します。
Ctrl + X | 選択したテキストもしくは領域を切り取り、クリップボードに移動します。
Ctrl + C | 選択したテキストもしくは領域をクリップボードにコピーします。
Ctrl + V | クリップボードの内容を貼り付けます。
Ctrl + A | 全てを選択状態にします。
Ctrl + D | 現在カーソルがある行を削除します。
Alt + Up | Move the selected line up one line.
Alt + Down | Move the selected line down one line.

#### ペイン

ペイン用のショートカット

ショートカットキー | コマンド
--- | ---
F9 | サイド・ペインの表示/非表示を切り替えます。
Ctrl + F9 | ボトム・ペインの表示/非表示を切り替えます。

#### 検索

検索用のショートカット

ショートカットキー | コマンド
--- | ---
Ctrl + F | 文字列を検索します。
Ctrl + G | 次の一致文字列に移動します。
Ctrl + Shift + G | 前の一致文字列に移動します。
Ctrl + K | インクリメンタル検索を行います。
Ctrl + H | 文字列を検索し置換します。
Ctrl + Shift + K | 一致した文字列の強調表示を解除します。
Ctrl + I | 指定した行番号へ移動します。

#### ツール

ツール用のショートカット

ショートカットキー | コマンド
--- | ---
Shift + F7 | スペル・チェックを行います（プラグインを使用します）。
Alt + F12 | 文字列の終端にある空白を削除します（プラグインを使用します）。
Ctrl + T | 指定した行をインデントします（プラグインを使用します）。
Ctrl + Shift + T | 指定した行のインデントを削除します（プラグインを使用します）。
F8 | 現在のディレクトリで "make" を実行します（プラグインを使用します）。
Ctrl + Shift + D | ディレクトリを表示します（プラグインを使用します）。

#### ヘルプ

ヘルプ用のショートカット

ショートカットキー | コマンド
--- | ---
F1 | pluma のマニュアルを開きます。

## 設定

To configure pluma, choose Edit Preferences . The Preferences dialog contains the following categories:

### 表示

Text Wrapping

  テキストの折り返しを有効にするオプションを選択した場合、長い文字列がテキストウィンドウの端まで来たときに、文字単位で次の行に折り返します。これにより、水平方向のスクロールを避けることができます。

  単語を二行以上に分割しないオプションを選択した場合、一つの単語が二行以上にまたがらないように折り返しが行われます。これにより、テキストが読みやすくなります。

Line Numbers

  行番号を表示するオプションを選択した場合、pluma ウィンドウの左側に、行番号を表示します。

Current Line

  カーソルのある行を強調表示するオプションを選択した場合、カーソルのある行の背景色が変わります。

Right Margin

  右マージンを表示するオプションを選択した場合、右マージンの位置が垂直線で表示されます。

  右マージンを表す列番号を使って、垂直線の表示位置を指定できます。

Bracket Matching

  対応するカッコを強調表示するオプションを選択した場合、カーソルの位置にカッコ文字が存在した場合、それに対応するカッコが強調表示されます。

### エディタ

Tabs

  タブの幅を使って、Tab キーを押したときにpluma が挿入する空白の幅を指定することができます。

  タブの代わりにスペースを挿入するオプションを選択した場合、Tab キーを押したときにpluma はタブ文字ではなく、適切な数の半角空白文字を挿入します。

Auto Indentation

  自動インデントを有効にするオプションを選択した場合、改行すると元の行のインデントと同じ位置までインデントを行います。

File Saving

  保存する前にバックアップを生成するオプションを選択した場合、ファイルを保存するたびに、バックアップ用のコピーも生成します。バックアップ用のコピーファイルは、ファイル名の末尾に ~ が付きます。

  ファイルを自動的に保存する間隔 ... 分ごとオプションを使えば、現在のファイルを定期的に保存できます。ファイルを保存したい時間間隔を指定してください。

### フォントと色

Font

  システムの固定幅フォントを使うオプションを選択した場合、pluma テキストウィンドウの文字列には、システムの標準フォントが使われます。

  エディタのフォントフィールドには、pluma が使う表示フォントの種類が表示されます。ボタンをクリックすれば、使用したいフォントの種類やスタイル、サイズを指定できます。

Color Scheme

  You can choose a color scheme from the list of color schemes. By default, the following color schemes are installed:

  Classic

    Classic color scheme based on the gvim color scheme.

  Cobalt

    Blue based color scheme.

  Kate

    Color scheme used in the Kate text editor.

  Oblivion

    Dark color scheme using the Tango color palette.

  Tango

    Color scheme using the Tango color scheme.

  You can add a new color scheme by clicking on Add..., and selecting a color scheme file

  You can remove the selected color scheme by clicking on Remove

### プラグイン

プラグインを使えば、より多彩な機能を pluma に追加できます。プラグインについての詳しい情報と、内蔵のプラグインについては、を参照してください。

#### プラグインを有効化する

pluma プラグインを有効化するには、以下の操作を実行してください。

1. Choose Edit Preferences .

2. プラグインタブを選択します。

3. 利用したいプラグインの名前の横にあるチェックボックスを選択します。

4. 閉じるをクリックして、設定ダイアログを閉じます。

#### プラグインを無効化する

pluma を終了しても、プラグインは有効化されたままです。

pluma プラグインを無効化するには、以下の操作を実行してください。

1. Choose Edit Preferences .

2. プラグインタブを選択します。

3. 無効化したいプラグインの名前の横にあるチェックボックスを非選択状態にします。

4. 閉じるをクリックして、設定ダイアログを閉じます。

## プラグイン

### プラグインを使用する

プラグインとはアプリケーションの機能を強化する補完プログラムであり、プラグインを導入することで、pluma に多様な機能を追加することができます。例えば、pluma メニューに新しい項目や新機能が追加されます。

いくつかのプラグインが pluma に内蔵されています。また、追加でインストールすることも可能です。サードパーティのプラグインについては、pluma のウェブサイトに一覧が存在します。

プラグインを有効化・無効化する方法や、どのプラグインが有効化されているかを確認する方法については、プラグイン設定の項目を参照してください。

以下のプラグインは pluma に内蔵されています。

- 大/小文字の変更は、選択したテキストの大/小文字を変更します。

- ドキュメントの統計は、ドキュメントの行数や単語数、文字数を表示します。

- 外部ツールは pluma から外部コマンドを実行します。

- ファイル参照ペインはサイド・ペインから、ファイルやフォルダの閲覧が可能になります。

- 行のインデントは指定した行にインデントを追加・削除します。

- 日付/時刻の挿入はドキュメントに現在の日付や時刻を追加します。

- モードラインは、個々のドキュメントごとに設定を保存したり、Emacs、Kate、Vim 風のモードラインをサポートします。

- Python コンソールは、プログラミング言語である Python のコマンドを実行します。

- コード・スニペットは、よく使われる文字列を保存し、手軽にドキュメントに挿入できます。

- 並び替えは、選択した行を並び替えることができます。

- スペル・チェッカは、選択したテキストのスペルを修正したり、ドキュメント内の誤字を自動的に発見します。

- タグの一覧は、HTML やその他の言語で一般的に使われるタグをサイド・ペインから簡単に挿入することができます。

For more information on creating plugins, see the pluma website.

### 大/小文字の変更プラグイン

大/小文字の変更プラグインは選択した文字列の、大文字・小文字を切り替えます。

大/小文字の変更プラグインを有効にすると、以下の項目が編集メニューに追加されます。

項目 | 動作 | 例
--- | --- | ---
Edit Change Case All Upper Case | 選択中の文字を全て大文字に変更します。 | `This text` → `THIS TEXT`
Edit Change Case All Lower Case | 選択中の文字を全て小文字に変更します。 | `This Text` → `this text`
Edit Change Case Invert Case | 選択中の全ての小文字を大文字に変更し、逆に選択中の全ての大文字を小文字に変更します。 | `This Text` → `tHIS tEXT`
Edit Change Case Title Case | 各単語の最初の文字を大文字に変更します。 | `this text` → `This Text`

### ドキュメントの統計プラグイン

ドキュメントの統計プラグインは、現在のファイルに対して、行数、空白込みの文字数、空白なしの文字数、バイト数を計算します。その計算結果はドキュメントの統計ダイアログに表示されます。ドキュメントの統計プラグインを利用するには、以下の手順を実行します。

1. Choose Tools Document Statistics to display the Document Statistics dialog. The Document Statistics dialog displays the following information about the file:

   - 現在のドキュメントの行数

   - 現在のドキュメントの単語数

   - 現在の文書の文字数（空白を含む）

   - 現在の文書の文字数（空白を除く）

   - 現在の文書のバイト数

2. ドキュメントの統計ダイアログを開いたまま、pluma 中のファイルを編集し続けることもできます。ドキュメントの統計ダイアログの情報を更新するには、更新をクリックしてください。

### 外部ツールプラグイン

外部ツールプラグインを使えば、pluma から外部コマンドを実行することができます。コマンドにデータを渡して、その出力結果を取得したり（例えば、sed）、独立した外部コマンドを実行したり（例えば、make）といったことが可能になります。

外部ツール・マネージャを使って、実行したいコマンドを定義することができます。定義したコマンドは、ツールメニューに表示されます。

#### 組み込みコマンド

以下のコマンドは、外部ツールプラグインを有効にした段階で利用できます。

ビルド

  編集中のドキュメントが存在するディレクトリで、make を実行します。

ディレクトリの内容を表示

  編集中のドキュメントが存在するディレクトリの内容を、新しいドキュメントに出力します。

環境変数

  ボトム・ペインに環境変数の一覧を表示します。

Grep

  編集中のドキュメントが存在するディレクトリ中の全てのファイルに対して検索を行います。結果はボトム・ペインに表示されます。

末尾の空白を削除する

  ドキュメント中の各行末尾にある空白を削除します。

#### コマンドの定義

外部コマンドを新規に追加するには、ツール外部ツールを選択してください。

外部ツール・マネージャウィンドウが開きますので、新規をクリックします。実行したいコマンドにあわせて、以下の情報を入力してください。

説明

  メニュー上でコマンドを選択したときに、ステータスバーに表示される説明です。

ショートカット・キー

  キーボードショートカットを行うためのキーコマンドを入力してください。

コマンド

  実行したいコマンドを入力します。コマンドに現在編集しているドキュメントの情報などを渡すために、pluma 環境変数を使うこともできます。詳しいことはを参照してください。

入力

  コマンドに（標準入力として）与える内容を指定します。編集中のドキュメント全体や、選択中のテキスト、行、単語などを指定できます。

出力

  コマンドの結果をどこに出力するかを指定します。ボトム・ペインに表示、新しいドキュメントに出力、編集中のドキュメントの末尾に追記する、カーソル位置に挿入する、選択部分を置き換える、ドキュメント全体を置き換えるなどを指定できます。

適用範囲

  コマンドで扱えるドキュメントの種類を指定します。保存されているドキュメントかそうでないか、ローカルのドキュメントかリモートのドキュメントかなどから選べます。

#### ツールの編集・削除

既存のツールを編集するには、一覧から編集したいツールを選択し、設定を変更してください。

ツールの名前を変更するには、一覧にて名前を二度クリックしてください。

組み込みコマンドに加えた変更を元に戻したい場合は、元に戻すをクリックしてください。

定義したツールを削除するには、一覧にてツールを選択し、削除をクリックしてください。ただし組み込みコマンドは削除できません。削除できるのは、新規に作成したコマンドのみです。

#### 変数

コマンドフィールドでコマンドを定義する際に、以下の変数を利用することができます。

- PLUMA_CURRENT_DOCUMENT_URI

- PLUMA_CURRENT_DOCUMENT_NAME

- PLUMA_CURRENT_DOCUMENT_SCHEME

- PLUMA_CURRENT_DOCUMENT_PATH

- PLUMA_CURRENT_DOCUMENT_DIR

- PLUMA_DOCUMENTS_URI

- PLUMA_DOCUMENTS_PATH

### ファイル参照ペインプラグイン

ファイル参照ペインプラグインを使えば、サイド・ペインにてファイルやフォルダを参照することができ、簡単にファイルを開くことができます。

To view the File Browser, choose View Side Pane and then click on the tab showing the File Browser icon at the bottom of the side pane.

#### ファイルを表示する

初期状態のファイル・ブラウザタブでは、ファイル・マネージャでブックマークされている内容が表示されています。中身を表示するには、それぞれの項目をダブルクリックしてください。

親フォルダを表示するには、ドロップダウンリストから選択するか、ファイル・ブラウザツールバー上の上矢印をクリックしてください。

編集中のドキュメントが存在するフォルダを表示するには、ファイルの一覧で右クリックし、ドキュメントのルートにするを選択してください。

#### ファイルを開く

ファイルを pluma で開くには、ファイルの一覧から開きたいファイルをダブルクリックしてください。

#### ファイルやフォルダを作成する

ファイル・ブラウザで表示されているフォルダに、新規に空のテキストファイルを作成するには、そのファイル一覧上で右クリックし、新しいファイルを選択してください。

ファイル・ブラウザで表示されているフォルダに、新規にフォルダを作成するには、そのファイル一覧上で右クリックし、新しいフォルダを選択してください。

### 行のインデントプラグイン

行のインデントプラグインは、行の先頭に空白を追加・削除します。

インデントやインデントの解除を行うには、次の手順を実行します。

1. インデントを設定する行を選択します。1 行にインデントを設定したり削除したりするには、その行にカーソルを置きます。同じ行であればカーソルの位置はどこでも構いません。

2. - To indent the text, choose Edit Indent .

   - To remove the indentation, choose Edit Unindent .

インデント幅やタブ文字/空白文字のどちらを使うかといった設定は、エディタ設定のタブ文字に依存します。詳しいことは、を参照してください。

### 日付/時間の挿入プラグイン

日付/時間の挿入プラグインプラグインは、ドキュメントに原罪の日付や時刻を挿入します。日付/時間の挿入プラグインを使用するには、次の手順を実行します。

1. Choose Edit Insert Date and Time .

   自動的に指定した形式で日付/時刻を挿入するよう日付/時刻の挿入プラグインで設定していない場合は、日付と時刻の挿入ダイアログが表示されます。一覧の中から、希望の形式を選択してください。挿入をクリックすれば、日付と時刻の挿入ダイアログが閉じます。さらに現在編集中のファイルのカーソル位置に、日付/時刻が挿入されます。

   特定の日付/時間形式を pluma が使用する設定になっている場合は、日付と時刻の挿入ダイアログは表示されません。日付/時間は、現在編集中のファイルのカーソル位置に自動的に挿入されます。

#### 日付/時間の挿入プラグインの設定

日付/時間の挿入プラグインを設定するには、次の手順を実行します。

1. Choose Edit Preferences .

2. プラグインタブを選択します。

3. 日付/時間の挿入 プラグインを選択します。

4. プラグインの設定をクリックして、日付/時間挿入プラグインの設定ダイアログを表示します。

5. 次のようにオプションを 1 つ選択します。

   - 日付/時間を挿入するたびに日付/時間の形式を指定したい場合は、フォーマットのためのプロンプトオプションを選択します。

   - To use the same pluma-provided date/time format each time you insert the date/time, select the Use the selected format option, then select the appropriate format from the list. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

   - To use the same customized date/time format each time you insert the date/time, select the Use custom format option, then enter the appropriate format in the text box. For more information about how to specify a custom format, see strftime 3. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

6. OKをクリックして、日付/時間挿入プラグインの設定ダイアログを閉じます。

7. 設定ダイアログを閉じるには、閉じるをクリックします。

### モードラインプラグイン

モードラインプラグインを使えば、ドキュメントごとの設定を保存できます。モードラインとは pluma がそのドキュメントを判別するためのテキストの先頭もしくは終端行を意味します。

モードラインを使えば、設定ダイアログで設定できる項目を上書きすることができます。

モードラインでは以下の項目を設定できます。

- タブの幅

- インデントの幅

- タブ文字の代わりに半角空白を使うかどうか

- テキストの折り返し

- 右マージン幅

モードラインプラグインでは、Emacs、Kate、Vim などのテキストエディタでも使われているモードラインをサポートしています。

#### Emacs モードライン

Emacs モードラインでは、ドキュメントの先頭二行を使って判別します。

Emacs ではタブの幅 (tab-width)、インデントの幅 (indent-offset)、インデント文字の種類 (indent-tabs-mode)、自動テキストの折り返し (autowrap)オプションなどをサポートしています。詳しいことは GNU Emacs マニュアルを参照してください。

#### Kate モードライン

Kate モードラインでは、ドキュメントの先頭と終端の十行を使って判別します。

Kate ではタブの幅 (tab-width)、インデントの幅 (indent-width)、空白文字によるインデント (space-indent)、単語の折り返し (word-wrap)、折り返し幅 (word-wrap-column)オプションなどをサポートしています。詳しいことは Kate のウェブサイトを参照してください。

#### Vim モードライン

Vim モードラインでは、ドキュメントの先頭と終端の三行を使って判別します。

Vim ではタブ文字の種類 (expandtab)、タブの幅 (tabstop)、インデントの幅 (shiftwidth)、テキストの折り返し (wrap)、折り返し幅 (textwidth)オプションなどをサポートしています。詳しいことは Vim のウェブサイトを参照してください。

### Python コンソールプラグイン

Python コンソールプラグインを使えば、pluma からプログラミング言語である Python のコマンドを実行できます。プラグインを有効にするとボトム・ペインにタブが追加されて、ここにコマンドプロンプトやその結果が出力されます。

Python コンソールで入力されたコマンドは、実行前の確認が行われません。そのため、無限ループなどを実行することで、pluma が停止してしまう可能性もあります。

### コード・スニペットプラグイン

コード・スニペットプラグインを使えば、よく使う文字列（スニペット）を保存し、手軽にドキュメントに挿入できます。

挿入できるスニペットは、現在編集中のドキュメントの種類に依存します。例えば、HTML ドキュメントを編集中であれば、HTML でよく使われるスニペットの一覧から文字列を選択することができます。一部のスニペットは、全ての種類のドキュメントで利用できます。

pluma には数多くの組み込みスニペットが存在し、それを編集することも可能です。

#### スニペットの挿入

スニペットを実際に挿入するにはまずタブトリガと呼ばれる単語を入力してから、Tab キーを押します。スニペットのタブトリガは、一般的に挿入したいスニペットの一部の文字で構成されるか、より覚えやすい短い単語が選ばれています。

別の方法として、Ctrl Space を入力すれば、挿入可能なスニペットの一覧が表示されます。訳注：日本語環境の場合、Ctrl Space は日本語入力のオン/オフが割り当てられていることがあるため、日本語入力の設定を変更しない限り使えない場合もあります。

#### スニペットの追加

新規にスニペットを追加する方法は次のとおりです。

1. ツールスニペットの管理を選択し、スニペットの管理ウィンドウを開きます。

2. スニペットの一覧は言語ごとにグループ分けされていますので、追加したいスニペットの言語か言語グループにあるスニペット自体を選択します。全ての言語に共通するスニペットを追加したい場合は、一覧の先頭にある全般を選択します。標準状態では、現在編集中のドキュメントの種類が選択されています。

3. 新規をクリックします。一覧の中に新しいスニペットの項目が現れます。

4. 新しいスニペットに対して、以下の情報を入力してください。

   名前

     スニペットの一覧で表示される、スニペットの名前を入力します。この名前は、そのスニペットがどういうものかを思い出すためだけに使われます。一覧の中でスニペットの名前をクリックすれば、名前を変更することができます。

   スニペットテキスト

     編集ボックスに、挿入したいスニペットの文字列を入力します。特殊なコードも入力可能です。詳しいことは、を参照してください。

     スニペットの管理ウィンドウを閉じることなく、ドキュメントウィンドウに一旦戻って、そこから入力したい文字列をコピーすることも可能です。

   タブトリガ

     タブ欄にタブトリガとなる文字列を入力します。これは、Tab キーを押した際に、どのスニペットに置き換えるべきかを識別するための文字列です。

     タブトリガは他のスニペットのタブトリガと重複できません。もし、入力した文字列が重複している場合は、タブの欄が赤く表示されます。

   ショートカット・キー

     スニペットを挿入するためのショートカット・キーを入力します。

#### スニペットの編集・削除

特定のスニペットを編集するには、一覧からスニペットを選択後、表示される各設定を適宜修正してください。

特定のスニペットの名前を編集するには、スニペットの名前を二度クリックしてください。

一度編集した組み込みスニペットを元に戻すには、元に戻すをクリックしてください。

特定のスニペットを削除するには、スニペットを選択後、削除をクリックしてください。組み込みスニペットは削除できません。自分で作ったスニペットのみ削除可能です。

#### スニペット置換

文字列を挿入するだけでなく、スニペットには状況に合わせて変更可能な文字列を挿入したり、スニペット挿入後に修正が必要な場所を指定したりといったことが可能です。

スニペットテキストに、以下のコードを入力できます。

タブコード

  `$n` はタブコードを表します。`n` は 1 から始まるタブの番号です。

  `${n:default}` は初期値付きのタブコードです。

  タブコードは、そのスニペットを挿入後に別の文字列を挿入する可能性がある場所を指定するコードです。

  タブコードを使うためには、まず普通にスニペットを挿入します。その後、カーソルが最初のタブ番号の位置に移動します。テキストを入力し、Tab キーを押せば、次のタブ番号の位置に移動します。タブコードの番号は、Tab キーを押すことによって進む順番を指定します。

  Shift Tab を押せば一つ前のタブ番号の位置にカーソルが移動します。一番最後の位置で、Tab キーを押した場合、スニペットで挿入された文字列の最後か、もし存在すれば終端コードの位置にカーソルが移動します。

ミラーコード

  タブコード連続して記述すると、既に定義されたコードを複写します。これによりスニペットが数回現れる場面でも、入力は一度だけで済みます。

終端コード

  `$0` は終端コードを表します。これはスニペットの末尾に記され、カーソルがスニペットの最後尾に移動する際に使われます。

環境変数

  `$PATH` や `$HOME` のような環境変数はスニペットでも利用できます。pluma では以下の独自の環境変数も使用できます。

  $PLUMA_SELECTED_TEXT

    現在選択中の文字列を表します。

  $PLUMA_FILENAME

    現在編集中のファイル名を表します。ドキュメントが未保存であれば、空文字となります。

  $PLUMA_BASENAME

    現在編注のファイル名の、拡張子を除いた部分を表します。ドキュメントが未保存であれば、空文字となります。

  $PLUMA_CURRENT_WORD

    現在カーソルが存在する場所の単語を表します。この変数が使われたとき、現在の単語は、スニペットに置換されます。

シェルコード

  `$(cmd)` は端末内で cmd を実行した結果に置換されます。

  `$(n:cmd)` は参照番号付きのシェルコードで、n には 1 以上の数字を割り当てます。`$n` を使えば、その番号の割り当てられたシェルコードと同じ出力結果を挿入できます。

Python コード

  `$<cmd>` は Python インタプリタ内で cmd を実行した結果に置換されます。

  `$<a:cmd>` は、別の Python コードへの依存性を表しています。ここで a はスニペットの順番です。これを使えば、他のスニペットで定義された Python 関数を利用できます。複数の依存性を表すには、次のようにカンマで区切ってください： `$<a,b:cmd>`

  他の Python スニペットで使っている変数を利用するには、その変数が`グローバル`として定義されている必要があります。

### 並び替えプラグイン

並び替えプラグインは、選択した行をアルファベット順（文字コード順）に並べ替えます。

You cannot undo the Sort operation, so you should save the file before performing the sort. To revert to the saved version of the file after the sort operation, choose File Revert .

並び替えプラグインを使用するには、次の手順を実行します。

1. 並び替えたい行を選択します。

2. Choose Edit Sort . The Sort dialog opens.

3. 並び替え作業で使用したいオプションを選択します。

   - 逆の順序に並べ替えたい場合は、逆順にするオプションを選択します。

   - 重複した行を削除する場合は、重複する部分を削除するオプションを選択します。

   - 大文字と小文字を認識して並び替えたい場合は、大/小文字を区別するオプションを選択します。

   - 各行ごとに最初の数文字を並び替え判別の対称から外したい場合は、開始行でその文字数を指定します。

4. 並び替え操作を実行するには、並び替えをクリックします。

### スペル・チェッカプラグイン

スペル・チェッカプラグインは、選択したテキストのスペルを確認します。自動的にスペルチェックを行ったり、特定の言語で手動でスペルチェックを行うといった設定が可能です。言語設定や自動チェックのオン/オフについては、ドキュメントごとに保存されます。スペル・チェッカプラグインを使用するには、以下の手順を実行します。

1. Choose Tools Set Language to display the Set language dialog. Select the appropriate language from the list. Click OK to close the Set language dialog.

2. To check the spelling automatically, choose Tools Autocheck Spelling . To unset the automatic spell check, choose Tools Autocheck Spelling again. When automatic spell checking is set, an icon is displayed beside the Autocheck Spelling menu item. Automatic spell checking is unset by default, each time pluma starts.

   辞書にないスペルが発見されたときは、別の色で下線が表示されます。その単語を右クリックし、スペルの提示を選択すると、以下の選択肢が表示されます。

   - 辞書にないスペルを別のスペルに置き換える場合は、スペルの提示に表示されているスペルを選択してください。

   - To add the unknown spelling to your personal dictionary, select Spelling Suggestions Add .

   - To ignore all occurrences of the unknown spelling, so that they are no longer flagged as unknown but are not added to your personal dictionary, select Spelling Suggestions Ignore All . The unknown word is ignored in the current pluma session only.

3. To check the spelling manually, choose Tools Check Spelling .

   スペルミスが発見されなかった場合は、情報ダイアログに、スペルミスと思われる単語が見つからなかった旨が表示されます。OK をクリックして情報ダイアログを閉じてください。

   スペルミスが発見された場合、スペルチェックダイアログが表示されます。

   - ダイアログの冒頭にはスペルミスと思われる単語が表示されます。

   - 変更先には、正しいと予想される候補が表示されます。正解の候補リストから別の候補を選択することや、変更先に直接正しいスペルを書き込むこともできます。

   - 変更先に入力したスペルが正しいかどうかを確認するには、単語のチェックをクリックしてください。辞書の単語と一致すれば、正解の候補リストの内容は`（正しいつづり）`に置き換わります。辞書の単語と一致しなければ、新しい候補が正解の候補リストに表示されます。

   - 現在の単語に対するスペルチェックを無視するには、無視をクリックしてください。同じドキュメント中にある同じ単語全てを無視するには全て無視をクリックしてください。これらの設定は pluma を再起動すると無効になります。

   - 現在、確認している単語のみを変更先の単語に置き換える場合は、変更をクリックします。同じスペルの単語を全て置き換える場合は、全て変更をクリックします。

   - その不明な単語を個人辞書に追加するには、単語の追加をクリックします。

   - スペル・チェックダイアログを閉じるには、閉じるをクリックしてください。

### タグの一覧プラグイン

タグの一覧プラグインを使えば、よく使われるタグがサイド・ペインに表示され、そこから簡単にドキュメントに挿入できます。

タグの一覧プラグインを使用するには、次の手順を実行します。

1. Choose View Side Pane .

2. 初期設定では、サイドペインには開いているファイルの一覧が表示されます。タグの一覧を表示するためには、サイド・ペインの下部にある + アイコンをクリックしてください。

3. ドロップダウンリストから、適切なタグカテゴリを選択します。例えば、`HTML - タグ`を選択します。

4. タグの一覧をスクロールして、希望のタグを見つけます。

5. 編集中のドキュメントのカーソル位置にタグを挿入するには、タグの一覧で該当するタグをダブルクリックします。次の方法でもタグを挿入できます。

   - Enter キーを押せば、タグを挿入し、サイド・ペインから表示領域に戻れます。

   - Shift Enter キーを押せば、タグを挿入し、フォーカスはサイド・ペイン上に残ります。

pluma
text editor