他のアプリケーションからTextMateを使用する

シェル/ターミナル

Mac OS Xにはopenが付属します。このシェルコマンドはTerminalからダブルクリックをシミュレートします。引数-aを使うことによって_Open With…_の動作をすることもできます。例えば、open -a TextMate .で現在のフォルダを(まっさらのプロジェクトを)TextMateで開きます。

この標準的なコマンドにはいくつかの欠点があります: 一回に一つのファイルしか開くことができないこと、個別の行のドキュメントを開くことができないこと、ファイルが閉じられるまでシェルを”ストール”させておくことができないことなどです。Subversionのコミットメッセージのようなものを書く際にエディタを使う際に、ストールさせておくと役に立ちます。。

こういうわけで、TextMateにはmateというシェルコマンドが付属します。このコマンドはopenコマンドにとってかわります。使い方は(ターミナルで)mate -hを実行してください。

mateコマンドはTextMateアプリケーションバンドルの中にあります。なので、(”インストール”するよりも)、コマンドに対して、シンボリックリンクを作成することが推奨されます。そうすることで、もしコマンドが将来アップデートされても、アップデートされたコマンドを再インストールする必要がありません。

シンボリックリンクを作成するには、メニューからHelp → Terminal Usage… を選択するか、もしくは、次のようなコマンドをシェルで実行することでできます:

ln -s /Applications/TextMate.app/Contents/Resources/mate ~/bin/mate

これは、あなたがパスに~/binを設定していて、なおかつTextMateが/Applicationsにインストールされていることを前提としてます。

このリンクを作った後、TextMateを他のアプリケーションの外部エディタとして使うためのシェル変数を設定する必要があるでしょう。

一般的な EDITOR 変数

EDITOR変数は、svn(subversoin)やCVSのようなたくさんのシェルコマンドで使われます。TextMateをEDITOR変数のエディタとして使うには、次のようにセットしてください(bashユーザは~/bash_profile、zshユーザは~/zshrcのように):

export EDITOR='mate -w'

TextMateがファイルを閉じるまで、コマンドを再会するのを待たせるために-wを加えました。

EDITOR変数で引数をサポートしないコマンドがあります。それは、crontabです。(crontablaunchdがあるためあまり使われませんが。)もし使う必要があれば、mateに、-wを意味する_waitと追加して、シンボリックリンクを作成することができます。例えば:

ln -s mate ~/bin/mate_wait   # run this once to create the link
export EDITOR='mate_wait'    # use in your ~/.bash_profile

Git エディタ

Gitレポジトリにコミットすると、キャレットが最初の行にないことに気づくかもしれません。

これは、Gitがコミットメッセージに使うテンプラリファイルを再利用して、TextMateが(拡張属性経由で)ファイル毎にキャレットを保存するからです。

Gitエディタをmate -wl1に設定することで、この問題を回避できます。こうして、最後に位置していた場所ではなく、1行目にキャレットが位置していた状態でTextMateはファイルを開きます。

このようにGitを設定するには、GIT_EDITOR変数を設定するかGitのcore.editorの設定変数を指定してください。

TeX エディタ

TeXがファイルに関するエラーメッセージを表示する際、eを押すことで、ファイルを編集(し、エラーを訂正)することができます。

TextMateがこのように使われるように設定するためにはTEXEDIT編集を次のようにしてください:

export TEXEDIT='mate -w -l %d "%s"'

lessでの編集

lessページャーはvを押すことで、そのファイルを編集することができます。TextMateをlessで使うためには、LESSEDIT変数をする必要があります:

export LESSEDIT='mate -l %lm %f'

URLスキーム (HTML)

txmtというURLスキームを使うことによって、例えば、HTMLドキュメント(アンカー)の中にあるハイパーリンク経由でTextMateでファイルを開くことができます。ローカルのファイルを参照できるので次のようなときに役に立ちます:

  1. [HTMLアウトプット][HTMLOutput]と一緒に[コマンド][Commands]を使って、現在のドキュメントエラーや警告を表示するしたり、プロジェクトの他のドキュメントを参照する。

  2. あなたが、同じような(テキスト)ファイルから、1セットのウェブページを生成しているときオリジナルのテキストファイルにリンクを張ることができます。なので、(ブラウザで)生成された結果を調べている時に、txmt:リンクを追っていくことでそれぞれのページのソースをすぐに編集できます。

URLスキームはtxmt:で現在はopenというコマンドを使っています。このコマンドには3つまでの引数を使えます:

  • url — (url=file://~/.bash_profileのような)開く(ファイル)URL。もし設定されてなければ、現在のドキュメントがターゲットになります。

  • line — ファイルが開かれた後に、どのラインにキャレットが置かれるか(例えば、line=11

  • column — ファイルが開かれた後に、どのカラムにキャレットがくるか(例えば、column=3

txmt:のURLの完全な例として、(テストのためにこちらをクリックしてください):

txmt://open/?url=file://~/.bash_profile&line=11&column=2

ODBエディタスイート

TextMateはODBエディタスイートのサーバーサイドを実装しています。このことによって、そのプロトコルのクライアントサイドを実装しているプログラムの外部エディタとして使うことができます。

しかしながら、どのテキストエディタがプロトコルを実装しているをりすとをハードコードしています。よって、もし、ODBエディタスイートをサポートしているアプリケーションの外部エディタのリストにTextMateがない場合は、そのアプリケーションの作者に、サポートされているエディタのリストにTextMateを加えるようにリクエストしないといけないかもしれません。

外部テキストエディタとして設定できるアプリケーションを追跡するwikiページあります。

Cocoaテキストフィールド

TextMateには(Mailで使われているのを含めて)TextMateをスタンダードCocoaテキストエディタコントロールからTextMateを呼び出すことができる、”Edit in TextMate”というインプットマネージャーが含まれます。これは、Safariのフォーム要素のように、ODBエディタスイートを実装しないプログラムで使うときに便利です。

詳しい情報は、(ステータスバーのギアメニューからアクセスできる)TextMateバンドルにある_Install “Edit in TextMate”…_を選択してください。実際にインストールする前に必要なドキュメンテーションをすべて提供します。 [ActivatingBundleItems]: bundles#activation-of-bundle-items [AutoPairs]: working_with_text#auto-paired-characters-quotes-etc [ColumnSelection]: working_with_text#column-selections [Commands]: commands [CompletionsPrefs]: preferences_items#completions [Completions]: working_with_text#completion [CustomizeSymbolList]: navigation_overview#customizing-the-list [DragCommands]: drag_commands [EnvVariables]: environment_variables [ExtendedAttributes]: saving_files#extended-attributes-metadata [Foldings]: navigation_overview#customizing-foldings [FormatStringConditionalInsertion]: regular_expressions#conditional-insertions [FormatString]: regular_expressions#replacement-string-syntax-format-strings [GoToFile]: working_with_multiple_files#moving-between-files-with-grace [HTMLOutput]: commands#html-output [IndentRules]: appendix#indentation-rules [KeyEquivalents]: bundles#key-equivalents [LanguageGrammars]: language_grammars [Macros]: macros [MailingListSearch]: getting_help#mailing-list [NamingConventions]: language_grammars#naming-conventions [PairedCharactersPrefs]: preferences_items#paired-characters [PreferencesItems]: preferences_items [PropertyListFormat]: appendix#property-list-format [RankingMatches]: scope_selectors#ranking-matches [RegularExpressions]: regular_expressions [ReIndentText]: working_with_text#re-indent-text [ScopedEnvVariables]: environment_variables#context-dependent-variables [ScopeSelectors]: scope_selectors [ShellCommands]: shell_commands [Snippets]: snippets [SourceBundle]: bundles#source [TerminalUsage]: using_textmate_from_terminal [TextMateURLScheme]: using_textmate_from_terminal#url-scheme-html [Themes]: themes [LC-CTYPE]: bundles#setting-lc_ctype [SupportFolder]: bundles#support-folder