adambard/learnxinyminutes-docs
1
1
Fork 0
mirror of https://github.com/adambard/learnxinyminutes-docs.git synced 2024-12-27 01:03:19 +03:00
Code Issues Projects Releases Wiki Activity

Merge pull request #2979 from Kyle-Mendes/vim-help-docs

Browse Source 
[vim/en] Vim help docs
This commit is contained in:
Andre Polykanine A.K.A. Menelion Elensúlë 2017-10-28 17:51:57 +03:00 committed by GitHub
commit c5ea4e4095
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 26 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
vim.html.markdown
View File

@ -8,15 +8,16 @@ filename: LearnVim.txt
[Vim](http://www.vim.org) [Vim](http://www.vim.org)
(Vi IMproved) is a clone of the popular vi editor for Unix. It is a text (Vi IMproved) is a clone of the popular vi editor for Unix. It is a text
editor designed for speed and increased productivity, and is ubiquitous in most editor designed for speed and increased productivity, and is ubiquitous in most
unix-based systems. It has numerous keybindings for speedy navigation to unix-based systems. It has numerous keybindings for speedy navigation to
specific points in the file, and for fast editing. specific points in the file, and for fast editing.
## Basics of navigating Vim ## Basics of navigating Vim
``` ```
vim <filename> # Open <filename> in vim vim <filename> # Open <filename> in vim
:help <topic> # Open up built-in help docs about <topic> if any exists
:q # Quit vim :q # Quit vim
:w # Save current file :w # Save current file
:wq # Save file and quit vim :wq # Save file and quit vim
@ -51,12 +52,12 @@ specific points in the file, and for fast editing.
# Jumping to characters # Jumping to characters
f<character> # Jump forward and land on <character> f<character> # Jump forward and land on <character>
t<character> # Jump forward and land right before <character> t<character> # Jump forward and land right before <character>
# For example, # For example,
f< # Jump forward and land on < f< # Jump forward and land on <
t< # Jump forward and land right before < t< # Jump forward and land right before <
# Moving by word # Moving by word
w # Move forward by one word w # Move forward by one word
@ -73,19 +74,28 @@ specific points in the file, and for fast editing.
L # Move to the bottom of the screen L # Move to the bottom of the screen
``` ```
## Help docs:
Vim has built in help documentation that can accessed with `:help <topic>`.
For example `:help navigation` will pull up documentation about how to navigate
your workspace!
`:help` can also be used without an option. This will bring up a default help dialog
that aims to make getting started with vim more approachable!
## Modes: ## Modes:
Vim is based on the concept on **modes**. Vim is based on the concept on **modes**.
Command Mode - vim starts up in this mode, used to navigate and write commands Command Mode - vim starts up in this mode, used to navigate and write commands
Insert Mode - used to make changes in your file Insert Mode - used to make changes in your file
Visual Mode - used to highlight text and do operations to them Visual Mode - used to highlight text and do operations to them
Ex Mode - used to drop down to the bottom with the ':' prompt to enter commands Ex Mode - used to drop down to the bottom with the ':' prompt to enter commands
``` ```
i # Puts vim into insert mode, before the cursor position i # Puts vim into insert mode, before the cursor position
a # Puts vim into insert mode, after the cursor position a # Puts vim into insert mode, after the cursor position
v # Puts vim into visual mode v # Puts vim into visual mode
: # Puts vim into ex mode : # Puts vim into ex mode
<esc> # 'Escapes' from whichever mode you're in, into Command mode <esc> # 'Escapes' from whichever mode you're in, into Command mode
@ -102,18 +112,18 @@ Ex Mode - used to drop down to the bottom with the ':' prompt to enter comm
## The 'Grammar' of vim ## The 'Grammar' of vim
Vim can be thought of as a set of commands in a Vim can be thought of as a set of commands in a
'Verb-Modifier-Noun' format, where: 'Verb-Modifier-Noun' format, where:
Verb - your action Verb - your action
Modifier - how you're doing your action Modifier - how you're doing your action
Noun - the object on which your action acts on Noun - the object on which your action acts on
A few important examples of 'Verbs', 'Modifiers', and 'Nouns': A few important examples of 'Verbs', 'Modifiers', and 'Nouns':
``` ```
# 'Verbs' # 'Verbs'
d # Delete d # Delete
c # Change c # Change
y # Yank (copy) y # Yank (copy)
@ -135,7 +145,7 @@ A few important examples of 'Verbs', 'Modifiers', and 'Nouns':
s # Sentence s # Sentence
p # Paragraph p # Paragraph
b # Block b # Block
# Sample 'sentences' or commands # Sample 'sentences' or commands
d2w # Delete 2 words d2w # Delete 2 words
@ -180,7 +190,7 @@ Here's a sample ~/.vimrc file:
``` ```
" Example ~/.vimrc " Example ~/.vimrc
" 2015.10 " 2015.10
" Required for vim to be iMproved " Required for vim to be iMproved
set nocompatible set nocompatible