==========
 用户手册
==========

:作者: limodou
:联系: limodou@gmail.com
:版本: $Id: userguide.txt 42 2005-09-28 05:19:21Z limodou $
:主页: http://wiki.woodpecker.org.cn/moin/UliPad
:BLOG: http://www.donews.net/limodou
:版权: GPL

.. contents:: 目录
.. sectnum::

说明
----

本手册采用对照菜单功能进行描述，个别专题单独讲解。

版权说明
--------

本软件采用GPL版权发布。

成员及联及方式
---------------

目前软件开发就是本人，如果你在使用过程中有什么意见和建议，欢迎给我写信 limodou@gmail.com 。也可以去我的 Blog_ 留言。

.. _Blog: http://www.donews.net/limodou

屏幕说明
---------

这是UliPad的主窗口：

.. image:: screenshot_01.jpg

UliPad分为菜单条、工具条、文档窗口和状态条。

文档窗口由Tab页组成，可以一次编辑多个文档。当前文档的标题会显示在主窗口的标题条上。
状态条可以看到行、列值。文档回车类型：WIN为DOS/Windows格式，UNIX为UNIX格式，
MAC为MAC格式。文档使用的编码。

运行环境及安装说明
-------------------

源码
~~~~

可以运行在Windows和Linux环境下。
需安装Python 2.3以上版本，wxPython 2.4.2.4 Unicode版本
将源码包解压放到一个目录下即可。
强烈建议使用 python 2.4+ wxPython 2.6+版本。

Windows安装包
~~~~~~~~~~~~~

只能运行在Windows环境。执行安装程序即可，不需要事先安装Python和wxPython。

最新更新
--------

3.6版本
~~~~~~~~

新增功能：

#. 增强定义跳转，可以无ctag支持下在文件内跳转
#. 对自动完成进行完善：自动判断类型，识别类结构等
#. 增加对正则搜索的范围设定
#. 增加对epydoc注释中参数类型的支持
#. 增加协同开发支持
#. 增加fortran,Lua语法高亮支持
#. 增强类浏览显示结构和内容，可以显示类属性和docstring
#. 增加css的自动提示信息

修改：

#. 改进类浏览窗口中，单击class类图标可以展开和折叠
#. 修正对弹出运行参数窗口点取消时，仍然运行的bug
#. 修正reStructuredText的语法高亮处理
#. 修正Python语法分析的bug
#. 修正当关闭目录浏览窗口时，再打开不能恢复目录的bug
#. 修正当文件或目录与UliPad不是一个盘符时，打开命令行窗口菜单执行失败的错误
#. 修正Music插件的bug
#. 删除打开最新目录功能
#. 修正当修改编码时，editctrl的tag页标题没有显示修改状态的bug

3.5版本
~~~~~~~

新增功能：

#. 增加不自动清除Message window信息的处理选项，增加Shift+F5快捷键
#. 使用FlatNotebook作为Notebook组件
#. 增加拼写检查插件，你需要安装pyenchant模块
#. 增加保存侧边栏大小的功能
#. 增加双击Notebook的Tab最大化的功能，对于侧边栏只能最大化到50%
#. 增强acp格式，可以通过{##}表示选中的文本了
#. 增加对ePyDoc生成函数说明的支持
#. 增加个人信息的管理，目前只有一个姓名
#. 增加session管理的功能，同时改进文档tab方向变化时不需要重启
#. 增加动态搜索正则表达式功能
#. 增加由nmweizi提供的CloseOther插件，可以保存当前文档关闭其它的文档
#. 增加智能导航的功能，可以记忆你的文件访问路径
#. 增加一个停止自动刷新的checkbox在rst html view窗口上
#. 增加语法检查正确时自动关闭检查结果窗口
#. 增加向目录浏览窗口拖拽目录和文件的功能
#. Notebook右键菜单可以动态生成
#. 在Notebook右键菜单上增加打开当前文档Dos窗口的功能(Window下可用)

修改：

#. 去掉在OnKeyDown中对Input Assistant的处理，简化程序处理
#. 修正保存时不检查语法的bug
#. 修正打开文档时无法search的bug
#. 修正工具条按钮Enabled状态不正确的bug
#. 修正语法高亮字体处理的bug
#. 重构，修正New...菜单与工具条菜单不一致的bug
#. 修正在SaveFile后输入集点丢失的bug
#. 修正Ctrl+F4会退出UliPad的bug
#. 增强工程设置处理：重构，增加删除配置处理
#. 将最近文件和最近目录的菜单处理改为弹出菜单，可以加快打开文件的速度
#. 修正执行python程序不重定向的bug,同时增加一个选项是否每次都显示参数设置窗口
#. 改进对自定义工具条控件的支持
#. 更新rerange.py Script对中文的支持
#. 解决Input Assistant的性能问题
#. 将Ctrl+Enter改为Shift+Enter

3.4版本
~~~~~~~

新增功能：

#. Notebook 改为 FlatNotebook 控件
#. 增加Ctrl+Enter功能，直接在下一行增加换行
#. 增加Back键自动显示缺省标识符功能
#. 增加jQuery的输入支持：项目设置，函数注释信息自动生成
#. 让caretlinkback可配置，在config.ini中设置[default]message_caretlinkback = #颜色
#. 增加文档标签方向的设置。在参数中文档页面中可以设置
#. 增加生成django app dot图的功能
#. 增加拷贝起始，结束的设置，用于字符的选择
#. 增加一个按第一行的空白间隔对后续行自动调整的Script(rerange.py)
#. 增加多视图功能
#. 增加命令搜索功能,有Impact和正常两种模式
#. 增加ReST和django template语法高亮支持
#. 增加ReST项目支持
#. 增加ReST的Html View功能，可根据内容变化自动刷新
#. 增加对ctags的支持(Ctrl+I)
#. 将语法检查插件移到核心中去了
#. 增加在_project中设置自动语法高亮绑定和自动acp文件绑定

修改：

#. 修正在Tab Notebook上打开dos prompt窗口时的错误
#. 修正Globals.app = self的位置
#. 将标识符自动提示扩展到自动完成功能中，因此不只是对Python有效，而且可以通过acp文件进行控制了
#. 修正类浏览器，当保存时改变位置到最后一个类的bug
#. 将样式字节全部设为7不再判断文件类型了
#. 修正录入辅助排序时不区分大小写的bug
#. 修正在处理on_char时对选中文本的处理，editor不再做处理，而是由各plugin进行处理
#. 修正执行GUI程序时的处理问题，不再弹出多的dos窗口了
#. 修正打开ToDo窗口不显示的Bug
#. 修正是否显示启动画面的选项处理有误的bug
#. 增加一个edittype的属性用来表示是否是编辑器环境，原documenttype只是用来标识不同的文档类型
#. 修正当DEBUG=False时仍然可以创建debug.txt和error.txt的问题
#. 修正当输入焦点消失时，弹出的列表窗口和Calltip不消失的Bug
#. 修正缩近粘贴的bug。修正列拷贝在文件尾时少一行的错误
#. 将mAutoComplete转到Input Assistant模块中
#. 将检查文件缺省值设为True
#. 修正打开上次窗口位置大小不正确的bug
#. 调整对on_char的InputAssistant的处理，当录入很快时可以自动取消
#. 修正当上下显示CallTip空间不足时，显示在下面
#. 修正标签的匹配，对/>不需匹配补齐
#. 修正当编辑其它文件再切换回html窗口时，窗口自动恢复的bug
#. 将Idle的处理置为线程方式，OnIdle不再做处理
#. 修正当关闭一个未存文件时，在保留后存在document丢失的问题
#. 修正向后查找时的当大小写变化找不到的bug
#. 关闭时自动隐藏其它的侧边栏，加快关闭速度

3.3版本
~~~~~~~

新增功能：

#. 当运行 Python 出错时，在消息窗口中出错提示行双击可以跳转到源文件的出错行
#. 在目录浏览窗口中增加：在Win平台上打开资源管理器，文件和目录的拷贝、剪切、粘贴，目录搜索等功能，同时支持Ctrl+C, Ctrl+V, Ctrl+X的快捷键
#. 在Django目录下，可以启动测试服务器和打开Shell窗口
#. 光标在某些样式中，如注释，字符串中时，禁止自动完成
#. 重新打开一个文档时，光标停留在原来的位置
#. DDE功能的Socket服务端口可重用
#. 增强Python文件中.自动完成功能。在from和import中支持.的自动属性选择功能
#. 增加列块拷贝的支持。在选择前先要按alt，就可以选对列块了
#. 增加列模式，按Alt+C进行切换。在列模式下可以输入一个字符，自动在其它行出现
#. 增加对Python文件的缩近拷贝的支持，可以在参数设置中关掉些功能
#. 增加在自动检查需要装入文件时是否需要确认的选项
#. 增强自动完成，可以支持控制字符组合了，不过菜单的组合键会先执行
#. 增加对当前文档单独设置ACP文件的功能

新增插件：

#. ruler 一个标尺

新增快捷键：

#. Alt+C 切换列模式
#. Ctrl+Del 可以删除当前位置之后的所以空白

修改：

#. 在帮助对话框中显示链接，并可以点击
#. 调整一些菜单的位置
#. 括起菜单的快捷键为Ctrl+'，退出改为Ctrl+Q
#. 消息窗口支持Wrap功能
#. 对DjangoProj插件进行改进，可以动态修改settings.py
#. 打开文件时进行Unicode转换时使用replace参数
#. 修正判断Python文件编码不正确的Bug
#. 修正语法配置文件读取时中文字体名未做转码的bug
#. 修正正则表达式替换不精确的bug
#. 修正自动检测缩近符不正确的bug
#. 修正在编辑html的js代码时总有波浪线的bug
#. 修正新打开文件时，光标停留与原来不太一致
#. 修正当按回车时，如果移到可视区下面，则看不到的bug
#. 转换项目中的Tab缩近全部改为4个空格缩近
#. 去掉关于对话框中的版本revision号

3.2版本
~~~~~~~

新增功能：

1. 增加当MessageWindow中出错异常时，可以根据当前行的异常信息自动跳转到出错文件的指定行的功能
2. Windows平台中增加目录浏览窗口中，对某个目录打开Dos窗口的功能
3. 自动保存上次打开目录，再次启动时自动打开上次目录
4. 可以在config.ini中设置缺省编辑器的字体，在中文环境下为“宋体”
5. 自动判断python文件的编码并进行转换后保存
6. 增加新建文件时缺省编码的设置，如果用户定义编码不为空，则用户定义编码将作为缺省编码。如果为
   空则使用缺省编码。
7. 在编辑窗口的右键菜单上增加修改文件编码菜单
8. 增加 TODO 窗口
9. 增加简单贴功能，并可以自动保存位置和大小
10. 根据文本类型自动选择注释符，并且可以在config.ini中设置使用comment_chars作为节，同时语言为key，
    可以有一个default作为缺省值
11. 增加ruby classbrowser功能
12. 增加对动态菜单快捷键的处理
13. 增加对debug生成的控制，缺省情况下debug不输出，需要在config.ini中设置才输出
14. 在参数中增加一个设置document语法高亮的按钮
15. 增加自动扩展功能，并支持项目处理及嵌套处理
16. 增加简单模板功能，可以在code snippet中加入 <#{name=inputname,description=info,defult=value}#>，
    这样在双击snippets会弹出对话框让你录入信息。
17. 可以设置某个目录工程类型，用在某些扩展中
18. 增加代理服务器参数设置
19. 增加网络分享窗口，目前只用于Rss Reader

新增插件：

1. rssreader RSS阅读器
2. docbook docbook的支持
3. djangoproj django项目的支持


新增快捷键：

1. Ctrl+Alt+R 清除Shell窗口的内容
2. F5    Python程序运行

修改：

1. 解决pyw的多线程运行阻塞的问题
2. 修正模块信息显示出错的问题
3. 在执行Tab与空格切换的菜单后自动调整缩近符
4. 更新image有效性的判断处理
5. 修正ftp目录分析的一个bug
6. 调整文档切换时菜单的动态生成，及语法切换的问题，减少不必要的更新

3.1版本
~~~~~~~

新增功能：

1. 增加若干插件
2. 增加若干快捷键
3. 增加makedot.py转换dot文件和查看图片的脚本
4. 增加自动检查设置项。可以在保存时自动检查Python语法
5. 增加自动扩展功能，支持扩展文件。并可以实现根据项目文件选择使用
6. 增加java, ruby, perl, css, javascript语法高亮支持
7. 增加目录浏览功能
8. 通过设置一个_project文件，支持简单的项目功能
9. 增加RemoveBlankLine.py脚本，可以删除当前文档中的空行
10. 增加在打开文件时可以指定当空文件时，是否使用一个模板文本进行填充
11. 增加New时可以选择文件的语法

新增插件：

1. pycheck 语法检查
2. Wizard 向导处理插件
3. plugintmp 可以生成一个plugin的框架
4. django 支持django 项目生成的插件

新增快捷键：

1. Alt+L 打开/关闭左边栏窗口
2. Alt+B 打开/关闭底边栏窗口
3. Alt+E 打开error.txt
4. Alt+D 打开debug.txt
5. F2 打开目录浏览窗口

修改：

1. 修改当文档改变时，Tab页标题名前加*号
2. 增加CheckList模块，改进插件管理界面
3. 修正在notebook的tab空白处上双击时会关闭当前文档的bug
4. 修改winpdb插件的路径错误
5. 去掉自动补充(, {, [等的功能
6. 提升Script菜单为顶级菜单
7. 修改findtext为空时死循环的错误
8. 修正保存时标题条的星号不改变的bug
9. 修改按Ctrl+Tab键时切换时光标不进入编辑窗口的bug
10. 修正按钮的高度
11. 修正切换自动缩近符菜单bug
12. 将修改设为一次性操作，使用BeginUndoAction()和EndUndoAction()
13. 修正无法选择自动缩近和使用制表符缩近菜单
14. 调整配置文件可以从UliPad安装目录和conf目录下读取


3.0版本
~~~~~~~

新增：

1. 版本号增加了Revision号
2. 增加目录浏览功能
3. 增加模块信息显示，主要用于扩展模块的信息显示
4. 增加pytts插件
5. 增加winpdb插件
6. 增加Wizard插件

修改：

1. 修改当出现自动完成下拉列表时，切换窗口下拉列表依然显示的bug
2. 修改帮助信息，站点地址，blog，联系方式等
3. 去除project和path功能
4. 扩展插件结构，插件为目录
5. 修改i18n的处理，支持多个mo文件串行处理，同时可以处理插件翻译文件
6. 修改图片处理支持gif, png和image对象
7. 网站主页及版本库转移到啄木鸟的SVN
8. 修正切换文档不改变文档编码的问题
9. 修改ftp端口号不能大于100的问题

2.9版本
~~~~~~~

新增：

1. 增加行注释和反注释的快捷键(Ctrl+/增加注释 Ctrl+\\取消注释)
2. 增加导入指定模块文件的功能，选中一个字符串，按F6可以导入字符串所表示的模块文件
3. 启动时编辑窗口的文件延迟打开
4. 增加设置解释器功能，可以在运行时执行要使用的解释器，同时可以设置是否使用输入输出重定向
5. 增加执行程序时，自动切换到程序所在的目录功能
6. 增加记录上次打开路径的功能
7. 增加中文目录的支持
8. 增加关闭当前文档快捷键 Ctrl+F4
9. 增加对导入mixins的异常保护

修改：

1. 修改FTP中上传文件文本文件未转换错
2. 修正生成插件目录__init__.py文件的错误
3. 修正未给frame.workpath赋值的错误
4. 调整 UliPad 的应用结构。
5. Find窗口按ESC可以关闭
6. 在UliPad中执行程序时，不进行输入输出重定向时采用异步执行
7. DDE支持使用CallAfter处理
8. 修正当选中文本时，按回车不清除文本的bug
9. 修正执行外部菜单时使用os.startfile()
10. 修正当snippet不存在时创建路径的处理
11. 修正取系统缺省编码的处理
12. 修正代码片段窗口按钮状态处理不正确错误
13. 修正自动完成中，从文本取出匹配串排序不正确的Bug
14. 修改在读取缺省编码有误时，使用utf-8编码
15. 修正改变语法颜色后，文档不更新的Bug。在colourize中增加force参数，当它为True时强制执行。
16. 修改当在一件空文档上打开文件时，不能正确处理文件类型切换的处理
17. 修改当自动保存文档时，不能正确保存unicode编码的问题。但对于其它的象ftp的文件保存可能有问题。
18. 修改对象比较处理，增加__eq__, __ne__方法
19. 修改当找不到文件对应的语法器时，缺省使用option中的语法器设置的处理，改为缺省使用text语法器
20. 修改语法高亮的处理，当语言类型未变时不再进行语法高亮处理
21. 修改ftp list的分析处理
22. 修改全部保存、全部关闭时不对未打开文档进行处理

2.8版本
~~~~~~~

新增：

1. 查找替换功能中，如果查找是正则表达式时，则替换也是正则表达式替换
2. Shell窗口，消息窗口，执行Python代码时，支持中文输入及输出
3. 增加自动补齐，函数语法提示功能
4. 在状态栏最后增加显示剩余内存的栏位(只用于Windows环境)
5. 直接将Html代码输出到Html窗口中
6. 增加用户自定义快捷键

修改：

1. 重新设计Blog的编辑功能
2. 修正保存代码片段窗口时的错误
3. 修正未选中代码片段分类时，按保存时出错的错误
4. utf-8的编码检查改为直接进行转换，当出错时使用缺省编码。
5. 修正帮助中Blog链接错
6. 修改新加Shell命令和Script时，自动对提示进入编辑状态
7. Shell, Message, 代码片段窗口均可以关闭
8. 在windows平台上注册到资源管理器上下文菜单时，根据文件后缀进行相应的处理
9. 重新设计在文件中查找界面
10. Blog的分类信息显示为对应的分类描述
11. 修改wxPythonDoc插件为wxPythonDocument
12. 修改wxPythonDocument和PythonDoc的路径使用sys.prefix

2.7版本
~~~~~~~

新增：

1. 在Windows下支持将UliPad注册到资源管理器的上下文菜单的功能，同时提供反注册。
2. 增加文本转换为Html的功能，现支持reSt->html, textile->html, py->html，
   同时提供多种输出方式：替换当前、输出到消息窗口、输出到独立的Html窗口
3. 增加查看Html文档的功能，可以使用内置的HtmlWindow来浏览Html文档。在Windows下
   是使用内嵌IE浏览器来查看
4. 在项目管理中增加将当前所有打开文档加入到项目中去的功能
5. 对于使用浏览器打开的窗口或Blog编辑窗口，Tab标签会显示不同的图标

修改：

1. 修改热键处理。Shell和Message窗口也可以使用Ctrl+C, Ctrl+V等热键了
2. 修改在增加一个Shell命令行时，无法修改命令行提示的Bug
3. 修正在执行Shell命令时，打开消息窗口出错的Bug
4. 修正在类浏览窗口的空白处理点击出错的Bug
5. 调整Plugins结构，增加异常处理功能
6. 取消对版本的检查

增加的文本转Html和Html浏览功能主要是中以辅助Html编辑及对Blog写作预览的支持。对于Windows安装
程序，在安装时会自动对注册表进行注册，即将UliPad增加到资源管理器的上下文菜单中。卸载时自动删除
注册表。

对于plugins功能进行调整，因此如果你已经使用了plugin，需要重新进行设置。

2.6.1版本
~~~~~~~~~

新增：

1. 自动判断文件的缩近符，自动进行调整
2. 增加Blog编辑功能插件

修改：

1. 改正文件未修改不能重新打开的Bug
2. Ftp下载时文件名自动填入
3. 调整Ftp布局

升级说明：

Blog插件是自选安装的，因此，在正式的安装包中不带。需要单独下载。如果要安装Blog插件，还要安装Meteor模块。

2.6版本
~~~~~~~

新增：

1. BookMark支持循环跳转
2. 可以设置当前的运行路径，方便脚本运行
3. 可以生成InnoSetup格式的Windows安装程序
4. 增加Ftp的上传和下载功能
5. 增加命令行选项 -f 可以不打开上次会话所保存的文件名

修改：

1. 对整个软件结构进行调整，提高启动速度
2. 所有的文件路径均自动处理为绝对路径

升级说明：

因为此次修改了程序结构，应用2.5版升级相似，在运行 UliPad 前应先执行tools/convert_opt2.6.py来转换UliPad.opt。
也可以简单地删除UliPad.opt文件。

2.5版本
~~~~~~~

新增：

1. 增加上下文缩近
2. 增加简单项目管理功能
3. 增加是否显示光标所在行功能
4. 增加一个启动或禁止psyco模块的使用的命令行选项 -s，缺省为不启用
5. 增加改变文档的编码功能，保存文件时可按此编码进行保存
6. 增加Ftp功能，可以远程打开、编辑文件，并保存。还提供了建目录、新文件、删除、改名、上传、下传等常见Ftp功能
7. 增加自动封闭功能，如输入某些对称符号时，如(),[],{}时，输入左边符号时，自动会补齐右边符号

修改：

1. 修正Floder失效的问题
2. 修改当光标所在位置前为空白时，保持原空白不变
3. 修改文件名中有汉字的情况。将文件名自动转为unicode处理，并在DDE传送时转为utf-8
4. 语法高亮设置可以修改：光标颜色、光标所在行背景色、选择文本颜色
5. 修正保存文件后，当找不到文件名对应的语法解释器时，会使用缺省样式改变当前指定的样式
6. 翻译文件编码转成utf-8
7. 将参数页由panel改为scrolledwindow
8. 重新设计了插件导入结构，根据导入算法重新修改了读取plugin和写入plugin的方法
9. 打开文档的语法高亮参数窗口时，自动根据当前文档的语法类型选中初始语法种类

升级说明：

因为此次修改了程序结构，因此造成原配置文件处理在新版本下会发生错误。因此，在安装完2.5版软件后，可以执行tools
目录下的convert_opt2.5.py来进行配置文件的转换。此程序只对2.5版以前的配置文件生效。还有最简单的方法就是删除
配置文件即可。同时，本软件所提供的插件(从http://UliPad.tigris.org上下载的)可能也存在问题，如果使用请重新下载。

2.4版本
~~~~~~~

新增：

1. 代码片段的导入和导出功能，可以导出或导入某个分类
2. 增加打印功能，支持HTML文档的打印
3. 增加psyco模块的加速支持，使用此功能要先安装psyco模块
4. 增加用户插件的管理功能
5. 在参数设置中可以设置新建文件缺省的语法高亮类型
6. 增加停止运行Python程序的菜单和工具条按钮
7. 运行Python程序时可以接收输入信息

修改：

1. DDE服务的端口可以在config.ini中指定
2. 修改打印帮助文件为全路径，且使用file:///协议
3. 修改在文件中查找时，双击结果文件行数跳转总多一行的问题
4. 修改当存在混合回车符时，保存文件出错的问题

2.3版本
~~~~~~~

新增：

1. 增加模拟DDE功能，命令行增加禁用DDE选项
2. 增加版本检查功能，需要Python 2.3以上，wxPython 2.4以上
3. 增加语法属性设置：颜色、字体等，语法文件后缀。并通过配置文件进行保存。
4. 重新设定语法指定

修改：

1. 将某些窗口的显示/隐藏菜单合并到左侧窗口和底部窗口
2. 改正保存新文件时不正确的错误(已在2.2第二版中解决)
3. 运行功能支持.pyw后缀
4. 增加错误日志(error.txt)
5. 改正查找时，单词选定选项无法保存的问题
6. 改正重新选定语言时菜单检查状态显示不正确错误

2.2版本
~~~~~~~

新增：

1. 代码片段管理--你可以将可重用的代码保存起来，需要时插入到文档中
2. Shell命令菜单管理--可以运行一些外部命令，并生成菜单在UliPad中调用
3. 打开和另存时可以选择是否显示编码选择对话框，从而实现文件编码的转换
4. 在状态条可以显示当前文档的编码

修改：

1. 修正生成的资源文件对象不正确的问题
2. 增加在保存文件时按文档的回车符进行自动转换的处理
3. 修正保存代码片段时utf-8编码处理不正确的错误
4. 当unicode处理失败时，对文件不作处理
5. 增加工具菜单，将Script菜单转移到它的下面

2.1版本
~~~~~~~

新增：

1. 自动检查文件是否被别的程序更新过
2. 打开文件时可以设置是否自动做备份
3. 可以重新装入上次保存后的文档
4. 增加在命令行指定打开文件参数
5. 在命令行增加缺省使用编码选项

修改：

1. 修正PyShell窗口的内置函数_与gettext中的翻译函数_冲突的问题，将所有翻译函数改名为tr()
2. 增加unicode转换出错的处理，并且版本已经不支持非unicode版本
3. 修正扩展选词不能处理'.'的问题
4. 读取language.ini文件时，可以过滤掉空行及#开始的行

2.0版本
~~~~~~~

新增：

1. 窗体布局进行调整，增加Shell和消息窗口。
2. 针对不同的文件名菜单和工具条可动态切换(现在只对Python文件)。
3. 增加脚本(script)管理菜单。用户可以编写对编辑的文档进行处理的Python程序，并通过脚本菜单进行管理。
4. 增加文件拖拽功能，现在只可以拖到菜单及工具条上。
5. 增加Python的类浏览窗口功能。
6. 增加国际化处理，用户可以自已编写相应语言的译文。现在支持中文和英文两种。
7. 增加在文件中查找功能。
8. 增加对C, HTML, XML关键字识别的功能。
9. 增加对Python文件进行执行的功能，并可以设定命令行参数。
10. 增加将所有制表符转换为空格的功能。

修改：

1. 修正启动时输入焦点无法切换到文档中的错误。
2. 修正最大化，最小化时保存坐标不正确的错误。
3. 修正首字母大写功能的错误。
4. 修正当文件换行符为MIX时，切换文档显示不正确的错误。

启动UliPad
-----------

启动UliPad可以在命令行下执行::

  python UliPad.py -u|-v|-n|[-e defaultencoding] files ...

  -u 显示用法信息

  -v 显示版本信息

  -n 禁用DDE功能(2.3新增)

  -e defaultencoding 可选，缺省使用编码

  -s 使用psyco加速模块(2.5新增)

  -f 启动时忽略上次会话打开的文件

  files ... 文件名列表，可以有多个，以空格隔开

可以双击UliPad.pyw图标启动。

File(文件)
----------

New(新建)
  生成新文档

Open(打开文档)
  打开存在文档，一次可以打开多个文档

Reopen(重新打开文档)
  重新装入上次保存后的文档

Open Recent(打开最近文档)
  当用户打开或保存一个文件之后，这个文件名将保存在最近文档中，下次用户可以直接从最近文档菜
  单中打开此文档。如果被打开文档已经打开，则直接切换到文档所在的Tab页面。

Open Recent Path(打开最近路径)
  当用户打开或保存一个文件之后，这个文件的路径将保存在最近路径中，下次用户可以直接从最近路径菜
  单中打开最新访问的路径。此功能还可以通过工具条的按钮来执行。

Directory Browser(目录浏览)(3.1版新增)
  可以浏览目录及相应的子目录。右键菜单会有更多的功能。

Close(关闭)
  关闭当前文档

Close All(关闭所有文档)
  关闭所有打开文档

Save(保存)
  保存当前文档

Save As(另存为)
  将当前文档改名保存

Save All(保存全部)
  保存全部打开文档

Page Setup(页面设置)(2.4版新增)
  打印页面的设置

Printer Setup(打印机设置)(2.4版新增)
  打印机设置

Print Preview(打印预览)(2.4版新增)
  打印效果预览

Print(打印)(2.4版新增)
  打印当前文档

Html File(Html文件)(2.4版新增)
  包括Html文档的打印预览和打印功能

Ftp...(Ftp功能)(2.5版新增)
  Ftp支持，用户可以打开、编辑、保存、删除、改为、新建文件、新建目录、上传和下传。更详细的见Ftp使用介绍。

Exit(退出)
  退出程序

Edit(编辑)
----------

Undo(撤销)
  撤销上次编辑操作

Redo(重做)
  重做刚才撤销的动作

Cut(剪切)
  剪切选中文本到粘贴板中

Copy(拷贝)
  拷贝选中文本到粘贴板中

Paste(粘贴)
  从粘贴板中拷贝文本

Selection(选择)
~~~~~~~~~~~~~~~

Select Word(选词)
  选中单词

Select Word Extend(扩展选词)
  将'.'作为单词的一部分进行选择。按Ctrl+鼠标双击也可以执行与此相同的功能。

Match Select (Left First)(匹配选择－－左向优先)
  可以选择括起来的文本，如文本使用()[]{}\'\'\"\"包括起来，执行此功能可以将括起来的文本选中。如果某段文本中有嵌套，如

::
  
      (print "%s%s" % (a, b)  )
          ^         ^       ^
          a         b       c

在最外层的括号内还有\"\"和()的嵌套。如果想选中最外层括号内的文本，则可以将插入点置于最外层括号与嵌套的包括符\"\"之间,
如上面所示可以有三个位置。如果为位置a，当执行向左匹配时，会先向左查找第一个包括符，这样会找到‘(’。然后，再向右查找与‘(’
相匹配的‘)’。匹配查找可以识别出嵌套的括号对，直到找到正确的匹配符。然后将包括符中的文本全部选中。如果找不到对应的匹配
符，则不做选择。如果将插入点置于位置b，则向左查找时会先找到‘\"’，这样可能与你的期望不符。这是因为双引号(还有单引号)是不
分左右的，因此对于它们的处理要小心些。如果将插入点置于位置c，匹配查找仍然会认为左边的‘\"’是第一个包括符，从而产生和位置
b一样的效果。因此为了正确选中文本，请将插入点置于a位置附近。或者将插入点放于位置c，但使用向右匹配功能。

选中的文本不包括找到的最外面的包括符，在上例就是不包括最外面的括号。

Match Select (Right First)(匹配选择－－右向优先)
  与左向优先相反，本功能是向右优先查找。选中的文本不包括最外面的包括符。

Enlarge Selection(扩大选择)
  可以将选中的文本区域向左右扩展一个字符，只对半角字符有效。适用于使用匹配选择功能后，还想要选中包括它们的字符时，使用此功能。

Select Line(选中当前行)
  将插入点所在的当前行全部选中，包括行尾的行结束符。

Select All(全选)
  将当前文档全部选中。

Duplication(复制)
~~~~~~~~~~~~~~~~~

复制功能主要的想法是复用以前的输入，包括以前输入过的字符、单词和句子。要复用以前的输入首先要同以前的内容进行匹配，因此你首先需
要输入要匹配的开始字符，可以是任意多个。注意，只处理标识符(英文字母，数字，'.', '_')。然后执行相应的功能进行匹配，匹配分为向前匹
配和向后匹配。匹配会查找与所输入的字符序列开始相同的标识符，如果找到则会在当前位置显示一个提示窗口(只有词、句匹配才可)，如果为你
想要的内容，按回车或空格选中匹配，按ESC可以取消本次匹配。如果不是想要的匹配，可以继续执行下一次匹配。

想要匹配首先要输入几个字符作为匹配串，匹配串的识别是：从当前插入点开始向左查找，如果字符在标识符集中，则存入匹配串，再进行下一次
查找。直到字符不在标识符集中为止。注意，匹配只针对于半角字符，不处理汉字。

对于字符'.'是否算做标识符集，可以通过复制扩展模式进行选中或不选中。

Duplicate Extend Mode(复制扩展模式)
  指明'.'是否做为单词的一部分。

Duplicate Current Line(复制当前行)
  拷贝当前行，插入到当前行的下面。

Duplicate Previous Char(复制上一个字符)
  向前匹配，复制匹配串后的一个字符。注意：只对前面的内容匹配最近的一个，不可以继续进行匹配。

Duplicate Next Char(复制下一个字符)
  同上，只是方向向后。

Duplicate Previous Word(复制上一个单词)
  向前匹配，如果匹配成功，则将匹配成功的完整单词显示在提示窗口中，按回车或空格选中，则将去掉匹配串的部分粘贴在当前插入点后面。如输入"abc"，
  匹配成功"abcdef"，则按回车后"def"将粘贴在当前插入点后面。如果匹配不是想要的，可以继续执行，那么将从当前所匹配成功的开始地方继续向
  前进行匹配。

Duplicate Next Word(复制下一个单词)
  向后匹配，功能同上。

Duplicate Previous Line(复制前一个句子)
  向前匹配，只不过是处理整个匹配成功的句子。

Duplicate Previous Line(复制后一个句子)
  向后匹配，功能同上。

Format(格式)
~~~~~~~~~~~~

格式菜单功能可以处理一行或多行。如果没有选中任何文本，则处理当前插入点所在的行。如果选中了文本，则处理选中文本所在的所有行。

Trim Trailing Spaces(去除尾部空白)
  去除行尾的空白。

Leading Spaces to Tabs(前导空白转换为制表符)
  将行首的空白转换为按缩近要求的制表符。

Leading Tabs to Spaces(前导制表符转为空格)
  将行首的制表符转换为按缩近要求的空格。

All Tabs to Spaces(所有制表符转为空格)(2.0新增)
  将所有的制表符转换为按缩近要求的空格。

Increase Indent(增加缩近)
  增加文本的缩近。

Decrease Indent(减少缩近)
  减少文本的缩近。

Line Comment(行注释)
  在选中文本的前面加上注释符。执行时会弹出对话框要求你输入注释符。

Line Uncomment(去掉行注释)
  去掉选中文本前的注释符。如果不存在，则不作处理。

Text Quote(文本括起)
  在选中文本两头加上括起字符串。有几种预定义的包括字符串可以使用，如：()[]{}等。你也可以自已输入包括字符串。

Text Unquote(去掉文本括起串)
  去掉选中文本两头括起的字符串。串的选择同上。

Case(大小写)
~~~~~~~~~~~~

Upper Case(变为大写)
  将选中文本变为大写

Lower Case(变为小写)
  将选中文本变为小定

Invert Case(大小写互换)
  将选中文本大小写互换

Capitalize(首字母大写)
  将选中文本中的所有单词的首字母变为大写。

Convert(转换)(2.7新增)
~~~~~~~~~~~~~~~~~~~~~~

In Html Window(在Html窗口中输出)
  文本转换输出选项，选中后，在转换成Html时，结果会显示在单独的Html弹出窗口中

In Message Window(在消息窗口中输出)
  文本转换输出选项，选中后，在转换成Html时，结果会显示在消息窗口中

Replace Selected Text(替换选中文本)
  文本转换输出选项，选中后，在转换成Html时，结果会替换当前选中的文本

reSt to Html(reSt转Html)
  reStructuredText 转换为Html

Py to Html(Py转Html)
  Python 源代码转换为Html

Textile to Html(Textil转Html)
  Textile格式文本转换为Html

View(视图)
----------

Tabs And Spaces(制表符和空白)
  显示或隐藏制表符和空白。制表符和空格一般是不可见的，如果切换为显示，则空格显示为一个点，制表符显示为一个箭头。

Indentation Guides(缩近指示)
  显示或隐藏缩近指示。如果显示，则相同的缩近会有一根虚线连在一起。

Right Edge Indicator(右边界指示)
  显示或隐藏左边界指示线。如果显示，则在设定的列处有一根线。它可以帮助你确定一行是否太长。

End-Of-Line Marker(行结束符)
  显示或隐藏行结束符。

Zoom In(放大)
  放大屏幕字体。

Zoom Out(缩小)
  缩小屏幕字体。

Search(查找)
------------

Find...(查找)
  查找指定串。支持正则表达式。如果先选中一段文本，则被选文本会作为待查字符串显示在查找对话框中。如果选中文本包含回车符，则不作为待查字符串。

Direct Find(直接查找)
  当选中一段文本后，执行此功能不会弹出查找窗口，而是直接进行查找。

Replace...(替换)
  先查找指定字符串，找到后进行替换。可以对全文档匹配串进行全部替换。如果在执行此功能之前已经选中一段文本，则可以指定在选定范围内进行全部替换。

Find Next(查找下一个)
  向下查找下一处匹配串。

Find Previous(查找上一个)
  向上查找下一处匹配串。

Find In Files(在文件中查找)(2.0新增)
  可以在指定的目录，指定的文件扩展名中进行查找某个字符串。

Go to Line...(行号跳转)
  跳转到指定行。

Go to Last Modify(跳到最后修改)
  跳转到最后一次进行过修改的地方。

Toggle Marker(标签切换)
  UliPad可以设置任意多的标签，可以在这些标签之间进行跳转。设定或取消标签。有标签设定的行在行号左边有一个蓝色的箭头。

Clear All Marker(清除所有标签)
  清除所有设定的标签。

Next Marker(下一处标签)
  跳转到下一处标签所在的行。

Previous Marker(上一处标签)
  跳转到上一处标签所在的行。

Document(文档)
--------------

Word-wrap(自动折行)
  设置/取消自动折行。当设置自动折行时，当文字一行过长，会根据窗口大小自动换到下一行。

Auto Indent(自动缩近)
  设置/取消自动缩近。当设置自动缩近时，按下回车键，新的一行会自动保持上一行的缩近。如果取消些功能，则按下回车键时，插入点总是在一行的第1列位置。

Change encoding...(改变保存编码)(2.5版新增)
  改变当前文档的编码，在保存时将使用此编码。对于转换远程文件的编码特别有用。

Syntax Highlight...(语法高亮)(2.3新增)
  重新设置当前文件的语法指定。

Syntax Preference...(语法参数设置)(2.3新增)
  语法参数设置，可以设置语法标记的颜色、字体名称、字体大小、字体属性。

Convert Line Ending(转换行结束符)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

可以将某种格式的换行符转换为其它格式。

Convert to Windows Format(转换为Dos/Windows格式)
  转换为Dos/Windows格式

Convert to Unix Format(转换为Unix格式)
  转换为Unix格式

Convert to MAC Format(转换为MAC格式)
  转换为MAC格式

Tool(工具)(2.2新增)
-------------------

Shell Command(Shell命令)(2.2新增)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Shell命令可以允许你加入外部的命令，生成菜单，在UliPad中进行调用。

Shell Command Manage...(Shell命令管理...)
  用于Shell命令的增加、删除、命名，移动

Script(脚本)(2.0新增)
~~~~~~~~~~~~~~~~~~~~~

脚本功能是我一直想实现的，你可以编写特别目的的Python程序，把它置于UliPad之下，可以对当前文档进行特殊的文本
处理。利用这一功能，用户可以扩展UliPad的文本处理功能。要想将脚本置于UliPad的菜单之下，首先要存在这个脚本，如果
没有请先编辑一个。然后，执行脚本管理功能，可以将脚本文件增加到脚本菜单中。在脚本管理窗口中，你可以修改脚本的描述(
用鼠标在某项描述上单击，即可进行修改)。这项描述将作为菜单项显示在脚本菜单中。

用户编写的脚本将作为UliPad的一部分进行执行，因此没有什么限制，所有UliPad的资源均可以使用。只不过要注意，使用
时要通过win这个对象来访问所有的资源。win对象为整个框架窗口，访问当前正在使用的文档窗口，可以使用win.document。
访问消息窗口可以访问win.messagewindow。文档窗口可能会随着文件的不同而不同，缺省的文档窗口类为wxStyledTextCtrl。
消息窗口为wxStyledTextCtrl类。因此你可以使用wxStyledTextCtrl的方法。最基本的方法可以为::

    GetLength()                     返回文档长度
    GetText()                       返回文档的内容，如果为Unicode版本，将返回Unicode内容
    AddText(text)                   在当前光标处，插入文本
    InsertText(pos, text)           在文档指定位置前插入文本
    ReplaceSelection(text)          替换选中文本
    SetText(text)                   重新设置文档的文本为text，以前的文本全部丢失
    SelectAll()                     选中全部文本
    SetSelection(start, end)        设置选中区域
    GetSelectedText()               得到选中文本
    GetSelection()                  得到选中范围，返回为一个tuple，(start, end)
    GotoPos(pos)                    跳转到指定位置
    GotoLine(pos)                   跳转到指定行
    GetCurrentPos()                 取得插入点的位置
    
当前还有许多的方法，上面只是列出一些常用的方法。

Script Manage...(脚本管理)
  用于脚本的增加、删除、命名、移动。

Snippets(片段)(2.2新增)
~~~~~~~~~~~~~~~~~~~~~~~

片段是为了实现代码的重用。在平时的编程中你可能有许多代码是可以被重用的，你可以将它们按照某个分类进行组织。同时
在需要的时候你可以将它们插入到文档中。片段功能包括：片段的使用和片段的管理。

当使用片段时会在文档的左边弹出一个窗口，窗口分为上下两部分。上部为片段的分类，组织为树状结构。下部为列表结构，
用于显示每一个分类里面所有的代码片段。当在分类中进行选择时，下面的代码片段会随着分类的改变而发生变化。当在代
码片段中双击时，选中的代码片段的内容会插入到当前文档的光标处。

片段的组织分为：分类的管理和片段代码的管理。

对于分类，你可以增加、删除、修改、增加一个子项。选中一顶后，可以将其上移、下移。并可以改变它的级别，通过左移
和右移来实现。这样，分类就完全组织为一个树状结构。当改动中想要保存时，可以选中[应用]按钮。保存退出时，请选择
[确定]按钮。

对于片段代码，你可以增加、删除、修改。首先要选定某个分类，然后才可以对此分类下的片段进行管理。当对某个分类进
行了修改时，分类列表框会被锁定，直到你保存它、或放弃保存才会被释放。这一点在使用时请注意。

Manage Snippets Catalog(片段分类管理)
  对片段的分类进行管理，可以增加、删除和、修改、增加子项、移动顺序(上移、下移)、改变分类的级别(左移、右移)。

Manage Snippets Code(片段代码管理)
  对分类的片段代码进行管理，可以 增加、删除和修改。

Plugin Manage(插件管理)(2.4新增)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  增加可由用户自已编写的插件管理功能。具体的插件发布见《技术手册》。此功能只有启动后设置的插件才起作用。

Option(选项)
------------

Preference...(参数设置)
  用于设置UliPad的一些可变参数。

Language(语言)(2.0新增)
  用于选择程序界面所用的语言。现在支持中文和英文两种。并且在中文平台第一次运行时，如果判断平台环境为中文的话，会
  自动使用中文环境。如果用户想要增加自已的语言支持，可以在tools目录下找到相应的文档和工具，进行相应的语言翻译即可。
  步骤如下：

	1. 复制UliPad.pot为想要翻译语言的目标文件，文件名应为：UliPad_地区代码.po。如中国为cn，台湾为tw。
	2. 将UliPad_地区代码.po中msgid不为空的内容进行翻译，译文写在msgstr处。格式要与msgid一致。如果有%d之类的
	   格式替换符请不要改变它们的顺序。
	3. 参与build.bat文件，执行相应的命令将po文件编译为mo文件，并拷贝到lang目录下。
	4. 修改lang目录下的language.ini文件。增加新的语言说明，格式为：地区代码 说明。如：fr French
	5. 启动UliPad，然后在Option->Language下，选中新加的语言。再重启UliPad即可。

Register to Explore(注册到资源管理器)(2.7新增)
  将UliPad注册到资源管理器的上下文菜单中

Unregister from Explore(从资源管理器反注册)(2.7新增)
  将UliPad从资源管理器的上下文菜单中反注册

Document(文档相关)
~~~~~~~~~~~~~~~~~~
Double click will close the selected document
  选中则当你在一个Tab标签上双击时可以关闭选中的文档。

Whitespace is visible on startup
  选中则启动UliPad时，空格和制表符是可见的。

Indentation guides is visible on startup
  选中则缩近指示在启动UliPad时是可见的。

Long line indicator is visible on startup
  长行指示(右边界)在启动UliPad时是可见的。

Long line indicator column
  用于设定长行指示的开始列，缺省为100列

Tab width
  一个制表符相当于多少个空格，缺省为4个

Auto indent
  自动缩近。设置保存后与执行菜单功能相同。

Use Tabs
  缩近是否使用制表符，选中则使用制表符，未选中则使用空格。

Auto detect UTF-8 encoding
  自动检测文件编码是否为utf-8，如果是则自动进行相应的编码转换。

Auto word-wrap
  自动折行。

Use code fold
  是否使用代码折叠功能。如果选中，则在行号右边会出现一个代码折叠边界区，用于指示代码的分级情况。点击相应的加号、减号图标，则
  可以对代码实现折叠。

Default line ending used in document
  文档中缺省使用的行结束符。此选项用于新建文件。如果打开已存在的文件，UliPad会自动识别于文件所用的行结束符，并且在状态条的最右边将文档
  的行结束符类型表示出来。

Auto make backup file as open a file
  在打开文件时自动备份文件(2.1版新增)

Auto check if there are some opened files were modified by others(2.1版新增)
  自动检查是否打开的文档被别人进行了修改

Auto close enclosing char, like: (, [, {(2.5片新增)
  是否自动对(, [, {进行补齐右包括字符

Auto close enclosing char, like: ', ", <(2.5片新增)
  是否自动对', ", <进行补齐右包括字符

Choose where converted text is outputed (2.7新增)
  选择被转换文本在何处输出，功能同Convert菜单相应的菜单

General(通用)
~~~~~~~~~~~~~

Max number of recent files
  最近更新文件列表的最大个数。

Max number of save find text
  保存的查找字符串的最大个数。UliPad可以将以前查找到的内容保存起来，根据使用的频率进行自动刷新。这个值用于设定最多保存多少个以前查找
  过的内容。

Auto load the files of last session
  自动装入上次会话打开过的文件。使用此功能时，上一次打开的文档，在程序直接退出时会保存起。再次启动时会自动打开上次处理过的文档。

Saves current status when exit the program
  在退出程序时保存当前状态。是指上次执行时的窗口坐标，及上次插入点所在的行。

Use duplication extend mode ('.' will be treated as word chars)
  设置复制的扩展模式，与Duplication Extend Word功能一样。

Show encoding selection dialog as openning or saving file.(2.2新增)
  当打开或保存文件时显示编码选择对话框。

Default syntax highlight.(2.4新增)
  缺省语法高亮。

Show caret line.(2.5新增)
  显示光标所在行。选中此功能，则光标所在行的背景以将为指定颜色。可以语法设置中进行修改。

Python(2.0新增)
~~~~~~~~~~~~~~~

Show class browser window as open python source file
  在打开Python源文件时显示类浏览窗口

Use context sensitive indent(2.5新增)
  使用上下文敏感缩近。比如：当输入函数定义，或语句块开始时，当最后为':'时，会在下一行自动
  增加一个缩近位。当输入行有return, break, continue时会自动减少一个缩进位。

Enable Calltip(2.8新增)
  允许函数提示功能

Enable auto completion(2.8新增)
  允许自动完成功能

Window(窗口)(2.6新增)
---------------------

Left Window(左侧窗口)(2.3新增)
  显示或隐藏左侧的窗口，现包含：代码片码窗口

Bottom Window(底部窗口)(2.3新增)
  显示或隐藏底部的窗口，现包含：Python Shell窗口，它是一个Python 交互窗口，用户可以输入Python的命令；消息
  窗口，此窗口与Python Shell窗口是在一起的。当执行Python程序时它可以用来显示输出信息。如果用户编写了脚本，可以用来作为输出。

Open Shell Window(打开Shell窗口)
  打开Shell窗口

Open Message Window(打开消息窗口)
  打开消息窗口

Open Snippets Window(打开代码片段窗口)
  打开代码片段窗口

Python(2.0新增)
---------------

此菜单只当你打开Python文件时才会出现。

Class Browser(类浏览)
  在文档左侧将打开一个类浏览窗口，它将显示当前文档的全部函数和类的函数。在函数名上双击后，会跳转到相应的行。

Class Browser Refresh(类浏览刷新)
  刷新类浏览窗口的内容。类浏览窗口中的内容在你编辑文档时自动发生变化，当执行了类浏览刷新功能后，才会发生相应的变化。

Run(运行)
  运行当前程序。结果显示在消息窗口中。

Set Arguments(设置命令行参数)
  设置在运行当前程序时所使用的命令行参数。

Help(帮助)
----------

UliPad Help Document(帮助文档)
  打开帮助文档页面。

Extended Module Info(扩展模块信息)(3.0新增)
  可以查看写在插件配置文件中的扩展模块的信息

Visit Project Homepage
  访问项目主页

Visit My Blog
  访问我的Blog

Contract to Me
  给我发邮件

About...
  关于本软件

快捷键
------

使用快捷键可以加快编辑的速度。菜单对应的快捷键列在菜单项的右边。还有一些与编辑有关的快捷键没有与菜单关联。

*凡在功能解释前带有(M)的表示有相应的菜单功能。*

===========================    =====================================================
  快捷键名称                        对应功能
===========================    =====================================================
F1								(M)UliPad Help Document(帮助文档)
F2                              (M)Directory Browser(目录浏览)(3.1版新增)
F3								(M)Find Next(查找下一个)
Shift+F3						(M)Find Previous(查找上一个)
F4								(M)Direct Find(直接查找)
Ctrl+F4							(M)Close(关闭)(2.9版新增)
F5                              (M)运行Python程序(3.2版新增)
F6          					(M)将当前串作为模块名打开模块所对应的源文件(2.9版新增)
F8								(M)Next Marker(下一处标签)(3.2修改)
Shift+F8						(M)Previous Marker(上一处标签)(3.2修改)
F9								(M)Toggle Marker(标签切换)
Ctrl+Shift+F9					(M)Bookmark Clear All(清除所有标签)
F10								(M)Duplicate Extend Mode(复制扩展模式)
Ctrl+A							(M)Select All(全选)
Ctrl+B							(M)Go to Last Modify(跳到最后修改)
Ctrl+C							(M)Copy(拷贝)
Ctrl+D							删除当前行
Ctrl+Shift+D					删除当前行，并拷贝到粘贴板中
Ctrl+E							(M)Match Select (Left First)(匹配选择－－左向优先)
Ctrl+Shift+E					(M)Match Select (Right First)(匹配选择－－右向优先)
Ctrl+Alt+E						(M)Enlarge Selection(扩大选择)
Ctrl+F							(M)Find...(查找)
Ctrl+G							(M)Go to Line...(行号跳转)
Ctrl+H							(M)Replace...(替换)
Ctrl+I或Tab						(M)Increase Indent(增加缩近)
Ctrl+Shift+I或Shift+Tab			(M)Decrease Indent(减少缩近)
Ctrl+J							(M)Duplicate Current Line(复制当前行)
Ctrl+L							(M)Duplicate Previous Line(复制前一个句子)
Ctrl+Shift+L					(M)Duplicate Previous Line(复制后一个句子)
Ctrl+M							(M)Duplicate Previous Char(复制上一个字符)
Ctrl+Shift+M					(M)Duplicate Next Char(复制下一个字符)
Ctrl+N							(M)New(新建)
Ctrl+O							(M)Open(打开文档)
Ctrl+P							(M)Duplicate Previous Word(复制上一个单词)
Ctrl+Shift+P					(M)Duplicate Next Word(复制下一个单词)
Ctrl+"							(M)Text Quote(文本括起)
Ctrl+Shift+"					(M)Text Unquote(去掉文本括起串)
Ctrl+R							(M)Select Line(选中当前行)
Ctrl+S							(M)Save(保存)
Ctrl+T                          (M)Todo窗口(3.1版新增)(3.3版修改)
Ctrl+U							(M)Upper Case(变为大写)
Ctrl+Shift+U					(M)Lower Case(变为小写)
Ctrl+V							(M)Paste(粘贴)
Ctrl+W							(M)Select Word(选词)
Ctrl+Shift+W					(M)Select Word Extend(扩展选词)
Ctrl+X							(M)Cut(剪切)
Ctrl+Y							(M)Redo(重做)
Ctrl+Z							(M)Undo(撤销)
Ctrl+/          				(M)将选中文本前增加注释(2.9版新增)
Ctrl+\          				(M)将选中文本前的注释去除(2.9版新增)
Ctrl+Alt+L                      (M)打开/关闭左边栏窗口(3.1版新增)
Ctrl+Alt+B                      (M)打开/关闭底边栏窗口(3.1版新增)
Ctrl+Alt+R                      (M)清除Shell窗口的内容
===========================    =====================================================

弹出菜单
--------

现在UliPad在文档窗口支持弹出菜单。

在文档内部的弹出菜单功能与主菜单的Edit(编程)功能相同。

在文档Tab页的弹出菜单与主菜单File(文件)功能基本相同。

UliPad的Unicode支持
--------------------

UliPad是完全支持Unicode的，当然前提是你要安装wxPython的Unicode版本。

支持Unicode，那么就面临本地编码与Unicode的转换问题。在UliPad中，这种转换发生在打开文件和保存文件的时候。
UliPad在进行码制转换时所用到的编码有三个来源：指定的编码、文档编码和缺省编码。UliPad在处理这三种编码是按
顺序进行的，即如果指定编码为空则使用用文档编码，如果文档编码为空则使用缺省编码。那么这三种编码都是怎么来的？
又会怎么处理的 ？

1. 指定编码

  如果用户想在打开文件或保存文件时单独指定某种编码，那么他需要在选项菜单中，设置“当打开或保存文件时显示编码
  选择对话框”选项为选中。这样，当打开或另存文件时，就会弹出编码选择对话框，用户选则好了编码后，UliPad会使
  用这种编码对文件进行编码和解码。如果处理失败，则打开文件或保存文件失败。如果成功，则设置文档编码为此编码。

2. 文档编码

  当用户使用了指定编码时，并且成功的打开或保存了文件，则此文档的编码为指定的编码。如果用户没有使用指定编码，
  则如果用户设置了选项菜单中的“自动进行utf-8编码检测”选项为选中时，则在打开某个文件时，UliPad会自动判断
  文件内容是否为utf-8编码，如果是则文档的编码为utf-8，如果不是则文档编码为缺省编码。

3. 缺省编码

  缺省编码支持是指当启动UliPad时，UliPad会根据操作系统的环境得到系统所使用的编码作为缺省编码。但个别情况
  下，UliPad所得到的系统编码可能有问题，这时，你可以在启动时加入命令行选项 -e encoding 为正确的编码即可。

要注意的是如果设定了要使用指定编码，但也只可以在弹出打开文件对话框，和打开保存文件对话框的时候可以使用，其它
情况下或者自动测试utf-8编码，或者使用缺省编码。

专题介绍
--------

Script(脚本)编写示例
~~~~~~~~~~~~~~~~~~~~

脚本功能允许用户编写自已的处理代码，可以对 UliPad 中的对象进行处理。它的目的就是快速的编写，并且可以作为菜
单放在 UliPad 中。它是一个独立的 Python 源程序。编写一个脚本有以下几步：

1. 编写脚本、保存
2. 在Script(脚本)菜单中添加入口项

关于第二步操作此处不作说明。下面对一些可用的脚本进行一些举例。

最简单的脚本
^^^^^^^^^^^^

::

	1       #---------------------------------------------------
	2       #                   UliPad script
	3       # Author  :limodou(chatme@263.net)
	4       # Date    :2004/07/11
	5       # Version :1.0
	6       # Description:
	7       #     Add linenum to each line of selected text
	8       #
	9       #---------------------------------------------------
	10      
	11      def run(win):
	12      	win.document.SetText("Hello, UliPad")
	13      
	14      run(win)

1-9行
  为注释，可以不写。但如果要给别人用，让人知道你的情况还是不错的。

11-12
  定义了一个run函数，win参数是可用的一个对象，它就是UliPad最外层的窗口，它有菜单，工具条，状态条，还有你看
  到的文档。当前正在编辑的文档为win.document。通过win对象，你可以访问到UliPad的任何一个对象。如：
  win.messagewindow就是消息窗口，你可以用它来输出一些信息。关于整个UliPad的架框在技术文档中将会有详细的描
  述，这里不再细说。

  12行调用了当前文档窗口的SetText方法，用来设置文档的内容为"Hello, UliPad"。要记住，它会清除以前的所有东
  西。因此它只是一个示例。你可以将这代码改为：win.messagewindow.SetText("Hello, UliPad")，看一看消息窗口
  中是不是有东西了。还可以改为：win.document.AddText("Hello, UliPad")，看一看是不是在文档光标处理增加了
  文本，而原来的内容并未清除。

14行
  对此函数进行调用。函数写法看上去清晰一些，但你完全可以不使用它，如可以改为::

    win.document.SetText("Hello, UliPad")
	
  再运行一下试试效果。

给文本增加行号
^^^^^^^^^^^^^^^

::

	1       #---------------------------------------------------
	2       #                   UliPad script
	3       # Author  :limodou
	4       # Date    :2004/07/11
	5       # Version :1.0
	6       # Description:
	7       #     Add linenum to each line of selected text
	8       #
	9       #---------------------------------------------------
	10      
	11      def run(win):
	12      	linenums = win.document.getSelectionLines()
	13      	for i, linenum in enumerate(linenums):
	14      		text = str(i+1).ljust(8) + win.document.getLineText(linenum)
	15      		win.document.replaceLineText(linenum, text)
	16      
	17      run(win)
	
此脚本用于给文档中选定的文本增加行号，从1开始。本例就是使用此功能实现的。

12行
  得到需要处理的行号范围。getSelectionLines函数是在Editor.py中定义的

14行
  得到要处理行的文本，并加上行号信息。getLineText是在Editor.py中定义的

15行
  将处理后的文本替换原来的文本。replaceLineText函数是在Editor.py中定义的

转换reStructuredText文档转换为HTML
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

::

	1       #---------------------------------------------------
	2       #                   UliPad script
	3       # Author  :limodou
	4       # Date    :2004/07/08
	5       # Version :1.0
	6       # Description:
	7       #     Convert reStructuredText to Html
	8       #
	9       #---------------------------------------------------
	10      def run(win):
	11      	from docutils.core import publish_file
	12      	import os.path
	13      	import cStringIO
	14      	
	15      	filename = win.document.filename
	16      	fi=cStringIO.StringIO(win.document.GetText().encode(win.document.locale))
	17      	f, ext = os.path.splitext(filename)
	18      	htmlfile = f+'.htm'
	19      	fo=open(htmlfile, "w")
	20      	publish_file(source=fi, destination=fo, writer_name='html')
	21      	fi.close()
	22      	fo.close()
	23      	win.messagewindow.SetText('Success!')
	24      	win.panel.bottom.notebook.showWindow(1)
	25      #	win.editctrl.new(htmlfile)
	26      
	27      run(win)

此脚本调用docutil模块用来将当前的reStructureText转换为HTML。第25行可以将转换后的文本显示出来。不过此处注释掉了。

详细处理不再描述，只讲述与UliPad有关的内容

15行
  取得当前文档的文件名。

16行
  将文档的内容转换为文档所用的编码。因为UliPad使用的是Unicode，因此在使用docutil处理前先要转成本地编码，再
  进行处理。locale是当前文档的编码。

17-18行
  根据原文件名生成.htm文件名。

20行
  调用docutil生成html文件

21-22行
  关闭文件

23行
  在消息窗口中显示成功信息

24行
  显示消息窗口

这个脚本有一点要注意，对于新建的文档，如果没有保存，它的filename属性为''，因此直接对它进行转换时在文件名处理
上可能有问题。此脚本不需要你先保存再转换，因此在使用时要小心一些。

Ftp使用说明
~~~~~~~~~~~

1. 选择 文件->Ftp或点中工具条上的Ftp按钮，即可以在下窗体上打开Ftp页。
2. 首先要进行Ftp站点的设置。点中Site Set(站点设置)，然后会弹出一个对话框。如果要增加一个新站点，必须输入站点
   名称和站点的IP地址，然后，增加按钮才可以使用。要删除一个站点，先选中要删除的站点，然后点删除。要修改一个站
   点，首先选中要修改的站点，然后进行修改，再选择更新即可。
3. 站点设置好，退出后，在主Ftp窗口上方有站点选择下拉列表。它的右侧为用户名和口令。当改变站点下拉列表时，用户
   名和口令会同时发生变化。再右边是连接与断开的按钮。选择连接，则将与选中的Ftp站点进行连接。如果用户名或口令
   为空，则会弹出对话框要求输入。注意，如果在本对用户名和口令进行修改并不影响保存的站点设置。也就是说，在此处
   进行设置用户名和口令，只对本次连接生效。如果想永久保存，请在站点设置中进行更新。选择断开，则断开与Ftp站点
   的连接。
4. 页的中间为文件、目录列表区。每次显示一个目录下的所有文件和目录。如果有父目录，则第一行为指定父目录的结点。
   当连接成功后，点鼠标右键会出现一个右键菜单，这些操作都是在连接状态下进行的。用户可以打开文件或目录，新建文件、
   新建目录、删除、改名、刷新当前目录、上传文件、下传文件。打开文件也可以在某个文件上双击即可。在打开文件时，都
   是使用二进制方式打开。对于上传和下传，则可以指定传输方式：二进制和文本方式。只用于文件上下传，并不会打开文件。
   当打开了远程文件后，如果进行了修改，则可以象通常保留文件的方法一样进行操作，即 文件->保存或点击工具条上的保
   存按钮。对于打开的远程文件，不能另存为远程文件，只可以另存为本地文件。
5. 页的下面为编码选择，此功能是当打开一个远程文件时使用何种编码进行打开。自动判断是否UTF-8的功能对远程文件仍然
   有效。在保存时此编码不起作用，如果想改变保存时的编码，则可以使用 文档->改变编码进行编码转换。再向右为远程目录，
   用户可以指定一个远程的目录，当与Ftp站点连接时，会自动跳转到此目录。并且在已经连接成功后，可以修改此路径，然后
   点击刷新按钮或执行右键菜单中的刷新，即可以改变当前目录。再右边是站点设置和关闭。

用户自定义快捷键(2.8版新增)
~~~~~~~~~~~~~~~~~~~~~~~~~~~

现在只提供一个Hack的方法。用户可以对主窗体和编辑窗口的菜单自定义快捷键。即在config.ini中增加main_hotkey节或
editor_hotkey节，然后增加：菜单消息=快捷键，如::

    [main_hotkey]
    IDM_FILE_SAVE_AS=F12

上面就会为[另存为]菜单增加一个F12的快捷键。如果main_hotkey节不存在，只要自已创建即可。

有关菜单消息号的查询可以在运行UliPad后，在debug.txt文件中，关于"[ INFO] -- [makemenu] makeaccelerator..."的后
面找到。

关于main_hotkey与editor_hotkey的区别就是，在主窗体中定义的热键是全局生效的，而在编辑器中定义的热键，只有当输入焦
点在编辑器中才会生效。

目录浏览功能(3.0新增)
~~~~~~~~~~~~~~~~~~~~~~

1. 增加一个目录
2. 关闭一个目录
3. 增加一个子文件夹
4. 增加一个文件
5. 删除一个目录或文件
6. 点击结点可以编辑从而改名
7. 刷新目录
8. 不会自动展现全部目录树，而是层层展现，提高速度，点击目录时才会打开一级目录
9. 双击文件结点将在编辑器中打开
10. F2键可以打开此窗口

`[返回]`_

.. _`[返回]`: index.htm