[Summary view] [Print] [Text view]

   1  @title User Guide: Configuring an External Editor
   2  @group userguide
   3  
   4  Setting up an external editor to integrate with Diffusion and Differential.
   5  
   6  = Overview =
   7  
   8  You can configure a URI handler to allow you to open files from Differential
   9  and Diffusion in your preferred text editor.
  10  
  11  = Configuring Editors =
  12  
  13  To configure an external editor, go to {nav Settings > Application Settings >
  14  Display Preferences} and set "Editor Link" to a URI pattern (see below). This
  15  will enable an "Open in Editor" link in Differential, and an "Edit" button in
  16  Diffusion.
  17  
  18  In general, you'll set this field to something like:
  19  
  20    lang=uri
  21    editor://open/?file=%f
  22  
  23  Some editors support opening multiple files at once when filenames are separated
  24  by spaces. If your editor supports this feature, set "Edit Multiple Files" to
  25  "Supported". Otherwise, you can set it to "Not Supported" to disable "Open All"
  26  buttons in the interface.
  27  
  28  == Configuring: TextMate on OS X ==
  29  
  30  TextMate installs a ##txmt://## handler by default, so it's easy to configure
  31  this feature if you use TextMate.
  32  
  33  First, create a local directory with symlinks for each repository callsign. For
  34  example, if you're developing Phabricator, it might look like this:
  35  
  36    /Users/alincoln/editor_links/ $ ls -l
  37    ... ARC -> /Users/alincoln/workspace/arcanist/
  38    ... P -> /Users/alincoln/workspace/phabricator/
  39    ... PHU -> /Users/alincoln/workspace/libphutil/
  40  
  41  Then set your "Editor Link" to:
  42  
  43    lang=uri
  44    txmt://open/?url=file:///Users/alincoln/editor_links/%r/%f&line=%l
  45  
  46  == Configuring: Other Editors ==
  47  
  48  General instructions for configuring some other editors and environments can be
  49  found here:
  50  
  51  http://wiki.nette.org/en/howto-editor-link