Reorganize Diviner articles into user/ and tech/
Summary: Ref T988. I'm splitting the Phabricator documentation into two separate documentation books, one less technical and one more technical. Move all the `.diviner` article files around into `src/docs/user/` or `src/docs/tech/`, accordingly. The only actual changes here are a couple of config changes in the `.book` files. Test Plan: Regenerated user and technical documentation and saw stuff in the right places. Reviewers: btrahan Reviewed By: btrahan CC: chad, aran Maniphest Tasks: T988 Differential Revision: https://secure.phabricator.com/D6822
This commit is contained in:
51
src/docs/user/userguide/external_editor.diviner
Normal file
51
src/docs/user/userguide/external_editor.diviner
Normal file
@@ -0,0 +1,51 @@
|
||||
@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 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
|
||||
|
||||
== Configuring: Other Editors ==
|
||||
|
||||
General instructions for configuring some other editors and environments can be
|
||||
found here:
|
||||
|
||||
http://wiki.nette.org/en/howto-editor-link
|
||||
Reference in New Issue
Block a user