Bram Moolenaar | badce65 | 2008-06-25 00:29:54 +0000 | [diff] [blame] | 1 | Tutor is a "hands on" tutorial for new users of the Vim editor. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 2 | |
Bram Moolenaar | badce65 | 2008-06-25 00:29:54 +0000 | [diff] [blame] | 3 | Most new users can get through it in less than one hour. The result |
| 4 | is that you can do a simple editing task using the Vim editor. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 5 | |
Bram Moolenaar | badce65 | 2008-06-25 00:29:54 +0000 | [diff] [blame] | 6 | Tutor is a file that contains the tutorial lessons. You can simply |
RestorerZ | 6fa304f | 2024-12-02 20:19:52 +0100 | [diff] [blame] | 7 | execute "vim tutor1" and then follow the instructions in the lessons. |
Bram Moolenaar | badce65 | 2008-06-25 00:29:54 +0000 | [diff] [blame] | 8 | The lessons tell you to modify the file, so DON'T DO THIS ON YOUR |
| 9 | ORIGINAL COPY. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 10 | |
RestorerZ | 6fa304f | 2024-12-02 20:19:52 +0100 | [diff] [blame] | 11 | On UNIX-like systems you can also use the "vimtutor" program. |
| 12 | It will make a scratch copy of the tutor first. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 13 | |
Bram Moolenaar | badce65 | 2008-06-25 00:29:54 +0000 | [diff] [blame] | 14 | I have considered adding more advanced lessons but have not found the |
| 15 | time. Please let me know how you like it and send any improvements you |
| 16 | make. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 17 | |
Bram Moolenaar | badce65 | 2008-06-25 00:29:54 +0000 | [diff] [blame] | 18 | Bob Ware, Colorado School of Mines, Golden, Co 80401, USA |
| 19 | (303) 273-3987 |
| 20 | bware@mines.colorado.edu bware@slate.mines.colorado.edu bware@mines.bitnet |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 21 | |
RestorerZ | 6fa304f | 2024-12-02 20:19:52 +0100 | [diff] [blame] | 22 | All of the above regarding chapter one of the tutorial also applies to chapter |
| 23 | two of the tutorial. Except that you must use the command “vim tutor2” to open |
| 24 | chapter two. |
| 25 | |
| 26 | The chapter two of the tutorial was written by Paul D. Parker. |
Bram Moolenaar | a9604e6 | 2018-07-21 05:56:22 +0200 | [diff] [blame] | 27 | |
| 28 | Translation |
| 29 | ----------- |
RestorerZ | 6fa304f | 2024-12-02 20:19:52 +0100 | [diff] [blame] | 30 | The files tutor1.xx and tutor1.xx.utf-8 for chapter one and tutor2.xx and |
| 31 | tutor2.xx.utf-8 for chapter two of the tutorial are translated files (where xx |
| 32 | is the language code). |
| 33 | The encoding of tutor1.xx or tutor2.xx might be latin1 or other traditional |
Bram Moolenaar | a9604e6 | 2018-07-21 05:56:22 +0200 | [diff] [blame] | 34 | encoding. If you don't need a translation with such traditional encoding, |
RestorerZ | 6fa304f | 2024-12-02 20:19:52 +0100 | [diff] [blame] | 35 | you just need to prepare the tutor1.xx.utf-8 or tutor2.xx.utf-8 file. |
| 36 | If you need another encoding, you can also prepare a file named tutor1.xx.enc or |
| 37 | tutor2.xx.enc (replace enc with the actual encoding name). You might also need |
| 38 | to adjust the tutor.vim file. |
| 39 | The "make" command can be used for creating tutor1.xx or tutor2.xx from |
| 40 | tutor.xx.utf-8 or tutor2.xx.utf-8, respectively. |
| 41 | See the Makefile for detail. (For some languages, tutor1.xx.utf-8 is created |
| 42 | from tutor1.xx for historical reasons.) |
Bram Moolenaar | a9604e6 | 2018-07-21 05:56:22 +0200 | [diff] [blame] | 43 | |
| 44 | [This file was modified for Vim by Bram Moolenaar et al.] |