mirror of
https://we.phorge.it/source/phorge.git
synced 2025-04-09 19:08:40 +02:00
85d9a009a9
Summary: Fixes T12418. This is a fairly advanced feature and I think users can reasonably consult the documentation for their own editors to figure out how to do this. Test Plan: Saw no more text. Reviewers: chad Reviewed By: chad Maniphest Tasks: T12418 Differential Revision: https://secure.phabricator.com/D17510
44 lines
1.5 KiB
Text
44 lines
1.5 KiB
Text
@title User Guide: Configuring an External Editor
|
|
@group userguide
|
|
|
|
Setting up an external editor to integrate with Diffusion and Differential.
|
|
|
|
= Overview =
|
|
|
|
You can configure a URI handler to allow you to open files from Differential
|
|
and Diffusion in your preferred text editor.
|
|
|
|
= Configuring Editors =
|
|
|
|
To configure an external editor, go to {nav Settings > Application Settings >
|
|
Display Preferences} and set "Editor Link" to a URI pattern (see below). This
|
|
will enable an "Open in Editor" link in Differential, and an "Edit" button in
|
|
Diffusion.
|
|
|
|
In general, you'll set this field to something like:
|
|
|
|
lang=uri
|
|
editor://open/?file=%f
|
|
|
|
Some editors support opening multiple files at once when filenames are separated
|
|
by spaces. If your editor supports this feature, set "Edit Multiple Files" to
|
|
"Supported". Otherwise, you can set it to "Not Supported" to disable "Open All"
|
|
buttons in the interface.
|
|
|
|
== Configuring: TextMate on OS X ==
|
|
|
|
TextMate installs a `txmt://` handler by default, so it's easy to configure
|
|
this feature if you use TextMate.
|
|
|
|
First, create a local directory with symlinks for each repository callsign. For
|
|
example, if you're developing Phabricator, it might look like this:
|
|
|
|
/Users/alincoln/editor_links/ $ ls -l
|
|
... ARC -> /Users/alincoln/workspace/arcanist/
|
|
... P -> /Users/alincoln/workspace/phabricator/
|
|
... PHU -> /Users/alincoln/workspace/libphutil/
|
|
|
|
Then set your "Editor Link" to:
|
|
|
|
lang=uri
|
|
txmt://open/?url=file:///Users/alincoln/editor_links/%r/%f&line=%l
|