How to edit files in a terminal with nano?

Question

Sometimes, a graphical text editor like gedit or kate cannot be used (because you're in a virtual console for example). Luckily, there are text editors for the terminal. An easy one is nano, but I cannot understand how to work with it.

If I start nano by running nano, the bottom text is supposed to help me but all I see are things like ^G Get Help ^O WriteOut.

1. How can I open text files for editing?
2. How can I save the file?
3. How can I quit the editor without saving the changes?
4. How to edit? I heard that you've to enter some commands to begin editing in vi, is this true for nano too?
5. Sometimes, if I manage to open a file, the text is unreadable due to its colors. How can I disable these colors? (see the image below)
6. In the some files, lines are truncated because those do not fit in the screen. How can I prevent that from happening? (see the image below)

Answer 1

Ctrl + G will let you read the help. nano can do some pretty nice things so you might want to pootle around in there for a bit.

When you see ^G (et al) it means Ctrl + G. In the help pages, M-H means Alt + H.

How can I open text files for editing?

This is the default in nano. Open and file and you're set to start editing:

nano filename

Note: you won't be able to save unless you have write permissions for that file.

How can I save the file?

F3 will let you save without exiting. Otherwise, Ctrl + X will prompt you if you've made changes. Press Y when it asks, and Enter to confirm the filename.

How can I quit the editor without saving the changes?

Ctrl + X, then N when it asks if you want to save.

How to edit? I heard that you've to enter some commands to begin editing in vi, is this true for nano too?

As above, no. nano is simple. It drops you in edit mode as soon as it opens. You can use arrow keys, Page Up / Page Down and Home / End as in gedit. You cannot use the mouse for moving the cursor position.

Sometimes, if I manage to open a file, the text is unreadable due to its colors. How can I disable these colors?

Colours are loaded through the nanorc framework. These are files that are loaded when nano loads which basically spell out the syntax highlighting. To toggle syntax highlighting, press Alt + Y. To disable it permanently for certain file types, edit /etc/nanorc and put a hash mark (#) before include "/usr/share/nano/*.nanorc".

In the some files, lines are truncated because those do not fit in the screen. How can I prevent that from happening?

Well I've been trying to find something but the best I could see was enabling soft-line-wrap with the funky key-combination of: Alt + $ (Alt + Shift + 4). To enable soft line wrapping by default, add the below line to ~/.nanorc:

set softwrap

More information about this configuration file can be found at man nanorc.

Answer 2

In the bottom text the ^ stands for Ctrl and M- stands for Alt

So^G is Ctrl-G and M-Y is Alt-Y (that one toggles the colors).

You can toggle line truncation with M-$. See the help pages (^G) for more functions.

Answer 3

The combination of ^ and a letter means you're supposed to press Ctrl and that letter. So when nano says ^X Exit that means you're gonna quit naony by pressing Ctrl+X.

1. To open a file called /etc/nanorc you can start nano with:

   nano /etc/nanorc
   

   Note that /etc/groups is not writeable by regular users, therefore you need sudo:

   sudo nano /etc/nanorc
   

   If you've already opened nano, you can press Ctrl+R to open a file.

2. On exit (Ctrl+X) nano will ask you whether to save the file. You can save it manually with F3.
3. Answer n for no in the Ctrl+X dialogue.
4. Basic editing is done by using the arrow keys to navigate and typing. Plain and simple.
5. Syntax highlighting is disabled in a hidden file called .nanorc in your home directory along with other options. Alt+Y toggles it.
6. In the aforementioned .nanorc you can add the line set fill 80 which will break long lines at 80 characters length. Alt+M toggles it.

Here is a list of stettings you can configure in .nanorc.