summaryrefslogtreecommitdiff
path: root/README.md
blob: fba7df7eeb0cada8e87e695c3dc78679c9314a29 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
FQTerm
======
FQTerm是为Telnet BBS设计的终端模拟器(俗称Term),支持Telnet,SSH协议。

本项目源自QTerm-Qt3,从2008年起,由Curvlet和dp2重写并移植至Qt4.

现在FQTerm的原开发组成员已经停止了该项目的维护,现由ArchLinux@newsmth
维护并进行Qt5的移植。

如何贡献源码
============
fork本项目,然后自己开发,提交自己的更改,再创建pull request.
详情请看GitHub的帮助:
- https://help.github.com/articles/fork-a-repo
- https://help.github.com/articles/using-pull-requests

TODO
====
- ~~Bug: Qt5分支中Ctrl按键异常 (暂时使用Mac OS的处理方法解决)~~
- Bug: Qt5分支中退出时SIGSEGV
- ~~Maybe something wrong with imageviewer (Qt5)~~
- 考虑代码重构
- Bug: 处理不完整GBK字符时存在一些异常,特别是在Qt5分支

安装
=======
ArchLinux用户可以直接从AUR安装,如
```
yaourt -S fqterm-git
```
或
```
# Qt5分支
yaourt -S fqterm-qt5-git
```

其他用户可手动编译,大致步骤如下:    
解决依赖: Qt, OpenSSL, alsa-lib(Linux)    
获取代码:      
```
git clone https://github.com/mytbk/fqterm.git
```
要用Qt5分支,可以在使用 ```--branch Qt5``` 参数,即:
```
git clone https://github.com/mytbk/fqterm.git --branch Qt5
```
然后开始编译:      

```
# 假设FQTerm源码目录为fqterm
mkdir build
cd build
cmake ../fqterm
make
# 以root身份安装,以下用sudo获取root权限
sudo make install
```

Windows版本
==============
- 在Linux下用MXE交叉编译,运行时错误,可能原因是MXE的Qt缺少语言Codec
- MinGW: 正常编译及运行,编译方法如下  
```
REM 假设源码在C:\fqterm, OpenSSL在C:\openssl, Qt在C:\Qt\4.8.6.static
mkdir build
cd build
cmake -G "MinGW Makefiles" -DOPENSSL_ROOT_DIR=C:\openssl -DCMAKE_CXX_FLAGS=-mwindows -DCMAKE_BUILD_TYPE=Release -DQT_QMAKE_EXECUTABLE=C:\Qt\4.8.6.static\bin\qmake.exe C:\fqterm
mingw32-make
REM 生成的fqterm.exe即为程序文件
```
- MSVC: 未测试