Editing Help:Text editor support (section)

====Use It's All Text! to invoke an external editor====
{{outdated}}
When the '''It's All Text!''' Firefox extension has been installed, a little blue edit button appears in the bottom right corner of the text area. Just click the button to open the contents of the text area in your editor.

However, before you can use ''It's All Text!'', you need to specify the path to your editor in the Preferences dialog box. The Preferences dialog opens automatically when you use ''It's All Text!'' for the first time, but you can open it manually as follows: Right click in the text area to open context menu; select "It's All Text" &rarr; "Preferences".

If your editor requires some other command line options in addition to the filename, use a shell script (.sh file in Linux and macOS, or .bat in Windows) to call your editor, and specify path to that script instead of calling your editor directly. In addition, you can add filename extension for wiki file type in Preferences dialog, in case your editor uses file type specific configuration.

Once the above is done, you can edit any text area in your editor by clicking at the Edit button at the lower-right corner of the text area. Alternately, you can right-click on the text area. From the "It's All Text" menu, you can choose which filename extension to use for editing.
Next time you use the blue edit button, the extension is the one you used last time.

After editing, just save the file from your editor. The contents are automatically copied to the text area in Firefox. To indicate this, the text area turns yellow briefly.

A temporary file is created for editing and is removed at the end. So if you want to preserve a text file for later editing, you can change the file name and/or save the file to another directory.

=====Using Vim or another console editor=====
Some macros may work in [[Vim_(text_editor)#Interface|Vim]], but not in [[Vim_(text_editor)#Interface|gVim]] for some reason (e.g., the macro to format text paragraphs). Or you just want to use Vim within an X terminal as you used to do, instead of using gVim. To invoke Vim within an X terminal window, you can write a shell script (see below) to invoke an X terminal and to run the <code>vim</code> command within that X terminal, or generally your preferred editor. Assume that the filename of this script is <code>wiki.edit.vim</code>, and that you put the script in the directory <code>/home_dir/bin/</code> so that the path of the script would be
<code>/home_dir/bin/wiki.edit.vim</code>
Put the above path in the Preferences box (instead of <code>/usr/bin/gvim</code>) of It's All Text. It should work. Note that <code>/home_dir/</code> is the complete path to your home directory from the root (<code>/</code>) directory; don't use <code>~/</code> (tilde) instead of <code>/home_dir/</code>; it won't work.
The listing of the script <code>wiki.edit.vim</code> is given below:
<syntaxhighlight lang="bash">
#!/bin/sh

exec xterm -e ${VISUAL:=vim} "$@"
</syntaxhighlight>
Don't forget to make the file executable with <code>$ chmod +x wiki.edit.vim</code>

=====Using Vim in macOS=====
To get It's All Text to work nicely with Vim in the Mac, you need to install [http://code.google.com/p/macvim/ Macvim]. When MacVim is installed, a script called mvim is also added. You need to tell It's All Text to use this script and not the MacVim.app file. A good place to keep it is in the same folder your MacVim.app file is (Applications by default).