我擼了一個(gè)劃線翻譯工具！

作者： Sincostan 2020-11-04 07:56:19

這里將要介紹的是一種在 Linux 平臺(tái)實(shí)現(xiàn)的劃詞翻譯工具，當(dāng)然在考慮自己實(shí)現(xiàn)一個(gè)如此功能的工具前，本人也是在網(wǎng)上搜索了一些在 Linux 平臺(tái)實(shí)現(xiàn)的類似的開源工具，例如 pdfTranslator，popup-dict，但它們的安裝和配置都顯得比較麻煩，而且使用起來(lái)也并不方便。

?[[350260]]?

本人實(shí)現(xiàn)這個(gè)工具的初衷本是方便自己看一些英文文獻(xiàn)和書籍的，極為方便，考慮到分享出去可以讓更多人受惠，因此這里詳細(xì)介紹一下它的實(shí)現(xiàn)步驟。

本文所實(shí)現(xiàn)的劃詞翻譯工具主要有以下特性：

支持英文單詞和短語(yǔ)到中文的翻譯
劃詞翻譯，終端顯示
自動(dòng)過濾選中文本中的換行等特殊字符
只依賴少數(shù)幾個(gè) Linux 命令工具

下面有動(dòng)圖進(jìn)行演示。

本人所使用的環(huán)境是運(yùn)行在 VMware 虛擬機(jī)下的 Linux 發(fā)行版 Ubuntu 18.04.3 LTS，因此這里介紹的步驟可能與其他 Linux 發(fā)行版中的實(shí)現(xiàn)略有不同。下面就來(lái)一步一步的實(shí)現(xiàn)它吧。

一. 安裝必要的命令

1.xclip

$ sudo apt install xclip

xclip 命令建立了終端和剪切板之間通道，可以用命令的方式將終端輸出或文件的內(nèi)容保存到剪切板中，也可以將剪切板的內(nèi)容輸出到終端或文件。詳細(xì)的用法可以使用 man xclip，見其手冊(cè)。這里介紹幾個(gè)常用的用法。

$ xclip file_name # 文件內(nèi)容保存到X window剪切板
$ xclip -selection c file_name #文件內(nèi)容保存到外部剪切板
$ xclip -o # X window剪切板內(nèi)容輸出到終端顯示
$ xclip -selection c -o # 外部剪切板內(nèi)容輸出到終端顯示

值得強(qiáng)調(diào)的是，這里所說的 X window 剪切板，簡(jiǎn)單的說就是你用鼠標(biāo)選擇的文本會(huì)實(shí)時(shí)的存放在這個(gè)剪切板，使用鼠標(biāo)中鍵可以粘貼。而外部剪切板是保存你用 ctrl+c 復(fù)制的文本，ctrl+v 可以粘貼。這兩個(gè)地方是不一樣的。

2.translate-shell

$ sudo apt install translate-shell

這是命令行版的谷歌翻譯工具，之前叫做 Google Translate CLI 是一款借助谷歌翻譯(默認(rèn))、必應(yīng)翻譯等來(lái)翻譯的命令行翻譯器。它讓你可以在終端訪問這些翻譯引擎。translate-shell 在大多數(shù) Linux 發(fā)行版中都能使用。常用的方法如下：

$ trans en:zh [word] # 英文到中文的單詞翻譯
$ trans en:zh -b [text] # 簡(jiǎn)要的輸出，進(jìn)行文本翻譯

需要注意的是，使用這個(gè)翻譯工具需要你能夠訪問外網(wǎng)，或者通過修改 translate-shell 的默認(rèn)翻譯引擎，具體的方法這里就不闡述了。

二. 編程實(shí)現(xiàn)

這個(gè)工具整體的思路就是 C 程序?qū)崟r(shí)檢測(cè)鼠標(biāo)按鍵的動(dòng)態(tài)，當(dāng)檢測(cè)到用戶使用鼠標(biāo)選擇一段文本之后，調(diào)用 shell 腳本獲取 X window 剪切板的內(nèi)容進(jìn)行翻譯后輸出到終端顯示。

1. 定位鼠標(biāo)設(shè)備文件

鼠標(biāo)作為輸入設(shè)備。其信息可以在文件 /proc/bus/input/devices 中，使用下列命令查看：

$ sudo cat /proc/bus/input/devices
I: Bus=0011 Vendor=0002 Product=0013 Version=0006
N: Name="VirtualPS/2 VMware VMMouse"
P: Phys=isa0060/serio1/input1
S: Sysfs=/devices/platform/i8042/serio1/input/input4
U: Uniq=
H: Handlers=mouse0 event2
B: PROP=0
B: EV=b
B: KEY=70000 0 0 0 0
B: ABS=3

其中的 Handlers 的值 event2 表示可以在 /dev/input/event2 文件下讀取鼠標(biāo)的狀態(tài)。需要注意的是，對(duì)于不同的設(shè)備，讀取鼠標(biāo)的狀態(tài)的文件可能不一樣，比如也可能是 /dev/input/event3 。我們可以使用下面的命令找到你的鼠標(biāo)對(duì)應(yīng)的是哪一個(gè) event。

$ sudo cat /dev/input/event2 | hexdump # 測(cè)試時(shí)改變數(shù)字即可

比如，當(dāng)我運(yùn)行上面這條命令之后，我移動(dòng)鼠標(biāo)、按鼠標(biāo)左鍵/中鍵/右鍵，終端都會(huì)輸出一些值，這就說明 event2 文件就是對(duì)應(yīng)著我的鼠標(biāo)。如果操作鼠標(biāo)沒有反應(yīng)，說明這個(gè)就不是。你可以通過這種方法找到你的鼠標(biāo)對(duì)應(yīng)的 event 文件。

2. Linux 下獲取按鍵響應(yīng)

在 Linux 內(nèi)核中，input 設(shè)備用 input_dev 結(jié)構(gòu)體描述，使用 input 子系統(tǒng)實(shí)現(xiàn)輸入設(shè)備驅(qū)動(dòng)的時(shí)候，驅(qū)動(dòng)的核心工作就是向系統(tǒng)報(bào)告按鍵、觸摸屏、鍵盤、鼠標(biāo)等輸入事件(event，通過 input_event 結(jié)構(gòu)體描述)，不再需要關(guān)心文件操作接口，因?yàn)?input 子系統(tǒng)已經(jīng)完成了文件操作接口 Linux/input.h 這個(gè)文件定義了 event 事件的結(jié)構(gòu)體，API 和標(biāo)準(zhǔn)按鍵的編碼等。

// 結(jié)構(gòu)體定義見 input.h
struct input_event
{
struct timeval time; // 按鍵時(shí)間
__u16 type;          // 事件類型
__u16 code;          // 要模擬成什么按鍵
__s32 value;         // 是按下還是釋放
};

// 下面宏定義見 input-event-coses.h
// type
#define EV_KEY 0x01
#define EV_REL 0x02
#define EV_ABS 0x03
// ...

// code
#define BTN_LEFT 0x110
#define BTN_RIGHT 0x111
#define BTN_MIDDLE 0x112
// ...

// value
#define MSC_SERIAL 0x00
#define MSC_PULSELED 0x01
// ...

這里稍微介紹一下 type，指事件類型，常見的事件類型有：EV_KEY，按鍵事件，如鍵盤的按鍵(按下哪個(gè)鍵)，鼠標(biāo)的左鍵右鍵(是否擊下)等;EV_REL，相對(duì)坐標(biāo)，主要是指鼠標(biāo)的移動(dòng)事件(相對(duì)位移);EV_ABS，絕對(duì)坐標(biāo)，主要指觸摸屏的移動(dòng)事件。

3. 編寫 C 程序

下面就可以編寫程序來(lái)檢測(cè)鼠標(biāo)的動(dòng)態(tài)了。首先在你的用戶~目錄下建立文件夾 Translator。在 Translator 里建立一個(gè) ct.c 源文件，代碼如下：

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <linux/input.h>
#include <fcntl.h>

int main(void)
{
int keys_fd;
struct input_event t;

// 注意這里打開的文件根據(jù)你自己的設(shè)備情況作相應(yīng)的改變
keys_fd = open("/dev/input/event2", O_RDONLY);
if (keys_fd <= 0)
{
printf("open /dev/input/event2 error!\n");
return -1;
}

while (1)
{
read(keys_fd, &t, sizeof(t));
if (t.type == EV_KEY)              // 有鍵按下
if (t.code == BTN_LEFT)        // 鼠標(biāo)左鍵
if (t.value == MSC_SERIAL) // 松開
// 調(diào)用外部shell腳本
system("~/Translator/goTranslate.sh");
}
close(keys_fd);
return 0;
}

然后就是調(diào)用 gcc 編譯器生成可執(zhí)行文件 ct ：

$ gcc ct.c -o ct

4. 編寫 shell 腳本翻譯剪切板內(nèi)容

在 Translator 里建立 goTranslate.sh 文件，內(nèi)容如下：

#!/bin/bash

str_old=$(cat ~/Translator/lastContent)
str_new=$(xclip -o 2>/dev/null | xargs)
if [[ "$str_new" != "$str_old" && $str_new ]]; then
echo -e "\n"
count=$(echo "$str_new" | wc -w)
if [ "$count" == "1" ]; then
echo -n -e "$str_new " >>~/Translator/words
echo "$str_new" | trans :zh-CN | tail -1 | cut -c 5- | sed "s,\x1b\[[0-9;]*[a-zA-Z],,g" | tee -a ~/Translator/words
else
echo "$str_new" | trans :zh-CN -b
fi
echo "$str_new" >~/Translator/lastContent
fi

原理非常簡(jiǎn)單，讀者自行了解。這里我們還要在 Translator 里建立一個(gè) lastContent.txt 文件作為緩存，目的是本次調(diào)用腳本時(shí)能夠獲取上一次調(diào)用時(shí)翻譯的文本內(nèi)容，如果和本次調(diào)用的翻譯文本一樣，則本次就不進(jìn)行翻譯。

設(shè)置 ct 別名

這里已經(jīng)可以通過下面的命令運(yùn)行程序了：