blob: 7aaafd19ad850ddd68ae6e0102b9022c60f7021d [file] [log] [blame]
Yegappan Lakshmanana54816b2024-11-03 10:49:23 +01001*pi_tutor.txt* For Vim version 9.1. Last change: 2024 Nov 02
2
3INTERACTIVE TUTORIALS FOR VIM *vim-tutor-mode*
4
5vim-tutor-mode provides a system to follow and create interactive tutorials
6for vim and third party plugins. It replaces the venerable `vimtutor` system.
7
8==============================================================================
91. Usage *vim-tutor-usage*
10
11vim-tutor-mode tutorials are hypertext documents, they have rich text and
12contain links. To stand out from the rest of the text, links are underlined.
13You can follow them by placing the cursor over them and pressing <Enter>, or
14by double-clicking them.
15
161.1 Commands
17------------
18 *:Tutor*
19:Tutor {tutorial} Opens a tutorial. Command-line completion for
20 {tutorial} is provided, the candidates are a list of
21 '.tutor' files found in the 'tutor/' folder in
22 the 'runtimepath'. Tutorials prefixed with 'vim-' will
23 always be shown first.
24
25 If no {tutorial} is provided, the command starts the
26 'vim-01-beginner' tutorial, which is equivalent to
27 Vim's `vimtutor`.
28
29=============================================================================
302. Creating tutorials *vim-tutor-create*
31
32Writing vim-tutor-mode tutorials is easy. For an overview of the format used,
33please consult the 'tutor.tutor' file: >
34
35 :Tutor tutor
36<
37New tutorials must be placed in the 'tutor/' folder in the 'runtimepath'
38to be detected by the :Tutor command.
39
40It is recommended to use a less formal style when writing tutorials than in
41regular documentation (unless the content requires it).
42
43============================================================================
443. Contributing
45
46Development of the plugin is done over at github [1]. Feel free to report
47issues and make suggestions.
48
49[1]: https://github.com/fmoralesc/vim-tutor-mode
50
51" vim: set ft=help :