Руководство по использованию WeiDU - История изменений

Vit MG: уточнено описание GAME_IS в связи с обновлением версии WeiDU

2009-01-11T22:01:24Z

уточнено описание GAME_IS в связи с обновлением версии WeiDU

94.25.24.34: /* Концепция D и DLG-файлов */ исправлена опечатка

2008-12-24T10:20:42Z

Концепция D и DLG-файлов: исправлена опечатка

94.25.24.34: /* Формат D-файла диалога (D-формат) */ GOTO также заменяется на +

2008-12-24T10:19:01Z

Формат D-файла диалога (D-формат): GOTO также заменяется на +

94.25.24.34: /* Формат D-файла диалога (D-формат) */ сокращенное форматирование

2008-12-24T10:16:12Z

Формат D-файла диалога (D-формат): сокращенное форматирование

Vit MG: Выделено указание на оригинальную документацию

2008-12-23T10:01:41Z

Выделено указание на оригинальную документацию

Vit MG: /* Компоновка мода: TP2-файлы (Module Packaging: TP2 Files) */ GAME_IS с уточнением про bgt,, поскольку этого нет в основном ридми

2008-12-23T09:52:06Z

Компоновка мода: TP2-файлы (Module Packaging: TP2 Files): GAME_IS с уточнением про bgt,, поскольку этого нет в основном ридми

Vit MG: /* Формат D-файла диалога (D-формат) */ мелкая правка

2008-11-23T21:55:44Z

Формат D-файла диалога (D-формат): мелкая правка

Vit MG: мелкое редактирование

2008-11-23T21:37:13Z

мелкое редактирование

Vit MG: /* Компоновка мода: TP2-файлы (Module Packaging: TP2 Files) */ опечатки

2008-08-06T16:30:11Z

Компоновка мода: TP2-файлы (Module Packaging: TP2 Files): опечатки

Vit MG: /* 11 Распространение WeiDU с модулями (модами) в виде: Setup-MyMod.exe */ дополнительные аргументы, не указанные в руководстве

2008-08-06T16:07:14Z

11 Распространение WeiDU с модулями (модами) в виде: Setup-MyMod.exe: дополнительные аргументы, не указанные в руководстве

@@ Строка 667: / Строка 667: @@
 | valign=top | ''или''
 | valign=top | '''GAME_IS''' String
-| valign=top | Возвращает ИСТИНА, если переменная IE game принимает значения из списка (String), иначе - ЛОЖЬ. Список - это перечень определенных значений, разделенных пробелами. Значения могут быть следующие (регистр не различается): bg2=soa, tob, iwd2, pst, bg1, totsc, iwd=iwd1, how, tutu, tutu_totsc (''начиная с [http://forums.pocketplane.net/index.php/topic,26109.msg317515.html#msg317515 версии 209] добавлено еще одно'' - bgt, - ''все это устоявшиеся сокращения, обозначающие игры [[Infinity Engine]], прим.перев.''). Указания типа bg2=soa означают синонимы: bg2 - это синоним soa. Обратите внимание, проверяется именно точное соответствие игры: например, bg2 проверяет наличие именно [[Baldur's Gate II: Shadows of Amn]], без установленного [[Trone of Bhaal]], или [[tutu]]. Соответственно, если для [[мод]]а требуется установленная SOA и tutu, то в нем должна быть следующая проверка: REQUIRE_PREDICATE GAME_IS ~bg2 tob tutu tutu_totsc~ .
+| valign=top | Возвращает ИСТИНА, если переменная IE game принимает значения из списка (String), иначе - ЛОЖЬ. Список - это перечень определенных значений, разделенных пробелами. Значения могут быть следующие (регистр не различается): bg2=soa, tob, iwd2, pst, bg1, totsc, iwd=iwd1, how,  tolm=totlm, tutu, tutu_totsc, bgt (''все это устоявшиеся сокращения, обозначающие игры [[Infinity Engine]], прим.перев.''). Указания типа bg2=soa означают синонимы: bg2 - это синоним soa. Обратите внимание, проверяется именно точное соответствие игры: например, bg2 проверяет наличие именно [[Baldur's Gate II: Shadows of Amn]], без установленного [[Trone of Bhaal]], или [[tutu]], а bgt проверяет наличие [[TOB]] (и отсутствие [[TOSC]]) и установленного мода [[Baldur's Gate Trilogy]] (''такой порядок действует с версии 210, прим.перев.''). Соответственно, если для [[мод]]а требуется установленная SOA и tutu, то в нем должна быть следующая проверка: REQUIRE_PREDICATE GAME_IS ~bg2 tob tutu tutu_totsc~.
 |}

@@ Строка 110: / Строка 110: @@
 Данный ответ будет доступен всегда ''(поскольку условие не задано - ~~, - прим.перев.)'' и в окне сообщений будет выведена строка: "Мои извинения...". Номер строки, соответствующей этому тексту -  28656. Если персонаж игрока ''([[PC]] - player character)'' выбирает данный ответ, происходит переход к шагу 1. ''(Пример несколько отличается от содержимого SCSARLES.DLG, полученного ранее, - текст строки указан частью программы диалога, а не в комментарии, - данный вид обычно имеют классические, жестко закодированные, диалоги модов, что и объясняет выбор примера, - прим.перев.)''
-Наконец, переход иметь такой вид:
+Наконец, переход может выглядеть следующим образом:
    COPY_TRANS имя_файла ярлык

@@ Строка 163: / Строка 163: @@
 | valign=top | ''или''
 | valign=top | +  [ [[условие_перехода]]  ] + [[текст_ответа]] [[опции_перехода]]  list [[после_перехода]]
-| valign=top | Это сокращенный синтаксис для наиболее часто используемых [[переход]]ов - с ответами ([[REPLY]]). Позволяет сэкономить время и силы, в остальном полностью соответствует стандартному варианту, приведенному выше. (''Прим.перев: Команды IF и REPLY заменены знаками +, THEN опущено. Пример сокращенного форматирования начала диалога SCSARLES.DLG:''
+| valign=top | Это сокращенный синтаксис для наиболее часто используемых [[переход]]ов - с ответами ([[REPLY]]). Позволяет сэкономить время и силы, в остальном полностью соответствует стандартному варианту, приведенному выше. (''Прим.перев: Команды [[IF]], [[REPLY]], а также [[GOTO]] заменены знаками +, THEN опущено. Пример сокращенного форматирования начала диалога SCSARLES.DLG:''
 BEGIN ~SCSARLES~<br>
@@ Строка 169: / Строка 169: @@
 IF ~NumTimesTalkedTo(0)~ THEN BEGIN 0<br>
 SAY #28655<br>
-++ #28656 GOTO 1<br>
+++ #28656 + 1<br>
-++ #28657 GOTO 2<br>
+++ #28657 + 2<br>
 END
-сравните с оригиналом, приведенным в начале статьи.)
+''сравните с оригиналом, приведенным в начале статьи.'')
 |-
 | valign=top | ''или''

@@ Строка 150: / Строка 150: @@
 | valign=top | '''APPEND''' [ '''IF_FILE_EXISTS''' ] имя_файла [[шаг]] ''list'' '''END'''
 | valign=top | Данная команда указывает [[WeiDU]] добавить указанные [[шаг]]и в конец уже существующего файла имя_файла.DLG. Если указан параметр IF_FILE_EXISTS, а файла в игре не существует, то действие не выполняется.
 |}

← Предыдущая		Версия 10:01, 23 декабря 2008
Строка 1:		Строка 1:
−	Данная статья - попытка представить перевод на русский язык документации [[WeiDU]] ~~([http://www.weidu.org/~thebigg/README-WeiDU.html WeiDU Documentation])~~, включаемой в архив программы, дополненный, по-возможности, комментариями и замечаниями, основанными на личном опыте составителей.	+	Данная статья - попытка представить перевод на русский язык документации [[WeiDU]], включаемой в архив программы, дополненный, по-возможности, комментариями и замечаниями, основанными на личном опыте составителей.
		+
		+	'''Оригинальную документацию смотрите [http://www.weidu.org/~thebigg/README-WeiDU.html здесь].'''

	==Краткая информация о [[WeiDU]]==		==Краткая информация о [[WeiDU]]==

@@ Строка 616: / Строка 616: @@
 | valign=top | '''AUTO_TRA''' ''путь''
 | valign=top | Флаг AUTO_TRA используется вместе с инструкцией COMPILE TP2. Он указывает автоматически загрузить [[TRA-файл]]ы, соответствующие [[D-файл]]ам ''(соответствие подразумевает совпадение имен до расширения; [[TRA-файл]]ы загружаются из указанного пути, в котором может использоваться переменная '''%s''', которую [[WeiDU]] заменяет на указанную пользователем директорию языка, - прим.перев.).''
 |}

@@ Строка 123: / Строка 123: @@
 Все ''ключевые слова'' синтаксиса даны в ВЕРХНЕМ РЕГИСТРЕ. Остальные ''ключевые слова'' символические ''(призваны интуитивно подсказывать, чем их в реальности заменять, - прим.перев.)''. Запомните, что:
-* "''list''" после выражения означает "''0 или более штук этого выражения''";
+* "''list''" после выражения означает "''далее, если нужно, могут быть еще такие же выражения''" или "''0, 1 или более выражений''";
 * "'''['''''выражение в квадратных скобках''''']'''" означает "''не обязательное выражение" или "0 или 1 выражение''";
 * ''многоточие'' (...) после выражения означает "''можно повторить выражение столько раз, сколько захочется''".

@@ Строка 5: / Строка 5: @@
 У [[WeiDU]] есть в Интернете домашняя страница:http://weidu.org/. Рекомендую вам загрузить оттуда самую свежую версию.
-[[WeiDU]] разработан ''(уже сложилась практика называть эту программу в мужском роде: он, [[WeiDU]] - прим.перев.)'' для того, чтобы упростить процесс написания и распространения [[мод]]ификаций (модов) для игр на [[Infinity Engine]]. Он может загружать и производить действия с ресурсами [[Infinity Engine]] в соответствии с инструкциями, которые вы ему напишете. [[WeiDU]] идеален для упаковки [[мод]]ификаций, которые включают диалоги, или таких, которые должны быть совместимы с другими [[мод]]ификациями.
+[[WeiDU]] разработан ''(уже сложилась практика называть эту программу в мужском роде: он, [[WeiDU]] - прим.перев.)'' для того, чтобы упростить процесс написания и распространения [[мод]]ификаций (модов) для игр на [[Infinity Engine]]. Он может загружать и производить действия с ресурсами [[Infinity Engine]] по инструкциям, которые вы ему напишете. [[WeiDU]] идеален для упаковки [[мод]]ификаций с диалогами, или таких, которые должны быть совместимы с другими [[мод]]ификациями.
 Сразу честно признаюсь: [[WeiDU]] поначалу кажется сложнее в использовании, чем другие подобные программы. Однако, большинство пользователей сходятся во мнении, что: во-первых, альтернативные программы не могут удовлетворить их из-за отсутствия функций, которые в [[WeiDU]] имеются, и, во-вторых, к [[WeiDU]] быстро привыкаешь.
@@ Строка 11: / Строка 11: @@
 Вы можете смело использовать эту программу для разработки и распространения своих собственных [[мод]]ов на [[Infinity Engine]]. На [[WeiDU]] распространяется действие GNU (General Public License), но, в расширение ее, вы имеете право, если пожелаете, свободно включать в состав [[мод]]а бинарный исполняемый файл WeiDU.EXE (в неизмененном виде и без исходного кода).
-Я решил написать свои собственную утилиту для работы с [[DLG]] и [[TLK]] в [[Infinity Engine]], потому что не смог добиться от [[TeamBG DLG Editor]] и [[Mass Converter]] правильной работы. Эти программы не анализируют строки или могут испортить текст или могут вдруг зависнуть ... где ни ткни, везде плохо. К тому же все они основаны на GUI (графическом интерфейсе). Будучи воспитанным на unix, я обожаю программы, работающие в командной строке, а как дипломированный PL-специалист ''(специалист по языкам программирования, - прим.перев.)'', я люблю разрабатывать всякие языки и компиляторы. [[WeiDU]] изначально состоял из нескольких маленьких программочек с ничего не говорящими названиями: DC, DD и TP. Более привлекательный термин "WeiDU" (который рифмуется с "IDU"  - ''сокращение от interface data unit, интерфейсный блок данных, прим.перев.'' - и "Eye-Dee-You" - ''не очень понятное сочетание; наверное наиболее интересным является созвучность с "we do", мы делаем, -  прим.перев.'') придумали Джейсон Комптон (Jason Compton) и Грейфэйн (Ghreyfain) - выдающиеся авторы [[мод]]ов для [[BGII]].
+Я решил написать свою собственную утилиту для работы с [[DLG]] и [[TLK]] в [[Infinity Engine]], потому что не смог добиться от [[TeamBG DLG Editor]] и [[Mass Converter]] правильной работы. Эти программы не анализируют строки, или могут испортить текст, или могут вдруг зависнуть ... где ни ткни, везде что-нибудь да не так. К тому же, все они основаны на GUI (графическом интерфейсе). Будучи воспитанным на unix, я обожаю программы, работающие в командной строке, а как дипломированный PL-специалист ''(специалист по языкам программирования, - прим.перев.)'', я люблю разрабатывать всякие языки и компиляторы. [[WeiDU]] изначально состоял из нескольких маленьких программочек с ничего не говорящими названиями: DC, DD и TP. Более привлекательный термин "WeiDU" (который рифмуется с "IDU"  - ''сокращение от interface data unit, интерфейсный блок данных, прим.перев.'' - и "Eye-Dee-You" - ''не очень понятное сочетание; наверное наиболее интересным является созвучность с "we do", мы делаем, -  прим.перев.'') придумали Джейсон Комптон (Jason Compton) и Грейфэйн (Ghreyfain) - выдающиеся авторы [[мод]]ов для [[BGII]].
 ==Без паники!==
 Пошаговое руководство к [[WeiDU]] для новичков:
-Наилучший способ научиться писать код в формате [[WeiDU]] - формате [[D-файл|D]] - прочитать код, написанный в формате [[WeiDU]] - формате [[D-файл|D]]. Начните с декомпиляции уже существующих игровых файлов DLG, которые вы хорошо знаете, и прочитайте полученные файлы. Сравните то, как они выглядят в [[WeiDU]] и то, как они выглядят в других редакторах, с которыми вы, возможно, лучше знакомы (например, [[Near Infinity]] и [[Infinity Explorer]]).
+. Без паники. Многие из вас - дети эры графических пользовательских интерфейсов (GUI). Но программы, которые работают в командной строке, тоже могут быть вашими друзьями, и, по большому счету, они работают гораздо быстрее, а использовать их, на самом деле, гораздо проще.
-Наилучший способ научиться писать код в формате [[WeiDU]] - формате [[D-файл|D]] - прочитать код, написанный в формате [[WeiDU]] - формате [[D-файл|D]], часть 2. Все больше аддонов к BG2 создаются при помощи [[WeiDU]]. Список можно найти здесь: http://www.pocketplane.net/modlist/. Они помогут вам понять, как использовать более сложные функции [[WeiDU]], такие как добавление диалогов, работа со скриптами и 2DA-файлами, а также вещами (item), заклинаниями (spells) и существами (creature), которые используются непосредственно в игре. Поставьте себе такую задачу: скачать определенный мод и разобраться КАК ИМЕННО он работают.
+. Лучший способ научиться писать код в формате [[WeiDU]] - ''прочитать'' код, написанный в этом формате (то есть, в формате [[D-файл|D]]). Начните с декомпиляции уже существующих игровых файлов DLG, которые вы хорошо знаете, и прочитайте полученные файлы. Сравните то, как они выглядят в [[WeiDU]] и то, как они выглядят в других редакторах, с которыми вы, возможно, лучше знакомы (например, [[Near Infinity]] и [[Infinity Explorer]]).
-Посмотрите некоторые примеры в этом документе. Есть замечательное руководство к [[WeiDU]] (написанное Japheth): http://forums.pocketplane.net/index.php?topic=55.0 (русский перевод [http://alina.aerie.ru/tutorial_rus.htm здесь]). Если чувствуете, настоящее руководство для вас слишком сложно, зайдите сначала туда. Там также объясняется как установить утилиту. Ghreyfain написал туториал "как создать NPC при помощи [[WeiDU]]" http://forums.pocketplane.net/index.php?topic=52.0 (русский перевод [http://alina.aerie.ru/npc_translation.htm здесь] )
+. Лучший способ научиться писать код в формате [[WeiDU]] - ''прочитать'' код, написанный в этом формате, часть 2. При помощи [[WeiDU]] создается все больше [[мод]]ов для [[BG2]]. Список можно найти, например, здесь: http://www.pocketplane.net/modlist/. Они помогут вам понять, как использовать более сложные функции [[WeiDU]], такие как добавление диалогов, работа со скриптами и 2DA-файлами, а также вещами (item), заклинаниями (spells) и существами (creature), которые используются непосредственно в игре. Поставьте себе такую задачу: скачать определенный мод и разобраться КАК ИМЕННО он работают.
-Есть специальный форум для обсуждения [[WeiDU]]: http://forums.pocketplane.net/index.php?board=50.0. Для того, чтобы получить ответ на вопросы по использованию [[WeiDU]] (и по разработке модов тоже), этот форум - самое подходящее место.
+. Посмотрите примеры в этом документе. Есть замечательное руководство к [[WeiDU]] (написанное Japheth): http://forums.pocketplane.net/index.php?topic=55.0 (русский перевод [http://alina.aerie.ru/tutorial_rus.htm здесь]). Если чувствуете, настоящее руководство для вас слишком сложно, зайдите сначала туда. Там также объясняется как установить утилиту. Ghreyfain написал туториал "как создать NPC при помощи [[WeiDU]]" http://forums.pocketplane.net/index.php?topic=52.0 (русский перевод [http://alina.aerie.ru/npc_translation.htm здесь] )
-Ну, и наконец, если Вы используете Mac и собираетесь пользоваться [[WeiDU]], посетите http://weidu.org/Mac.html  - там содержится информация по созданию копии [[WeiDU]], работающей под OS X.
+. Есть специальный форум для обсуждения [[WeiDU]]: http://forums.pocketplane.net/index.php?board=50.0. Для того, чтобы получить ответ на вопросы по использованию [[WeiDU]] (и по разработке модов тоже), этот форум - самое подходящее место.
 ==Концепция [[D-файл|D]] и [[DLG-файл]]ов==

@@ Строка 595: / Строка 595: @@
 {|width=96% align = center style="font-size: 100%; text-align: left" border=1 cellpadding=4 cellspacing=0
 |-
-! valign=top width=10% | [[TP2-файл]] || valign=top width=20% |  || valign=top width=70% | [[TP2-файл]] - это текстовый файл, в котором имеется одна или несколько компоненов (''компоненты - Components - так называется основная часть [[TP2-файл]]а, см.ниже, названия разделов, использующиеся в качестве команд, оставлены без перевода - прим.перев.'') мода . [[TP2-файл]]ы указывают [[WeiDU]], как инсталлировать различные части мода на компьютере пользователя.
+! valign=top width=10% | [[TP2-файл]] || valign=top width=20% |  || valign=top width=70% | [[TP2-файл]] - это текстовый файл, в котором имеется одна или несколько компонентов (''компоненты - Components - так называется основная часть [[TP2-файл]]а, см.ниже, названия разделов, использующиеся в качестве команд, оставлены без перевода - прим.перев.'') мода . [[TP2-файл]]ы указывают [[WeiDU]], как инсталлировать различные части мода на компьютере пользователя.
 |-
 | valign=top | ''это''
@@ Строка 606: / Строка 606: @@
 '''Компонент''' ''list''
-| valign=top | [[TP2-файл]] - это необходимое вступление перед списком Компонентов. BACKUP указывает [[WeiDU]], куда поместить резервные копии файлов, которые будут перезаписаны, с тем, чтобы их можно было потом восстановить. Соответствующая директория, если потребуется, будет создана автоматически. AUTHOR служит для информирвания пользователя об адресе, куда нужно обращаться с проблемами установки и багами. [[WeiDU]] устанавливает переменной '''TP2_AUTHOR''' значение ''адрес_email'', а переменной '''TP2_FILE_NAME''' - имя данного [[TP2-файл]]а. [[TP2-флаг]]и устанавливают глобальные настройки (global options). В секции Language (язык) описываются все языки, доступные для данного мода. И, наконец, секция Коммпоненты содержит собственно сам мод. Различные компоненты могут устанавливаться и удаляться независимо друг от друга, но все, что внутри компонента, рассматривается, как единое целое.
+| valign=top | [[TP2-файл]] - это необходимое вступление перед списком Компонентов. BACKUP указывает [[WeiDU]], куда поместить резервные копии файлов, которые будут перезаписаны, с тем, чтобы их можно было потом восстановить. Соответствующая директория, если потребуется, будет создана автоматически. AUTHOR служит для информирования пользователя об адресе, куда нужно обращаться с проблемами установки и багами. [[WeiDU]] устанавливает переменной '''TP2_AUTHOR''' значение ''адрес_email'', а переменной '''TP2_FILE_NAME''' - имя данного [[TP2-файл]]а. [[TP2-флаг]]и устанавливают глобальные настройки (global options). В секции Language (язык) описываются все языки, доступные для данного мода. И, наконец, секция Компоненты содержит собственно сам мод. Различные компоненты могут устанавливаться и удаляться независимо друг от друга, но все, что внутри компонента, рассматривается, как единое целое.
 |-
 | colspan=3 |
@@ Строка 614: / Строка 614: @@
 | valign=top | ''это''
 | valign=top | '''AUTO_TRA''' ''путь''
-| valign=top | Флаг AUTO_TRA испоьзуется вместе с инструкцией COMPILE TP2. Он указывает автоматически загрузить [[TRA-файл]]ы, соответствующие [[D-файл]]ам ''(соответствие подразумевает совпадение имен до расширения; [[TRA-файл]]ы загружаются из указанного пути, в котором может использоваться переменная '''%s''', которую [[WeiDU]] заменяет на указанную пользователем директорию языка, - прим.перев.).''
+| valign=top | Флаг AUTO_TRA используется вместе с инструкцией COMPILE TP2. Он указывает автоматически загрузить [[TRA-файл]]ы, соответствующие [[D-файл]]ам ''(соответствие подразумевает совпадение имен до расширения; [[TRA-файл]]ы загружаются из указанного пути, в котором может использоваться переменная '''%s''', которую [[WeiDU]] заменяет на указанную пользователем директорию языка, - прим.перев.).''
 |}

@@ Строка 624: / Строка 624: @@
 * Setup-MyMod.tp2
 * MyMod.tp2
-''(эта функция призвана способствовать упрощению организации процедуры установки модов, но часто используется разработчиками как предлог для оптимизации архивов модов - в них вообще не включается EXE-файл и подразумевается, что пользователь должен самостоятельно переименовать WeiDU.EXE в вид, соответствующий [[TP2-файл]]у [[мод]]а, а при необходимости, - скачать и сам архив [[WeiDU]], - прим.перев.)''
+''Примечания переводчика:''
 ==11.2  Значения, которые возвращает [[WeiDU]]==