vimwiki

Personal wiki for vim
git clone https://github.com/vimwiki/vimwiki.git
Log | Files | Refs | README | LICENSE

commit aea5b41f449049922a4a96cbe5e3b0f91fe3d6cc
parent d19cc85a71f7080e528f95b4588707dd1be74658
Author: mwcz <mwc@clayto.org>
Date:   Sun, 21 Apr 2013 13:19:46 -0400

update README to markdown format

Diffstat:
DREADME | 112-------------------------------------------------------------------------------
AREADME.md | 129+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 129 insertions(+), 112 deletions(-)

diff --git a/README b/README @@ -1,112 +0,0 @@ -This is a mirror of http://www.vim.org/scripts/script.php?script_id=2226 - -A Personal Wiki For Vim Plugin -============================================================================== -Screenshots are available on http://code.google.com/p/vimwiki/ -There are also zipped vimwiki files there in case you do not like vimball archives. - - -Prerequisites -============================================================================== -Make sure you have these settings in your vimrc file: - -set nocompatible -filetype plugin on -syntax on - -Without them Vimwiki will not work properly. - - -Intro -============================================================================== -Vimwiki is a personal wiki for Vim -- a number of linked text files that have -their own syntax highlighting. - -With vimwiki you can: - - organize notes and ideas; - - manage todo-lists; - - write documentation. - -To do a quick start press <Leader>ww (this is usually \ww) to go to your index -wiki file. By default it is located in: - ~/vimwiki/index.wiki - -Feed it with the following example: - -= My knowledge base = - * Tasks -- things to be done _yesterday_!!! - * Project Gutenberg -- good books are power. - * Scratchpad -- various temporary stuff. - -Place your cursor on 'Tasks' and press Enter to create a link. Once pressed, -'Tasks' will become '[[Tasks]]' -- a vimwiki link. Press Enter again to -open it. Edit the file, save it, and then press Backspace to jump back to your -index. - -A vimwiki link can be constructed from more than one word. Just visually -select the words to be linked and press Enter. Try it with 'Project -Gutenberg'. The result should look something like: - -= My knowledge base = - * [[Tasks]] -- things to be done _yesterday_!!! - * [[Project Gutenberg]] -- good books are power. - * Scratchpad -- various temporary stuff. - - -For the various options see :h vimwiki-options. - - -Basic Markup -============================================================================== -see :h vimwiki-syntax - -*bold* -- bold -_italic_ -- italic - -[[wiki link]] -- link with spaces -[[wiki link|description]] -- link with description - -Lists: -* bullet list item 1 - - bullet list item 2 - - bullet list item 3 - * bullet list item 4 - * bullet list item 5 -* bullet list item 6 -* bullet list item 7 - - bullet list item 8 - - bullet list item 9 - -# numbered list item 1 -# numbered list item 2 - # numbered list item 3 - # numbered list item 4 - -= Header1 = -== Header2 == -=== Header3 === - - -Key bindings -============================================================================== -see :h vimwiki-mappings - -normal mode: -<Leader>ww -- Open default wiki index file. -<Leader>wt -- Open default wiki index file in a new tab. -<Leader>ws -- Select and open wiki index file. -<Leader>wd -- Delete wiki file you are in. -<Leader>wr -- Rename wiki file you are in. -<Enter> -- Folow/Create wiki link -<Shift-Enter> -- Split and folow/create wiki link -<Ctrl-Enter> -- Vertical split and folow/create wiki link -<Backspace> -- Go back to parent(previous) wiki link -<Tab> -- Find next wiki link -<Shift-Tab> -- Find previous wiki link - - -Commands -============================================================================== -:Vimwiki2HTML -- Convert current wiki link to HTML -:VimwikiAll2HTML -- Convert all your wiki links to HTML - diff --git a/README.md b/README.md @@ -0,0 +1,129 @@ +A Personal Wiki For Vim Plugin +============================================================================== + +This is a mirror of http://www.vim.org/scripts/script.php?script_id=2226 + +Screenshots are available on http://code.google.com/p/vimwiki/ +There are also zipped vimwiki files there in case you do not like vimball archives. + + +Prerequisites +============================================================================== + +Make sure you have these settings in your vimrc file: + + set nocompatible + filetype plugin on + syntax on + +Without them Vimwiki will not work properly. + + +Intro +============================================================================== +Vimwiki is a personal wiki for Vim -- a number of linked text files that have +their own syntax highlighting. + +With vimwiki you can: + + * organize notes and ideas; + * manage todo-lists; + * write documentation. + +To do a quick start press <Leader>ww (this is usually \ww) to go to your index +wiki file. By default it is located in: + ~/vimwiki/index.wiki + +Feed it with the following example: + + = My knowledge base = + * Tasks -- things to be done _yesterday_!!! + * Project Gutenberg -- good books are power. + * Scratchpad -- various temporary stuff. + +Place your cursor on 'Tasks' and press Enter to create a link. Once pressed, +'Tasks' will become '[[Tasks]]' -- a vimwiki link. Press Enter again to +open it. Edit the file, save it, and then press Backspace to jump back to your +index. + +A vimwiki link can be constructed from more than one word. Just visually +select the words to be linked and press Enter. Try it with 'Project +Gutenberg'. The result should look something like: + + = My knowledge base = + * [[Tasks]] -- things to be done _yesterday_!!! + * [[Project Gutenberg]] -- good books are power. + * Scratchpad -- various temporary stuff. + +For the various options see `:h vimwiki-options`. + + +Basic Markup +============================================================================== +see `:h vimwiki-syntax` + + *bold* -- bold + _italic_ -- italic + + [[wiki link]] -- link with spaces + [[wiki link|description]] -- link with description + +Lists: + + * bullet list item 1 + - bullet list item 2 + - bullet list item 3 + * bullet list item 4 + * bullet list item 5 + * bullet list item 6 + * bullet list item 7 + - bullet list item 8 + - bullet list item 9 + + # numbered list item 1 + # numbered list item 2 + # numbered list item 3 + # numbered list item 4 + + = Header1 = + == Header2 == + === Header3 === + + +Key bindings +============================================================================== +see `:h vimwiki-mappings` + +normal mode: + + * `<Leader>ww` -- Open default wiki index file. + * `<Leader>wt` -- Open default wiki index file in a new tab. + * `<Leader>ws` -- Select and open wiki index file. + * `<Leader>wd` -- Delete wiki file you are in. + * `<Leader>wr` -- Rename wiki file you are in. + * `<Enter>` -- Folow/Create wiki link + * `<Shift-Enter>` -- Split and folow/create wiki link + * `<Ctrl-Enter>` -- Vertical split and folow/create wiki link + * `<Backspace>` -- Go back to parent(previous) wiki link + * `<Tab>` -- Find next wiki link + * `<Shift-Tab>` -- Find previous wiki link + + +Commands +============================================================================== + + * `:Vimwiki2HTML` -- Convert current wiki link to HTML + * `:VimwikiAll2HTML` -- Convert all your wiki links to HTML + * `:help vimwiki-commands` -- list all commands + +Install details +============================================================================== + +Using pathogen (http://www.vim.org/scripts/script.php?script_id=2332) + + cd ~/.vim + mkdir bundle + cd bundle + git clone git://github.com/vim-scripts/vimwiki.git + +Then launch vim and run `:help vimwiki` to verify it was installed.