# 安装和运行 OmegaT

## Windows 用户

安装 OmegaT Windows

### 下载安装包

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

- 是：下载OmegaT_3.n.n_Windows_without_JRE.exe。

- 否/我不知道：下载 OmegaT_3.n.n_Windows.exe。

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

### 安装OmegaT

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

安装开始时您可以选择在安装过程中使用的语言。在接着的窗口中您可以选择在OmegaT使用的语言。如果您选中了相应的复选框，则会修改OmegaT.l4J.ini文件以使用选择的语言（请参阅下一部分了解详情）。然后，当您接受了许可协议后，安装程序将询问是否要在开始菜单中创建文件夹以及在桌面和快速启动栏创建快捷方式（以后您可以拖动OmegaT.exe到桌面或开始菜单来创建快捷方式）。最后一个画面提议您看看所安装版本的自述文件和更新文件。

### 运行 OmegaT

运行OmegaT Windows

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

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

运行 OmegaT Windows INI 文件

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

### 升级 OmegaT

升级OmegaT Windows

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

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

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

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

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

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

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

## Linux (Intel) 用户

安装 OmegaT Linux

### 下载正确的安装包

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

- 是：下载OmegaT_3.n.n_Without_JRE.zip。

- 否/我不知道：下载OmegaT_3.n.n_Linux.tar.bz2。

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

### 安装OmegaT

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

$ tar xf downloaded_file.tar.gz

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

#### KDE 4 用户

定制OmegaT Linux

可按下列步骤添加 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］保存所作变更。

#### GNOME 用户

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

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

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

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

### 运行 OmegaT

运行 OmegaT Linux

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

## Mac OS X 用户

安装 OmegaT OS X

### 下载安装包

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

下载OmegaT_3.n.n_Mac.zip。

### 安装OmegaT

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

### 添加 OmegaT 到 Dock

拖放 OmegaT.app 到 Dock 中。

### 运行 OmegaT

运行 OmegaT OS X

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

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

定制OmegaT OS X 启动参数

您可以修改 Properties 和 VMOptions 部分。

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

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

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

### Mac OS X 优势

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

## 其它系统

安装 OmegaT 其他系统

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

### 下载正确的安装包

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

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

- 是：下载OmegaT_3.n.n_Windows_without_JRE.zip。该安装包可用在安装了兼容Java 1.6 JRE的JRE的任何平台上。

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

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

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

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

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

### 安装OmegaT

安装 OmegaT 其他系统

要安装OmegaT，只需解压OmegaT_3.n.n_Without_JRE.zip文件。这样会在工作目录中创建./OmegaT_3.n.n_Without_JRE/文件夹，且其中包含运行OmegaT需要的所有文件。

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

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

### 运行 OmegaT

运行 OmegaT 其他系统

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

## 使用 Java Web Start

运行 OmegaT 使用 Java Web Start

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

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

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

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

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

## 从命令行启动 OmegaT

运行 OmegaT 命令行启动

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

### 打开命令行窗口

命令行窗口也被叫做“终端窗口“。在 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`

请注意如果在Windows外的其中操作系统中输入错误的大小写形式，例如输入omegat 而不是OmegaT ，那么程序将不会启动！

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

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

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

### 启动命令参数

运行 OmegaT 启动脚本参数

基本的参数已经在上面提到过了。修改该命令可以添加增加额外的“参数”。参数添加到首个 "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缺省使用英语。这是标准行为。

  运行OmegaT 启动脚本参数 用户界面语言

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

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

- 用户国家

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

  运行OmegaT 启动脚本参数 用户国家

- 字体抗锯齿——（仅Java 1.6）

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

  运行 OmegaT 启动脚本参数 字体抗锯齿

- 内存分配

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

  运行 OmegaT 启动脚本参数 内存分配

  `java -Xmx1024M -jar OmegaT.jar`

- 代理服务器主机 IP 地址

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

  运行OmegaT 启动脚本参数 代理主机IP地址

- 代理主机端口

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

  运行OmegaT 启动脚本参数 代理主机端口

- 谷歌翻译v2

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

  运行 OmegaT 启动脚本参数 谷歌翻译 V2

- Microsoft Translator

  运行OmegaT 启动脚本参数 Microsoft Translator

  确保您已经有了免费的微软账户。您需要把它注册到Windows Azure Marketplace并使用Translator服务。注意免费账户每月最多可用2M字符数。在您账户页面中有必须的主账户密钥和客户ID两个条目：

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

  -Dmicrosoft.api.client_secret=XXXX9xXxX9xXXxxXXX9xxX99xXXXX9xx9XXxXxXXXXX=

- 团队项目选项

  运行OmegaT 启动脚本参数 no-team option

  -no-team处理团队工作的项目设置。使用此参数能让OmegaT不同步项目内容。

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

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

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

运行 OmegaT 命令行模式

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

#### 先决条件

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

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

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

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

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

要以控制台模式启动 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`

    仅翻译source文件夹下当前目录中的test.html。如果在其子目录下有名为test.html的文件，它们会被忽略。

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

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

- `--output-tag-validation-={regexp}`

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

  - `.*\.html`

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

  - `test\.html`

    仅翻译source文件夹下当前目录中的test.html。如果在其子目录下有名为test.html的文件，它们会被忽略。

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

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

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

  该选项支持在批处理模式中进行标签验证。如果选择了`abort` ，则标签验证器会在遇到首个非法片段时停止。如果使用`warn`，则标签验证器会处理所有片段并把含非法标签片段的警告写入指定文件。

#### 静默选项

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

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

#### 标记验证选项

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

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

## 从源代码编译 OmegaT

运行 OmegaT 从源代码编译 OmegaT

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

`$ ant jar release`

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