■慣用語句ファイルフォーマット

　１つの慣用語句集は、ここで説明する書式で記述されたテキストファイルに 格納されます。このファイルのファイル名は任意ですが、拡張子名は、通常、 .ptx にしておきます。

　慣用語句集のテキストは、１つの「タイトル規定行」と、１つ以上の「項目規定部」 から、構成されます。この両者の間には、空行があっても構いません。また、所定の 書式に合致しない部分は読み飛ばされます。その場合、特にエラーメッセージは、 表示されません。

●タイトル規定行

　タイトル規定行は、慣用語句集の「タイトル名」を規定します。これは、 「Title:」から始まる１行で、次のような書式になります。

Title:　〈タイトル名〉　〈ソートキー〉

• 「Title:」は、必ず行頭にします。
• 「Title:」と〈タイトル名〉の間には、１個以上のTAB を入れます。
• 〈タイトル名〉には、TAB と改行以外の任意の文字が使用できます。
• 〈ソートキー〉 は、12 文字まで有効で、TAB と改行以外の任意の文字が使用できます。
• 〈タイトル名〉と〈ソートキー〉の間には、１個以上の TAB を入れます。
• 「慣用語句一覧ダイアログボックス」内の「分類」コンボボックスの ドロップダウンリストには、各タイトル名が、〈ソートキー〉の順に表示されます。

●項目規定部

　項目規定部は、慣用語句集内の各項目の「項目名」とその内容を指定します。 これは、「Item:」から始まり、Form Feed コード（ 0x0C ）で終る部分で、 次のような書式になります。

Item: 〈項目名〉 〈オプション〉
〈入力テキスト〉〈FF〉

• 「Item:」は、必ず行頭にします。
• 「Item:」と〈項目名〉の間には、１個上の TAB を入れます。
• 〈項目名〉には、TAB と改行以外の任意の文字が使用できます。
• 〈項目名〉と〈オプション〉の間には、１個以上のTAB を入れます。
• 〈オプション〉は、省略可能ですが、指定する場合は、必ず、- で始めて、 英字を１字以上記入します。ここで意味のある英字は、次の通りです。

  b	〈入力テキスト〉を矩形状（ボックス状）に挿入します。 この指定時、-i オプションは無効です。
  i	〈入力テキスト〉内の改行コードで自動インデントします。
  s	〈入力テキスト〉で選択範囲を囲みます。この詳細は、後述します。
  t	挿入後のカーソル位置を挿入部の先頭にします。 この指定がなければ、挿入部の末尾になります。
  x	メタ文字 \ を無効にします。この指定がなければ、 メタ文字 \ は有効です。このメタ文字の詳細は、後述します。

• 〈オプション〉と〈入力テキスト〉は、必ず改行で区切ります。
• 〈入力テキスト〉は、必ず行頭から始めます。この部分は、 Form Feed コード以外の任意の文字が使用できます。 もし、Form Feed コードを入力したい場合は、エスケープ文字にします。
• 〈FF〉は、Form Feed コード（ 0x0C ）です。初期環境では、このコードは、 Ctrl+L で入力できます。また、このコードは、半角の塗り潰し矩形内に 白抜きの L で表示されます。
• -s オプションに関して
  • ・囲いの前半と後半は、〈入力テキスト〉 内の \@ の前後で区切られます。
  • ・-s 指定時、-i と -b の指定は無効です。
  • ・矩形と行の範囲選択時は、その各行ごとに、選択範囲が囲われます。
  • ・選択範囲が無い時に実行した場合、通常の挿入と同じです。
• 〈入力テキスト〉内のメタ文字 \ は、次のエスケープ文字の表記に使います。

  \t	水平タブコード（ \x09 ）
  \n	改行コード（ CR/LF, LF, CR のどれか、現改行種別に依存 ）
  \r	キャリッジリターンコード（ \x0D ）
  \v	垂直タブコード（ \x0B ）
  \f	フォームフィードコード（ \x0C ）
  \e	エスケープコード（ \x1B ）
  \\	\ 自身
  \xnn	ASCII コード（ nn は 1〜2 桁 の16進数 ）
  \unnnn	UTF-16 ユニコード（ nnnn は 1〜4 桁 の16進数 ）
  \Unnnnnn	UTF-32 ユニコード（ nnnnnn は 1〜6 桁 の16進数 ）

• 〈入力テキスト〉内のメタ文字 \ は、 次のような特別な機能があります。

  \@	入力テキストの挿入後、この位置にカーソルが来ます。 この \@ は、入力テキストには含まれません。
  \+	入力テキストの挿入時、この部分は、その時点でのクリップボードのテキストに 置き換えられます。

• 〈入力テキスト〉内のメタ文字 \ に続く {〜} の部分は、 特別な文字列に置き換えられます。これには、次のものがあります。

  \{path}	現編集ファイルのフルパス
  \{dir}	現編集ファイルのフォルダのフルパス
  \{file}	現編集ファイルのファイル名
  \{mfn}	現編集ファイルの拡張子部を除いたファイル名部
  \{ext}	現編集ファイルの拡張子名
  \{time "..."}	現在の日時（ ... は次の変換を伴う書式指定 ）

  %a 曜日（ 日 月 ・・・ 土 ） %d 日２桁（ 01 〜 31 ） %H 時２桁（ 00 〜 23 ） 24時間時計 %I 時２桁（ 01 〜 12 ） 12時間時計 %m 月２桁（ 01 〜 12 ） %M 分２桁（ 00 〜 59 ） %p AM or PM %S 秒２桁（ 00 〜 59 ） %y 西暦年２桁（ 例：05 ） %Y 西暦年４桁（ 例：2005 ） %% % 自身 　　なお、\{time} だけの場合、書式は「%Y.%m.%d %H:%M:%S」になります。

  \{ask "〈プロンプト〉", "〈初期入力文字列〉"}

  この部分があると、その慣用語句の入力時に、まず、文字列入力の ダイアログボックスが表示されます。そこで入力した文字列が この部分と置き換えられます。 　〈プロンプト〉は、そのダイアログボックス内の文字列入力ボックスの ラベルとして表示されます。"〈プロンプト〉" が省略された場合、 そのラベルには、「入力文字列：」が表示されます。 　〈初期入力文字列〉は、そのダイアログボックス内の文字列入力ボックスに 最初に入力されている文字列です。"〈初期入力文字列〉" が省略された場合、 そこは、空文字列になります。 　なお、このダイアログボックスの入力では、 エスケープ文字（ \t, \n 等 ）が使えます。これによって、 タブや改行コードの制御コード等を入力できます。

• 〈入力テキスト〉内で、メタ文字 \ の次が改行コードの場合、その部分は、 読み飛ばされて、入力テキストには含まれません。この表記を使うと、 〈入力テキスト〉に改行コードが含まれない長い文字列を記述する場合、 任意の箇所で、行を折り返せるので、見易くできます。