Skip to content

command_line.zh.md

Latest commit

 

History

History
46 lines (40 loc) · 3.86 KB

command_line.zh.md

File metadata and controls

46 lines (40 loc) · 3.86 KB

🏗️ 命令行使用

后端引擎 （中文版）

默认引擎是 google 翻译，中国大陆IP无法访问。 对于中国大陆IP的用户，我们提供腾讯引擎，虽然其准确性不如 google 引擎。 使用腾讯引擎需要注册 腾讯翻译API账号。 注册后，您可以在腾讯控制台中获取secret ID（不是APP ID！）和secret Key。 腾讯翻译是据我们所知除谷歌翻译外免费额度最高的翻译API，每月有500万字符免费额度，且不手动充值情况下不会扣费（即不用担心误操作）。

命令行安装

  1. 安装 Python3 和 pip。
  2. pip install --upgrade mathtranslate

命令行使用

对于 Windows 用户，您可能需要以管理员身份运行 cmd 或 powershell 。

  1. 准备或生成一个 tex 文件或项目。你可以用如下方式得到 tex 文件或项目：
    • 对于大多数 arxiv 论文， latex 源代码是公开的。对于 arxiv 论文，我们提供了一个简单 API 从 arxiv number 一键翻译整个项目。
    • 使用 mathpix 把你想翻译的 pdf 转成 latex 代码。mathpix 可以直接把 pdf 或截图转换成 latex 代码，这两种方式我们都可以处理。不幸的是，mathpix 在使用超过一定数量之后需要收费，这里是价格表。
  2. （腾讯翻译API用户）运行translate_tex --setkey来存储 API secretID 和 secretKey。
  3. 使用命令行翻译　tex 文件或项目
    • 翻译单个文件: translate_tex input.tex -o output.tex 会生成翻译后的 tex 文件 output.tex。
    • 翻译 arxiv 项目: translate_arxiv 2205.15510 会生成翻译后的 tex 项目 2205.15510.zip。
  4. 编译您的 tex 文件。对于单个文件，您可以用 texlive 的命令 xelatex output.tex 编译。中文翻译需要 xeCJK 包。对于 arxiv 项目我们建议把得到的 .zip 文件上传到 overleaf 在线编译 (New Project - Upload Project)。注意，您需要在 Menu - Compiler 中设置成 XeLatex 编译器。
  5. 您可以通过命令行参数 -engine、-from、-to 更改翻译语言和引擎的默认设置。 例如 translate_tex -engine tencent input.tex -o output.tex。 您还可以通过 translate_tex --setdefault 永久更改设置。 您可以通过 translate_tex --help 查看更多细节。translate_arxiv也提供完全相同的命令行参数，它们的效果是一样的。

如果您有任何问题或有兴趣做出贡献，请通过 susyustc@gmail.com 与我联系或加入 QQ 群 288646946 。

自定义命令

在翻译过程中您可能会遇到一些内容没有被翻译出来，这一般是因为有一些自定义的命令没有被识别到导致的。在命令行模式中我们提供了自定义命令的功能，您只需创建一个文件（例如MT_additional_commands.txt），里面定义需要翻译的命令，例如：

# if you need more, just add lines with the same format (don't miss the ","!)
# each line is in the format of (command_name, N, (n1, n2, ...)), 
# N is the total number of arguments, 
# n1, n2, ... are the index of arguments requiring translation (counting from 0)
additional_commands = [
  # latex: \mycommand1{translation needed}
  ('mycommand1', 1, (0, )),
  # latex: \mycommand2{translation not needed}{translation needed}
  ('mycommand2', 2, (1, )),
  # latex: \mycommand3{translation needed}{translation not needed}
  ('mycommand3', 2, (0, )),
  # latex: \mycommand4{translation needed}{translation not needed}{translation needed}{translation not needed}
  ('mycommand4', 4, (0, 2)),
  # practical example: \textcolor{red}{Need translation here}
  ('textcolor', 2, (1, )),
]

之后加上命令行参数 -commands MT_additional_commands.txt 即可翻译自定义的命令。