vimwiki/README-cn.md

129 lines
3.9 KiB
Markdown
Raw Normal View History

2014-11-27 05:45:53 +01:00
一个私人的维基——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`来确保他已经被安装了。