第 3 章 安装和运行 OmegaT
上一页 |  | 下一页

# 第 3 章 安装和运行 OmegaT

## 1. Windows 用户

### 1.1. 下载安装包

安装了与 Oracle 的 Java 1.5 JRE 兼容的 Java 实现了吗？

- 是：下载 OmegaT_2.5.x_Windows_without_JRE.exe。

- 否 / 我不知道：下载 OmegaT_2.5.x_Windows.exe。

  该安装包捆绑了 Oracle 的 Java 运行环境。该 JRE 不会与系统中可能已安装的其它 Java 实现相冲突。

### 1.2. 安装 OmegaT

要安装 OmegaT，仅需双击下载的程序并按照指示操作。

### 1.3. 向启动菜单或桌面添加 OmegaT

在安装过程中，安装程序将询问是否要在开始菜单中创建一个文件夹，以及是否想在桌面和快速启动栏创建快捷方式。

在完成安装之后您仍然可以创建快捷方式，只需将 OmegaT.exe 拖动到桌面或开始菜单，以将其连接到该处。

### 1.4. 运行 OmegaT

一旦安装好 OmegaT，您可以通过点击 OmegaT.jar 或者从命令行启动它。

然而，最简单的方法是运行 OmegaT.exe 程序。在此情形下，将从 OmegaT.l4J.ini 文件读取程序选项，该文件与可执行文件在同一目录，您可对它进行修改以反映您的设置。下面的 INI 文件将保留 1GB 内存，以法语为用户语言，将国家设置为加拿大：

`# OmegaT.exe 运行时配置 # 要使用某参数，仅需删除 '-' 前面的 '#' # Memory -Xmx1024M # Language -Duser.language=FR # Country -Duser.country=CA`

### 1.5. 升级 OmegaT

这里的内容只适用于通过“传统”方式安装的 OmegaT 的 Windows 版本。它不适用于 Web Start 版本（它会自动更新），也不适用在 Windows 上安装的跨平台版本。

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

- 使用覆盖方式进行安装。要实现这个操作，只需将新版本安装到现有安装所在的目录。旧版本的 OmegaT 会被覆盖，不过将保留所有的设置。其中包括 OmegaT 中的首选项设置，对 `OmegaT.l4J.ini` 文件进行的所有更改以及您使用的启动脚本（.bat 文件）。

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

- 安装到新文件夹。这样您可以同时使用两个版本，直到您适应新版本的时候。使用这种方法您也可以使用在 OmegaT 中更改的首选项和设置。不过此时：

  - 如果您对 `OmegaT.l4J.ini` 进行了修改或使用 .bat 文件，那么必须把它们复制过去。

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

## 2. Linux (Intel) 用户

### 2.1. 下载正确的安装包

安装了与 Oracle 的 Java 1.5 JRE 兼容的 Java 实现了吗？

- 是：下载 OmegaT_2.5.x_Without_JRE.zip。

- 否/我不知道：下载 OmegaT_2.5.x_Linux.tar.bz2。

  该安装包捆绑了 Oracle 的 Java 运行环境。该 JRE 不会与系统中可能已安装的其它 Java 实现相冲突。

### 2.2. 安装 OmegaT

解压下载的文件。该操作将会在工作目录中创建一个 omegat/ 目录，在该目录中可以找到运行 OmegaT 所需的所有文件。要解压 .tar.gz 文件：

$ tar xf downloaded_file.tar.gz

### 2.3. 向菜单（KDE）或面板（Gnome）中增加 OmegaT

#### 2.3.1. KDE 4 用户

可按下列步骤添加 OmegaT 到菜单中：

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

- 然后选择适当的菜单，通过［文件］－［新子菜单］和［文件］－［新项目］添加一个子菜单／项目。输入 OmegaT 作为新菜单项的名称。

- 在 "命令［Command］" 字段中，通过导航［navigation］按钮找到 OmegaT 启动脚本（在解压目录中命名为 OmegaT 的文件)并加以选中。

- 点击图标按钮（在 Name/Description/Comment 字段的右边）。

- 其它图标［Other Icons］ - 浏览［Browse］，导航至 OmegaT 应用程序文件夹的 /images 子文件夹。选择 OmegaT.png 图标。

- 最后，通过“文件-保存”［File－Save］保存所作变更。

#### 2.3.2. GNOME 用户

可按下列步骤添加 OmegaT 到菜单中：

- 在面板上单击鼠标右键——添加新启动器［Add New Launcher］。

- 在［名称］（Name）字段输入 "OmegaT"，在［命令］（Command）字段使用［导航］按钮找到 OmegaT 启动脚本（解压后文件夹中名为 OmegaT 的文件）。选中并通过［确定］（OK）按钮进行确认。

- 点击图标按钮，然后点击【浏览】（Browse）……然后导航至 OmegaT 应用程序文件夹的 /images 子文件夹。选择 OmegaT.png 图标。GNOME 可能无法显示当前格式的图标文件，原本看起来预期值为一份 SVG 文件，但如果选中了该文件夹，将会显示该文件并可以选择 OmegaT.png。

### 2.4. 运行 OmegaT

可直接在命令行中通过包含命令行启动参数的脚本启动 OmegaT，或直接点击 OmegaT.jar 启动它。根据发行版本方法有所不同。请确认正确设置了 PATH 以及 .jar 与 Java 启动器正确关联。查阅下文中的 "命令行启动 " 了解更多信息。

## 3. Mac OS X 用户

### 3.1. 下载安装包

OmegaT 2.5 的运行需要 1.5。从苹果菜单调用 "软件更新（Software Update）..." 以更新 Java 的版本。

下载 OmegaT_2.5.x_Mac.zip.

### 3.2. 安装 OmegaT

双击 OmegaT_2.5.x_Mac.zip 解压缩。该操作会创建一个名为 OmegaT 的文件夹。此文件夹中包含两个文件：index.html 和 OmegaT.app. 将文件夹复制到合适的文件夹（如：Applications)。完成上述操作后，即可删除 OmegaT_2.5.x_Mac.zip 文件。

### 3.3. 添加 OmegaT 到 Dock

拖放 OmegaT.app 到 Dock 中。

### 3.4. 运行 OmegaT

双击 OmegaT.app 或点击它在 Dock 中的位置。

要访问 Info.plist，请右键点击 OmegaT.app 并选择［显示包内容］"Show Package Contents"，然后右键点击该文件并选择文本编辑器来将其打开。您还可以在命令行 "cd" 到这里并在命令行编辑器（例如 emacs 或 vi）中打开 Info.plist。

您可以修改 Properties 和 VMOptions 部分。

如果要向 VMOptions 添加值 ，在两者之间放置一个空格。例如，`-Xmx1024M -Duser.language=ja` 将提供 1024MB 内存并以日文用户界面启动 OmegaT。

要运行多个 OmegaT.app 实例，请双击在 OmegaT.app/ Contents/MacOS/ 中的 JavaApplicationStub 文件。

请使用在 OmegaT.app/Contents/Resources/Java/ 中的 OmegaT.jar 文件来从命令行启动 OmegaT。查阅下文中的 "命令行启动 " 了解更多信息。

### 3.5. Mac OS X 优势

可以从 Mac OS X 提供的服务直接访问 OmegaT.app。因此，您可以在 OmegaT 的任何地方选择一个单词，然后使用在 Spotlight 或谷歌提供的服务查阅该词。您还可以使用 AppleScript 或 Automator 创建能够自动频繁查询的服务或脚本

## 4. 其它系统

这里的信息适用于诸如 Solaris SPARC/x86/x64、Linux x64/PowerPC、Windows x64 的系统

### 4.1. 下载正确的安装包

OmegaT 提供一种为Linux (Intel x86) 和 Windows 平台准备的捆绑了 Oracle Java JRE 的版本。其他平台的用户（Linux PowerPC, Linux x64, Solaris SPARC/x86/x64, Windows x64 等) 要使用 OmegaT 必须安装与系统兼容的 Java JRE。

安装了与 Oracle 的 Java 1.5 JRE 兼容的 Java 实现了吗？

- 是：下载 OmegaT_2.5.x_Windows_without_JRE.zip。该安装包可用在任何安装了 Java 1.5 JRE 兼容 JRE 的平台上。

- 我不知道：打开终端，输入 "java -version"。如果返回了 "command not found" 或类似的信息，系统很有可能没有安装 Java

- 否：获取适用于您系统的 Java JRE（见下文）并下载 OmegaT_2.5.x_Without_JRE.zip。

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

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

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

### 4.2. 安装 OmegaT

要安装 OmegaT，仅需解压 OmegaT_2.5.x_Without_JRE.zip 文件。该操作会在工作目录中创建 ./OmegaT_2.5.x_Without_JRE/ 目录，该目录包含运行 OmegaT 需要的所有文件。

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

按照系统的提示在方便的地方安装 OmegaT 快捷方式。

### 4.4. 运行 OmegaT

安装好 OmegaT 后，可直接在命令行中通过包含命令行启动参数的脚本启动，或直接点击 OmegaT.jar 启动它。根据发行版本方法有所不同。请确认正确设置了 PATH 以及 .jar 与 Java 启动器正确关联。查阅下文中的 "命令行启动 " 了解更多信息。

## 5. 使用 Java Web Start

使用 Java Web Start技术（对Java 1.5 及以上版本），只需一次点击就可通过网络部署独立的 Java 应用软件。Java Web Start 能够保证部署应用程序的最新版本以及使用正确 Java运行环境（JRE）版本。为首次通过 Java Web Start 启用 OmegaT，在浏览器中输入下面的 URL：

http://omegat.sourceforge.net/webstart/OmegaT.jnlp

下载 OmegaT.jnlp 文件然后点击它。在安装期间，根据操作系统的不同，您可能会收到几条安全警告。您赋予该版本的权限（可能会被认为是“对计算机的无限制访问”）和您给予本地版本的相同，也就是说它们被允许访问计算机硬盘。如果处于在线状态，之后再点击 OmegaT.jnlp 将会检查是否有升级，如果有的话将安装升级包并运行 OmegaT。初始化安装之后，您当然可以在离线状态使用 OmegaT.jnlp。

隐私政策：OmegaT Java Web Start 不会在您的计算机之外保存您在其中操作的任何资料。该应用程序只在您的计算机上运行。您的文档和翻译记忆将保留在您的计算机上，并且 OmegaT 项目就没有您的工作或信息。

请注意，如果您需要某个启动命令参数（见上文），就不得不使用正常安装。

## 6. 从命令行启动 OmegaT

正常情况下，没有必要从命令行启动 OmegaT。不过，从命令行启动的方法允许用户控制和修改程序的行为。在命令行有两种启动 OmegaT 的方法：

### 6.1. 打开命令行窗口

命令行窗口也被叫做“终端窗口“。在 Windows 中可以称之为 "MS-DOS 窗口"，可从开始菜单，程序中的 "MS-DOS" 项找到。Mac OSX 对应的是位于 应用程序［Applications] → 实用工具［Utilities］ 中的应用程序终端。

为启动 OmegaT，通常您必须执行两条命令。第一条是：

`cd {文件夹}`

其中 {folder} 是 OmegaT 程序，具体地是 OmegaT.jar 文件所在的文件夹的名称（带完整路径）。在实际情况中，该命令可能是这样的：

在 Windows 上

`cd C:\Program Files\OmegaT`

在 Mac OS X 上

``cd <OmegaT.app location>/OmegaT.app/Contents/Resources/Java/``

在 Linux 上

`cd /usr/local/omegat`

该命令将目录改为包含可执行 OmegaT 文件的目录。第二条是实际启动 OmegaT 的命令。就最基本的形式而言，该命令为：

`java -jar OmegaT.jar`

请注意如果输入错误的大小写形式例如 omegat 而不是 OmegaT ，那么程序将不会启动!

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

上面的方法对于经常性启动一个程序来说是不切实际的。为此，上述两条命令被包含在一份文件（一份脚本、在 Windows 上也叫做一份 “.bat 文件”）。

执行该文件时，将自动执行其中的命令。因此，要修改启动命令，修改该文件即足以。

### 6.2. 启动命令参数

基本的参数已经在上面提到过了。修改该命令可以添加增加额外的“参数”。参数添加到首个 "java" 之后，且在 "-jar OmegaT.jar" 之前。请注意，在 Windows 环境中您可以修改 OmegaT.l4J.ini 文件来选择自己的偏好。在 Mac OS X 中，您可以修改在 OmegaT.app/Contents/ 中的 Info.plist 文件来达到相同的目的。

下面给出了可用参数的清单：Advanced users can obtain more information on the arguments by typing man java in the terminal window.

- 用户界面语言

  -Duser.language=XX 正常情况下，也就是 OmegaT 不带任何参数启动的情况下，程序将首先检测用户操作系统所使用的语言。如果存在所用语言的界面， OmegaT 将会使用它。因此，如果用户的操作系统为俄语版，而 OmageT 有俄语版的本地化版本，OmegaT 将显示为俄语用户界面、俄语菜单等等。如果用户系统的语言不存在，OmegaT 将默认使用英语。这是标准行为。

  "-Duser.language=XX" 参数会使得 OmegaT 使用指定的语言而不是用户操作系统的语言。命令中的 "XX" 代表所需语言的双数字代码。要想 OmegaT 以法语界面运行（例如在俄语操作系统上），该命令应该为：

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

- 用户国家设置

  -Duser.country=XX 语言之后，您也可以指定国家，例如对于中文情况下的 CN 或 TW 。要使用期望的语言显示即时入门指南，您必须同时指定语言和国家。甚至在只要一种可用组合的情况下，这也是必须的，比如 Portuguese / Brazil 情况下的 pt_BR 。

- 字体抗锯齿 - (仅 Java 1.5)

  -Dswing.aatext=true 该参数影响字体的抗锯齿效果，从而改善其外观。

- 内存分配

  -XmxZZM 该命令给 OmegaT 分配更多内存。缺省情况下，将会分配 256 MB 内存，因此分配低于此大小的内存是没有好处的。"ZZ" 代表以兆字节为单位的内存。因此，启动 OmegaT 时分配 1024 MB(1G)内存的命令是：

  `java -Xmx1024M -jar OmegaT.jar`

- 代理服务器主机 IP 地址

  -Dhttp.proxyHost=nnn.nnn.nnn.nnn 如果您系统上使用代理服务器，在这里指定它的地址。

- 代理服务器端口

  -Dhttp.proxyPort=NNNN 访问代理服务器使用的端口。

- 谷歌翻译 v2

  -Dgoogle.api.key=A123456789B123456789C123456789D12345678 如果您签约了谷歌翻译服务，请在这里输入您私有的谷歌 API 密钥。请注意该密钥长度为 38 个字符。

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

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

### 6.3. 以命令行模式运行 OmegaT

控制台模式的目的是将 OmegaT 用作脚本环境的翻译工具。在控制台模式下，将不会载入任何图形化界面（因此仅在某控制台中运行），同时会自动按要求翻译指定的项目。

#### 6.3.1. 先决条件

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

如果需要变更设置，必须提供配置文件。可通过两种方式达到这个目的：

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

- 如果您无法正常运行 OmegaT（没有可用的图形界面）：可将另一机器上安装的 OmegaT 设置文件复制到特定的目录。位置并不重要，因为无论如何，启动时您都必须将位置添加到命令行。相关的文件是可在用户主目录找到的 `filters.conf` 和 `segmentation.conf`（如：Windows 系统中的 `C:\Documents and Settings\%User%\OmegaT` 或 Linux 系统中的 `%user%/.omegat/`）

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

要以控制台模式启动 OmegaT，必须在启动时传入额外的参数。最重要的是 `<project-dir>`，以及可选的 `--config-dir=<config-dir>。`例如：

`java -jar OmegaT.jar /path/to/project \`

`--config-dir=/path/to/config-files/ \`

`--mode=console-translate|console-createpseudotranslatetmx|console-align`

`--source-pattern={regexp}`

请注意所有的参数都以两个 - 字符开始。

说明：

- `<project-dir>` 告知 OmegaT 要翻译项目的位置。如果给出了该参数，则 OmegaT 以控制台模式启动并翻译指定的项目。

- `--config-dir=<config-dir>` 告知 OmegaT 配置文件所在的目录。如果没有给出该参数，OmegaT 将转而使用缺省值（即用户主目录中的 OmegaT 目录，如果不可用的话则是当前的工作目录）。请注意两个 - 字符

- `--mode`=...- OmegaT 以控制台模式启动，接着执行下列的某个服务

  - `--mode=console-translate`

    在该模式中，OmegaT 将尝试使用可用的翻译记忆来翻译 /soruce/ 中的文件。这可用于在含有 TMX 文件的服务器上运行 OmegaT 来自动翻译项目。

  - `--mode=console-createpseudotranslatetmx`

    在该模式中，OmegaT 将仅根据项目的源文件创建整个项目的 TMX。您可以使用后面的参数指定要创建的 TMX 文件：

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

    参数 pseudotranslatetype 指明了目标片段是与源片段相同或留空。

  - `--mode=console-align`

    在该模式中，OmegaT 将对齐在项目的`/source/` 目录找到的 Java 属性文件在指定位置的内容。生成的 TMX 保存在 `/omegat/` 目录，名称为 `align.tmx`。

    此时需要额外的参数指明目标数据的位置：

    `--alignDir={已译文件的位置}`

    `alignDir` 必须包含项目目标语言的翻译。例如，如果项目为 EN->FR，则 alignDir 必须包含以 _fr 结尾的包。生成的 TMX 保存在 `omegat` 目录，名称为 `align.tmx`。

- `--source-pattern={regexp}`

  如果使用了模式，则该选项将指定要自动翻译的文件。如果未使用该选项，则处理所有文件。这里是一些限制源文件匹配的实际例子：

  - `.*\.html`

    此时将翻译所有的 HTML 文件，需要注意到 *.html 在正则表达式中指定时需要进行转义 (\.)。

  - `test\.html`

    只有根目录下的 test.html 文件将会被翻译。如果在其它目录下有名为 test.html 的文件，它们将会被忽略。

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

    仅翻译 dir-10 目录中的 test.html 文件。再次强调反斜杠也需要进行转义。

#### 6.3.3. 静默选项

控制台模式专用的一个附加命令行参数： `--quiet`。在静默【Quiet】模式下，屏幕上将显示更少的日志信息。在状态栏通常可以看到的所有信息都不会被显示。

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

#### 6.3.4. 标记验证选项

控制台模式专用的一个附加命令行参数：`--tag-validation=[abort|warn]。`添加此参数后，会在翻译/文本对齐之前验证标签。如果该参数值为 `abort`，那么在遇到标签错误时打印出错误，同时程序停止。如果该参数值为 `warn`，则打印错误且 OmegaT 继续执行。

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

## 7. 从源代码编译 OmegaT

请注意您还需要 ant 程序（http://ant.apache.org/bindownload.cgi）来编译 OmegaT。解压 OmegaT_2.5.x_Source.zip 文件，并进入 OmegaT_2.5.x_Source 目录或进入 SVN 检出代码的 ./omegat/ 目录。请确认 build.xml 文件存在该目录中。然后，在命令行输入：

`$ ant jar release`

该命令将在 ./dist/ 目录中创建一份完整的 OmegaT 发行文件，其中包含运行 OmegaT 需要的所有文件。

上一页 |  | 下一页
第 2 章 快速入门指南 | 起始页 | 第 4 章 用户界面