5 个稳定版本
2.1.0 | 2024 年 7 月 14 日 |
---|---|
2.0.0 | 2024 年 3 月 3 日 |
1.0.2 | 2023 年 12 月 1 日 |
在 文本处理 中排名第 228
72KB
1.5K SLoC
dptran
英文 | 此处有日本语版
一个在您的命令行上运行 DeepL 翻译的工具。
它使用 Rust 编写,并通过 curl 连接到 DeepL API。
要使用,您需要从 https://www.deepl.com/en/pro-api/ 获取 DeepL API 密钥。
安装
二进制 crate
dptran
可在 crates.io 上找到。
- 将
rustup
或cargo
安装到您的计算机上。 - 运行这个
$ cargo install dptran
库 crate
dptran
默认包含了二进制 crate 的依赖库(如 clap
、serde_json 和
confy
)。
要仅安装库 crate,请通过添加 --no-default-features
参数来禁用默认功能。
$ cargo add dptran --no-default-features
或者,将以下内容添加到您的 Cargo.toml 文件中
[dependencies]
dptran = { version = "2.1.0", default-features = false }
二进制 crate
二进制 crate 提供了一个命令行工具,用于使用 DeepL API 翻译文本。
功能
- 从命令行参数翻译文本。
- 交互式翻译文本。
- 翻译多行。
- 从管道翻译文本。
- 从文件翻译文本。 (v2.1.0-)
- 从编辑器翻译文本。 (v2.1.0-)
- 从源文本中删除换行符。 (v2.1.0-)
- 输出到文本文件。 (v2.1.0-)
- 检查剩余待翻译的字符数。
- 检查有效的语言代码。
- 缓存翻译结果。 (v2.1.0-)
语言代码
如果您省略目标语言选项,则默认使用英语 (EN) 进行翻译。
有关语言代码的更多信息,请参阅从 DeepL API 获取的语言列表
$ dptran list -s # for the list of source languages
$ dptran list -t # for the list of target languages
使用方法
设置 API 密钥
请确保在使用服务之前获取您的 DeepL API 密钥并在 dptran 中设置。
API 密钥免费提供(每月最高 500,000 个字符)。
https://www.deepl.com/en/pro-api/
$ dptran set --api-key [API key]
从命令行参数进行翻译
如果没有指定任何语言,则自动检测源语言,并将目标语言默认设置为英语(EN)。
可以使用 -f
选项指定源语言,使用 -t
选项指定目标语言。
$ dptran Bonjour
Hello
$ dptran -t FR Hello
Bonjour
交互式模式翻译
$ dptran
> ありがとうございます。
Thank you very much.
> Ich stehe jeden Tag um 7 Uhr auf.
I get up at 7 a.m. every day.
> La reunión comienza a las 10 a.m.
The meeting begins at 10 a.m.
> 今天玩儿得真开心!
Had a great time today!
> quit
可以交互式地翻译多个源文本。
使用 quit
退出。
如果您想将源文本翻译成特定语言,请使用 -t
选项。
翻译多行
要输入多行,请使用 -m 选项。
然后输入一个空行以发送输入。
$ dptran -m -t JA
> A tool to run DeepL translations on your command line.
..It's written in Rust, and uses curl to connect to the DeepL API.
..To use, you need to get the DeepL API key from https://www.deepl.com/en/pro-api/.
..
コマンドラインでDeepL翻訳を実行するためのツールです。
これはRustで書かれており、DeepL APIへの接続にはcurlを使用します。
使用するには、https://www.deepl.com/en/pro-api/ から DeepL API キーを取得する必要があります。
从管道翻译
您可以使用 dptran 翻译其他命令的输出。
例如,将手册页的内容翻译成日语。
$ man ls | cat | dptran -t JA
从文件翻译
您可以使用 dptran 通过使用 -i
选项来翻译文本文件的内容。
$ dptran -i file.txt
从编辑器应用程序(例如 vi, vim, nano, emacs 等)翻译
您可以使用 dptran 通过使用 -e
选项从编辑器翻译内容。
示例:vi
$ dptran set -e vi
$ dptran -e
示例:vim
$ dptran set -e vim
$ dptran -e
示例:nano
$ dptran set -e nano
$ dptran -e
示例:emacs
$ dptran set -e "emacs -nw"
$ dptran -e
删除换行符
您可以使用 -r
选项从源文本中删除换行符。
$ dptran -t FR -e -r
例如,以下输入(在编辑器中)
Hello!
How are you?
将翻译为如下一行
Bonjour, comment allez-vous ?
输出到文本文件
您可以使用 -o
选项将翻译结果输出到文本文件。
$ dptran -t JA Hello -o output.txt
显示帮助信息
有关命令的更多信息,请参阅帮助信息
$ dptran -h
显示剩余可翻译字符数
$ dptran -u
usage: 222 / 500000 (0%)
remaining: 499778
您可以在当前月份看到可以通过 DeepL API 翻译的剩余字符数。
免费 DeepL API 计划每月最多可翻译 500,000 个字符。
更改默认目标语言
默认设置为英语(EN-US)。
您可以使用 set --target-lang
更改它。
例如,要将它更改为日语(JA),请执行以下操作
$ dptran set --target-lang JA
重置设置
您可以重置所有设置。
注意:API 密钥也将重置。如果您想再次使用 dptran,请重新设置 API 密钥。
$ dptran set --clear
卸载
$ cargo uninstall dptran
库包(v2.0.0-)
有关库包的文档,请参阅此处。
依赖项
~9–18MB
~263K SLoC