Просмтор этого файла доступен только зарегистрированным пользователям. Но у нас супер быстрая регистрация: достаточно только электронной почты!

Текст из файла (страница 39)

Рис. 14-2. Диалог "Language Selection"

1. Выберите желаемый язык из списка поддерживаемых типов языковых файлов.

2. Щёлкните на "Add".

3. В этом месте Вам потребуется подтвердить свой выбор. Щёлкните на "Yes".

Диалог "Language Selection" закроется, и Вы теперь увидите вновь созданный файл перевода в списке доступных переводов.

Редактирование существующего файла перевода

Чтобы отредактировать файл перевода в списке переводов [список "Translactions" диалога "PhAB Language Editor" – прим. пер.]

1. Щёлкните на нужном языке в списке.

2. Щёлкните на клавише "Open".

Появится диалог "Text Translation Editor". Этот текстовый редактор отображает все текстовые строки, доступные для перевода, в текущей базе данных языков.

Перевод текста

Чтобы перевести текстовую строку:

1. Щёлкните на текстовой строке, которую Вы хотите перевести. Выбранная текстовая строка отобразится в текстовой области в верхней части окна:

Default text принимаемый по умолчанию текст, привязанный к приложению

Translation текущий перевод (если имеется) для текстовой строки. Это область, используемая Вами для набора нового перевода.

При редактировании перевода Вы можете использовать кнопки вырезки, копирования и вставки, расположенные над областью перевода.

1. Сразу по изменении переводимой строки, выше области перевода появятся кнопки с зелёной птичкой и красным крестиком.

2. Щёлкните на зелёной птичке, чтобы принять Ваши изменения (кнопкой быстрого доступа является <Ctrl> – <Enter>).

3. Щёлкните на красном крестике, чтобы отменить Ваши изменения.

Повторите вышеприведенные шаги для всех строк, которые Вы хотите перевести. Когда закончите, щёлкните на кнопке "Save & Close".

Горячие клавиши

При переводе приложения появляется проблема, связанная с тем, что назначенные горячие клавиши больше не соответствуют переводимой строке, если та не включает значение клавиши быстрого доступа. Исходя из этого соображения, PhAB добавляет в базу данных языка также и строки клавиши быстрого доступа.

При переводе текстовой строки переводчик может также изменить клавишу быстрого доступа. Если клавиша, используемая в качестве горячей, не является функциональной (т.е. код клавиши меньше 0хF000), PhAB автоматически изменит горячую клавишу, чтобы соответствовать клавише быстрого доступа.

Например, предположим, Ваше приложение имеет кнопку с надписью "Cancel". Вы устанавливаете в С значение ресурса Pt_ARG_ACCEL_KEY, и монтируете <Alt> – <C> для вызова ответной реакции Pt_CB_HOTKEY.

Когда Вы генерируете базу данных языков, Вы обнаружите, что она включает надпись на кнопке и её клавишу быстрого доступа. Если Вы переводите приложение на французский, надпись на кнопке станет "Annuler", так что горячая клавиша <Atl> – <C> больше не подходит. Просто переведите Pt_ARG_ACCEL_KEY на А, и горячей клавишей автоматически станет <Alt> – <A>, когда Вы запустите приложение на французском.

 Вы должны убедиться, что отсутствуют повторяющиеся клавиши быстрого доступа. Если это, к несчастью, случится, будет признана только первая заданная клавиша.

Ресурсы help'a

Если Вы используете просмотровщик помощи (Photon Helpviewer) для организации помощи в Вашем приложении и планируется обеспечить для Вашего приложения многоязычные файлы помощи, переводчик также может перевести так называемые маршруты тем помощи, чтобы указать правильные позиции внутри соответствующих файлов помощи.

Функции перевода

Вы можете строить свой собственный редактор языков, если обнаружите, что предлагаемый по умолчанию не соответствует Вашим потребностям. Вы найдёте эти функции полезными.

Вы можете использовать эти функции, чтобы создать свой собственный редактор языков, или преобразовать базу данных языков в файл другого формата (например, так Вы сможете переслать файл в не-Photon'овскую или не-QNX'овскую систему для перевода).

Запуск Вашего приложения на исполнение

После того как база данных языков полностью переведена, последним шагом является запуск приложения.

Когда Вы создаёте файлы перевода, они помещаются в той же директории, что и файл Вашего приложения abapp.dfn. Вы можете рассматривать это как рабочие версии файлов. Когда Вы запускаете Ваше приложение из PhAB'а, это является используемыми Вами версиями.

Когда Вы запускаете Ваше приложение вне PhAB, оно просматривает файлы перевода в следующем порядке:

1. В директориях, перечисленных в переменной окружения ABLPATH, если она задана. Этот список имеет вид: dir:dir:dir:dir.

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

1. В той же директории, где располагается исполняемый файл, если переменная окружения ABLPATH не определена.

Для того, чтобы API PhAB знал, какой файл перевода Вы хотите использовать, Вы должны установить значение переменной ABLANG в одно из следующих значений:

 Этот список приведен на момент написания этого документа, но с тех пор мог быть обновлён. Чтобы получить последнюю версию, см. файл /usr/photon/appbuilder/languages.def

[Хе-хе. В безнадёжных поисках ru_RU – Прим.пер.]

Например, чтобы запустить приложение на немецком (как выражаются, в Германии), Вы должны сделать следующее:

$ export ABLANG=de_DE

$ myapplication

 Приложение ищет наилучшую возможность совпадения. Например, если расширение языка задано как fr_CA, поиск выполняется следующим образом:

1. Точное совпадение (например, fr_CA);

2. Совпадение в основном (например, fr);

3. Совпадение по групповому символу (например, fr*).

Если никакого перевода не найдено, используется оригинальный текст приложения.

Команда export может быть помещена в профайл входящего пользователя, так что приложение будет запускаться на языке, предопределённом каждым пользователем.

Распространение Вашего приложения

Когда Вы отправляете Ваше приложение клиенту, Вы должны убедиться, что включили файлы переводов в Ваш лист отправки. Например, если Ваше приложение называется myapp, ти у Вас есть файлы переводов на французкий и немецкий, Вам надо включить в приложение файлы myapp.fr_FR и myapp.de_DE.

Эти файлы должны располагаться:

• В директориях, перечисленных в переменной окружения ABLPATH, если она задана. Этот список имеет вид:

dir:dir:dir:dir

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

• В той же директории, где располагается исполняемый файл, если переменная окружения ABLPATH не определена.

Если Вы хотите, чтобы каждый клиент мог переводить приложение, Вы также должны распространять с приложением:

• языковый редактор (phablang), который можно разместить в директории /usr/bin/photon.

• файл определения языков (languages.def), который должен быть установлен в той же директории, что и редактор.

• базу данных языков приложеения (myapp.ldb).

База данных языков и файл перевода, созданные клиентом, должны размещаться:

• в одной из директорий, перечисленных в переменной окружения ABLPATH, если она задана.

• В той же директории, где располагается исполняемый файл, если переменная окружения ABLPATH не определена.

Глава 15. Контекстно-чувствительная помощь

Эта глава описывает, как обеспечить в Вашем приложении контекстно-чувствительную помощь:

• Создание текста помощи

• Ссылки на темы помощи

• Связывание помощи с виджетами

• Доступ к помощи из Вашего кода

Создание текста помощи

Чтобы создать текст помощи для чтения Photon'овским просмотровщиком помощи, Вам потребуется два типа файлов:

• сами файлы помощи

• файлы с таблицами содержания

Файлы помощи

Файлы помощи пишутся на HTML и имеют расширение .html. Просмотровщик помощи поддерживает следующие тэги (с атрибутами):

Просмотровщик помощи использует виджеттт PtWebClient и поддерживает общие форматы образов Интернета. Он также поддерживает объекты стандарта HTML 3.2/ISO для символов, а также следующее:

Файлы таблиц содержания

Файлы таблиц содержания (Table-of-contents-TOC) определяют список продуктов, имеющих информационную помощь, и иерархию тем для каждого продукта. Эти файлы имеют расширение .toc. Все они располагаются в директории /usr/help/product. Каждый продукт имеет TOC-файл 1-го уровня и директорию с чем-либо ещё. Так, например, помощь по Photon'у включает:

Характеристики

Список файлов книги