vimwiki/README-cn.md
2014-11-27 12:45:53 +08:00

3.9 KiB
Raw Blame History

一个私人的维基——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来确保他已经被安装了。