Browse Source

Edit external_editor.rst

Add intro
Tweak text
Add commands for Emacs
Link to the two official external editor plugins
Nathan Lovato 4 years ago
parent
commit
3271002b9e
1 changed files with 21 additions and 6 deletions
  1. 21 6
      tutorials/editor/external_editor.rst

+ 21 - 6
tutorials/editor/external_editor.rst

@@ -3,17 +3,20 @@
 Using an external text editor
 Using an external text editor
 ==============================
 ==============================
 
 
+This page explains how to code using an external text editor.
+
 .. warning::
 .. warning::
 
 
-    `External editors are currently incompatible with Godot's "Sync Script Changes" feature. <https://github.com/godotengine/godot/issues/10946>`__
+    `External editors are currently incompatible with Godot's "Sync Script
+    Changes" feature. <https://github.com/godotengine/godot/issues/10946>`__
 
 
-Godot can be used with an external text editor, such as Sublime Text or Visual Studio Code.
-To enable an external text editor, browse to the relevant editor settings via:
-``Editor -> Editor Settings -> Text Editor -> External``
+Godot can be used with an external text editor, such as Sublime Text or Visual
+Studio Code. Browse to the relevant editor settings: ``Editor -> Editor Settings
+-> Text Editor -> External``
 
 
 .. image:: img/editor_settings.png
 .. image:: img/editor_settings.png
 
 
-There are two fields: the executable path and command line flags. The flags
+There are two fields: the executable path and command-line flags. The flags
 allow you to integrate the editor with Godot, passing it the file path to open
 allow you to integrate the editor with Godot, passing it the file path to open
 and other relevant arguments. Godot will replace the following placeholders in
 and other relevant arguments. Godot will replace the following placeholders in
 the flags string:
 the flags string:
@@ -45,5 +48,17 @@ Some example Exec Flags for various editors include:
 +---------------------+-----------------------------------------------------+
 +---------------------+-----------------------------------------------------+
 | Vim (gVim)          | ``"+call cursor({line}, {col})" {file}``            |
 | Vim (gVim)          | ``"+call cursor({line}, {col})" {file}``            |
 +---------------------+-----------------------------------------------------+
 +---------------------+-----------------------------------------------------+
+| Emacs               | ``emacs +{line}:{col} {file}``                      |
++---------------------+-----------------------------------------------------+
+
+.. note:: For Visual Studio Code, you will have to point to the ``code.cmd``
+          file. For Emacs, you can call ``emacsclient`` instead of ``emacs`` if
+          you use the server mode.
+
+Official editor plugins
+-----------------------
+
+We have official plugins for the following code editors:
 
 
-.. note:: For Visual Studio Code you will have to point to the ``code.cmd`` file.
+- `Visual Studio Code <https://github.com/godotengine/godot-vscode-plugin>`_
+- `Emacs <https://github.com/godotengine/emacs-gdscript-mode>`_