3.9 KiB
3.9 KiB
一个私人的维基——vim插件
这是http://www.vim.org/scripts/script.php?script_id=2226 的一个镜像。
在http://code.google.com/p/vimwiki/ 有部分截图文件。 如果你不喜欢vimball,你也可以在那里找到zip的打包文件。
在安装之前,你需要做的
确定在vimrc
中,你的设置是这样的。
set nocompatible
filetype plugin on
syntax on
如果没有他们,Vimwiki将无法正常工作。
介绍
Vimwiki是私人维基的vim插件 -- 许多有自己代码高亮的text文件。
通过vimwiki,你可以:
- 组织笔记和想法
- 制作代办事项表
- 写文档
一个快速的开始,通常使用<Leader>ww
(一般是'\ww'),然后创建你的index wiki文件。
通常,它在:
~/vimwiki/index.wiki
在这个文件,输入如下的例子:
= My knowledge base =
* Tasks -- things to be done _yesterday_!!!
* Project Gutenberg -- good books are power.
* Scratchpad -- various temporary stuff.
将你的光标放到'Tasks'(任务)上,并且按回车键去创建一个链接。一旦按下,'Task'将会 变成'Tasks' -- 一个vimwiki的链接。再按一次回车去打开它。编辑文件,保存它, 然后按backspace来返回你的index。
一个vimwiki链接可以一句话创建。只需要通过选择visual模式选择这个句子,然后按回车。 你可以通过选择'Project Gutenberg'来尝试。结果像是这个样子:
= My knowledge base =
* [[Tasks]] -- things to be done _yesterday_!!!
* [[Project Gutenberg]] -- good books are power.
* Scratchpad -- various temporary stuff.
更多的选项,请用:h vimwiki-options
来查看。
基本标记
查看:h vimwiki-syntax
*bold* -- bold
_italic_ -- italic
[[wiki link]] -- link with spaces
[[wiki link|description]] -- link with description
列表:
* 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
1. numbered list item 1
2. numbered list item 2
a) numbered list item 3
b) numbered list item 4
= Header1 =
== Header2 ==
=== Header3 ===
键位绑定
查看:h vimwiki-mappings
normal 模式:
<Leader>ww
-- 打开默认的wiki index文件<Leader>wt
-- 通过tab实现上一个功能<Leader>ws
-- 选择并且打开index文件<Leader>wd
-- 删除进入的wiki文件<Leader>wr
-- 重命名你进入的wiki文件<Enter>
-- 进入/创建 wiki 链接<Shift-Enter>
-- 通过分屏模式sp,进入/创建wiki链接<Ctrl-Enter>
-- 通过分屏模式vs,进入/创建wiki链接<Backspace>
-- 返回父节点<Tab>
-- 寻找下一个wiki链接<Shift-Tab>
-- 寻找上一个wiki链接
命令
:Vimwiki2HTML
-- 转换当前wiki成为html:VimwikiAll2HTML
-- 转化你的全部wiki到html:help vimwiki-commands
-- 显示全部命令
安装细节
使用 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
然后启动vim,使用:Helptags
然后 :help vimwiki
来确保他已经被安装了。