Merge remote-tracking branch 'Svtter/master' into dev

README-cn.md

@@ -0,0 +1,128 @@
+一个私人的维基——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`来确保他已经被安装了。