[[PageOutline]]
= File Editing =

== File Editing Software ==
The following are the three most commonly used editors

=== nano ===

nano is the easiest to use editor available on the clusters.

Use the following command to open a file for editing with nano:

{{{ user@host> nano filename }}}

=== vim ===
vim is the improved version of vi with code syntax highlighting and other features useful for programming. This editor has a steep learning curve, but is very efficient.

[[https://vimhelp.org/quickref.txt.html | Vim Quick Reference]]

Use the following command to open a file for editing with vim:

{{{ user@host> vim filename }}}

=== emacs ===
emacs also has code syntax highlighting along with auto-indentation and a whole list of other advanced editing features.

[[http://insti.physics.sunysb.edu/itp/computing/doc/emacs-intro.html|Emacs Reference]]

Use the following command to open a file for editing with emacs:

{{{ user@host> emacs filename }}}

=== GUI Based Editors ===

There are a number of GUI based editors available across platforms (VSCode, gedit, notepad++, sublime text edit just to name a few). The choice of GUI based text editor is a personal one and we offer no opinions on which is best.

That being said, any GUI based editor you use should be able to save files in a clean text format (so Microsoft Word is out).

==== Visual Studio Code====
[https://code.visualstudio.com/ Visual Studio Code], also commonly referred to as VS Code, is a source-code editor developed by Microsoft for Windows, Linux, macOS and web browsers. Features include support for debugging, syntax highlighting, intelligent code completion, snippets, code refactoring, and embedded version control with Git. Users can change the theme, keyboard shortcuts, preferences, and install extensions that add functionality.
* [https://code.visualstudio.com/docs/remote/wsl Windows WSL]

== Exercise ==
[[cypress/FileEditingSoftware/Example|Exercise]]


== Remote Editing with VSCode ==
[[cypress/VScode|Visual Studio Code]]

== Next Section ==
[[cypress/FileTransfer|Transferring Files]]