# Pluma マニュアル

2015-2021
MATE Documentation Project
2007
GNOME Documentation Project
2002
2003
2004
Sun Microsystems
2000
Eric Baudais
MATE 文書化プロジェクト
GNOME 文書化プロジェクト
MATE 文書化プロジェクト
MATE デスクトップ
Joachim
Noreiko
GNOME 文書化プロジェクト
GNOME
Hal
Canary
ショートカット・キーの一覧を追加
Sun Java 文書化チーム
サン・マイクロシステムズ
gdocteam@sun.com
Eric
Baudais
GNOME 文書化プロジェクト
baudais@okstate.edu
Baris
Cicek
以前の改訂版 Pluma アプリケーションからの情報です。
George
Ajit
プラグインに関する情報です。
1.0
2000

Eric Baudais baudais@okstate.edu

GNOME 文書化プロジェクト

2.0
2002年3月

Sun GNOME 文書化チーム

GNOME 文書化プロジェクト

2.1
2002年6月

Sun GNOME 文書化チーム

GNOME 文書化プロジェクト

2.2
2002年8月

Sun GNOME 文書化チーム

GNOME 文書化プロジェクト

2.3
2002年9月

Sun GNOME 文書化チーム

GNOME 文書化プロジェクト

2.4
2003年1月

Sun GNOME 文書化チーム

GNOME 文書化プロジェクト

2.5
2003年3月

Sun GNOME 文書化チーム

GNOME 文書化プロジェクト

2.6
2003年9月

Sun GNOME 文書化チーム

GNOME 文書化プロジェクト

2.7
2004年3月

Sun GNOME 文書化チーム

GNOME 文書化プロジェクト

2.8
2015年7月

Sun Java 文書化チーム

GNOME 文書化プロジェクト

2.9
2006年7月

GNOME 文書化チーム

GNOME 文書化プロジェクト

3.0
2015年7月

MATE 文書化チーム

MATE 文書化プロジェクト

本マニュアルは、Pluma 1.10 版について説明しています。

## はじめに

Pluma アプリケーションでは、テキストファイルの作成・編集を行うことができます。

Pluma は、シンプルで使いやすいテキストエディタであることがその目標です。さらに強力な機能は、色々なプラグインで可能になるので、テキスト編集でさまざまな作業を可能にします。

## 使ってみましょう

### Pluma を使ってみる

次の方法でPluma を起動します。

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

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

コマンドラインから

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

デフォルトでは、ファイルマネージャでテキスト文書を開くと、Pluma が起動して文書を表示します。

### Pluma のウィンドウ

Pluma を起動したら、次のウィンドウが表示されます。

#### Pluma のウィンドウ

Pluma のメイン・ウィンドウを表示します。

Pluma ウィンドウには次の項目があります。

メニューバー

  メニューバーのメニューには、Pluma の操作に必要なコマンドが全部含まれています。

ツールバー

  ツールバーには、メニューバーからアクセス可能な、コマンドのサブセットが含まれています。

表示領域

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

ステータスバー

  ステータスバーには、Pluma の現在の実行状況に関する情報や、メニュー項目のコンテキスト情報が表示されます。ステータスバーは次の情報も表示します。

  - カーソル位置：現在カーソルがある行番号と列番号です。

  - 編集モード：エディターが挿入モードの場合、ステータスバーに 挿入 の文字が表示されます。上書きモードの場合は、ステータスバーに 上書き の文字が表示されます。INS キーを押すと、編集モードが切り変わります。

サイドペイン

  サイドペインには、開いている文書の一覧や、有効なプラグインに応じた情報などが表示されます。

  既定では、サイドペインが表示されません。サイドペインを表示するには、表示サイドペインを選択します。

下端ペイン

  下端ペインは、Python コンソール・プラグインのようなプログラミング・ツールが出力を表示するために使用します。

  既定では、下端ペインは表示されません。下端ペインを表示するには、表示下端ペインを選択します。

Plume ウィンドウ内で右クリックすると、アプリケーションはポップアップ・メニューを表示します。このメニューには、最も一般的なテキスト編集用のコマンドが含まれています。

他の MATE アプリケーションと同様に、Pluma の操作には複数の方法があります。メニュー、ツールバー、そしてショートカットキーが使えます。すべてのアプリケーションに共通なショートカットキーは、ユーザーガイドに記載されています。

### コマンドラインから Pluma を起動するには

コマンドラインから Pluma を実行し、1つまたは複数のファイルを開くことができます。コマンドラインから複数のファイルを開くには、次のコマンドを入力し、Enter を押します。

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

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

コマンドラインから Pluma を実行する方法の詳細については、pluma 1 man ページを参照してください。

## ファイルを使った作業

### 新しい文書を作成するには

新しい文書を作成するには、ファイル新規作成を選択します。Pluma は、新しい白紙の文書をウィンドウに表示します。

### ファイルを開くには

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

このエディタは、直近に編集した5個のファイルのパスとファイル名を記録し、それをメニュー項目としてファイルメニューに表示します。また、ツールバーの 最近開いたファイルのメニュー・アイコンを表示します。 アイコンをクリックすると、最近使ったファイルのリストが表示されます。

Pluma では同時に複数のファイルを開くことができます。このエディタでは、開いているファイル毎にそのタブがウィンドウに追加されます。これについての詳細はをご覧ください。

ファイルを開くダイアログで、ファイルの場所を入力することができます。場所情報の入力と「パンくずリスト」を切り替えるには、Ctrl、l、.、~、/ のいずれかを押します。

### ファイルの保存

次のいずれかの方法で保存できます。

- 既存ファイルの変更を保存するには、 ファイル 保存 を選択します。

- 新しいファイルを保存したり、既存のファイルを新しいファイル名で保存したりするには、ファイル別名で保存を選択します。別名で保存ダイアログにファイル名を入力し、保存をクリックします。

- 現在 Pluma で開いているすべてのファイルを保存するには、文書すべて保存を選択します。

現在 Pluma で開いているすべてのファイルを閉じるには、文書すべて閉じるを選択します。

### タブを使った作業

複数のファイルを開いているとき、Pluma は表示領域の上に各文書のタブを表示します。文書を切り替えるには、そのタブをクリックします。

文書を別の Pluma・ウィンドウに移動するには、ファイルに対応するタブを移動したいウィンドウにドラッグします。

文書を新しい Pluma・ウィンドウに移動するには、そのタブをデスクトップにドラッグするか、文書新しいウィンドウに移動を選択します。

## テキストを使った作業

### テキストの編集

次のいずれかの方法でテキストの編集を行えます。

- キーボードで新しいテキストを入力します。点滅している挿入カーソルは、新しいテキストが表示される位置を示しています。この位置を変更するには、キーボードの矢印キーを使うか、マウスでクリックします。

- 選択したテキストをクリップボードにコピーするには、編集コピーを選択します。

- 選択したテキストを削除しクリップボードに移動するには、編集切り取りを選択します。

- 選択したテキストを永久に削除するには、編集削除を選択します。

- クリップボードの内容をカーソル位置に挿入するには、編集貼り付けを選択します。Pluma や他のアプリケーションから貼り付けする前に、テキストの切り取りまたはコピーをしておく必要があります。

- ファイル内のすべてのテキストを選択するには、編集すべて選択を選択します。

### 元に戻す作業とやり直す作業

操作で加えた変更を元に戻すには、編集元に戻すを選択します。この操作自体を取り消すには、編集やり直しを選択します。

## 検索と置き換えについて

Pluma では、テキストを検索する方法が2つあります。検索ダイアログを使って特定の文字を検索する方法と、入力中にマッチした文字を強調表示する逐次検索があります。

### テキストを検索する

ファイルの中の文字列を検索するには、次の手順で行います。

1. 検索 検索を選択して、検索ダイアログを表示します。

2. 検索の入力欄に検索したい文字列を入力します。改行やタブなどの特殊文字を含めることができるので、を参照してください。

3. 検索をクリックすると、現在のカーソル位置以降で最初に出現する文字列がファイル内で検索されます。Pluma が複数の文字列を見つけた場合、その文字列の最初の出現箇所を選択します。その他の文字列は強調表示されます。

4. 次に出現する文字列を探すには、検索をクリックするか、検索次を検索を選択します。前の文字列を検索するには、検索前を検索を選択します。

検索ダイアログを閉じた後でも、検索次を検索や検索前を検索を選択することで、テキストの他の出現箇所へ移動することができます。

テキストから強調表示を取り消すには、検索強調表示を消去を選択します。

検索ダイアログでサポートされる正規表現の構文や意味の詳細については、pcrepattern 3を参照してください。

### 逐次検索

逐次検索では、一文字ずつ入力していくと、文書内で一致するテキストが強調表示されます。（これは、いくつかのウェブブラウザにある検索機能に似ています）

逐次検索を開始するには、検索逐次検索を選択します。表示領域の上部に検索ボックスが表示されます。

入力を開始すると、条件に一致したテキストが文書内で強調表示されます。カーソル位置の後にある最初のインスタンスも選択されます。

逐次検索ボックスを開いたまま、選択先を次の一致箇所へと移動するには、Ctrl G を押します。前の一致箇所へ戻るには、Ctrl Shift G を押します。

また、上下の矢印キーやマウスホイールを使っても、前後の一致箇所の範囲内で移動することができます。

### テキストの置き換え

ファイル内の文字列を検索し、その文字列を別のものに置き換えるには、次の手順にしたがってください。

1. 検索 置換を選択し、置換ダイアログを表示します。

2. 検索の入力欄に検索したい文字列を入力します。改行やタブなどの特殊文字を含めることができるので、を参照してください。

3. 使いたい文字列を置換後の文字列欄に入力して、見つけた文字列と置き換えるます。

文字列を置き換える前に各々の一致箇所を調べるには、検索をクリックします。Pluma が文字列を見つけた場合、その文字列が選択されます。置換をクリックすると、選択された文字列が置換されます。次に該当す文字列を探すには、再び検索をクリックします。

文書内で一致するすべての文字列を一度に置換えるには、すべて置き換えるをクリックします。

### 検索と置き換えのオプション

検索ダイアログと置換ダイアログには、それぞれ次のようなオプションがあります。

- 大文字と小文字を区別してマッチオプションを選択すると、入力したテキストの大文字と小文字で一致する文字列だけが検索されます。例えば、大文字と小文字を区別してマッチを選択した場合、"TEXT "は "text "とは一致しません。

- 単語全体にのみマッチオプションを選択すると、入力した単語に完全に一致する文字列だけが検索されます。例えば、単語全体にのみマッチを選択した場合、"text" は "texture" とは一致しません。

- 前を検索というオプションを選択すると、文書の冒頭へ向かって検索を行うことができます。

- 折り返すというオプションを選択すると、文書ファイルの一方の端まで検索したあとでもう一方の端からも検索を続けることできます。

### 特殊文字

検索・置換するテキストに次のエスケープシーケンスを含めることで、特殊文字を表現することができます。

`\n`

  改行を指定します。

`\t`

  タブ文字を指定します。

`\r`

  行頭復帰を指定します。

`\\`

  バックスラッシュ文字を検索する場合は、この文字自体をエスケープする必要があります。例えば、`\n` というリテラルを探している場合、検索欄に "\\n" と入力する必要があります。また、一連のバックスラッシュを検索する場合は、検索するバックスラッシュの数を2倍にしなければなりません。

### カーソルを特定の行に合わせる

現在のファイル中の指定した行にカーソルを置くには、検索指定行へ移動を選択します。表示領域の上部に行番号の入力ボックスが表示されます。

カーソルを移動させたい行の番号を入力し始めると、文書が指定した行へスクロールします。

入力ボックスを消してカーソルを指定した行に移動するには、Return を押します。

## 印刷する

### ページオプションの設定

ページのオプションを設定するには、ファイルページの設定を選択して、ページの設定ダイアログを表示します。

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

#### 全般タブの項目

強調表示を含めて印刷する

  構文の強調表示を印刷するには、このオプションを選択します。構文の強調表示の詳細については、を参照してください。

ページのヘッダを印刷する

  このオプションを選択すると、印刷する各ページにヘッダを含めることができます。ユーザはヘッダを構成できません。

行番号

  行番号を印刷するオプションを選択すると、ファイルを印刷する時に行番号を含めることができます。

  行番号を付与する間隔というスピンボックスを使用して、行番号を印刷する頻度、たとえば、5 行毎や 10 行毎などを指定します。

テキストの折り返し

  テキストの折り返しを有効にするオプションを選択すると、ファイルを印刷する時に文字単位でテキストを次行に折り返します。このアプリケーションでは、行番号付けの際、折り返された複数行も 1 行として数えます。

  単語を二行以上に分割しないオプションを選択すると、ファイル印刷時にテキストの折り返しが単語単位で行われます。

#### フォント

本文

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

行番号

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

ヘッダーとフッター

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

Plumaでファイルを印刷する時、既定フォントにリセットするには、既定のフォントに戻すをクリックします。

### 文書のプリント

Pluma を使うと、次のようなプリント操作ができます。

- 文書をプリンタで印刷します。

- print コマンドの出力をファイルにプリントします。

ファイルにプリントする場合、Pluma はファイル出力をプリプレス形式にして送ります。プリプレス形式としては、PostScriptとPDF（Portable Document Format）が一般的です。

印刷したいページをプレビューするには、 ファイル 印刷プレビュー を選択します。

現在のファイルをプリンターで印刷、またはファイルに出力するには、ファイル印刷を選択して、印刷ダイアログを表示します。

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

#### 印刷ジョブのタブ項目

印刷範囲

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

  - すべて

    このオプションを選択すると、ファイルのすべてのページを印刷します。

  - 行番号

    指定行だけを印刷するには、このオプションを選択します。From および To スピンボックスを使用して、行の範囲を指定します。

  - 選択

    このオプションを選択すると、選択したテキストだけを印刷します。このオプションは、テキストを選択した場合にのみ使用できます。

コピー

  コピーの数スピンボックスを使用して、印刷したいファイルのコピー数を指定します。

  ファイルから複数のコピーを印刷する場合、ページ順に揃えるオプションを選択すると、印刷するコピーをページ順に揃えます。

#### 印刷のタブ項目

プリンタ

  このドロップダウンリストを使って、ファイルを印刷したいプリンタを選択します。

設定

  このドロップダウンリストを使って、プリンタの設定を選択します。

  プリンターを設定するには、設定をクリックします。例えば、両面印刷を有効または無効にしたり、遅延印刷を予約したりすることも、プリンター側でこの機能をサポートしている場合には可能です。

場所

  このドロップダウンリストを使用して、印刷先を次のいずれかより選択します。

  CUPS

    ファイルを CUPS・プリンタで印刷します。

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

  lpr

    ファイルをプリンタで印刷します。

  ファイル

    ファイルを PostScript ファイルとして出力します。

    別名で保存をクリックすると、PostScript 形式で名前と保存場所を指定するダイアログが表示されます。

  カスタム

    指定したコマンドを使って、ファイルを印刷します。

    テキストボックスにコマンドの名前を入力します。すべてのコマンドラインの引数はすべて含めてください。

状態

  このバージョンの Pluma では、この機能はサポートされていません。

種類

  このバージョンの Pluma では、この機能はサポートされていません。

説明

  このバージョンの Pluma では、この機能はサポートされていません。

#### 用紙のタブ項目

用紙サイズ

  このドロップダウンリストを使って、ファイルを印刷する用紙の大きさを選択します。

幅

  このスピンボックスを使って、用紙の幅を指定します。となりのドロップダウンリストを使うと、長さの単位が変更できます。

高さ

  このスピンボックスを使って、用紙の高さを指定します。

用紙の向き

  このドロップダウンリストを使って、プリンタの用紙の向きを選択します。

ページの向き

  このドロップダウンリストを使って、プリンタの方向を選択します。

レイアウト

  このドロップダウンリストを使って、ページレイのアウトを選択します。選択した各々のレイアウトは、プレビューに表示されます。

出力先のトレイ

  このドロップダウンリストを使って、出力先のトレイを選択します。

## プログラミングの機能

Pluma のプログラミング用機能のいくつかは、プラグインで提供されます。たとえば、タグリストのプラグインは、さまざまなマークアップ言語でよく使われるタグのリストを提供します。を参照してください。

### 強調表示モード

シンタックス強調表示は、テキストの異なる部分を別々の色で表示することによって、ソースコードを読み易くします。

Pluma は、文書の種類に応じて適切な構文強調表示モードを選択します。構文強調表示モードを変更するには、表示強調表示モードを選択し、次のメニュー項目のいずれかを選択します。

なし

  構文の強調表示はしません。

ソース

  構文の強調表示をして、ソースコードを編集することができます。ソースのサブメニューでその種類を選択します。

マークアップ

  構文の強調表示をして、マークアップのコードを編集することができます。マークアップのサブメニューでその種類を選択します。

スクリプト

  構文の強調表示をして、スクリプトのコードを編集することができます。スクリプトのサブメニューでその種類を選択します。

その他

  構文の強調表示をして、その他のコードを編集することができます。その他のサブメニューでコードの種類を選択します。

### print コマンドの出力をファイルにパイプします。

Pluma を使うと、コマンドの出力をテキストファイルにパイプすることができます。たとえば、`ls` コマンドの出力をパイプするには、`ls | pluma` と入力し、Return を押します。

`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 + 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 | 現在カーソルがある行を削除します。
Ctrl + U | 大文字に変更します。
Ctrl + L | 小文字に変更します。
Alt + U | 各文字の大文字／小文字をトグルします。
Alt + L | 各単語を大文字にします。
Alt + Up | 選択した行を 1 行上に移動させます。
Alt + Down | 選択した行を 1 行下に移動させます。
Tab | 選択した行のインデントを大きくします。
Shift + Tab | 選択した行のインデントを小さくします。

表示

現在の表示のショートカットです。

ショートカット・キー | コマンド
--- | ---
Ctrl + Y | 行番号の表示と非表示を切り替えます。

ペイン

ペインの表示・非表示を切り替えるショートカットです。

ショートカット・キー | コマンド
--- | ---
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 ユーザー・マニュアルを開きます。

## 各種設定

Pluma を設定するには、編集設定を選択します。設定ダイアログには、次のカテゴリがあります。

### 表示の設定

テキストの折り返し

  テキストの折り返しを有効にするオプションを選択すると、長いテキスト行がウィンドウの端からはみ出すことなく、段落として表示されます。これによって、水平方向にスクロールしなくて済みます。

  単語を2行以上に分割しないオプションを選択すると、次の行にテキストが回り込む際に、単語の固まりとして保持します。これによって、テキストが読み易くなります。

行番号

  行番号を表示するというオプションを選択すると、Pluma・ウィンドウの左側に行番号を表示します。

行番号

  カーソルのある行を強調表示するオプションを選択すると、今カーソルが置かれている行を強調表示します。

右マージン

  右マージンを表示するを選択すると、右側の余白を示す縦線が表示されます。

  右マージンを表す列番号のスピンボックスで、縦線の位置を指定します。

対応する括弧

  対応する括弧のオプションを選択すると、カーソルが括弧の文字の上にあるとき、対応する括弧が強調表示されます。

### エディタの設定

タブ文字

  タブの幅のスピンボックスを使うと、Tab キーを押したときPluma が挿入する空白の幅を指定できます。

  Pluma では、タブの代わりにスペースを挿入するというオプションを選択すると、Tab キーを押したとき、タブ文字の代わりに空白を挿入します。

自動インデント

  自動インデントを有効にするオプションを選択すると、次行が現在のインデントレベルで開始するようになります。

ファイルの保存

  保存する前にバックアップを生成するというオプションを選択すると、ファイルを保存するたびにそのバックアップ・コピーが作成されます。バックアップコピーには、ファイル名の最後に ~ が付加されます。

  ファイルを自動的に保存する間隔というオプションを選択すると、現在のファイルが一定の間隔で自動的に保存されます。スピンボックスを使って、ファイルを保存する頻度を指定します。

### フォントと色の設定

フォント

  システムの固定幅フォントを使うというオプションを選択すると、Pluma ウィンドウでシステムの既定フォントを使用します。

  エディタのフォント欄には、Pluma がテキストを表示する際に使用するフォントが表示されます。ボタンをクリックして、テキストに使用するフォントの種類、スタイル、大きさを指定します。

色のスキーム

  配色リストの中から配色を選択することができます。デフォルトでは、次のような配色がインストールされています。

  クラシック

    gvim のカラースキームを基本にしたクラシックな配色です。

  コバルト

    青を基調とした配色です。

  Kate

    Kate テキストエディタで使用されている配色です。

  Oblivion

    Tango 系の色を使った暗い配色です。

  Tango

    Tango 系の配色を使った配色です。

  追加...をクリックして、新しい配色ファイルを選択することで、新しい配色を追加できます。

  削除をクリックすれば、選択した配色を削除できます。

### プラグインの設定

プラグインは、Pluma に追加的な機能を加えるものです。プラグインの詳細や内蔵プラグインの使用方法については、をご覧ください。

#### プラグインを有効にするには

Pluma のプラグインを有効にする手順は、次のとおりです。

1. 編集 設定 を選択します。

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

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

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

#### プラグインを無効にするには

プラグインは、Pluma を終了しても有効なままです。

Pluma プラグインを無効にするには、次の手順を行ってください。

1. 編集 設定 を選択します。

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

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

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

## プラグイン

### プラグインを使った作業

プラグインを有効にすることで、Pluma に機能を追加できます。プラグインとは、アプリケーションの機能を拡張する補助的なプログラムのことです。プラグインは、Pluma のメニューに新しい機能の項目を追加します。

Pluma に組み込まれたいくつかのプラグインです。

プラグインの有効化・無効化の方法、または現在どのプラグインが有効なのかを確認するには、をご覧ください。

Pluma に組み込まれたいくつかのプラグインです。

- は、文書の行数、単語数、文字数を表します。

- は、Pluma で外部コマンドを実行できるようにします。

- は、サイドペインでファイルやフォルダーをブラウズできるようにします。

- は、選択した行にインデントを追加または削除します。

- は、文書に現在の日付と時刻を挿入します。

- によって、個々の文書の編集設定を行うことができ、Emacs、Kate、Vimスタイルのモードラインをサポートします。

- は、プログラミング言語 python のコマンドを実行可能にします。

- は、保存後の文書の末尾の空白を取り除くことができます。

- は、よく使う文章を保存しておき、文書に素早く挿入できるようにします。

- は、選択した行のテキストをアルファベット順に並べます。

- は、選択したテキストのつづりを修正したり、文書内のエラーに自動的に印をつけたりします。

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

プラグイン作成の詳細については、をご覧ください。

### 文書統計のプラグイン

文書の統計プラグインは、現在のファイルの行数、単語数、空白のある文字数、空白のない文字数、バイト数をカウントします。このプラグインは、結果を文書の統計ダイアログに表示します。このプラグインを使うには、次の手順を実行します。

1. ツール文書の統計を選択すると、文書の統計ダイアログが表示されます。文書の統計ダイアログには、そのファイルに関して次の情報が表示されます。

   - 現在の文書の行数。

   - 現在の文書の単語数。

   - 現在の文書に含まれる、スペースを含む文字数。

   - 現在の文書に含まれる、スペースを含まない文字数。

   - 現在の文書のバイト数。

2. 文書の統計ダイアログが開いていても、その間 Pluma を使ってファイルで作業を続けることができます。文書の統計ダイアログの内容を更新するには、更新をクリックしてください。

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

外部ツール・プラグインを使用すると、Pluma から外部コマンドを実行することができます。いくつかのコンテンツをコマンドにパイプしてその出力を利用したり（ sed など）、定義済みのコマンドを起動したり（ make など）することができます。

コマンドを作成・編集するには、外部ツール・マネージャを使用します。外部コマンドを実行するには、ツールメニューからコマンドを選択します。

#### 内部コマンド（組み込みコマンド）

外部ツール・プラグインでは、次のコマンドが用意されています。

ビルド

  現在の文書があるディレクトリで make を実行します。

ディレクトリの表示

  現在の文書があるディレクトリの内容を、新しい文書に一覧表示します。

環境変数

  下端ペインに環境変数の一覧を表示します。

Grep

  現在の文書があるディレクトリ内の全ファイルの中から、パターンの一致を使って用語を検索します。検索結果は下端ペインに表示されます。

末尾の空白を削除する

  文書の行末からすべてのスペースを取り除きます。

#### コマンドを定義する

外部コマンドを追加するには、ツール 外部ツールを選択します。

外部ツール・マネージャのウィンドウで、New をクリックします。新しいコマンドには、次のような詳細を指定できます。

説明

  この説明は、メニューのコマンドを選択した時に、ステータスバーに表示されます。

アクセラレータ

  コマンドのキーボード・ショートカットを入力します。

コマンド

  実際に実行されるコマンドです。Pluma の環境変数を使って、コマンドにコンテンツを渡すことができます。をご覧ください。

入力

  コマンドに渡す内容（標準入力として）です。つまり、現在の文書のテキスト全体、現在の選択、行、または単語。

出力

  コマンドの出力をどのように扱うかということです。つまり、下端のペインに表示する、新しい文書に置く、または現在の文書に置く、最後に置く、カーソルの位置に置く、または選択部分または文書全体を置き換える、ということです。

適用性

  コマンドの影響を受ける文書の種類を決定します。たとえば、保存するかしないか、ローカルかリモートかなどです。

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

ツールを編集するには、一覧からそのツールを選択し、プロパティを変更します。

ツールの名前を変更するには、一覧の中でもう一度クリックします。

変更した組み込みツールを復元するには、Revert を押します。

ツールを削除するには、リストから選択して削除を押します。組み込みツールは削除できません。自分で作成したツールだけ削除できます。

#### 変数

コマンドを定義するためのコマンド欄では、次の変数を使用できます。

- 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

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

ファイル参照ペイン・プラグインは、ファイルやフォルダをサイドペインに表示し、素早くファイルを開けるようにします。

ファイルブラウザを表示するには、表示サイドペインを選択し、サイドペインの下端にある「ファイルブラウザ」アイコン表示のタブをクリックします。

#### ファイルをブラウズする

ファイルブラウザー・タブは、最初ファイルマネージャのブックマークを表示します。内容を見るには、各アイテムをダブルクリックします。

親フォルダーを表示するには、ドロップダウンリストから選択するか、ファイルブラウザのツールバーの中にある ↑ を押します。

現在作業している文書を含んだフォルダを表示するには、ファイルリストで右クリックし、文書のルートにするを選択します。

#### ファイルを開くには

Pluma でファイルを開くには、ファイルリストの中にあるファイルをダブルクリックします。

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

ブラウザに表示された現在のフォルダに、新規で空のテキストファイルを作成するには、ファイルリストで右クリックして新規ファイルを選択します。

ブラウザに表示されている現在のフォルダに新しいフォルダを作成するには、そのリスト内で右クリックして新しいフォルダを選択します。

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

インデント行・プラグインは、テキスト行の先頭にスペースを追加または削除します。

テキストのインデントまたはインデント解除は、次の手順を実行します。

1. インデントしようとする行を選択します。１行だけのインデントまたはインデント解除を行うには、その行の任意の場所にカーソルを置きます。

2. - テキストのインデントを設定するには、編集インデントを選択します。

   - インデントを解除するには、編集インデント解除を選択します。

使用するスペースの量、およびタブ文字とスペース文字のどちらを使用するかは、[編集] > [設定] 項目にある Tab Stops の設定によって決まります。を参照してください。

### 日付/時刻を挿入する

日付/時刻の挿入・プラグインは、現在の日付と時刻を文書に挿入します。I日付/時刻の挿入・プラグインを使用するには、次の手順にしたがってください。

1. 編集 日付/時刻の挿入 を選択します。

   日付/時刻の挿入」プラグインで、その形式の設定を確認せずに自動的に挿入するという設定をしていない場合、Pluma は日付/時刻の挿入ダイアログを表示します。一覧から適切な形式を選択してください。日付/時刻の挿入をクリックして挿入ダイアログを閉じます。pluma は、現在カーソルがある位置に日付/時刻を挿入します。

   もし、特定の日付・時刻の形式を使用するように Pluma を設定していた場合には、日付と時刻の挿入ダイアログは表示されません。日付・時刻は、現在カーソルがある位置へ自動的に入力されます。

#### 日付/時刻挿入プラグインを設定する

日付/時刻の挿入というプラグインを設定するには、次の手順にしたがってください。

1. 編集 設定 を選択します。

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

3. 日付/時刻の挿入を選択します。

4. 設定をクリックすると、日付/時刻の挿入ダイアログが表示されます。

5. 次のいずれかのオプションを選択します。

   - 日付/時刻を挿入するたびにその形式を指定するには、書式を毎回指定するというオプションを選択します。

   - 日付/時刻を挿入するたびに、Pluma が提供する同じ日付/時刻フォーマットを使用するには、次の書式を使うというオプションを選択し、一覧から適切な形式を選択してください。このオプションを選択すると、編集日付と時刻の挿入を選択したときに、Pluma はその形式を尋ねるプロンプトを表示しません。

   - 日付／時刻を挿入するたびにカスタマイズした同じ形式を使用するには、次の形式を使うというオプションを選択し、テキストボックスに適切な形式を入力してください。カスタム形式を指定方法の詳細については、strftime 3 を参照してください。このオプションを選択すると、編集日付と時刻の挿入を選択したときに、その入力プロンプトが表示されなくなります。

6. OK をクリックすると、日付/時刻の挿入を設定するダイアログを閉じます。

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

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

モードラインプラグインを使うと、個々の文書に対して設定を行うことができます。モードラインとは、Pluma がその設定を認識できるような、文書の最初または最後に置かれたテキスト行のことです。

モードラインを使った設定は、設定ダイアログで指定した設定よりも優先されます。

モードラインを使うと、次の設定が行えます。

- タブの幅

- インデントの幅

- タブの代わりにスペースを挿入

- テキストの折り返し

- 右側の余白の幅

モードライン・プラグインは、他のテキストエディタ Emacs、Kate、Vim で使用されるオプションのサブセットをサポートしています。

#### Emacs モードライン

文書の最初の 2 行を Emacs のモードラインでスキャンします。

Emacs のオプション、タブ幅、インデントのオフセット、インデントタブモード、オートラップに対応しています。詳しくは、GNU Emacs マニュアルをご覧ください。

#### Kate モードライン

文書の最初と最後の 10 行を Kate のモードラインでスキャンします。

Kate のオプションでは、タブ幅、インデント幅、空白インデント、ワードラップ、コラムに対応しています。詳しくは、Kate のウェブサイトをご覧ください。

#### Vim モードライン

文書の最初と最後の 1 行を Vim のモードラインでスキャンします。

Vim オプションの et、expandtab、ts、tabstop、sw、shiftwidth、wrap、textwidth に対応しています。詳しくは、Vim のウェブサイトをご覧ください。

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

Python コンソール・プラグインは、Python プログラム言語のコマンドを Pluma から実行できるようにするプラグインです。プラグインを有効にすると、下端のペインにタブが追加されます。ここに、最近の出力とコマンドプロンプトの入力欄を表示します。

Python コンソールに入力されたコマンドは、実行される前にチェックされません。そのため、無限ループに入るなどして、Pluma をハングアップさせる可能があります。

### 末尾のスペースを削除して保存

末尾のスペースを削除して保存というプラグインは、スペース（`˽`）、タブ（`\t`）、キャリッジリターン（`\r`）などの空白文字を行末から取り除きます。このプラグインを使うには、次の手順を実行してください。

1. で説明されているプラグインを有効にします。

2. 文書の準備ができたら、保存してください。

3. 文書が保存された後には、末尾のホワイトスペースがすべて取り除かれているのが分かります。

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

スニペット・プラグインは、よく使う短い文字列をスニペットと呼んで保存し、文書に素早く挿入することができます。

スニペットは、現在の文書の言語構文に特化しています。例えば、HTMLドキュメントを扱っているときは、HTMLに役立つスニペットの一覧から選ぶことができます。さらに、いくつかのスニペットはグローバルなので、その場合はすべての文書で利用できます。

Pluma には多数のスニペットコードが組み込まれていて、それは変更することが可能です。

#### スニペットを挿入する

スニペットを文書に挿入するには、そのスニペットのタブトリガーを入力し、Tab キーを押します。スニペットのタブトリガーは、通常、スニペットの最初の数文字や、短くて覚えやすいようなものです。

また、Ctrl Space を押すと、挿入可能なスニペット一覧を表示します。

#### スニペットを追加する

新しいスニペットを作るには、次のようにします。

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

2. スニペットのリストは、言語ごとにグループ化されています。追加したい言語、または言語グループのスニペットを選択してください。スニペットをすべての言語へ追加するには、リストの一番上にある「グローバル」を選択します。既定では、現在作業している文書の構文が表示されます。

3. 新規をクリックします。新しいスニペットがリストに表示されます。

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

   名前

     スニペット・リストのテキスト入力枠に、スニペットの名前を入力します。スニペットの名前は、その目的を思い起こさせてくれるだけの役割を担います。作成したスニペットの名前は、リスト内でそのスニペットをクリックすれば変更できます。

   スニペットの文字列

     スニペットの編集テキストボックスに文字列を入力します。使用できる特別なコードについては、をご覧ください。

     スニペットの管理ウィンドウを閉じずに、文書ウィンドウに戻ってテキストをコピーすることができます。

   タブトリガー

     スニペットのタブトリガーを入力します。これは、Tab キーを押してスニペットを挿入する前に入力する、文字列のことです。

     タグは、文字だけで構成された１個の単語か、または任意の１つの文字でなければなりません。無効な入力がされると、タブトリガーは赤色で強調表示されます。

   ショートカット・キー

     スニペットを挿入するときに使うショートカット・キーを入力します。

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

スニペットを編集するには、リストでスニペットを選択し、その文字列とアクティベーションのプロパティを変更します。

スニペットの名前を変更するには、リストでそれを再度クリックします。

変更した組み込みスニペットを元に戻すには、復元を押します。

スニペットを削除するには、リストから選択して削除を押します。組み込みスニペットは削除できません。自分で作成したスニペットだけ削除できます。

#### スニペットの置換

スニペットには、保存されたテキストの挿入に加えて、カスタマイズ可能なテキストや、一度スニペットを文書に挿入した後ではテキストを追加できるマークスペースを含めることもできます。

スニペットテキストには、次のプレースホルダコードを使用できます。

タブのプレースホルダ

  `$n` はタブのプレースホルダを定義します。`n` は 1 以上の任意の数字で構いません。

  `${n:default}` はタブのプレースホルダを既定値で定義します。

  タブのプレースホルダは、スニペットが挿入された後で、テキストの追加が可能なスニペットテキスト内の場所を示します。

  タブのプレースホルダを使用するには、通常どおりにスニペットを挿入します。カーソルは最初のタブのプレースホルダに置かれます。テキストを入力し、タブを押して次のタブのプレースホルダに進みます。プレースホルダコード内の番号は、タブがテキスト内の各場所へ移動する順序を定義します。

  Press Shift Tab to return to the previous tab placeholder. Pressing Tab when there are no more tab placeholders moves the cursor to the end of the snippet text, or to the end placeholder if it exists.

Mirror placeholders

  A repeated tab placeholder will mirror the placeholder already defined. This allows you to type in text only once that you want to appear several times in the snippet.

End placeholder

  `$0` defines the end placeholder. This allows you to finish working with the snippet with the cursor at a point other than the end of the snippet text.

Environmental variables

  Environmental variable such as `$PATH` and `$HOME` are substituted in snippet text. The following variables specific to pluma can also be used:

  $PLUMA_SELECTED_TEXT

    The currently selected text.

  $PLUMA_FILENAME

    The full filename of the document, or an empty string if the document isn't saved yet.

  $PLUMA_BASENAME

    The basename of the filename of the document, or an empty string if the document isn't saved yet.

  $PLUMA_CURRENT_WORD

    The word at the cursor's location in the document. When this variable is used, the current word will be replaced by the snippet text.

Shell placeholders

  `$(cmd)` is replaced by the result of executing cmd in a shell.

  `$(n:cmd)` allows you to give this placeholder a reference, where n is any number from 1 upwards. Use `$n` to use the output from one shell placeholder as input in another.

Python placeholders

  `$<cmd>` is replaced by the result of evaluating cmd in the python interpreter.

  `$<a:cmd>` specifies another python placeholder as a dependency, where a gives its order in the snippet. This allows you to use python functions defined in another snippet. To specify several dependencies, separate the numbers with commas thus: `$<a,b:cmd>`

  To use a variable in all other python snippets, declare it as `global`.

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

並び替えプラグインは、選択した行のテキストをアルファベット順に並べます。

並び替えプラグインを使用するには、次の手順に従ってください。

1. 並べ替えたいテキストの行を選択します。

2. 編集 並び替え を選択します。並び替えダイアログが開きます。

3. 並べ替えで利用するオプションを選択します。

   - テキストを逆に並べる場合は、逆順にするを選択します。

   - 重複している行を削除するには、重複する部分を削除するを選択します。

   - 大文字と小文字の区別を無視するには、大／小文字の区別しないを選択します。

   - 冒頭の行の文字を無視して並び替えるには、最初に並び替える文字を開始行のスピンボックスで設定してください。

4. 並び替えを行うには、並び替えをクリックします。

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

スペルチェッカー・プラグインは、選択されたテキストのつづりが正しいか確認します。Pluma では、指定の言語で自動的にチェックを行うように設定することも、手動で行うように設定することもできます。言語の設定とつづりの自動チェックのプロパティは、文書ごとに適用されます。このプラグインを使うには、次の手順にしたがってください。

1. ツール 言語の設定を選択すると、言語の設定ダイアログが表示されます。一覧から適切な言語を選択してください。OK をクリックすれば、 言語設定 ダイアログが閉じます。

2. スペルを自動的にチェックするには、ツール自動スペルチェックを選択します。自動スペルチェックの設定を解除するには、もう一度ツール自動スペルチェックを選択します。これが設定されていると、自動スペルチェックメニュー項目の横にアイコンが表示されます。既定では、Pluma を起動するたびに、この設定は解除されます。

   不明なつづりは異なる色で表示され、下線が引かれます。不明なつづりの上で右クリックして、ポップアップメニューからスペルの提案を選択してください。

   - 不明なつづりを一覧にある別のものに置き換えるには、スペルの提示ポップアップメニューで置き換えたいつづりを選択してください。

   - 不明なつづりをご自分の辞書に追加するには、スペルの提案追加を選択してください。

   - 不明なつづりの箇所すべてを無視して、未知のフラグを立てず、個人辞書にも追加しないようにするには、スペルの提案すべて無視を選択してください。不明な単語は、現在の Pluma セッションでだけ無視されます。

3. 手動でスペルチェックを行いたいときは、ツールスペルチェックを選択します。

   つづり間違いがない場合、情報ダイアログに「文書にはスペルミスのある単語がありません」というメッセージが表示されます。OKをクリックして情報ダイアログを閉じてください。

   もしつづりの間違いがあった場合、スペルチェックダイアログが表示されます。

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

   - 変更先テキストボックスに修正候補のスペルが表示されます。正解の候補リストからスペルを選択することにより、これを別の修正候補と置き換えることができます。あるいは、変更先テキストボックスへ直接文字を入力することもできます。

   - 変更先テキストボックス内にあるテキストのスペルをチェックするには、単語のチェックをクリックします。既知の単語である場合は、正解の候補リストがテキスト `(正しいスペル)` に置き換えられます。単語が不明な場合は、正解の候補リストに新しい候補が表示されます。

   - 今現在見つかった不明な単語を無視するには、無視をクリックします。不明な単語すべての発見箇所を無視するには、すべて無視をクリックします。不明な単語は、現在の Plume セッションでだけ無視されます。

   - 今見つかった不明な単語だけを変更先テキストボックス内のテキストに変更するには、変更をクリックします。不明な単語の箇所すべてを変更先テキストボックス内のテキストに変更するには、すべて変更をクリックします。

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

   - スペルチェックダイアログを閉じるには、閉じるをクリックします。

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

タグの一覧というプラグインを使うと、共通のタグをリストからサイドペインに挿入することができます。

タグの一覧プラグインを使うには、次の手順にしたがってください。

1. 表示 サイドペイン .を選択してください。

2. 既定では、サイドペインには、開いている文書の一覧を含むタブが表示されています。サイドペインの最下部に表示される＋アイコンのタブをクリックすると、タグリストが表示されます。

3. ドロップダウンリストの中から適切なタグカテゴリーを選択してください。例えば、HTML - タグ などです。

4. タグリストをスクロールして、必要なタグを探してください。

5. 現在カーソルがある位置にタグを挿入するには、タグリスト内のタグをダブルクリックします。また、次のようにしてタグを挿入することもできます。

   - 現在のファイルにタグを挿入し、サイドペインから表示領域にフォーカスを移すには、Return を押します。

   - 現在のファイルにタグを挿入し、タグの一覧プラグイン・ウィンドウのフォーカスを維持するには、Shift Return を押します。