Руководство пользователя ОмегаТ 3.0

# Темы, не вошедшие в другие разделы

## ОмегаТ в режиме командной строки

### Примечание

Этот раздел предназначен для опытных пользователей!

Режим работы ОмегаТ в командной строке задуман для того, чтобы программу можно было использовать как средство выполнение перевода в скриптовом окружении. После запуска ОмегаТ в режиме командной строки графический интерфейс не будет загружаться (таким образом, программа работает любой в командной строке) и указанный проект переводится автоматически. В качестве примера можно привести программный продукт, чей графический интерфейс переведён на несколько языков. В этом случае, режим командной строки можно использовать для автоматизированного создания переведённого интерфейса в рамках общего процесса сборки программы.

### Что для этого нужно

Прежде всего нужен проект в формате ОмегаТ. Его расположение не важно, так как оно явно указывается в командной строке при запуске.

Если нужны не стандартные настройки для работы, нужно, чтобы имелись соответствующие файлы конфигурации (`filters.conf` и `segmentation.conf`). Этого можно достичь двумя способами:

- Запустить ОмегаТ в нормальном режиме (с графическим интерфейсом) и настроить её так, как нужно. После этого ОмегаТ будет использовать указанные настройки и в режиме командной строки.

- Если же запустить ОмегаТ в нормальном режиме не получается (отсутствует графическое окружение): скопируйте в соответствующий каталог файлы конфигурации ОмегаТ с другого компьютера. Куда вы их скопируете — тоже не имеет значения, так как путь к файлу конфигурации можно указать в командной строке при запуске (см. ниже). Нужные вам файлы `filters.conf` и `segmentation.conf` находятся в домашнем каталоге пользователя (например, `C:\Documents and Settings\%Имя пользователя%\OmegaT` в Windows, `/home/%Имя пользователя%/.omegat/` в GNU/Linux).

### Запуск ОмегаТ в режиме командной строки

Для того, чтобы запустить ОмегаТ в режиме командной строки, нужно передать ей при запуске несколько параметров. Самый важный из них — `<project-dir>`, `--config-dir=<config-dir>` можно не указывать. Пример:

`$> java -jar OmegaT.jar /путь/к/проекту \`

`--config-dir=/путь/к/файлам-конфигурации/ \`

`--mode=console-translate \`

`--source-pattern={регулярное выражение} \`

`--tag-validation=[block|warn]`

Пояснение:

- `<project-dir>` указывает ОмегаТ, где находится проект перевода. Если этот параметр задан, при запуске в режиме командной строки ОмегаТ переводит данный проект.

- `--config-dir=<папка с файлами конфигурации>` указывает ОмегаТ, в каком каталоге находятся файлы конфигурации. Если этот параметр не задан, ОмегаТ использует настройки по умолчанию (находящиеся в каталоге OmegaT в домашнем каталоге пользователя, или, если они там не найдены — в текущем рабочем каталоге).

- `--mode=console-translate` указывает ОмегаТ запуститься в режиме командной строки и перевести указанный проект

- `--source-pattern={регулярное выражение}` так можно указать файлы для перевода. Пример регулярного выражения: `test\.html`

- `--tag-validation=[abort|warn]` Если в качестве значения параметра задано «abort», при нахождении ошибок тегов, программа будет автоматически завершена. Если задано «warn», ошибки будут напечатаны, но программа продолжит работу. Если параметр не задан, проверки тегов не происходит.

### Параметр «quiet»

Для режима командной строки также предусмотрен ещё один параметр: `--quiet`. В режиме «quiet» или в «тихом» режиме на экран выводится меньше информации. Сообщения, обычно выводящиеся в строку состояния, показываться не будут.

Использовать параметр можно так: `java -jar OmegaT.jar /путь/к/проекту --mode=console-translate --quiet`

### Параметр проверки тегов

Для режима командной строки также предусмотрен ещё один параметр: `--tag-validation=[abort|warn]`. Если он задан, перед переводом проводится проверка тегов. Если задано `abort`, ошибки будут напечатаны и программа завершит работу. Если задано `warn`, ошибки будут напечатаны, но работа будет продолжена.

Использование: `java -jar OmegaT.jar /путь/к/проекту --mode=console-translate --tag-validation=abort`

## Автоматическое выравнивание файлов Java properties

ОмегаТ в режиме командной строки может выравнивать *.properties-файлы Java. Если у вас есть исходный и переведённый Properties-файлы для нужной языковой пары, то, используя их содержимое, вы можете создать TMX-файл. Использование:

`java -jar OmegaT.jar --mode=console-align /каталог-проекта --alignDir=/переведённыеФайлы/`

в каталоге `alignDir` должен находится файл на языке, используемом в проекте как язык перевода. Т. е., если в проекте производится перевод с английского на французский, имя bundle-файла должно иметь окончание «_fr». Полученный TMX-файл будет размещён в каталоге `omegat` под именем `align.tmx`.

## Настройки шрифтов

Это диалоговое окно позволяет вам изменить шрифт, который ОмегаТ использует в следующих окнах:

- Главное окно ОмегаТ (область редактирования, область просмотра совпадений, область глоссария)

- Окно поиска

- Окно проверки тегов

Это диалоговое окно можно вызвать, выбрав пункт меню «Параметры → Шрифт...» Это диалоговое окно содержит:

- Шрифт: меню выбора шрифтов, доступных на вашем компьютере;

- Размер: поле для изменения размера шрифта;

- Образец текста: область предварительного просмотра выбранного шрифта.

Примечание: в некоторых случаях ОмегаТ может потребоваться довольно значительное время, чтобы обновить окна после изменения настроек шрифта. Это особенно заметно, если на слабом компьютере открыт большой документ со множеством сегментов. Кроме того, имейте в виду, что некоторым языковым парам одни шрифты подходят больше, а другие — меньше. Если вы переводите текст на язык с другим алфавитом/системой письма (например, с русского на японский), нужно выбрать шрифт, поддерживающий оба языка.

## Предотвращение потери данных

ОмегаТ — довольно стабильное приложение. Тем не менее, как и при использовании любой другой программы, во время работы с ОмегаТ необходимо заботиться о сохранности ваших данных. Когда вы переводите свои файлы, ОмегаТ сохраняет наработки в памяти переводов `project_save.tmx`, которая находится в папке `/omegat` вашего проекта.

Кроме того, ОмегаТ сохраняет резервные копии памяти переводов в файлах «project_save.tmx.ГГГММДДЧЧНН.bak» в той же папке при каждом открытии или перезагрузке проекта. «ГГГГ» это год (4 цифры), «ММ» — это месяц, «ДД» — число, «ЧЧ» и «НН» — это часы и минуты, когда была сохранена предыдущая память переводов.

Если вы потеряли часть перевода, вы можете восстановить проект до предыдущей сохранённой копии (как правило, они не старше 10 минут) следующим образом:

1. закройте проект

2. переименуйте текущий файл `project_save.tmx` (например, `project_save.tmx.temporary`)

3. выберите резервную копию, которая скорее всего содержит нужные вам данные

4. переименуйте её в `project_save.tmx`

5. откройте проект

Чтобы предотвратить потерю важных данных:

- Регулярно делайте копии файла «/omegat/project_save.tmx» на резервные носители, например, CD или DVD.

- Пока не освоитесь с ОмегаТ, регулярно создавайте файлы перевода и проверяйте, чтобы они содержали последнюю версию перевода.

- После начала перевода будьте особенно аккуратны при любых изменениях файлов в каталоге `/source`. Если исходный файл изменяется после начала перевода, ОмегаТ может не найти сегмент, который вы уже перевели.

- Чтобы побыстрее освоиться, почаще обращайтесь к этому руководству. Если возникнут проблемы, напишите в список рассылки пользователей ОмегаТ . Пишите на том языке, на котором изъясняетесь лучше всего.