pi_tutor.txt 1.8 KB

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