一. 背景介绍

本人以前在win10上经常使用xshell来登陆服务器。xshell提供了很丰富的功能和快捷键。个人比较喜欢的包括三个功能

• 终端透明
• 双击时根据分隔符选中文字
• 突出显示

但是自从使用deepin作为主力操作系统以后，固执地使用原创应用而非第三方应用的执念一直伴随着我。所以deepin-terminal成为我使用频率最高的应用。但是deepin-terminal相对于xshell这种重量级的专业终端来说，不仅轻量，功能也相对单一。

比如deepin-terminal虽然可以通过设置来实现透明，但是缺少设置透明的快捷键。在deepin15.11 里面还可以通过ctrl+滑轮来调整，但是在deepin 20+版本里，干脆直接取消了透明快捷操作方式，直接放到终端设置里面。

这让喜欢通过快捷键直接调整透明度，以达到单个屏幕复用，可视多个窗口的我极为抓狂。

求救N次无果后，最终决定自己重新编译，来实现自己想要的功能。

本篇博客的操作过程，就是以此为背景，为deepin-terminal增加一个透明度快捷键的功能。

二. 操作过程

github上，deepin-terminal项目的readme给了言简意赅的编译过程。先安装依赖，然后创建编译目录，最后编译和安装。

1. 首先安装依赖环境

sudo apt-get intall cmake pkg-config qtbase5-dev qtbase5-private-dev qttools-dev-tools libdtkwidget-dev lxqt-build-tools libdframeworkdbus-dev libutf8proc-dev libatspi2.0-dev libglib2.0-dev libsecret-1-dev

2. 然后下载源码

git clone https://github.com/linuxdeepin/deepin-terminal.git

本篇博客使用的版本是:5.4.0.12

3. 理清思路

本人并没有强大的cpp和qt编程背景，直接面向源码和搜索引擎。

在半个月反复啃了几次源码之后，稍微理出一些头绪。

deepin-terminal的代码相对稳定，添加一个快捷键应该不难。

在原有代码基础上，最大程度保持代码风格的同时，添加相应的功能代码就可以。

这里不得不感谢官方开发人员们统一的编码风格和强大的注释。注释真的很重要。

总结一下修改过程：

• 首先要在deepin-terminal的“设置”选项中，添加一个“透明度快捷键”的选项
• 其次把该快捷键绑定到一个可以改变终端的信号上

细化一下过程：

• deepin-terminal的“设置”是通过json文件生成
• json中是英文，因此需要翻译成中文
• 在窗口功能中绑定快捷键盘以及信号处理函数

进一步细化：

• deepin-terminal-5.4.0.12/src/assets/other/default-config.json 该文件就是”设置“面板的生成文件。在这里按照规则添加对应的内容
• deepin-terminal-5.4.0.12/src/settings/settings_translation.cpp 该程序文件功能是把default-config.json中指定的英文内容翻译出来
• deepin-terminal-5.4.0.12/translations/deepin-terminal_zh_CN.ts 该文件指定了要把英文到中文的翻译内容。需注意翻译文件的行号
• deepin-terminal-5.4.0.12/src/main/mainwindow.cpp 该文件的主要负责绑定快捷键与处理快捷键的信号
• deepin-terminal-5.4.0.12/src/main/mainwindow.h 该文件声明mainwindow.cpp自定义的快捷键信号处理方法

4. 正式编码

我在摸索前进的过程中，实现了两个版本。

第一个版本主要实现了同一个终端实例情况下，当前标签页通过快捷键实现”半透明“和”不透明“的功能，而其他标签保持默认。这里添加了两个快捷键。

第二个版本主要实现了同一个终端实例情况下，所有标签页保持状态同步，即都透明或者都不透明，仅一个快捷键实现状态翻转(类似于xshell)。

4.1 第一个版本

1. 修改源码文件：deepin-terminal-5.4.0.12/src/settings/settings_translation.cpp

在该文件的内容

auto shell_profile = QObject::tr("Shell profile");
Q_UNUSED(shell_profile);

auto shortcuts_terminal_seventy_percent_opacityName = QObject::tr("Translucent");
Q_UNUSED(shortcuts_terminal_seventy_percent_opacityName);
auto shortcuts_terminal_one_hundred_percent_opacityName = QObject::tr("Opaque");
Q_UNUSED(shortcuts_terminal_one_hundred_percent_opacityName);

{   
	"key": "copy",
	"name": "Copy",
	"type": "shortcut",
	"default":  "Ctrl+Shift+C"
}, 

{
	"key": "opaque",
	"name": "Opaque",
	"type": "shortcut",
  	"default": "Alt+e"
},
{
	"key": "translucent",
	"name": "Translucent",
	"type": "shortcut",
	"default": "Alt+r"
},

connect(createNewShotcut("shortcuts.terminal.copy"), &QShortcut::activated, this, &MainWindow::slotShortcutCopy);

connect(createNewShotcut("shortcuts.terminal.opaque"), &QShortcut::activated, this, &MainWindow::slotShortcutOpaque);
connect(createNewShotcut("shortcuts.terminal.translucent"), &QShortcut::activated, this, &MainWindow::slotShortcutTranslucent);

void MainWindow::slotShortcutCopy()
{
    TermWidgetPage *page = currentPage();
    if (page) {
        page->copyClipboard();
    }    
}

void MainWindow::slotShortcutOpaque()
{
    TermWidgetPage *page = currentPage();
    if (page) {
        page->setTerminalOpacity(1);
        page->focusCurrentTerm();
    }    
}
void MainWindow::slotShortcutTranslucent()
{
    TermWidgetPage *page = currentPage();
    if (page) {
        page->setTerminalOpacity(0.5);
        page->focusCurrentTerm();
    }    
}

void slotShortcutCopy();

void slotShortcutOpaque();
void slotShortcutTranslucent();

cd build
cmake ..
make 
sudo make install

auto shell_profile = QObject::tr("Shell profile");
Q_UNUSED(shell_profile);

auto shortcuts_terminal_seventy_percent_opacityName = QObject::tr("Opacity fast");
Q_UNUSED(shortcuts_terminal_seventy_percent_opacityName);

{
	"key": "copy",
	"name": "Copy",
	"type": "shortcut",
	"default":  "Ctrl+Shift+C"
},

{
	"key": "opacity_fast",
	"name": "Opacity fast",
	"type": "shortcut",
	"default": "Alt+r"
},

<message>
	<location filename="../src/settings/settings_translation.cpp" line="85"/>
	<location filename="../src/main/mainwindow.cpp" line="2181"/>
	<source>Copy</source>
	<translation>复制</translation>
</message>

<message>
	<location filename="../src/settings/settings_translation.cpp" line="159"/>
	<source>Opacity fast</source>
	<translation>透明快捷键</translation>
</message>

connect(createNewShotcut("shortcuts.terminal.copy"), &QShortcut::activated, this, &MainWindow::slotShortcutCopy);

connect(createNewShotcut("shortcuts.terminal.opacity_fast"), &QShortcut::activated, this, &MainWindow::slotShortcutOpacityFast);

void MainWindow::slotShortcutCopy()
{
    TermWidgetPage *page = currentPage();
    if (page) {
        page->copyClipboard();
    }    
}

void MainWindow::slotShortcutOpacityFast()
{
    TermWidgetPage *page = currentPage();
    if (page) {
        if (Settings::instance()->settings->option("basic.interface.opacity")->value().toInt() == 100) {
            page->setTerminalOpacity(0.7);
            Settings::instance()->settings->option("basic.interface.opacity")->setValue(70);
        }else{
            page->setTerminalOpacity(1.0);
            Settings::instance()->settings->option("basic.interface.opacity")->setValue(100);
        }
        page->focusCurrentTerm();
    }
}

void slotShortcutCopy();

void slotShortcutOpacityFast();

cd build
cmake ..
make 
sudo make install