*txtbrowser* "纯文本浏览器": 浏览纯文本的插件 适用Vim版本: 6.0 and above "Author: ypguo "Date: 2011/08/07 "Release version: 1.3.5 1 简介~ |txt-introduction| 2 安装指南~ |txt-install| 2.1 安装插件 2.2 卸载 3 功能和使用说明 |txt-howto| 3.1 语法高亮功能 |txt-highlight| 3.2 浏览文档的标题 |txt-browser-title| 3.3 浏览文档的图列表和表列表 |txt-browser-table| 3.4 浏览文档中的URL |txt-browser-url| 3.5 在文档中查字典 |txt-browser-dict| 3.6 在文档中调用搜索引擎搜索 |txt-browser-search| 3.7 一些花哨的其它功能 |txt-extra_function| 3.8 开发中的功能 |txt-todo| 4 偏好定制 |txt-options| 4.1 标题级数 |txt-title-level| 4.2 定制自己的字典 |txt-title-level| 4.3 定制自己的搜索引擎 |txt-search-engine| 4.4 更多的定制功能 |txt-custoize-more| 4 语法元素的定义和说明 |txt-element| 5.1 文本标题 |txt-title| 5.2 文本图 |txt-figure| 5.3 文本表 |txt-table| 5.4 文本关键字 |txt-keywords| 5.5 文本超键接 |txt-url| 5.6 文本Email的关键词 |txt-email| 5.7 文本引号内文字 |txt-quotes| 5.9 文本括号内文字 |txt-bracket| 5.9 文本列举 |txt-list| 5.10 文本引用 |txt-reference| 6 常见的问题 |txt-faqs| 6.1 有关Windows下中文文件名(或其它宽字节语言)的taglist不能显示的问题 6.2 文档更新后taglist好像无法及时更新. 6.3 taglist窗口里标题被显示多次 6.4 taglist窗口标题不能正常显示: 7 问题反馈~ |txt-bug| 8 版权 |txt-license| 9 发行记录~ |txt-changelog| ============================================================================== 1. 简介~ *txt-introduction* "纯文本浏览器"是一个vim文本浏览插件, 借助它你可以实现高效地浏览你的纯文本文件: 1) 为文本文件生成标题标签: 用Vim打开纯文本文件, 执行":Tlist"命令即可生成纯文本 文件的目录树, 点击标签就可实现跳转到正文, 就像在使用 taglist浏览C代码一样. 方 便你的浏览. 修改内容后用命令 ":TlistUpdate"即可完成刷新. 建议使用映射以提高效 率: nmap :Tlist) noremap :TlistUpdate 2) 语法高亮: 如果你经常从事文字工作, 想必认为纯文本是"黑白"的吧. "纯文本浏览" 插件为你的文档加上语法高亮, 使关键的部分有颜色, 突出显示标题, 关键字, 列举项, 我想一定会增加你的浏览效率. 语法高亮的加载是自动完成的, 也就是说你只要打开扩展 名为.txt 的文件 , "纯文本浏览插件"就会为你的文档加上语法高亮. 用":colorscheme colorname"命令多试几种颜色方案吧, 也许你会发现原来纯文本也如此丰富多彩. 3) 浏览功能 s: 用搜索引擎(可定制, 默认为google)搜索光标下的单词或选中的文本. f: 用网络字典(可定制, 默认为google.cn)对光标下的单词或选中的文本查字典. g: 打开光标下或选中的URL. 本插件启动后语法高亮和标题标签打开的效果图: http://guoyoooping.blog.163.com/album/edit/#m=1&aid=193892890 本插件自己生成标题, 图, 表标签, 但是相比其它类似功能的插件, 不需要在文档里做任 何特殊标记, 兼容性强. 例如任一个rfc文档打开即可实现目录树和语法高亮. 拷贝 taglist窗口里的目录到正文里, 即可以做为正文的目录. 用于语法高亮的文本元素可以 随意定制, 真正实现个性化. 无需要修改. 本插件同时支持gvim和控制台 , 同时所有的操作系统, 当然前提是ctags能工作. ============================================================================== 2. 安装指南~ *txt-install* 2.1 安装插件 1)请首先安装taglist插件 (http://www.vim.org/scripts/script.php?script_id=273). [注意]: 由于taglist插件对中文(其实还包括CJK, 即中, 日, 韩等其它语言)支持不太好 , 因此强烈建议中文用户(CJK)打上作者提供的patch: taglist.diff, 或者使用作者提供 的修正版的 taglist.vim. 这个下载将在taglist.vim的作者修正这些问题后将删掉. 2. 下载插件后解压缩到目录$HOME/.vim(或$HOME/vimfiles, $VIM/vimfiles)即可, 安装 完成后你的文件夹下应该有下面的几个文件(请注意目录结构): * $HOME/.vim/syntax/txt.vim - 用于标题标签的生成. * $HOME/.vim/syntax/txt.vim - .txt文件的语法高亮文件. * $HOME/.vim/plugin/txtbrowser.vim - 浏览工具. * $HOME/.vim/doc/txtbrowser.txt - 英文帮助文档. * $HOME/.vim/doc/txtbrowser.cnx - 中文帮助文档. 安装后别忘了打开txtbrowser.txt然后执行 ":helptags ."生成标签. 3)在你的.vimrc文件里加入下面三行, 然后重启你的Vim: syntax on filetype plugin on au BufRead,BufNewFile *.txt setlocal ft=txt 好了, 现在用Vim一个纯文本文件(打开本文也行), 执行":Tlist"命令, 现在你看到了什 么? 你的纯文本将拥有漂亮的树状标签和语法高亮, 详情请参考 |txt-howto|. [注意]本插件从版本1.1.1开始, 插件名正式从"txt.zip"更改为"TxtBrowser", 在这个版 本之前的版本升级需要先卸载老版本. [注意]本插件从版本1.2.1开始, 插件结构进行了重大调整, 方便了用户安装. 在这个版 本之前的版本升级需要先卸载掉老的.ctags文件. [注意]"文本浏览"插件可以和别的插件同时工作, 包括别的文件插件. 以"#2208: txtfmt"为例, 在你的.vimrc文件里加入下面两行即可(最好加在setlocal ft=txt这行之 后): au BufRead,BufNewFile *.txt runtime ftplugin/txtfmt.vim au BufRead,BufNewFile *.txt runtime syntax/txtfmt.vim 2.2 卸载 根据上节的目录结构, 直接到相应的目录下将其文件删除即可, 不会残留下任何东东. ============================================================================== 3. 功能和使用说明 *txt-howto* 经过第一部分的简介和第二部分安装过程的预览, 你一定对本插件有了比较感性的认识. 本章则带你更深入地了解"纯文本浏览"插件的使用, 有时候你可能需要定制更适合你的配 置. 3.1 语法高亮功能 *txt-highlight* 如果你经常从事文字工作, 想必认为纯文本是"黑白"的吧. "纯文本浏览"插件为你的文档 加上语法高亮, 使关键的部分有颜色, 突出显示标题, 关键字, 列举项, 我想一定会增加 你的浏览效率. 语法高亮的加载是自动完成的, 也就是说你只要打开扩展名为.txt的文件 , "纯文本浏览插件"就会为你的文档加上语法高亮. 用":colorscheme colorname"命令多 试几种着色方案吧, 也许你会发现原来纯文本也如此丰富多彩. 有一些文件不以.txt结尾, 但事实上也是纯文本, 我能让它也显示语法高亮吗? 答案是肯 定的, 打开文件后, 只需要执行一下下面的命令即可: :set ft=txt 我在工作经常用到.log文件, 用这个方法能让我的log文件高亮关键字, 浏览起来挺方便 的. 当然, 对于经常使用浏览log文件的也可以在你的.vimrc里加上下面的命令, 就不用 每次都在vim里敲命令了. au BufRead,BufNewFile *.log setlocal ft=txt 3.2 浏览文档的标题 *txt-browser-title* 如果你是一个程序员, 如果你用过taglist插件浏览源代码, 那你一定非常熟悉通过 taglist窗口定位函数. 纯文本浏览插件的使用完全一样. 插件安装 完成后, 用 Vim(Gvim)打开文档, 执行":Tlist"后会开一个taglist窗口, 在这个窗口里列出文章的小 标题, 图列表和表列表. 用鼠标点击标签即可跳转到正文定义处, 就像在使用 taglist浏 览C代码一样. 有些正式一点的文档需要一个目录, 用"纯文本浏览"插件很容易完成这件事情. 完成文档 的写作后, 打开taglist窗口, 选中目录, 拷贝过来粘贴到正文中即可. Vim也不是神仙, 它是怎么知道你的文档里哪里是标题呢? 别急, 我们先分析一下人们写 文档的习惯, 那就让我们用rfc文档做分析吧. rfc文档通常在第一页会有一个封面, 然后是目录, 接着就是正文, 这些我们都不关心. 我 们真正关心的是它的标题的格式. rfc文档通常的标题都是以"数字" + 符号"." + "空 格" 打头, 也就是说, 以"数字"+符号"." + "空格"打头的行就是标题了. 哈, 原来这么 简单! 因此作者建议自己在撰写文档的时候, 不仅要采用标准的内容, 最好也要采用通用的格式 标准, 不仅方便自己的浏览, 同时也便于大家的交流. 3.3 浏览文档的图列表和表列表 *txt-browser-table* 有些文档引用了大量的图和表, 有时需要快速的定位他们, "纯文本浏览"插件提供了高效 的定位的手段, 方法和上一节"浏览文档的标题"一样, 直接在taglist窗口点击相应的图 或表即可定位到正文. 3.4 浏览文档中的URL *txt-browser-url* 有时候想访问文档中的URL(如网页, Email地址, 文件等), 还需要打开一个网页浏览器, 在地址中输入地址才能查看. "纯文本浏览"插件从1.1.1版本起提供了从文档中直接打开URL的功能. 使用方法为将光标 放到URL上, 执行命令":TGoto"即可, 也可以执行下面默认的映射: g 实际上这里的URL是广义的URL, 不光支持打一个http链接, 还支持file://, mailto://等 格式 , 从1.2.8版本开始， 还将支持简写的Url, 如下面的URL都可以支持: http://guoyoooping.blog.163.com www.vim.org mailto:guoyoooping@sohu.com guoyoooping@sohu.com file:///media/data/audio/casablanca.mp3 C:\Documents and Settings\ypguo\Desktop\tmp\sample.JPG ../audio/Childhood.Memory.ape ftp://10.208.16.10 将光标放到该URL上, 或者选中该URL, 执行g, 即可调用系统默认播放器, 开始 播放这个文件. 实际上, 所有系统支持的文件格式, 如.jpg, .pdf文件等效果都是一样的 . [注意]这里是"mapleader"变量的值, 如果你没有做过设置, 这个值一般是"\", 即就是说你把光标放到URL上, 只需要敲一个"\"键, 然后再敲一下"g"键即可. 作者建议 你设置自己"mapleader"的值(如用命令let mapleader = ","设置成","键), 因为我们的 小拇指负担太重了, 设置到别的手指上有助于保护你的小拇指的健康^)^ 3.5 在文档中查字典 *txt-browser-dict* 不知道你英语好不好, 有时候看英文文档的时候遇到不认识的单词怎么办? "纯文本浏览" 插件提供了一个途径, 把光标放到单词上, 或者选中要查找的单词， 执行命令 ":TFind" 或下面的映射即可打开在线词典查单词. f 默认的在线词典是google/dictionary, 你也可以定制你自己喜欢的词典, 请参考 |txt-dict|. 3.6 在文档中调用搜索引擎搜索 *txt-browser-search* 有时候在浏览文档的时候看见一个热门词汇? 想要调用google搜一下吗? "纯文本浏览" 插件提供了一个快捷途径, 把光标放到单词上, 或选中要查找的文本，执行命令 ":TSearch"或下面的映射即可打开在线词典查单词. s 默认搜索引擎是www.google.com , 你也可以定制你自己喜欢的搜索引擎, 请参考 |txt-search-engine| 3.7 一些花哨的其它功能 *txt-extra_function* 将光标放到目录单词下, 或者用鼠标选中相应的文本, 点击鼠标右键, 然后选择"文本浏 览工具", 可以实现下面的功能, 比较花哨, 可能没什么用处, 还有一些没有解决的难题 (比如无法防水这些高亮), 但是没有什么害处, 所以推荐大家尝试一下: Normal模式和插入模式下: 加粗: 将光标下的单词变成粗体 变斜: 将光标下的单词变成斜体 加红: 将光标下的单词变成红色 加绿: 将光标下的单词变成绿色 加蓝: 将光标下的单词变成蓝色 选择模式下: 加粗: 将选中的单词变成粗体 变斜: 将选中的单词变成斜体 加红: 将选中的单词变成红色 加绿: 将选中的单词变成绿色 加蓝: 将选中的单词变成蓝色 3.8 开发中的功能 *txt-todo* 其它功能, 正在开发中... 请关注最新动向. 同时欢迎给作者写信或登录作者的博客 (http://guoyoooping.blog.163.com)表达您想要的功能, 同时欢迎提供技术支持. * 标题标签支持折叠功能(Fold), 预计会在2.0版本中支持. * 支持中文数字打头的标题, 如: 一、这是一个标题. * 中文表和图标签的完善. * 考虑是否支持类似于txt2tags风格的标题表示方法. ============================================================================== 4. 偏好定制 *txt-options* TxtBrowser提供了很多个性化的定制功能, 并且还在增加中, 你可以定制下面的东东: 4.1 标题级数 *txt-title-level* 一般的文章三级标题足够用了. 但是有时候文章比较长的时候也许你会觉得三级标题太多 了, 满眼都是标题, 找个小标题要拖很长的鼠标. 有时候又觉得三级标题不够, 没有完全 列出想要的内容, 你可以在.vimrc定制自己的标题级数(未定义为3级): let TxtBrowser_Title_Level = 2 4.2 定制自己的字典 *txt-dict* 默认的在线词典是www.google.cn/dictionary, 你也可以定制你自己喜欢的词典, 方法为 : 打开你喜欢的词典页, 查一个单词"text", 查到单词后将地址栏里的地址复制下起, 设 为全局变量TxtBrowser_Dict_Url的值. 例如你喜欢用"www.dict.cn"查单词, 查了一个单 词 "text"后浏览器的地址为"http://dict.cn/text", 那么在你的.vimrc里加下面的一句 即可实现用"www.dict.cn"查单词: let TxtBrowser_Dict_Url='http://dict.cn/text' 4.3 定制自己的搜索引擎 *txt-search-engine* 默认搜索引擎是www.google.com(google Chinese, 不同的国家和地区实际的引擎应该稍 有区别), 你也可以定制你自己喜欢的搜索引擎, 方法和上一节定制网络字典是一样的, 打开你喜欢的搜索引擎, 搜一个单词"text", 搜索结束后获得该网页的url, 设为全局变 量Txtbrowser_Search_Engine的值. 例如你喜欢用"www.baidu.com"搜索, 查了一个单词 "text"后浏览器的地址为"http://www.baidu.com/s?wd=text&oq=text&f=3&rsp=2", 那么 在你的.vimrc里加下面的一句即可实现用"www.baidu.com"搜索: let Txtbrowser_Search_Engine='http://www.baidu.com/s?wd=text&oq=text&f=3&rsp=2' 4.4 更多的定制功能 *txt-custoize-more* 很多其它的东东都可以定制, 如标题的格式, 自定义自己的关键字, 等. 我现在主要忙于 TxtBrowser的稳定工作, 等有时间我会提供更多的定制选项. 同时也希望给我写信, 推荐 您想要的定制功能. 近期可能实现的功能包括: * 在.vimrc里定制自己的标题格式. * 在.vimrc里定制自己需要高亮的文本, 以及高亮的颜色方案. ============================================================================== 5. 关键元素的定义 *txt-element* ------------------------------------------------------------------------------ 5.1 文本标题 *txt-title* 标题的格式: 通过编号来标定标题, 如: 1，1.1，1.1.1, 注意标题应该顶格写, 数字和标题名之间最 好留有空格. 通过数字的层数多少来设定层次, 如下面分别是三级标题的例子: 1000001. 标题1 ~顶格写,~~~~~这里留一个空格 本段文字是一级标题的内容. 注意数字顶格写, 数字和后面标题名留一个空格. 1000001.1 标题1.1 本段文字是二级标题的内容. 1000001.1.1 标题1.1.1 本段文字是三级标题的内容. 标签窗口最多只支持四级标题, 默认支持3级标题, 而语法高亮没有这个限制. 下面是标 签窗口关于三级标题的定义: --regex-txt=/^([0-9]+\.?[ \t]+)([^,]+$)/\1\2/c,content/ --regex-txt=/^(([0-9]+\.){1}([0-9]+\.?)[ \t]+)([^,]+$)/. \1\4/c,content/ --regex-txt=/^(([0-9]+\.){2}([0-9]+\.?)[ \t]+)([^,]+$)/. \1\4/c,content/ 下面是语法页关于标题的定义. 注意这里用到的是Vim的正则表达式(和普通的正则表达式 稍有不同, 请参考":help regex"). syn match txtTitle "^\(\d\+\.\)\+\s*[^,。，]\+$" syn match txtTitle "^\([一二三四五六七八九十][、.]\)\+\s*[^,。，]\+$" syn match txtTitle "^\d\s\+.\+\s*[^,。，]$" 标题元素将同时用于列出文档结构和语法高亮. ------------------------------------------------------------------------------ 5.2 文本图 *txt-figure* 以空格打头, 后跟关键字"figure"的行定义为"文本图". 如下段文字中, 包含 "Figure 1: Example Message Flow"的那一行(注意该行是以空格打头的)是一个文本图. 该行将被列在 taglist窗口中. 文本图的定义在文件".ctags"里, 具体如下, 你可以根据你的需要重新定义. --regex-txt=/^[ \t]+(figure[ \t]+[0-9a-zA-Z]+([.: ]([ \t]*.+)?)?$)/\1/f,figures/i --regex-txt=/^[ \t]*(图[ \t]*[0-9a-zA-Z]+[.: ][ \t]*.+$)/\1/f,figures/i | F1 MESSAGE | | |--------------------> | F2 MESSAGE | | | ----------------------->| | | F3 200 OK | | | <-----------------------| | F4 200 OK | | |<-------------------- | | | | | User 1 Proxy User 2 Figure 1: Example Message Flow 本元素的定义主要用于列出文件的结构图. ------------------------------------------------------------------------------ 5.3 文本表 *txt-table* 以空格打头, 后跟关键字"table"的行定义为"文本表". 如下段文字中, 包含 "Table 1: Summary of header fields, A--O"的那一行(注意该行是以空格打头的)是一个文本图. 该 行将被列在 taglist窗口中. 文本表的定义在文件".ctags"里, 具体如下, 你可以根据你的需要重新定义. --regex-txt=/^[ \t]+(table[ \t]+[0-9a-zA-Z]+([.: ]([ \t]*.+)?)?$)/\1/t,tables/i --regex-txt=/^[ \t]*(表[ \t]*[0-9a-zA-Z]+[.: ][ \t]*.+$)/\1/t,tables/i Header Field where proxy MESSAGE __________________________________________ Accept R - Content-Encoding o Max-Forwards R amr m Organization ar o Table 1: Summary of header fields, A--O 本元素的定义主要用于列出文件的结构图. ------------------------------------------------------------------------------ 5.4 文本关键词 *txt-keywords* 下面的关键字定义为"文本关键字", 其定义在"txt.vim"文件中. 它们在文本中将根据重要 程度显示为不同的颜色(和你正在使用的coloscheme有关). 你也可以将你关心的关键字加 入其中. syn keyword txtTodo todo fixme note debug comment notice syn keyword txtError error bug caution dropped 本元素的定义主要用于语法高亮. ------------------------------------------------------------------------------ 5.5 文本超键接 *txt-url* 文本中的超级键接定义为"文本超级键接", 主要包括网址, Email地址, ftp地址等, 请参 考rfc1738(Uniform Resource Locators (URL))和rfc3986(Uniform Resource Identifier (URI)获得超级链接更多的详情, 网页上的超级链接一般显示为带下划线的蓝色, 因为我们 也将尽量将其显示为带下划线的蓝色(具体表现根据你的coloscheme会稍有不同), 下面是 例子: guoyoooping@163.com http://guoyoooping.blog.163.com/blog ftp://192.168.1.5/ftpboot/username/example.txt 本元素的定义主要用于语法高亮. ------------------------------------------------------------------------------ 5.6 文本Email关键字 *txt-email* Email中的关键字定义如下, 例子如下: syn match txtEmailMsg '^\s*\(From\|De\|Sent\|To\|Para\|Date\|Data\|Assunto\|Subject\):.*' syn match txtEmailQuote '^\(>\($\| \)\)\+' From: San Zhang(R&D Center Beijing) Sent: 2008年11月27日 13:17 To: Si Li, Wu Wang, Liu Chen Subject: RE: 你们都不踢球? 本元素的定义主要用于语法高亮. ------------------------------------------------------------------------------ 5.7 文本引号内文字 *txt-quotes* 大多数情况下, 人们用引号把文字括起来以引起注意, 因此我们定义在引号内的文字为"文 本引号内文字", 并为其添加语法高亮, 目的是为了引起人们的注意. 下面是定义和例子: syn match txtQuotes '["“][^"”]\+\(\n\)\=[^"”]*["”]'hs=s+1,he=e-1 例子: "good example" 本元素的定义主要用于语法高亮. ------------------------------------------------------------------------------ 5.8 文本括号内文字 *txt-bracket* 多数情况下, 人们需要关注用括号内的文字, 因此我们定义在括号内的文字为"文本括号内 文字", 并为其添加语法高亮, 目的是为了引起人们的注意. 这里的括号包括圆括号, 尖括 号, 中括号和大括号, 下面是定义和例子: syn match txtParentesis "[(（][^)）]\+\(\n\)\=[^)）]*[)）]" contains=txtUrl syn match txtBrackets '<[^<]\+\(\n\)\=[^<]*>'hs=s+1,he=e-1 contains=txtUrl syn match txtBrackets '\[[^\[]\+\(\n\)\=[^\[]*\]'hs=s+1,he=e-1 contains=txtUrl 例子: (good example) [good example] 本元素的定义主要用于语法高亮. ------------------------------------------------------------------------------ 5.9 文本列举 *txt-list* 有时人们在列举一组相似的事情时, 喜欢在这些列举的一行前冠以"*", "-"等符号, 我们 定义以这些符号打头的行(有些符合如"5."需要前面有空格)为"文本列举". 下面是定义和 例子: syn match txtList '^\s*[-+*.] [^ ]'me=e-1 syn match txtList '^\s*(\=\([0-9]\+\|[a-zA-Z]\))' syn match txtList "^\s\+\d\+\.\d\@!" 例子: - item1: this is the first item. + item1: this is the first item. * item1: this is the first item. . item2: this is the second item. 3)item3: this is the third item. a)item3: this is the third item. 5.item3: this is the third item. 本元素的定义主要用于语法高亮. ------------------------------------------------------------------------------ 5.10 文本引用 *txt-reference* 有时需要引用其它人的描述或在回复邮件时需要引用原文, 这时可以高亮引用的部分. 以特殊符号">"(or "|", ":")打开的部分被定义为引用, 这些符合是回复Email, 回复 BBS常用的符号. 为了不致影响阅读原文, 语法高亮只高亮这些标识引用的符号, 正文不 会被高亮, 就像用Email回邮件那样. 文本引用的定义如下, 你可以自由定制: syn match txtReference '^[|>:]\(\s*[|>:]\)*' 这是一个来自vim的一封邮件的例子(为了简短, 删掉了一些文字): ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Frank Shute wrote: > On Wed, Aug 19, 2009 at 01:59:05AM -0400, Glen Barber wrote: >> On Wed, Aug 19, 2009 at 12:43 AM, Steve Bertrand wrote: >>> Apologies up front for the off-topic'dness. >>> >>> I'm thoroughly enjoying my new editor, and swiftly learning and >>> experiencing the benefits. As a matter of fact, ... >>> >> Hi, Steve >> >> Google has a Vim group. I'm not sure if you need a Google account or not. >> >> And, of course, there's this one: http://www.vim.org/maillist.php > > I'm a member of that list which is a straightforward mailing list > AFAIK (Disclaimer: I do have a google account but I can't remember if > that was necessary to sign up). Thanks all, I'll check out how to configure my mailer with Google Groups for this list. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 本方法元素主要用于语法高亮. ============================================================================== 6. 常见的问题~ *txt-faqs* 6.1 有关Windows下中文文件名(或其它宽字节语言)的taglist不能显示的问题 问题1: Windows操作系统下如果路径或文件名里有中文(或其它文字)字符, taglist不能 正常显示 答: 这是taglist的问题, taglist现在的版本没有考虑不同编码的字符的转换问题, 所有 的问题基本上只要打上下面的patch都可以解决: 如果你不熟悉diff文件和patch命令, 也 可以直接到这里下载修正过的taglist.vim(基于 taglist.vim v4.5), 修正了这个问题, TxtBrowser安装后不再需要手动转换编码格式: http://att.newsmth.net/att.php?p.731.55149.1226.vim taglist.diff(patch命令的使用方法: patch taglist.vim taglist.diff) |Index: taglist.vim |=================================================================== |RCS file: /cygdrive/d/cvsroot/docu/script/vim/taglist/taglist.vim,v |retrieving revision 1.1.1.1 |diff -u -p -r1.1.1.1 taglist.vim |--- taglist.vim 13 Mar 2009 04:16:54 -0000 1.1.1.1 |+++ taglist.vim 24 Mar 2010 14:27:57 -0000 |@@ -103,6 +103,9 @@ if !exists('loaded_taglist') | endif | endif | |+ " Taglist doesn't work with multibyte language because of encoding |+ " issue. ypguo fix it and mark it. The fix start with ypguo |+ let Tlist_Enc_Patch = 1 | | " Automatically open the taglist window on Vim startup | if !exists('Tlist_Auto_Open') |@@ -2177,6 +2180,13 @@ function! s:Tlist_Parse_Tagline(tag_line | " Extract the tag name | let tag_name = strpart(a:tag_line, 0, stridx(a:tag_line, "\t")) | |+ " ypguo add: The tag_name is parsed from the original buf and encoded with |+ " origional buffer's &fenc, so convert it to new buffer's &enc if they are |+ " different. |+ if (&enc != getbufvar("#", "&fenc")) |+ let tag_name = iconv(tag_name, getbufvar("#", "&fenc"), &enc) |+ endif |+ | " Extract the tag scope/prototype | if g:Tlist_Display_Prototype | let ttxt = ' ' . s:Tlist_Get_Tag_Prototype(s:fidx, s:tidx) |@@ -2264,8 +2274,9 @@ function! s:Tlist_Process_File(filename, | set noshellslash | endif | |- if has('win32') && !has('win32unix') && !has('win95') |- \ && (&shell =~ 'cmd.exe') |+ "ypguo disable it: Windows doesn't work well with Chinese in batch file, I |+ "didn't see the problem described in the following. |+ if 0 | " Windows does not correctly deal with commands that have more than 1 | " set of double quotes. It will strip them all resulting in: | " 'C:\Program' is not recognized as an internal or external command |@@ -2285,6 +2296,20 @@ function! s:Tlist_Process_File(filename, | | call s:Tlist_Log_Msg('Cmd: ' . ctags_cmd) | |+ "ypguo add: win32 cmd(shell) need 'cpxxx' characters, so convert it before |+ "pass the parameters, if chcp doesn't work, please set it maually. |+ if executable("chcp") |+ let code_page = 'cp' . matchstr(system("chcp"), "\\d\\+") |+ call s:Tlist_Log_Msg('code_page: ' . code_page) |+ else |+ " If chcp doesn't work, set its value manually here. |+ let code_page = 'cp936' |+ endif |+ |+ if has('win32') && !has('win32unix') && (&enc != code_page) |+ let ctags_cmd = iconv(ctags_cmd, &enc, code_page) |+ endif |+ | " Run ctags and get the tag list | let cmd_output = system(ctags_cmd) | |@@ -3338,6 +3363,12 @@ function! s:Tlist_Window_Jump_To_Tag(win | if tidx != 0 | let tagpat = s:Tlist_Get_Tag_SearchPat(fidx, tidx) | |+ " ypguo add: The tagpat will be passed to get the location. make sure |+ " is the same encoding as the origional buffer's &fenc |+ if (&enc != getbufvar("#", "&fenc")) |+ let tagpat = iconv(tagpat, getbufvar("#", "&fenc"), &enc) |+ endif |+ | " Highlight the tagline | call s:Tlist_Window_Highlight_Line() | else 6.2 文档更新后taglist好像无法及时更新. 问: 文档更新后,taglist好像无法及时更新. 答: 文件保存后执行"TlistUpdate"即可, 你也可以把这个命令映射成快捷键加到你的 _vimrc里 nmap :TlistUpdate 6.3 taglist窗口里标题被显示多次 问: 不知道为什么现在的我文档全部显示了重复的目录，我是指在左边栏会显示如下： 1. xxxxxxxx 1. xxxxxxxx 2. cccccccc 2. cccccccc ... ... 就是说，都是重复的，不知道为什么会这样？估计是taglist的问题？盼解答并期待新版 本。 答: 出现这种情况的原因应该是你的$HOME目录还有一份.ctags文件, 你把它删除了应该就OK 了. 由于早期的TxtBrowser使用配置文件定义标签, 新版则采用定义变量的方式定义标签 , 两种方法都是有效的, 所以使用新的版本而保留老的.ctags文件的话, 标签可能会显示 2次. 6.4 taglist窗口标题不能正常显示: 问: 打开taglist窗口后标题不能被正常示, 如下图所示: txtbrowser_cnx.txt (D:\release\1.1.6\doc) content . 1000001.1.1 标题1.1.1 . 1000001.1 标题1.1 . 2.1 安装插件 . 2.2 卸载 . 2.3 可能会遇到的问题 . 2.4 安装可选项 . 3.1 语法高亮功能 答: 问题的原因不是标题没有被正常显示, 而是显示的顺序不对, 在taglist窗口执行 "s"命令即可正常显示. 错误的原因是你一定在你的.vimrc里配置了tag的显示顺序(如下 所示), 所以标题被重新排序了. let Tlist_Sort_Type = "name" 解决的办法是删除这个配置或者将上面的配置修改成: au BufRead,BufNewFile *.txt let Tlist_Sort_Type = "order" ============================================================================== 7. 问题反馈~ *txt-bug* 我尽量在发布时多做测试, 争取尽量减少bug, 但是如果你发现了bug, 非常欢迎直接向我 报告. 做为开源软件, 用户反馈是软件成熟的重要途径, 所以非常感谢您的支持. bug反 馈可用下面的任意途径: 我的Email: mailto://guoyoooping@163.com ping的博客: http://guoyoooping.blog.163.com 我经常去的论坛: 水木vim版 ============================================================================== 8. 版权~ *txt-license* GPL ============================================================================== 9. 发行记录~ *txt-changelog* 本人写插件经验不是很丰富, 所以更新频繁, 下面仅列举重要更新. 2009-12-26 1.0 1)第一版发表 2010-01-23 1.1 1)增加了帮助文档 2)去掉了插件中个人的配置 2010-03-06 1.2 1)插件名正式从"txt.zip"改成"TxtBrowser" 2)增加从文本文件中直接打开URL的功能 3)修正了中文标题不能显示的bug. ============================================================================== vim:tw=78:ts=8:noet:ft=txt: