iggredible/learn-vim

This repository is a free book called Learn Vim (the Smart Way). Vim is a keyboard-driven text editor with a steep learning curve, and the author Igor Irianto wrote this guide to teach the parts of Vim that are actually worth learning. The README explains the gap it tries to fill: the built-in vimtutor program is too short, the official help manual is too dense, and most readers want something in between. The book is aimed at both beginners and experienced Vim users. It starts with broad, simple ideas and works up to more specialised topics. The author says even experienced users may find something new by reading it from the start. You can read it on GitHub by clicking the chapter links in the README, but you can also read it locally as a styled book using Docker. The README gives a single docker compose command that builds and serves the book at http://localhost:8080. The project is free, but the author offers two optional ways to support it: buying the book on Leanpub or sending a tip through Buy Me a Coffee. The table of contents is in the README. Part 1, called Learn Vim the Smart Way, is the core editor course: starting Vim, buffers and windows and tabs, opening and searching files, the grammar of Vim commands, moving inside a file, insert mode, the dot repeat command, registers, macros, undo, visual mode, search and substitute, the global command, running external commands from inside Vim, command-line mode, tags, folding, Git, compiling, views and sessions, and operations across multiple files. Part 2 is about customisation: the vimrc config file, package management, and the runtime directory. Part 3 covers Vimscript, the editor's built-in scripting language, including data types, conditionals and loops, variable scopes, functions, and a worked example of writing a small plugin that converts text to title case. The README also lists community translations: a Chinese version on wsdjeg.net and a Spanish fork on GitHub. Material is copyright Igor Irianto, 2020 to 2021, and licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0, which means you can share and adapt it freely as long as you credit the author, do not sell it, and release derivatives under the same license.