第 3 章 安装和运行 OmegaT

1. Windows 用户
1.1. 下载安装包
1.2. 安装 OmegaT
1.3. 向启动菜单或桌面添加 OmegaT
1.4. 运行 OmegaT
1.5. 升级 OmegaT
2. Linux (Intel) 用户
2.1. 下载正确的安装包
2.2. 安装 OmegaT
2.3. 向菜单(KDE)或面板(Gnome)中增加 OmegaT
2.4. 运行 OmegaT
3. Mac OS X 用户
3.1. 下载安装包
3.2. 安装 OmegaT
3.3. 添加 OmegaT 到 Dock
3.4. 运行 OmegaT
3.5. Mac OS X 优势
4. 其它系统
4.1. 下载正确的安装包
4.2. 安装 OmegaT
4.3. 安装便捷的快捷方式
4.4. 运行 OmegaT
5. 使用 Java Web Start
6. 从命令行启动 OmegaT
6.1. 打开命令行窗口
6.2. 启动命令参数
6.3. 以命令行模式运行 OmegaT
7. 从源代码编译 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

您可以修改 PropertiesVMOptions 部分。

如果要向 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.confsegmentation.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 需要的所有文件。