MacのCotEditorでUNIXスクリプトを使って作業を自動化する

スクリプトメニュー用のUNIXスクリプトを作成する

CotEditor用のUNIXスクリプトは、実行環境がMacに用意されていればどんなスクリプト言語でも作成できます。ただし、スクリプトファイルは、.sh、.pl、.php、.rb、.py、.js、.awk、または.swiftのいずれかの拡張子を付ける必要があります。

スクリプトを正しく実行するには、使用するインタープリタを指定する#!（shebang）行をスクリプトに含め、スクリプトファイルが実行可能である必要があります。例えば、Macの「ターミナル」でファイルを実行可能ファイルにすることができます。

ファイルパスを参照する

現在の書類が保存済みのときは、その書類の絶対ファイルパスが引数 (argv) としてスクリプトに渡されます。

スクリプトにテキストを渡す

現在の書類の内容を標準入力としてスクリプトに渡すことができます。スクリプトにCotEditorからデータを渡すには、スクリプトの冒頭にコメントを置き、固定テキスト「%%%{CotEditorXInput=xxxx}%%%」を埋め込みます。「xxxx」で、受け渡すデータを指定します。このコメントを記述しなかった場合は「None」と同等の処理となり何もスクリプトに渡されません。

「xxxx」には以下のいずれかの入力元を指定することができます:

スクリプトに渡されるテキストのエンコーディングは、書類のテキストエンコーディングに関わらず常にUTF-8です。

スクリプトの出力を受け取る

スクリプトから標準出力に送ったテキストはCotEditorで受け取り書類などに反映できます。CotEditorでスクリプトの出力を受け取るには、スクリプトの冒頭にコメントとして固定テキスト「%%%{CotEditorXOutput=xxxx}%%%」を埋め込み、「xxxx」で受け取ったあとの処理を指定します。このコメントを記述しなかった場合は「Discard」と同等の処理となり出力は無視されます。

「xxxx」には以下のいずれかの出力先を指定することができます:

スクリプトからCotEditorに返すテキストのエンコーディングは、書類のテキストエンコーディングに関わらず常にUTF-8でなければなりません。

コンソールにテキストを表示する

標準エラー出力に投げられたテキストはコンソールウインドウに出力されます。

スクリプトを書く

例えば、以下のPythonスクリプトは、現在の書類の選択範囲内のすべての行の行頭に「>」を追加し、さらに処理した行数をコンソールに表示します。

#!/usr/bin/env python3
# %%%{CotEditorXInput=Selection}%%%
# %%%{CotEditorXOutput=ReplaceSelection}%%%

import sys

count = 0
for line in sys.stdin:
    count += 1
    print(">" + line.rstrip())
sys.stderr.write("Processed {} lines.".format(count))

このスクリプトをCotEditorのスクリプトメニューから実行すると、以下のメッセージがコンソールに表示されます:

関連項目

• MacのCotEditorの作業をスクリプトで自動化する