一、Vimwiki
DescriptionVimwiki is a personal wiki for Vim -- a number of linked text files that have their own syntax highlighting.
With vimwiki you can
- organize notes and ideas
- manage todo-lists
- write documentation
以下引自:http://www.clarkok.com/blog/?p=534
我早就说过,Vim是一款功能及其强大的文本编辑器,它的强大之处可不仅仅在于进行快捷的文本编辑,它还有成千上万的插件可供扩展。今天这款VimWiki就是一款能让你自己打造Wiki世界的插件。
首先说说VimWiki的功能,让你们眼馋一下。我所看中的VimWiki的常用功能:
- 创建你自己的Wiki
- 记录你每天的日记,并按时间组织起来
- 生成HTML以供发布或浏览
- 与Vim紧密结合,更加高效地写东西
这次是在Ubuntu下写的,所以没有开鼠标,所有动作都是在键盘下完成的,如果是windows用户可以试试使用鼠标,会有意想不到的惊喜哦。
首先在这里下载一个压缩文件,将里面的 Vimwiki-XXX.vba解压到任意目录下,接着用Vim打开这个文件,在普通模式下输入:
:so %来安装。安装过程很快,几秒钟就行了。接着用Vim打开安装目录下的_vimrc(Linux: ~/.vimrc)文件,这就是上次编辑过的配置文件,在后面加入:
set nocompatiblefiletype plugin onsyntax on" vimwikilet g:vimwiki_list = [{'path': '~/vimwiki/',\ 'path_html': '~/vimwiki/html/',\ 'template_path': '~/vimwiki/',\ 'template_default': 'template',\ 'template_ext': '.html'}]let g:vimwiki_camel_case = 0" 个人喜欢utf-8,要换的话下面模板中编码也要改set encoding=utf-8map <F4> <Plug>Vimwiki2HTMLmap <S-F4> <Plug>VimwikiAll2HTML上面前三行是必须的,后面是我个人的定义,解释一下" vimwiki后面的内容:
- 'path': '~/vimwiki/' —-表示我的Vimwiki目录在~/vimwiki/下,Windows下可以改成比如'D:\vimwiki\'之类的
- 'path_html' : '~/vimwiki/html/' —-表示生成的html防止的位置
- 下面三行必须是在 Vimwiki 1.2才能有的,以下的版本是用另外一种方式来定义模板的。
- 'template_path': '~/vimwiki' —-表示模板的位置
- 'template_default': 'template' —-表示模板的文件名(没有路径和扩展名)
- 'template_ext': '.html' —-表示模板的扩展名,这样,你就可以在~/vimwiki/下放一个名叫template.html的模板了
既然提到了模板,那就先讲模板吧。以下是一个最简单的模板的例子:
<!DOCTYPE HTML><html> <head> <link rel="Stylesheet" type="text/css" href="style.css"> <title>%title%</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> </head> <body> <div id="content"> %content% </div> </body></html>%title%用于引用标题,%content%用于引用正文。
设置部分完成,让我们来创建你的第一个wiki条目:Index.wiki!
重启Vim,连续按下"\ww"三个键,会打开一个新文件,这就是你的第一个wiki条目了。在其中输入:
= Hello World! =这是第一个段落!然后保存,在普通模式输入":Vimwiki2HTML"或者按下F4,看到提示后回车,此时你设定的目录下就有一个Index.html了,正是按照模板生成的。有些人应该已经发现了,这些HTML文件并没有自带样式,而是引用了相同目录下的style.css样式表,熟悉的童鞋可以把它改成自己喜欢的样式,不熟悉的童鞋这里有CSS教程。
Vimwiki支持大部分Wiki的语法,这里介绍少许:
用处语法/介绍
标题Wiki语法中有6级标题,级别越小,在HTML中越大,
用若干个等号把标题文字包在中间,左右等号的数量就表示级别:
= 一级标题 =
== 二级标题 ==
…
====== 六级标题 ======
内部链接用于指向其他wiki词条的链接
词条
在普通模式下把光标移到他上面,按回车,就会转到这个词条(若不存在则创建)
外部链接直接打地址就行了,同样在普通模式下回车之可以调用默认的浏览器访问它
图片直接打地址
虽然在Vim中不能看,但同样可以用回车访问,在生成的HTML中也会直接出现
加粗字体(HTML,下同)用*包住,比如
*这是一段加粗的话*
在Vim下也会有高亮
斜体用_包住,比如
_斜体_
同样有高亮
删除线用~~包住
~~有删除线的字~~
代码(无高亮)用`包住,注意这个符号不是单引号,它的案件通常位于键盘的左上角,1的左边
`Some Code Here`
上标A^的上标^
下标B,,的下标,,设置还有最最神奇的表格:
| Head1 | Head2 ||-------+-------|| text | text |head部分是标题单元格,很不幸,表格中只允许有一行。
说了啊,这里只是少许介绍,更加详细的介绍请见":help vimwiki"或者这里有一份官方的中文帮助。
并且!这里是我的wiki主页,因为词条量还太少,没敢给主页的链接,而且有部分链接会404,并且我的CSS在IE8及以下会有不兼容的现象,所以只算是Beta版本,仅供参考,欢迎吐槽
|