OmegaT 4.2 - 用户指南

# 安装和运行 OmegaT

## Windows 用户

### 下载安装包

是否有与 Oracle 的 Java 8 JRE 相兼容的 Java 实现?

- 是： 下载 `OmegaT_4.n.n_Windows_without_JRE.exe`。

- 否 / 吾不知： 下载 `OmegaT_4.n.n_Windows.exe`。

  这个包捆绑有 Oracle 的 Java 运行时环境（JRE）。此 JRE 不会干扰系统上可能已经安装的其他 Java 实现。

### 安装 OmegaT

要安装 OmegaT，只需双击已下载的程序。

在安装开始时，你可以选择安装过程中使用的语言。在下一个窗口中，你可以选择是否要让 OmegaT 也使用这个选定的语言。如果你勾选了相应的复选框，`OmegaT.l4J.ini` 文件会被修改为使用选定的语言（详细信息请参阅下一章）。稍后，在接受了许可协议后，安装程序会询问你是否要在 开始 菜单中创建文件夹，以及是否要在桌面以及快速启动栏中创建快捷方式——你也可以稍后通过将 `OmegaT.exe` 拖拽到桌面上或开始菜单里来创建相应的快捷方式。最后一屏让你可以查看所安装版本的自述文件和变更记录文件。

### 运行 OmegaT

安装 OmegaT 之后，可以点击 `OmegaT.jar` 来直接启动它或者从命令行来直接启动它。

不过，启动 OmegaT 的最简单的方式是执行 `OmegaT.exe` 程序。在这种情况下，程序的启动参数将从 `OmegaT.l4J.ini` 文件中读取，该文件与 exe 文件处于同一文件夹，您可以编辑该文件来反映您的设置。以下 INI 文件示例保留了 1 GB 内存、要求使用法语作为用户语言并且将国家设置为加拿大：

    # OmegaT.exe runtime configuration
    # To use a parameter, remove the '#' before the '-'
    # Memory
    -Xmx1024M
    # Language
    -Duser.language=FR
    # Country
    -Duser.country=CA

建议：如果 OmegaT 在 Windows 的远程桌面会话中运行缓慢，你可以使用此选项：

    -Dsun.java2d.noddraw=false

### 升级 OmegaT

此处的信息仅适用于 OmegaT 的“传统”Windows 版本。它不适用于自动升级的 Web Start 版本，也不适用于安装在 Windows 上的跨平台版本。

如果您已经在电脑上安装了某个版本的 OmegaT 且希望升级到更新版本，有两个选择：

- 在现有安装上覆盖安装。 要执行此操作，只需要在安装新版本时选择与现有安装相同的安装文件夹。OmegaT 的“旧”版本将被覆盖，但其中的所有设置都会被保留。这包括你对 `OmegaT.l4J.ini` 文件所做的所有更改，以及，如果你使用了，你的启动脚本（`.bat` 文件）。

使用这种方法您可以下载“不含 JRE 的 Windows” 版本，因为新的安装可以使用已有的 JRE。

- 安装到新的文件夹。 这样你就可以同时保留两个版本，在您对新版本感到满意之前您可能希望这么做。此方法也会使用你在 OmegaT 内所设置的首选项与设置。不过，在这种情况下：

  - 如果你对 `OmegaT.l4J.ini` 文件做出了更改，或者使用了 .bat 温江，你必须把它们复制过去。

  - 如果您已安装的程序是“带 JRE 的 Windows”版本，那么新的安装程序也必须是“带 JRE 的 Windows”版本。

## Linux（Intel）用户

### 下载正确的安装包

是否有与 Oracle 的 Java 8 JRE 相兼容的 Java 实现?

- 是： 下载 `OmegaT_4.n.n_Without_JRE.zip`。

- 否 / 吾不知： 下载 `OmegaT_4.n.n_Linux.tar.bz2`。

  这个包捆绑有 Oracle 的 Java 运行时环境（JRE）。此 JRE 不会干扰系统上可能已经安装的其他 Java 实现。

### 安装 OmegaT

解压缩下载的文件。这将在工作文件夹中创建一个 `omegat/` 文件夹，你可以在其中找到运行 OmegaT 所需的全部文件。要解压缩 `.tar.gz` 文件：

    $ tar xf downloaded_file.tar.gz

### 将 OmegaT 添加到菜单（KDE）或面板（Gnome）中

#### KDE 4 用户

你可以这样来将添加 OmegaT 到菜单中：

- 按 Alt+F2 显示 KRunner。输入 kmenuedit+enter 以运行命令。KMenuEditor 就会出现。在 KMenuEditor 中选择 文件 > 新项目 。

- 然后，选择了适当的菜单后，用 文件 - 新建 子菜单和 文件 - 新项目 来添加子菜单/项目。输入 OmegaT 作为新项目的名称。

- 在“命令”字段中，用导航按钮找到 OmegaT 启动脚本（在解压得到的文件夹中名为 OmegaT 的文件）并选中之。

- 点击图标按钮（在名称/描述/命令字段的右边）。

- 其他图标 - 浏览，然后导航至 OmegaT 应用程序文件夹中的 `/images` 子文件夹。选择 `OmegaT.png` 图标。

- 最后，用 文件 - 保存 来保存更改。

#### GNOME 用户

你可以这样来将添加 OmegaT 到菜单中：

- 右键点击面板 - 添加新启动器 。

- 在“名称”字段中输入“OmegaT”；在“命令”字段中，用导航按钮找到 OmegaT 启动脚本（在解压缩得到的文件夹中名为 OmegaT 的文件）。选中并用确定进行确认。

- 点击图标按钮，然后点击浏览...并导航到 OmegaT 的应用程序文件夹内的 `/images` 子文件夹中。选择 `OmegaT.png` 图标。GNOME 在可用格式中可能无法显示此文件图标，一开始似乎预期要 SVG 文件，但如果选择了该文件夹，则会显示文件并且可以选择 `OmegaT.png`。

### 运行 OmegaT

你可以从命令行用包含启动选项的脚本启动 OmegaT，或者你可以点击 `OmegaT.jar` 直接启动它。具体方法根据发行版本而有所不同。请确保 `PATH` 设置是正确的，且 `.jar` 已经正确地与 Java 启动器关联。更多信息，参见下面的“从命令行启动 OmegaT”。

## macOS 用户

### 下载安装包

OmegaT包含 Java JRE 1.8

下载 `OmegaT_4.n.n_Mac.zip`。

### 安装 OmegaT

双击 `OmegaT_4.n.n_Mac.zip` 将其解压缩。这将创建一个名为 `OmegaT` 的文件夹。该文件夹包含 2 个文件：`index.html` 和 `OmegaT.app`。将此文件夹复制到合适的文件夹（例如 Applications）中。完成此操作后，可以删除 `OmegaT_4.n.n_Mac.zip` 文件，该文件不再需要。

### 将 OmegaT 添加到 Dock

将 `OmegaT.app` 拖放到 Dock 上。

### 运行 OmegaT

在 `OmegaT.app` 上双击或者点击其在 Dock 上的位置。

你可以通过编辑 Properties 以及包中的 `Configuration.properties` 文件来修改 OmegaT 的行为。

要访问 `Configuration.properties`，请右键单击 `OmegaT.app` 并选择“显示包内容”，然后右键点击 `Contents/Resources` 中的此文件并选择你要使用的文本编辑器。你也可用直接从命令行 cd 到那然后在 emacs 或 vi 之类的命令行编辑器中打开 `Configuration.properties`。

通过修改 `Configuration.properties` 来更改选项。对于预定义的选项，删除参数前的 `#` 即可启用它。例如，`user.language=ja`（没有`#`）会以日文用户界面启动 OmegaT。

要改变可用内存量，编辑 OmegaT.app/Contents/Info.plist 文件，取消注释 `<!-- <string>-Xmx6g</string> -->` 这一行（删除 `<!--` 和 `-->`）。这将以 6 GB 内存启动 OmegaT；将 `6g` 更改为所需的量。

要启动多个 `OmegaT.app` 实例，请双击位于 `OmegaT.app/Contents/MacOS/` 中的文件 OmegaT 。

用位于 `OmegaT.app/Contents/MacOS/Java/` 中的 `OmegaT.jar` 文件来从命令行启动 OmegaT。更多信息，请参考下文的“从命令行启动 OmegaT”。

### macOS 上的好事

`OmegaT.app` 可以使用 macOS 服务。因此，你可以在 OmegaT 中任何地方选择一个单词，然后用服务来核查之，例如用 Spotlight 或用 Google。你也可以用 AppleScript 或 Automator 来创建服务或者脚本来自动化常用动作。

## 其它系统

此信息适用于诸如 Solaris SPARC/x86/x64、Linux x64/PowerPC、Windows x64 等系统。

### 下载正确的安装包

对于 Linux（Intel x86）和 Windows 平台，OmegaT 提供了捆绑了 Oracle Java JRE 的版本。其他平台的用户（Linux PowerPC、Linux x64、Solaris SPARC/x86/x64、Windows x64 等）则需要在系统上运行有兼容的 Java JRE 才能使用 OmegaT。

是否有与 Oracle 的 Java 8 JRE 相兼容的 Java 实现?

- 是： 下载 `OmegaT_4.n.n_Windows_without_JRE.zip`。这个包可以用在任何安装了 Java 8 兼容 JRE 的平台上。

- 不知道： 打开终端，输入 java -version 。如果返回了“command not found（未找到命令）”或类似的信息，则可能系统上未安装 Java。

- 否： 为你的系统弄个 Java JRE（见下文）并下载 `OmegaT_4.n.n_Without_JRE.zip`。

  Oracle 在http://www.oracle.com/technetwork/java/archive-139210.html 提供了用于 Solaris SPARC/x86（Java 8）和 Linux x64、Solaris x64、Windows x64（Java 8）的 JRE。

  IBM 在 http://www.ibm.com/developerworks/java/jdk/linux/download.html提供了用于 Linux PowerPC 的 JRE。

  请按照所需安装包的说明进行操作。

### 安装 OmegaT

要安装 OmegaT，只需解压 `OmegaT_4.n.n_Without_JRE.zip` 文件即可。这会在工作文件夹中创建一个 `./OmegaT_4.n.n_Without_JRE/` 文件夹，其中有运行 OmegaT 所需的全部文件。

### 安装方便的快捷方式

请按照系统说明在你觉得方便的地方安装 OmegaT 快捷方式。

### 运行 OmegaT

一旦安装好 OmegaT，你可以直接从命令行启动它、可以创建一个包含命令行启动参数的脚本、也可以单击 `OmegaT.jar` 直接启动它。方法随发行版本而不同。要确保 `PATH` 已正确设置、`.jar` 文件已经与 Java 启动器正确关联。更多信息，参见下文的“从命令行启动 OmegaT”

## 拖放

在大多数系统中，可以通过将 `omegat.project` 文件放到 OmegaT 的桌面图标上来打开项目。也可以通过双击 `omegat.project` 文件来打开 OmegaT 项目。

## 使用 Java Web Start

Java Web Start 技术（是 Java 8 或更高版本的一部分）可用于通过网络部署独立的 Java 软件应用程序，只需一次点击。Java Web Start 确保将部署的是应用程序的最新版本，以及使用的是正确版本的 Java Runtime Environment（JRE）。要首次通过 Java Web Start 启动 OmegaT，请在浏览器中打开以下网址：

https://omegat.sourceforge.io/webstart/OmegaT.jnlp

下载 `OmegaT.jnlp` 文件并点击之。在安装过程中，你可能收到几个安全警告，具体取决于你的系统。你授予此版本的权限（可能显示“对计算机的无限制访问”）与你授予本地版本的权限相同，即，它们可以存取计算机上的硬盘驱动器。以后点击 `OmegaT.jnlp` 会先检查是否有更新，如果有的话安装之，然后启动 OmegaT。在初始安装结束后，即使离线也（理所当然）可以使用 `OmegaT.jnlp`。

隐私 ：OmegaT Java Web Start 不会将任何信息保存到你所运行的计算机之外。此应用程序只运行在你的机器上。你的文档和翻译记忆库都留在你的计算机上，OmegaT 项目无法访问你的工作或信息。

请注意，如果您需要使用启动命令参数（见上文），就必须使用普通安装。

## 从命令行启动 OmegaT

通常，没有必要从命令行启动 OmegaT。不过，改用命令行让用户可以控制和修改程序的行为。用命令行启动 OmegaT 有两种方法。

### 打开命令行窗口

命令行窗口也称为“终端窗口”。在 Windows 上它被称为“MS-DOS 窗口”，可通过开始菜单中“程序”内的“MS-DOS”条目启动。macOS 内的等价物是终端（Terminal）应用程序，位于 `应用程序/实用工具`内。

要启动 OmegaT，通常需要输入两条命令。第一条是：

    cd
                         文件夹

其中 `文件夹` 是带有完整的路径的 OmegaT 程序——更具体地说，`OmegaT.jar` 文件——所在文件夹的名称。因此，实际上此命令应该是类似于这样的：

在 Windows 上

    cd C:\Program Files\OmegaT

在 macOS 上

    cd
                         <OmegaT.app 位置>
                      /OmegaT.app/Contents/Resources/Java/

在 Linux 上

    cd /usr/local/omegat

此命令将文件夹更改至包含可执行 OmegaT 文件的文件夹。第二条命令是实际启动 OmegaT 的命令。此命令最基本的形式是：

     java -jar OmegaT.jar

注意大小写——在 Windows 以外的操作系统中，如果你输入的是 `omegat` 而非 `OmegaT`，程序不会启动。

该方法对于找寻问题的原因有特别的意义：如果在使用程序过程中发生了错误，在终端窗口所显示的错误信息对查找原因提供了有用的信息。

上面的方法用于例行地启动程序多少有些不切实际。基于此原因，上述两个命令可以包含到一个文件内（“脚本”，在 Windows 系统上又叫“`.bat` 文件”）。

执行此文件时，将自动自动执行其中的命令。因此，要更改启动命令，只需修改此文件即可。

### 启动命令参数

上面已经提到了基本的命令。对该命令的修改涉及到对其添加“参数”。参数是添加开头的 java 之后、`-jar OmegaT.jar`之前的。注意，在 Windows 中你可以修改 `OmegaT.l4J.ini` 文件来反映你的偏好设置。在其他平台上，你可以修改 `Configuration.properties` 文件（Mac）或 `OmegaT` 启动器（Linux）来达到相同结果。

下文罗列了所有可能参数。进阶用户可以通过在终端窗口中输入 man java 来获取关于参数的更多信息。

- 用户界面语言

  `-Duser.language= `XX`` 通常，即，不带参数启动 OmegaT 时，程序会先检测用户的操作系统的语言。如果此语言的用户界面可用，OmegaT 就会使用之。因此，如果用户的操作系统是俄语的且 OmegaT 已经对俄语进行了本地化，OmegaT 就会显示俄语用户界面、俄语菜单等。如果用户系统的语言不可用，OmegaT 默认为英语。这是标准行为。

  `-Duser.language= `XX`` 参数会让 OmegaT 使用指定的语言而非用户操作系统的语言。此命令中的 `XX` 代表期望语言的两位代码。要用法语界面启动 OmegaT（举例说，在俄语操作系统上），命令就应该是：

      java -Duser.language=fr -jar OmegaT.jar

- 用户国家

  -Duser.country= `XX` 除语言外，你还可以指定国家/地区，例如，对于中文情况下的 `CN` 或 `TW`。要以期望语言显示快速入门指南，您需要同时指定语言和国家/地区。即使只有一种可能的组合这也是必须的，比如说巴西葡萄牙语情况下的 `pt_BR`。

- 内存分配

  `-Xmx `??` M` 此命令为 OmegaT 分配更多内存。默认情况下，会分配 1024 MB，因此分配比这数字更少是没有任何好处的。 `??` 代表分配的内存量，以兆字节（M）为单位。因此，启动 OmegaT 并分配 2048 MB（2 GB）内存的命令是：

      java -Xmx2048M -jar OmegaT.jar

- 代理主机 IP 地址

  `-Dhttp.proxyHost= `nnn.nnn.nnn.nnn`` 如果你的系统使用代理服务器，这里是代理服务器的 IP 地址。

- 代理主机端口

  `-Dhttp.proxyPort= `NNNN`` 你的系统用于访问代理服务器的端口号。

- Google 翻译 v2

  `-Dgoogle.api.key= `A123456789B123456789C123456789D12345678`` 如果你已经注册了 Google 翻译服务，在这里输入你的 Google API 私钥。注意密钥长度为 38 个字符。

- Microsoft Translator

  确保你有了免费的 Microsoft 账户。你需要用它来登录 Windows Azure Marketplace 并使用 Translator 服务。请注意，每月最多可以免费处理 2 百万个字符。在您的账户页中主账户密钥和客户 ID 下可以找到所需的两个条目：

      -Dmicrosoft.api.client_id=
                                    XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

      -Dmicrosoft.api.client_secret=
                                    XXXX9xXxX9xXXxxXXX9xxX99xXXXX9xx9XXxXxXXXXX=

- Yandex Translate

  确保你有免费的 Yandex 账户。你需要用它才能获得并使用 Yandex Translate 的 API 密钥。API 密钥可以使用 API 密钥请求表单获取，并可以在 My Keys（我的密钥）页面查看。

      -Dyandex.api.key=
                                    trnsl.1.1.XXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

参数可以进行组合：要想以上面所举所有例子启动 OmegaT 的话，命令应当是：

    java -Dswing.aatext=true -Duser.language=pt -Duser.country=BR -Xmx2048M -Dhttp.proxyHost=192.168.1.1 -Dhttp.proxyport=3128 -jar -OmegaT.jar

### 命令行模式下的 OmegaT

控制台模式的目的是在脚本环境中将 OmegaT 用作翻译工具。当以控制台模式启动时，不会加载图形界面（所以在任意控制台上都可运行）并且将按请求自动处理给定项目。

#### 先决条件

要以命令行模式运行 OmegaT，必须指定有效的 OmegaT 项目。其位置并不重要，因为无论如何你都需要在启动时将其添加到命令行中。

如果需要更改设置，则配置文件必须可用。这可以通过两种方式实现：

- 正常运行 OmegaT（带图形界面）并指定设置。如果你用控制台模式启动 OmegaT，它将使用相同的设置。

- 如果无法正常运行 OmegaT（没有可用的图形环境）：从另一台机器上安装的其他 OmegaT中将设置文件复制到特定文件夹。位置不重要，因为你可以在启动时将其添加到命令行。相关文件是 `filters.conf` 和 `segmentation.conf`，可以在用户的主文件夹中找到（例如 `C:\Documents and Settings\ `user` \OmegaT`（Windows 下）或 `~/.omegat/`（Linux 下）)。

#### 以控制台模式启动

要以控制台模式启动 OmegaT，必须在启动时将一些额外的参数传递给它。最重要的是 `/path/to/project`，可选的还有 `--config-dir= `/path/to/config-files/`` 。例如：

    java -jar OmegaT.jar
                            /path/to/project
                          \
        --config-dir=
                            /path/to/config-files/
                          \
        --config-file=
                            /path/to/config-file/
                          \
        --mode=
                            console-translate|console-createpseudotranslatetmx|console-align
                          \
        --source-pattern=
                            regexp

注意所有参数都必须以两个 `-` 字符开头。

说明：

- `/path/to/project` 告诉 OmegaT 去哪找要翻译的项目。如果给出，OmegaT 会以控制台模式启动并翻译给定项目。

- `--config-dir= `/path/to/config-files/`` 告诉 OmegaT 配置文件存放在哪个文件夹里。如果未给出，OmegaT 会还原为默认值（用户主文件夹下的 OmegaT 文件夹，或，如果前者不可用，就是当前工作文件夹）。注意那两个 `-` 字符。

- `--config-file= `/path/to/config-file/`` 告诉 OmegaT 使用哪个配置文件。

- `--mode= `...`` OmegaT 以控制台模式启动并自动执行以下服务之一

  - `--mode=console-translate`

    在此模式下，OmegaT 会将尝试用可用的翻译记忆库翻译 `/source/` 中的文件。这对于在服务器上运行 OmegaT 并将 TMX 文件自动提供给项目会非常有用。

  - `--mode=console-createpseudotranslatetmx`

    在此模式下，OmegaT 会仅基于原文文件来为整个项目创建一个 TMX。你可以用以下参数来指定要创建的 TMX

    `--pseudotranslatetmx= `allsegments.tmx` --pseudotranslatetype= `equal|empty``

    参数 pseudotranslatetype 指定译文片段是要与原文片段相同还是留空。

  - `--mode=console-align`

    在此模式下，OmegaT 会将出现在项目的 `/source/` 目录中的文件与在指定位置出现的内容对齐。生成的 TMX 存放在 `/omegat/` 文件夹下，名称为 `align.tmx`。哪些文件会用来进行对齐取决于文件过滤器是否支持它。一些已支持的过滤器有：ILIAS 语言文件、Java(TM) 资源包、键=值文本、Magento CE 语言环境 CSV、MoodlePHP、Mozilla DTD、Mozilla FTL、PO、RC、SubRip 字幕、Windows 资源

    这种情况下需要额外的参数，用以指定译文数据的位置：

    `--alignDir= `<已译文件的位置>``

    `alignDir` 必须包含项目的目标语言译文。例如，如果项目是 EN 翻 FR，`alignDir` 包含以 `_fr` 结尾的包。生成的 TMX 存放在 `omegat`文件夹下，名为 `align.tmx`。

- `--source-pattern= `正则表达式``

  指定了模式后，此选项将指定要自动处理的文件。如果未指定此参数，则将处理文件。以下是一些限制选择的典型示例：

  - `.*\.html`

    将会翻译所有 HTML 文件——注意出现在通常的 `*.html` 中的句点需要按照正则表达式的规则进行转义（`\.`）

  - `test\.html`

    只会翻译直接位于原文文件夹下的 test.html 文件。如果在其他文件夹内有名为 test.html 的文件，将忽略它们。

  - `dir-10\\test\.html`

    只会处理 `dir-10` 文件夹下的 `test.html` 文件。再次提醒注意反斜杠也要转义。

- `--tag-validation= `abort|warn`` `outputFileName`

  此选项允许以批处理模式进行标签验证。如果选择了 `abort`，标签验证器会在第一个无效标签处停下。如果指定了 `warn`，标签验证器会处理所有片段并将关于所有带有无效标签的片段的警告信息写入指定文件。

- `--no-team` 处理为团队作业而设立的项目。使用此选项能让 OmegaT 不同步项目内容。

- `--disable-project-locking` 在 Windows 下允许多个 OmegaT 实例打开同一个项目。默认情况下，在 Windows 下，`omegat.project` 是被锁定的，试图打开已经在另一个 OmegaT 实例中打开的项目会收到错误信息。使用该选项就不会发生锁定。

#### 静默选项

另一个控制台模式专用的命令行参数：`--quiet`。在静默模式下，屏幕上记录的信息较少。你通常会在状态栏上看到的那些信息不会显示出来。

用法：`java -jar OmegaT.jar /path/to/project --mode=console-translate --quiet`

## 从源代码构建 OmegaT

当前版本的源码可以用 Git 客户端从存储库 https://git.code.sf.net/p/omegat/code 获取，或直接在 SourceForge 上获取。

一旦下载了代码，在源代码文件夹中打开命令行并输入：

    gradlew assembleDist

这会在 in the `./build/distributions` 文件夹中创建 OmegaT 的完整发行版，在这个文件夹里你会找到一个 zip 包，包里包含有运行 OmegaT 所需的所有东西。

你也可以用以下命令直接运行该应用程序：

    gradlew run

详细的构建说明请参阅 docs_devel 中的 readme。