[投稿]Pkm工具:Vimwiki

本文作者:Yibie,版权归属「Geek4us」、「学无止境@一点一滴

阅读本文之前,首先你要确保,你会用Vim,懂得配置Vim的配置文件。如果不懂,请上网自行搜索Vim入门教程,已经有很多中文资源,我就不再解释了。

1.0 Vimwiki的安装

1.1 从以下链接中下载Vimwiki插件:

http://www.vim.org/scripts/script.php?script_id=2226

将下载到的vimwiki.vba文件放到vim的安装目录”~\Vim\vim72\plugin”或”~\Vim\vimfiles\plugin”下

用Vim打开vimwiki.vba,然后在”Normal模式”下,输入命令’:so %’,等一会儿,安装将自动完成.

1.2 在Vim的配置文件中添加以下命令:

” vimwiki
let g:vimwiki_use_mouse = 1
let g:vimwiki_list = [{'path': '~/vimwiki/',
\ 'path_html': '~/vimwiki/html/',
\ 'html_header': '~/vimwiki/template/header.tpl',}]

这个命令的目的是,修改你存放Vimwiki文件的地方,否则会默认安装存放在系统盘用户文件夹下(如果是在XP下,应该是在「我的文档」下面;如果是Windows7,则在「用户」这个文件夹下)。

例如:

” vimwiki
let g:vimwiki_use_mouse = 1
let g:vimwiki_list = [{'path': 'E:/vimwiki/', (这个是修改存放Vimwiki文件的地方,Vimwiki的文件后缀为.wiki)
\ 'path_html': 'E:/vimwiki/html/', (这个是修改存放Vimwiki下把wiki文件转换为Html网页的地方)
\ 'html_header': 'E:/vimwiki/template/header.tpl',}] (这个是修改存放Vimwiki转换网页时用的网页模板的地方)

2.0 Vimwiki的使用

2.1 Vimwiki的语法

Vimwiki的下载主页上面给出一个快速学习Vimwiki语法的知识卡片(pdf格式,可通过一些软件转换为图片),从上面便可知道所有的Vimwiki中使用的语法,十分简单,方便使用.

PDF地址:http://habamax.ru/myvim/data/vimwikiqrc.pdf

2.1.1 普通语法:

bold — bold

italic — italic

WikiWord — link to WikiWord (这是驼峰词的用法)

complex wiki link — link to complex wiki link

Indent lists with at least 1 space:

* bullet item

# numbered list item

= Header1 =

== Header2 ==

=== Header3 ===

2.2 Vimwiki键盘指令

首先,要明白,在Vim里面,输入指令是指在”Normal”状态下,敲击键盘上的按键,就是输入指令

如果有什么不懂,可输入在”Normal”下输入”:h vimwiki-mappings”查询

normal mode:

<Leader>ww — 打开默认的wiki主页

<Leader>wt — 在新的标签页中打开默认的wiki主页

<Leader>ws — Select and open wiki index file.(未知)

<Leader>wd — 删除你所在的wikiword的页面

<Leader>wr — 重命名你所在的wikiword页面

Enter — 在当前页面中新建新的wikiword页面

Shift-Enter — 新建一个wikipage,并在新的分割窗口中显示出来

Ctrl-Enter — 新建一个wikipage,并在新的分割窗口中显示出来(Vertical split and folow/create WikiPage)

Backspace — 返回上一页

Tab — 寻找下一个wikiword

Shift Tab — 寻找上一个wikiword

2.3 Vimwiki输入指令

输入’:Vimwiki2HTML — 将当前wiki页转换成Html格式’

输入’:VimwikiAll2HLML — 将所有的wiki页转换成HTML格式’

3.0 Vimwiki的特性

  • 与Vim紧密结合,可使用Vim的内建的正则表达式规则,高效处理文本
  • 与Vim紧密结合,可利用Vim内建的多种命令,以及可显示多个分页的特性,同时展示多种窗口,快速查看多份资料.
  • 由于Vim是文本处理工具,所以任何笔记,只要存为文本数据,便可以用Vim来组织和整理
  • 内置了特别的语法高亮模式,在观感上与普通见到的wiki没有多大的分别.
  • 可利用’:VimwikiAll2Html’这个命令快速将文本转化为网页.
  • 在Vim中自动识别网络链接格式,点击便可打开网页.
  • 在Vim的”Normal模式”下,在某行字句上面敲击”=”可自动为该字句添加标题语法
  • 自动添加wikiwork,当英文单词里面有连续两个英文字母为写’WikiWord’,Vimwiki会自动识别并将其标记为wikiword.该特性仅针对英文.

4.0 Vimwiki的一些缺点

  • 没有下划线的wiki语法
  • 由于是基于文本处理软件所开发的插件,所以无法支持导入图像、音频、视频等格式,同时也无法添加附件,但可以通过添加文件链接、或是网络链接的方式变通

(本文档,还未完成,将持续更新)


B1:已有评论19 条

  • 希锐亚: 2009-12-22 12:58, #13476

    我最想要的是版本记录功能,而wiki的格式我并不喜欢,已经有html了,wiki的语法只是把事情搞得更复杂了。

    回复

    bigclean: 2009-12-22 18:55

    版本记录可以用相应的版本控制工具(svn,git),wiki只是作为载体而已,wiki简洁还是可以提高生产力的。

    回复

  • bigclean: 2009-12-22 18:50, #13479

    似乎忘了介绍vimwiki的后端delplate,用ruby写的还不错的wiki工具。在使用过的轻量标记wiki语言中,最喜欢的还是txt2tags和asciidoc,比较通用,而且前者很简单,导出格式也很多,后者是很强大(依赖于docbook)。vim的vimwiki和emacs的muse或是emacs-wiki都还是太依赖于具体软件了,相对来说还是muse更好,而且deplate的初衷也是作为muse的vim的clone。

    回复

    Yibie: 2009-12-22 19:44

    那个是 Vim 另外一个插件——Viki所使用的后端,在Vimwiki中,输出网页不需要通过其他工具转换

    回复

    bigclean: 2009-12-23 10:39

    还是不大喜欢用vba安装vim的插件,vimwiki的上个版本自己安装也会出错,也没有深究过。
    或许vba也是vim插件的未来格式,可能会方便一点,总是感觉用代码控制起来不大容易。
    vimviki输出网页不需要后端,deplate安装还要通过rubygems进行,实在很烦,有空再好好试试。

    回复

    Yibie: 2009-12-22 19:58

    我知道Muse,但是 Emacs 的学习曲线比 Vim 更加陡峭,而且对于我这个非计算机行业的人员来说,Emacs 基本上是没有必要去探究的,除非出自于兴趣

    txt2tags的使用,一直无法明白…

    首先还是要从自己能懂的工具下手吧

    回复

    bigclean: 2009-12-23 10:35

    emacs的确是学习的成本有点太大了。muse一个很不错的特性是插入图片是可视化的,而且各级标题是会有大小区别,只是这个特性是由emacs提供的。
    txt2tag和ascciidoc都是单py文件,需要python的运行环境,可能更多的是依赖于命令行(cmd或是shell)或是用makefile管理。可以参考一下这篇中文介绍,http://sunxun.info/2009/08/txt2tags-basic/。
    还有markdowm也很不错,wordpress也有相应的插件支持,可以试试。

    回复

    Yibie: 2010-01-24 14:16

    终于是知道了 txt2tags 是个超牛的工具~看看能否和vimwiki结合吧~如果是这样就好了

  • tc: 2009-12-22 20:33, #13487

    vimwiki这个插件第一眼看到的时候就觉得不错
    完全读完它的帮助文件,就知道,这就是我想要的,不要为了voof的双边框就安装个python
    感觉真的没有必要,在windows平台下.
    另外,vimwiki的转换网页功能也不错.值得使用

    回复

  • http://t.chinaren.com/xinwenjiang: 2009-12-23 10:14, #13489
  • 田鼠007: 2009-12-23 10:23, #13490

    当英文单词里面有连续两个英文字母为写’WikiWord’,这句话好象写得不通啊……

    回复

  • 天毅: 2009-12-23 10:30, #13491

    不知道善用佳软在用firefox的时候,有没有在用vimperator,感觉相当不错的一个插件。

    回复

  • http://t.chinaren.com/xinwenjiang: 2009-12-23 10:47, #13494

    请联系我,IT新闻奖候选通过。加我qq或者msn
    295788398
    chenzhong@live.it

    回复

  • beta: 2009-12-23 21:06, #13503

    一个很不错的软件:7-zip9.10重编译中文美化版。
    http://hi.baidu.com/wnsh83/blog/item/84746137a5e0fa1a90ef3905.html

    回复

  • 发条狐狸: 2009-12-25 17:56, #13569

    要是图片有移到网络链接上就显示的功能就爽了.

    回复

  • 天毅: 2010-01-09 9:26, #14341

    想问个问题,和vim兼容性比较好的拼音输入法是哪个?搜狗打“无奈”和按2选词的时候会执行vim里的其它命令,很无奈
    【善用佳软:无法具体回答,因为不用拼音。我认为这是输入法的bug,还上升不到兼容的层面(一般说vim兼容是指支持normal模式自动英文,i模式自动中文),猜测:换一个sogou版本,或者随便换一款google, 紫光等应该都行吧。】

    回复

    Yibie: 2010-01-24 14:00

    现在vim有vimim输入法插件,可以直接在vim下输入汉字而不必启用输入法软件

    回复

  • goreycn: 2010-01-29 16:04, #15115

    原文:将下载到的vimwiki.vba文件放到vim的安装目录”~\Vim\vim72\plugin”或”~\Vim\vimfiles\plugin” 下

    这一步不是必需的,放在哪里都一样,应该这个文件装好后,是用不到的,删了都可以。

    至少,我在Win,Mac里装都没有放到上面所说的位置。

    回复

  • ytao: 2010-03-06 16:50, #15799

    我装过几个版本的vimwiki,不知怎么的,无法用GoHome功能到index,每次都会报错。也许是我的配置有问题吧。

    回复

我要发表评论

您的留言:
NOTICE: You should type some Chinese word (like “你好”) in your comment to pass the spam-check, thanks for your patience!

 名称/Name (* 必需)
 邮箱/Email (* 必需)
 链接/Link