==========
 项目介绍
==========

:作者: limodou
:联系: limodou@gmail.com
:版本: $Id: introduce.txt 42 2005-09-28 05:19:21Z limodou $
:主页: http://newedit.tigris.org/
:BLOG: http://www.donews.net/limodou
:版权: GPL

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

引言
--------

本项目是一个个人项目，开发的目的是希望设计和开发一种方便灵活的Python编辑器，一方面有自主版权，另一方面可以在需要
时进行定制实现特殊的功能需要。

目的
~~~~~~~

本文档用于帮助用户对项目的背景、功能、适用范围等方面进行了解，以便合理有效地使用本项目。

简介
~~~~~~

NewEdit 是一个编辑器，你可以用它来进行你的文档写作，编程开发。它使用 Python 编程语言开发，用户界面基于 wxPython 
。它除了想要完成一般编辑器的常用功能之外，最主要是想实现一种方便、灵活的框架，开发者可以方便地开发新的功能。而且
有编程经验的用户还可以针对日常工作中的特别问题编制处理的插件，从而使之与自已的日常工作紧密结合起来。由于使用的是
Python 这种功能强大的编程语言，你可以方便地对本软件进行修改，从而满足自已的需要。

本软件采用GPL版本方式发布，欢迎您与我交流。


项目历史
~~~~~~~~~~~

本项目最早的前身应该是 FlyEdit (取意为飞翔之意，是想实现自由扩展)。最早也是使用wxPython，但那时wxPython的wxStyledTextCtrl
组件(是Scintilla编辑器包－－一个强大的编辑器－－的wxPython的封装)还不完善，当使用多文档时(那时想使用多文档来实现)会出现问题，
因此就放弃了wxPython。然后转向了Tcl/Tkinter(另一种跨平台的图型包，但控制受限，中文处理有些麻烦)，已经实现了Mixin机制，还可以
允许用户编写自已的插件。它的基础是从Python IDLE中转来的，其中语法高亮等功能是使用Python来实现的，而不是Tcl/Tkinter本身所有的
功能，因此执行效率上很慢。而且许多编辑器的功能都不具备，实现起来也很麻烦。再加上后来在Linux上测试了一下，程序运行出错，所以也
放弃了。

就在2004年4月份，我在freshmeat.net上发现了DrPython，它是一个编辑器，使用wxPython 2.4.2.4(现在已经升级到2.5.1了)，实现了
多文档(使用wxNotebook和wxStyledTextCtrl组件)，而且功能很不错，于是我提出了一些改进了建议，并且后来成为其中一名开发者，并为
其修改并实现了一些功能。但随着软件的庞大，修改也变得越来越困难。因为一个新的功能的实现可能要修改菜单、参数对话框、事件处理代码
等等地方，但这些地方往往并不是在一起的，而是分散开的，这样改写程序也要同时改好几个地方，很麻烦。而且另一个人不会很清楚地知道你
到底改了什么地方，有可能要比较好几个程序才知道改了什么地方。但如果你同时修改了好几个功能，这样比较出来的结果可能是好几个功能混
在一起，查看改动很不方便。

在经过一段时间对DrPython的修改和学习，我感到wxPython现在已经很稳定(Borland也说想要在他的C++ Builder X中使用wxWindow作为图形
开发开台，这样看来wxWindow还是很有前途的)，因此想重新实现一种灵活方便的编程框架，特别是要用到Python强大的动态性的特征，而且许
多新的东西都可以在开发中应用，可以学到许多wxPython的知识。因此我开始了新的项目开发。为了与FlyEdit相区别，我叫它为NewEdit，意
为“新生的编辑器”。

NewEdit项目于2004年4月22正式开始编码，在此前经过仔细的框架考虑。现在它使用两种基本结构：Mixin和Plugin。关于两者区别在我的blog
中仔细进行了区分。简单地说，这两者都是对类进行扩充的机制，Mixin是用来增加新的成员变量和成员方法，而Plugin是对程序中设定的特别
调用点进行处理的插件(有点象回调函数或伪事件)。这样，我首先实现一个基于可用的类，当实现了新的功能时，使用Mixin机制将新功能加入到
类中。在类需要特殊处理的地方，预设插入点(不需要知道可能调用什么东西，只需要定义传入的参数接口即可)，然后需要在插入点插入新的代码
时，使用Plugin机制来实现。因为程序中可能不止一个类需要进行扩充，可能是很多的类，因此在Mixin和Plugin的机制中，还加入了接口识别功
能，也就是说：允许进行Mixin和Plugin的类要从统一的Mixin类进行派生，并且定义唯一的Mixin名称，用于区分不同的Mixin类。新增的Mixin或
Plugin需要使用一个插入函数将自身插入到相应的类中，需要提供要插入的Mixin名称。这样允许Mixin的类和可以Mixin以类中的内容就可以对应
起来了。(更详细的内容请参阅《技术手册》)

在3.3版开始，NewEdit更名为UliPad。

Version 1.0 发布于2004/05/27

Version 2.0 发布于2004/06/20

Version 2.1 发布于2004/06/28

Version 2.2 发布于2004/07/07

Version 2.3 发布于2004/07/20

Version 2.4 发布于2004/07/28

Version 2.5 发布于2004/08/19

Version 2.6 发布于2004/08/26

Version 2.6.1 发布于2004/09/10

Version 2.7 发布于2004/09/20

Version 2.8 发布于2004/10/08

Version 2.9 发布于2005/07/24

Version 3.0 发布于2005/10/16

Version 3.1 发布于2005/11/22

Version 3.2 发布于2005/01/18

Version 3.3 发布于2006/08/23

Version 3.4 发布于2006/10/08

Version 3.5 发布于2006/10/24

Version 3.6 发布于2006/12/04

术语和缩写词
~~~~~~~~~~~~~~

Python 
    一种强大的解释执行自动编译的动态型语言，纯面向对象，有灵活方便数据结构，拥有大量优秀的模块，语法
    清晰、简洁，而且可以在众多的平台上运行。
wxPython 
    wxWidgets项目的Python绑定。它是一个图型库，使用简单、方便，但同时功能强大，而且可以跨Windows, 
    Mac, linux运行。
槽类(slot class) 
    一个槽类就是可以允许实现Mixin的类，也叫目标类。它可以在运行时被进行动态扩充，比如增加类的属性、方
    法等。
Mixins 
    一种在运行时动态扩充机制，比如一个槽类在运行时使用Mixins技术可以增加它的类属性和方法。它是一种统称，
    我将其再细分为Mixin和Plugin。
Mixin 
    可以向类中增加新的属性和方法。
Plugin
    是一种（调用点/实现）框架，你需要先定义一个调用点，然后再实现它。这个引用点就定义在槽类中。一个调
    用点可以有多个实现，它们或者是全部执行，或者有选择地执行并返回结果。


创作思路
------------

软件开发是一件很痛苦的事情，大量新的需求与现有软件结构之间的冲突是造成软件难以维护的一个主要原因。很
多软件在刚开始时可能结构很好，便于扩充，但随着软件功能的丰富，代码的增加，可能会造成结构也变得不再适应
新需求的发展。对于编辑器软件来说，这样的问题更为明显。那么NewEdit就是想在如何构造一种灵活的结构方面进
行的一种有益地探索，同时它会发展成为一个专业、稳定地编辑器软件。因此，NewEdit的设计核心就是，如何构造一
种灵活的架构，使得新功能的增加更为方便和易于维护。

NewEdit使用的软件基础是Python+wxPython。因此，NewEdit可以充分地享受Python的动态特性所带来的好处，同
时由于使用了wxPython，还可以实现跨平台的运行。

这样，NewEdit的设计思想就是充分利用Python语言的动态特性，构造易于扩充而又灵活的软件体系。具体的实现技术
就是全部采用Mixin和Plugin的设计与开发方法，更为通俗地说法就是分布式类编程技术，或狭义地理解为插件编程
(但分布式类编程与插件编程是不同的，分布类编程包括Mixin和Plugin，而插件编程一般只包括Plugin，因此插件编程
的功能扩展是有局限的)。有时为了简单，我会叫分布类编程为Mixin，具体到技术细节时，会细分Mixin和Plugin。

比如，软件刚开始还是一个雏形，可能只有少数的功能。因此，会有一些实现了基础功能的类。当这些基础功能稳定，同
时有新的需求时，这时需要对这些类进行扩展。扩展基本分为两种：

 1. 新的方法、属性的实现 
 2. 增加对新方法、属性的调用入口

对于无法通过新的方法、属性实现的可能还需要增加新的类。此时可以对现有的类采用第二种扩展从而实现原有类与新
类之间的联系。

知道了扩展方式，那么在哪里去实现呢？对于第1种扩展，我的方法是，基本不动原来的类所在的文件，而是创建一个
新的文件，在这个新文件中实现新的方法、属性。然后通过一种机制把新的方法和属性与目标类进行融合，同时这种融
合是在运行时才实现的。这样，一个类的功能是随着开发的进行，不停地进行扩展。由于新的扩展并不是直接在原来的
文件中进行地修改，并且在一个文件中可以同时对多个类进行扩展，因此相对容易地知道本次扩展都做了哪些工作，对
于软件的维护非常方便。这些扩展会通过一种机制，在软件运行时自动与目标类进行融合，不需要做额外的工作。对于
这种扩展，我叫它为Mixin扩展。对于第2种扩展，我的方法是，在原来的类中增加相应的调用接口，同时在Mixin扩展
中增加对调用接口的具体实现，从而通过调用接口将新增的功能与原类联系起来。对于这种扩展我叫它为Plugin扩展，
也可以叫做插件扩展。

因此Mixin扩展的开发主要是对目标类进行功能扩展，如增加新的类方法，修改类方法，增加新的属性等。对于Plugin
扩展主要是在目标类中需要寻找合适的调用位置，定义相应的调用接口。同时实现具体的Plugin实现代码。

项目概述
----------

功能
~~~~~~~
本软件为一个编辑器，因此它主要适用于软件开发，特别是 Python 语言的开发，但由于它的架构灵活，因此你也可以
编写一些应用插件来扩展它的功能。开发这款编辑器的目的是提高程序员的开发效率，因此在功能上有许多的贴心操作
的功能。

特点
~~~~

整个软件都是基于Mixins的思想开发出来的，因此许多功能你可以根据需要去掉，而不会对整个软件有影响。正是因为
这种灵活的编辑框架，因此开发和维护都相对容易。这种编程的框架你也可以提取出来用在其它的项目开发当中。

它同时是一款国际化的软件，可以自动识别系统所使用的编码从而显示相应的本地语言。目前支持中文和英文。它对中
文的支持特别好。

项目的组织和管理
~~~~~~~~~~~~~~~~~~

本项为个人项目。在项目建立时就在 http://www.tigris.org 上申请了项目空间 http://http://newedit.tigris.org/，
整个项目使用CVS版本管理软件进行管理。并且在国内著名的 Python 社区 ―― 啄木鸟社区(http://www.woodpecker.org.cn)
上创建了wiki页面，发布信息和接受用户的反馈。

主要特性
~~~~~~~~~~~

下面列举的为NewEdit现在具有的主要特性，某些特性是别的编辑器所不具备的。新的特性还在不停地增加中：

多种语法高亮
  现支持Python, Html, C/C++语法高亮

Python类浏览
  可以浏览Python的类结构

Python程序运行
  可以在编辑器中直接运行Python程序，查看结果。设定运行路径，设定运行命令行参数。

扩展选词
  可以将'.'作为单词的一部分进行选择。

匹配选择
  可以对象( ) { } [ ] \' \' \" \"之类的包括起来的文本进行选择。如一段文本是使用()包括起来的，将插入点置于括号内，执行选择功能，则括号
  内的所有东西都被选中。如果括号之中还有嵌套的其它括号，则可以选择是优先左方向匹配选择还是优先右方向匹配选择，这样对于嵌套的括号也
  可以处理。

选择扩大
  在选中文本之后，执行本功能可以将选择区域左右进行扩展。本功能适合与匹配选择功能一起使用。在使用完匹配选择功能之后，这时
  你只选中了括号中的内容，但括号本身并未被选择，使用选择扩大可以将括号进行选中。

复制功能
  增加了许多复制功能。有些思路是从Vim中来的。在输入文本中，很有可能是拷贝以前的输入。这样，你可以只输入头几个字母，然后
  使用复制功能(包括字符，单词和句子)，这样可以从以前已经录入过的文本中查找开始头符与当前输入一致的文本(可能是词或句子)，会在当前位
  置显示一个提示窗口，你可以继续执行从而实现备选词或句子的前后翻动。当找到可以复制的内容时，输入回车即可补齐当前输入。极大方便输入。

文本括起
  可以将选中的文本使用某些字符包括起来，如(),{}。有些是定义好的，如果没有的话，可以用户输入自定义引用字符串。

直接查找
  一般编辑器的查找功能可以先将要查找的内容选中，然后打开查找对话框，这时刚才选中的内容即出现在查询对话框中，然后执行查找
  就可以进行查找了。但有时还是不方便，于是NewEit提供了按F4键直接对选中的内容进行查找，不会再打开查找对话框。

跳转到上次修改
  NewEdit可以记住上次修改的地方。当由于查阅程序而离开了刚才修改过的地方，使用本功能可以直接跳回到刚才改过的地方。

代码片段
  可以将重复性的文本保存为代码片段，在需要时将其插入文档中。

Ftp功能
  可以对远程的Ftp站点上的文件进行：打开、编辑、保存、删除、改名、新建文件、新建目录、上传、下传。

Blog编辑
  增过加入Blog插件就可以方便地进行Blog的写作。

文本转Html
  支持reStructuredText -> html, python source -> html, textile -> html

内置Html查看器
  可以使用内置的Html查看器来浏览Html文件(在Windows下是使用IE)

向导功能
  用户可以自定义模块，实现代码自动套用和代码框架的自动生成。

目录浏览
  可以打开一个或多个目录在左边栏，方便对文件进行编辑，浏览和切换。

自动扩展
  可以根据输入的内容自动实现追加、替换、正则查找等功能。

UliPad基本上是按照EditPlus的功能来实现的，同时加入了我认为在编程中非常方便的功能。因此有些功能与EditPlus是相似的，
不再叙述，更详细地请参阅《用户手册》。

作用范围
~~~~~~~~~~~

本软件是跨平台的软件，安装和配置简单。可以运行在象Windows, Mac, linux的环境下，只要安装好Python和wxPython即可运行本
软件。在Windows下同时还提供可执行的安装程序以方便用户安装。如果要安装一些第三方插件，需要按照插件地说明安装相应的其
它软件包。

项目开发平台和工具
--------------------

本软件是跨平台的。在项目初期是使用一般的文本编辑工具进行了，在项目具备一定功能之后就变成自开发的了，即自已开发自已。

应用领域
-----------

用于文档编辑、软件开发。当开发出特殊功能的插件后还可以用于其它目的，如：听MP3、Blog编辑、文件格式转换（这些已经有相
应的插件）。


`[返回]`_

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