如何制作定制版本

从3.3.17版本开始，CTerm允许用户制作定制版本。

对于与此相关的版权问题，除了 license.txt 中所有条款之外，补充声明如下：

1、用户制作的 Logo 图片（具体方法见下文）中必须包含清晰可辨的“CTerm”或“CTerm III”字样；

2、如果用户制作的定制版本只是作为私人使用，不用作网络发布和其它形式发布，则不需征求作者同意；

3、如果用户制作的定制版本需要用于网络发布或其它形式发布，则需要征求作者同意。主要是需要向作者发送电子邮件，说明定制版本的基本情况（做了哪些修改，将用于何处发布），并把用户制作的 Logo 图片发送给作者。作者收到邮件后，将检查 Logo 图片是否符合要求，回复是否同意发布（一般情况下，都会同意的）。在得到作者同意之后，才允许用于网络发布或其它形式发布。发布之后将相关地址通知作者。

4 、定制版本的发行包及发行网页应有对该定制版本的详细说明文档，描述以哪个版本为基础，修改了哪些内容。

具体制作方法说明如下：

1、用户自定义的内容包括：主界面中的 Logo 图片、地址簿中的站点及其顺序、最喜爱的站点、启动时自动连接的站点、站点属性、自定义命令（“自定义按钮”工具栏）、快捷键、IP 数据库、系统配置参数、语言包及脚本。

2、定制主界面的 Logo 图片：用户制作一幅合适的BMP格式图片（按照上文的版权声明，其中必须包含清晰可辨的“CTerm”或“CTerm III”字样。另外，由于 CTerm 本身的显示界面为黑色背景，建议图片也以黑色为好），并以“mylogo.bmp”的名称保存于 user 文件夹下（CTerm 启动时检查是否存在 user\mylogo.bmp，若存在则启用为 Logo 图片）。

3、站点设置：打开地址簿对话框，(1)使用该对话框左方的上下箭头按钮，调整站点列表中的站点顺序；(2)选中站点名称，可以设置为“启动时自动连接”的站点（只允许一个）和“最喜爱的站点”（最多5个）；(3)（新增站点）选中站点名称，修改其名称后点击“加入/更新”按钮，如果该名称不存在则为加入新站点；(4)选中站点名称，点击“详细设置”按钮可以设置该站点的详细参数；(5)用户不能删除地址簿中原有的站点，也不能恶意修改其它站点的参数。(5)对于部分没添加到设置界面又必须设置的参数，可直接编辑 user\addrinfo.ini，在站点名称（需要与地址簿中的名称相同）对应的小节下面添加参数，如果修改此文件需要包含之。(6)发行包里的address.bok和addrinfo.ini在发行时应该加上.example后缀，以避免覆盖用户数据。

4、自定义按钮：点击菜单“工具 > 自定义命令”，或点击“自定义按钮”工具栏上的“定制”按钮，就可以手工编辑该工具栏对应 user\mycmds.txt 文件。保存该文件并点击“自定义按钮”工具栏上的“更新”按钮即可更新。该文件发行时同样要加上.example后缀。

5、自定义快捷键：点击菜单“工具 > 自定义快捷键”，就可以自定义快捷键（保存在 user\myaccel.dat 中）。

6、自定义IP：CTerm 的“查看IP地址的实际地理位置”和“自动判断IP地址并替换为实际地理位置”功能是通过检索IP数据库来实现的。IP数据库包括通用IP数据库和用户IP数据库。CTerm自带的通用IP数据库是“珊瑚虫精简版IP数据库”（CoralWry.dat），用户可以把另外的通用IP数据库置于CTerm文件夹中，并在“系统参数设置”对话框中的“IP与图片”标签下点击IP数据库名称按钮，可以设定通用IP数据库。而用户IP数据库是 user\myips.txt，用户可以手工编辑该文件（CTerm 本身只提供了 myips.txt.example，这个文件仅用作示例，用户的文件应该保存为 myips.txt）。

9、定制系统配置参数：可从系统选项对话框修改；对未在该对话框的参数，可直接编辑user\CTerm.ini，具体参考“系统参数.txt”及发布更新文档（whatsnew.txt, history.txt）。若有配置参数修改，发布时需要包含CTerm.ini。

10、对高级用户，可以修改相关脚本，添加高级功能，如：(1)修改ct_system.py，OnStart()，可添加更多自启动站点；(2)编写脚本，将之添加到onstart.lst，可以实现启动执行其它功能。(3)对于站点界面比较特殊的，可能导致CTerm内部算法对某些状态识别不正确，可以修改sitestatus.py改正，在站点参数启用“python状态识别”。特别注意：修改的脚本可能会覆盖其他用户定制的脚本，发行时要特别注明。

11、界面语言：在language目录下添加、修改相关ini语言包。欢迎帮助改进，完善界面语言的翻译。

12、由于CTerm运行目录涉及到很多临时文件，包括python脚本编译产生的.pyc，各种log，各种非必要的配置数据，等等。为避免发行版包含过多的临时文件或遗漏某些必需的文件，建议定制之前将原始版本解压并复制两份，如一个文件夹为“CTerm”，另一个为“CTerm测试”。所有的修改、测试工作都在“CTerm测试”下进行，完成后把相关文件拷贝到发行文件夹“CTerm”的相关位置。有的需要改名：mycmds.txt，address.bok和addrinfo.ini等文件要加.example后缀。

13、在完成上一步操作之后，可以对整个“CTerm”文件夹打包，用于发行（提醒一下：shortcut.vbs 是用于在桌面上生成快捷方式的，打包发行时或许用得上）。打包之前，如有必要，最好查一下毒。