Руководство по использованию WeiDU

Данная статья - попытка представить перевод на русский язык документации WeiDU (WeiDU Documentation), включаемой в архив программы, дополненный, по-возможности, комментриями и замечаниями, основанными на личном опыте составителей.

7.9 Преобразование "жестко закодированного" D-файла в пару D/TRA (последнее обновление: v200)

Материал любезно предоставил Джейсон Комптон (Jason Compton).

D и TP2-файлы позволяют указывать текст либо прямо в программе:

 // Greeting.d
 SAY ~Привет.~

либо с помощью дополнительного TRA-файла (от translation - перевод, прим.перев.), что позволяет, кроме прочего, использовать несколько языков:

 // Greeting.d
 SAY @1

 // Greeting.tra
 @1 = ~Привет.~

Суть в том, что для перевода, например, на французский, достаточно сделать Greeting.tra на французском:

 // French-Greeting.tra
 @1 = ~Bonjour.~

Однако, те пользователи WeiDU, которые для удобства или им просто не приходила в голову идея о переводе, и они использовали "жестко закодированные" диалоги, а теперь изменили свое решение, могут воспользоваться командой --traify, которая преобразует весь текст в командах SAY, REPLY и записи JOURNAL в формат, удобный для перевода (трафицированный формат - прим.перев.) Команда --traify также может быть использована для TP2-файлов.

Чтобы преобразовать "жестко-закодированный" D-файл FWKI.d в комбинацию из новых файлов D и TRA (трафицировать - прим.перев.), используйте команды --traify и --out, чтобы указать исходные и конечные имена файлов соответственно:

 C:\Program Files\Black Isle\BGII - SoA\> weidu --traify fwki.d --out fwki-new.d

Через несколько секунд будут созданы файлы fwki-new.d и fwki-new.tra.

После выполнения команды --traify исходный код в файле fwki.d:

 APPEND J#KLSYJ
   IF ~~ THEN BEGIN KelseySAHPR4
     SAY ~Urk. Who was the lucky donor?~
     IF ~~ THEN EXTERN SAHPR2 10
   END
 END 

в файле fwki-new.d выглядит так:

 APPEND J#KLSYJ
   IF ~~ THEN BEGIN KelseySAHPR4
     SAY @0
     IF ~~ THEN EXTERN SAHPR2 10
   END
 END 

а во вновь созданном fwki-new.tra, будет соответственно:

 @0    = ~Urk. Who was the lucky donor?~

и теперь это диалог готов для перевода.

--traify выполняется для всего D-файла от начала до конца и нумерует строки, начиная с @0. Никакие уже имеющиеся строки НЕ пропускаются, даже если они и будут найдены под каким-либо номером (@x), поэтому, если ваш D-файл уже был частично трафицирован, то лучше дополнительно использовать ключ --traify-old-tra.

Поскольку, по умолчанию --traify начинает нумерацию с @0 и игнорирует любые имеющиеся в D-файле ссылки на строки типа @x, если Вы уже пытались трафицировать диалог вручную, скорее всего, Ваши ссылки @x будут конфликтовать с результатами команды --traify.

Другими словами, если у вас уже есть трафицированный кусок

 IF ~~ THEN BEGIN blah
   SAY @0
   IF ~~ THEN EXIT
 END

--traify не пропустит ссылку @0 и у Вас будет две ссылки с одинаковым номером @0, хотя вы намеревались использовать две различные строки, и это, как Вы понимаете, плохо.

Чтобы избежать такой проблемы, добавьте ключ (аргумент) --traify-old-tra, чтобы указать, что файл уже частично трафицирован:

 C:\Program Files\Black Isle\BGII - SoA\> weidu --traify fwki.d --traify-old-tra fwki.tra --out fwki-new

будут сохранены имеющиеся ссылки на номера строк и добавлены новые - на строки из нового файла fwki-new.tra.

Наконец, учтите, что --traify работает также и с BAF-файлами.

Замечание: Можно было бы посоветовать воспользоваться в этом случае ключом --traify#. Но, если вы не хотите, чтобы нумерация строк начиналась с какого-то определенного номера, используйте ключ --traify-old-tra.

Во всех случаях, возможно, Вы найдете полезным использование в командной строке также ключа --traify-comment, поскольку это позволит добавить в D-файл содержимое строк, на которые даны ссылки, но уже в виде комментариев (чтобы легче было редактировать его в будущем):

 C:\Program Files\Black Isle\BGII - SoA\> weidu --traify fwki.d --traify-old-tra fwki.tra --out fwki-new --traify-comment

Один нюанс: используя вместе ключи --traify-comment и --traify-old-tra, можно добавить в комментарии D-файла отсутствующие расшифровки строк. (Смысл фразы оригинала уточнен практической проверкой - отсутствующие комментарии, действительно, появляются в D-файле, так же, как отсутствующие строки-расшифровки в TRA-файле, прим.перев.)

(Прим.перев.: во всех практических примерах в оригинале вместо --traify-old-tra использовалось отсутствующее в списке ключей командной строки --traify-tra, очевидно, ошибочно - исправлено.)

11.2 Значения, которые возвращает WeiDU

Завершение работы WeiDU.exe (или Setup-MyMod.exe) заканчивается установкой величины, называемой "возвращаемое значение" (или “код завершения”, или “код состояния”, или “уровень ошибки”), которая зависит от успеха или неудачи определенных операций. В зависимости от Вашей операционной системы, можно использовать эту величину в программных скриптах или исполняемых фалах, которые запускают WeiDU. По общему правилу, WeiDU возвращает 0 в случае успеха. Значение, отличное от 0 означает сбой. Вот список возвращаемых значений:

• 0. Общий успех. Ошибок, указанных ниже, не отмечено.
• 1. Установить компонент TP2 невозможно. В результате ошибки установки выводится одна из следующих строк: “Stopping installation because of error” (Установка прекращена из-за ошибки), “ERROR Installing [Component], rolling back to previous state” (Ошибка при установке указанного компонента, возврат к предыдущему состоянию), “PLEASE email the file SETUP-MYMOD.DEBUG to AUTHOR” (Пожалуйста, отправьте файл SETUP-MYMOD.DEBUG разработчику), “ERROR Re-Installing [MyMod] component 1” (Переустановка компонента такого-то мода [MyMod] вызвала ОШИБКУ).
• 2. Ошибка авто-обновления.
• 3. Повторная попытка авто-обновления. WeiDU.exe успешно обновлен, нужно запустить WeiDU.exe еще раз.
• 4. Неверный ключ коммандной строки.