Файл с таблицей диалогов обычно называется dialog.tlk (dialogf.tlk, содержащий строки для женских персонажей) и содержит все строки, отображаемые игрой перед пользователем. Данный формат файла был разработан Bioware Corp. и используется в сериях игр Baldur's Gate, Planescape: Torment, IceWind Dale, Neverwinter Nights, Knights of the Old Republic.
Перед использованием редактора следует сделать резервные копии файлов, с которыми планируется работать. Автор (Nightfall) не несет НИКАКОЙ (на то и бесплатно) ответственности (однако, готов выслушать все замечания и принять к сведению все предложения) за возможную порчу файлов пользователя в результате использования (ошибки могут быть как в самой программе, так и в браузере, веб-сервере, системе и т.д.) редактора. В файле history.txt отображен ход развития, а в forward.txt - возможные в будущем модификации редактора. Файл bugslist.txt содержит список недостатков текущей версии.
1. Если вы используете Apache-сервер, отличный от Денвер-2, то остановите его. В противном случае могут возникнуть проблемы с доступом к локальному хосту (localhost), через который работает tlk-редактор.
2. Запуск редактора.
2.1. Запуск редактора с помощью файла автозапуска.
Запустите файл start.bat из корневой папки с установленным редактором. Будет создан виртуальный диск Z и запущен собственно сам сервер:
В системном трее появится иконка Apache-сервера:
. Также с помощью интернет-браузера будет открыта страница начальных сведений о редакторе:
и открыто окно самого редактора:
В системном трее появится иконка Apache-сервера:
. Также с помощью интернет-браузера будет открыта страница начальных сведений о редакторе:и открыто окно самого редактора:
2.2. Для запуска редактора вручную.
Запустите Apache-сервер пакета Денвер-2: [путь к Денвер-2]\etc\Run.exe. При этом будет создан виртуальный диск Z и запущен собственно сам сервер (см. скриншот выше).
Набрав в командной строке интернет-браузера http://localhost/nfu/, запустите редактор в отдельном окне, или http://localhost/nfu/tlkedit/ - для запуска редактора в собственном окне браузера.
Набрав в командной строке интернет-браузера http://localhost/nfu/, запустите редактор в отдельном окне, или http://localhost/nfu/tlkedit/ - для запуска редактора в собственном окне браузера.
3. Все элементы в редакторе имеют всплывающие подсказки, текст которых дублируется в строках статуса редактора и вашего интернет-браузера.
4. Для завершения работы редактора нужно просто закрыть окно (вкладку) браузера с ним.
5. Для завершения работы сервера пакета Денвер-2 нужно запустить [путь к Денвер-2]\etc\Stop.exe. При этом будет отключен созданный при запуске сервера виртуальный диск и остановлен сервер.
Остановку сервера пакета Денвер-2 рекомендуется выполнять до завершения работы Windows.
В файле install.txt содержатся указания для настройки и работы редактора как совместно с пакетом Денвер-2, так и с другими Apache-серверами. Примечание: для работы собственных настроек редактора, необходима поддержка Cookies (проверьте в настройках) вашим браузером.
Можно сохранять неограниченное количество профилей. В профиле сохраняются следующие данные состояния редактора:
- пути к первому и второму файлам;
- выбор главного файла;
- значение строки поиска;
- список найденного;
- подсказка списка найденного;
- номер текущей строки;
- закладки для первого и второго файлов.
При сохранении текущего состояния редактора в новый профиль последовательно будут показаны два запроса:
1. Запрос на имя нового профиля, которое должно быть не более 12-ти символов (больше не предусматривается вводом для удобства отображения в меню профилей).
2. Запрос на описание нового профиля, длина которого не оговаривается (хотя также для удобства отображения в меню профилей не стоит вводить слишком большое описание).
ПРИМЕЧАНИЯ: по умолчанию в качестве имени и описания для нового профиля используются значения текущего профиля; профили сохраняются в файл profiles.js, при сохранении профиля происходит перезапись этого файла с сохранением других профилей.
Размер файла в байтах;
Тип файла, который однозначно TLK;
Версия структуры файла, поддерживаются V1 (Planescape: Torment, Baldur's Gate, Baldur's Gate II, Icewind Dale, Icewind Dale II) и V3.0 (Neverwinter Nights, Knights of the Old Republic, Knights of the Old Republic II);
Языковой идентификатор файла, даже при русскоязычных строках используется английский, т.е. 0.
В разделе "Текущая строка:" будет отображена следующая информация:
номер текущей строки;
общее число строк в файле;
флаг (Flags) текущей строки;
длина (StringSize) текущей строки, в байтах;
смещение (Header + String Data Table + OffsetToString) текущей строки от начала файла, в байтах;
звуковой ресурс (SoundResRef) текущей строки;
отклонение высоты/тональности звукового ресурса (PitchVariance) текущей строки;
отклонение громкости звукового ресурса (VolumeVariance) текущей строки;
длительность звукового ресурса (SoundLength) текущей строки, в секундах (не поддерживается в TLK V1).
При нажатии кнопки ">" рядом с надписью звуковой ресурс раздела "Текущая строка", появится список-панель всех звуковых ресурсов в текущем tlk-файле. При щелчке правой кнопки мышки на любой позиции в списке, соответствующая строка будет добавлена к списку изменений текущего tlk-файла. Список звуковых ресурсов может быть отсортирован по номеру строки:
...или по имени ресурса:
В разделе "Статистика:" будет выведена различная информация об обработке текущего запроса.
Этот раздел может быть полностью "очищен" после положительного ответа на вопрос:
Также поле статистики можно открыть в отдельном окне, что может быть полезно при большом числе сообщений:
после чего нажать "Обзор..." ("Browse...") и выбрать необходимый файл, который будет загружен автоматически, аналогично описанному выше.
при этом поле контента текущей строки будет горизонтально разделенным на две части, каждая из которых будет отображать строку соответствующего файла.
Информация о файле и строке отображается только для главного (поле имени отмечено круглым чекбоксом) файла, а потому, в данном случае останется неизменной. Однако вы можете "на лету" менять главный файл, просто щелкнув на нужном чекбоксе. При этом поля контента текущей строки поменяются местами и обновится информация о главном файле и текущей строке.
 Опция "оба файла" (одновременная навигация обоих отрытых tlk-файлов) приводит к изменению контента строки дополнительного файла одновременно с изменением строки главного (при навигации). Эта опция сохраняется и ее текущее состояние будет использовано при последующих запусках редактора. |
ПРИМЕЧАНИЕ: если опция "оба файла" была выключена, то при загрузке второго файла в поле его контента вы увидите следующее: "Внимание: вы указали для обработки в редакторе дополнительный файл. Контент строки дополнительного файла появляется (обновляется) здесь только при одновременной обработке его с главным файлом." |
ПРИМЕЧАНИЯ: поиск/замена производятся без учета не сохраненных в файле изменений (о работе с изменениями строк см. далее); замена доступна при неодинаковых полях ввода текста поиска и замены.
ПРИМЕЧАНИЕ: поиск/замена при указанном числе совпадений прекращаются по достижении этого числа.
ПРИМЕЧАНИЕ: поиск/замена без учета регистра на данный момент не работает с русскоязычными строками.
 - по текстовым блокам;- в dlg-файлах по номеру строки; - в spl-файлах по номеру строки; - в itm-файлах по номеру строки; - с одинаковым текстом среди двух указанных диапазонов строк (не указывайте слишком большие диапазоны - это сильно замедлит поиск); - с ошибками в токенах (токен или маркер - текст, заключенный в <>) или ключах (текст, заключенный в []); - с некорректными флагами (например, если указан флаг 0, а строка содержит текст); - с указанным флагом; - указанной длины (в байтах); - со звуковым ресурсом; - с длительностью звукового ресурса (поиск производится по наличию длительности звукового ресурса; не поддерживается для TLK V1 в виду отсутствия данного параметра в этой версии); - с <токенами>; - с [ключами]; - с русскими символами; - с русскими и английскими символами; - с английскими символами. |
ПРИМЕЧАНИЕ: при выборе пунктов меню, отличных от поиска "по текстовым блокам" или "в dlg-файлах...", в строке поиска будет сформировано соответствующее ключевое слово. Не изменяйте его. |
 - возможно указать до 9-ти текстовых блоков для поиска;- также можно указать блок для замены каждого из искомых текстовых блоков. |
 - для ускорения ввода пути для поиска можно просто "указать" любой dlg-файл в нужной папке;- есть опциональная возможность производить поиск в подпапках (глубина поиска составляет 2 подпапки); - есть опциональная возможность сразу после успешного поиска загрузить первый dlg-файл из получившегося списка; - раздел Результаты последнего поиска появляется соответственно после поиска; - на протяжении текущего сеанса работы редактора, каждый загруженный из этого списка dlg-файл будет подсвечен красным. |
 - для ускорения ввода пути для поиска можно просто "указать" любой spl-файл в нужной папке;- есть опциональная возможность производить поиск в подпапках (глубина поиска составляет 2 подпапки); - есть опциональная возможность сразу после успешного поиска загрузить первый spl-файл из получившегося списка; - раздел Результаты последнего поиска появляется соответственно после поиска; - на протяжении текущего сеанса работы редактора, каждый загруженный из этого списка spl-файл будет подсвечен красным. |
 - для ускорения ввода пути для поиска можно просто "указать" любой itm-файл в нужной папке;- есть опциональная возможность производить поиск в подпапках (глубина поиска составляет 2 подпапки); - есть опциональная возможность сразу после успешного поиска загрузить первый itm-файл из получившегося списка; - раздел Результаты последнего поиска появляется соответственно после поиска; - на протяжении текущего сеанса работы редактора, каждый загруженный из этого списка itm-файл будет подсвечен красным. |
 - в редакторе предусмотрена автоматическая синхронизация текущей строки со списком найденных;- при наведении указателя мышки на фразу "совпавшие строки", в подсказке и строке статуса редактора можно увидеть искомый текст или имя файла "изменений" из которого были получены строки. |
ПРИМЕЧАНИЕ: элементы мини-навигации по найденным совпадениям не предусматривают ручной ввод номера. |
- txt-файл с изменениями собственного формата;
ПРИМЕЧАНИЕ: структура файла с изменениями в этом формате имеет следующий вид: StringRef:[space]номер_строки[enter]контент_строки[enter][enter] и так далее...
- txt-файл с изменениями, создаваемый BG2 dialog.tlk editor for TEAMBG версии 1.6.0.0 за авторством Avenger;ПРИМЕЧАНИЕ: структура файла с изменениями в этом формате имеет следующий вид: <номер_строки, расширенный нулями до семизначного числа>контент_строки<END>[enter] и так далее...
- tra-файл с изменениями WeiDU-формата;ПРИМЕЧАНИЕ: структура файла с изменениями в этом формате имеет следующий вид: @номер_строки[?space]=[?space]~контент_строки~[enter] и так далее...
- d-файл WeiDU-формата;ПРИМЕЧАНИЕ: структура файла в этом формате имеет сложный вид, но изменения извлекаются в соответствии со следующим алгоритмом: #номер_строки[?space]/*[?space]~контент_строки~[?space][?([буквы_цифры])][?space]*/ и так далее...
- dlg-файл диалогов от Bioware;ПРИМЕЧАНИЯ: 1). при обработке получается последовательный список строк каждого из диалогов, содержащихся в файле; 2). завершение каждого из диалогов определяется нулевой строкой (содержащей например <NO TEXT>); 3). завершение диалога происходит при ссылке на предыдущий или текущий диалог, а также на другой dlg-файл;
- spl-файл заклинаний от Bioware;ПРИМЕЧАНИЕ: при обработке получается список из названий и описаний (описание для неопределенного заклинания может отличатся от реального описания) заклинания в spl-файле;
- patch-файл с изменениями, создаваемый tlk-редактором Baldur's Gate - string editor версии 1.0.6.11 (из состава Baldur's Gate File Format Hacking Project) за авторством PeZ (zahradni@student.fsid.cvut.cz).ПРИМЕЧАНИЕ: структура файла с изменениями в этом формате имеет следующий вид: >[space]номер_строки[enter]контент_строки[enter] и так далее...
- num-файл собственного формата, содержащий только номера строк, разделенных запятой.ПРИМЕЧАНИЕ: при обработке dlg-файлов параметры сортировки не учитываются.
- "перв." - к нулевой/начальной строке;
- "-10" - на десять строк назад;
- "пред." - к предыдущей строке;
- "след." - к следующей строке;
- "+10" - на десять строк вперед;
- "посл." - к последней строке.
ПРИМЕЧАНИЯ: если при открытии внешнего окошка "500" активна опция "с текущей позиции", то будет открыто до 500 строк, начиная с текущей; при клике на строке в этом окошке, в редакторе происходит переход к этой строке (изменения применяются также).
 - устанавливать закладку для текущей строки;- загружать по выбору сохранённую закладку; - удалять по выбору сохранённую закладку; - удалять все закладки сразу. |
ПРИМЕЧАНИЯ: именем закладки является номер текущей строки; по умолчанию для описания закладки будет использовано до 64-х символов текущей строки; закладки сохраняются с привязкой к текущему tlk-файлу (поэтому, установив закладку в профиле одного tlk-файла, вы не найдёте её, загрузив профиль другого файла); закладки сохраняются раздельно для главного и дополнительного файлов.
ВНИМАНИЕ: одновременно может быть выполнено не более одного действия!
Оно возникает когда еще не завершена одна операция (например, - поиск текста), а пользователь пытается выполнить другую. Также такое сообщение возникает при медленной обработке (вызванной работой брандмауэра, например AtGuard) открытия строки (более ~0.2 секунды) и быстром нажатии кнопок навигации.
 - навигация по измененным строкам производится аналогично навигации по найденным строкам;- также приводится число изменений для текущей строки. |
Кнопкой ">|" можно непосредственно добавить любую строку к массиву изменений, что может пригодиться при создании произвольного файла изменений.
ПРИМЕЧАНИЯ: кнопка "|<" будет доступна только при наличии несохраненных изменений, а кнопка ">|" - в противном случае; по мере редактирования tlk-файла, количество изменений, отображаемое на описанных выше кнопках, будет динамически изменяется; список изменений и отмененных изменений являются связанными, т.о., при нажатии кнопки "отменить" последняя в списке изменений строка помещается в конец списка отмененных изменений, а при нажатии кнопки "вернуть" последняя в списке отмененных изменений строка помещается в конец списка изменений.
ПРИМЕЧАНИЯ: при первом изменении строки после сохранения сначала очищается массив отмен; наличие указанных выше изменений в массиве отмен отражается символом "~" на кнопках "отменить" или "вернуть".
 - txt (собственный или TeamBG-формат) со структурой, аналогичной файлу с исправлениями (см. выше);- patch (формат Baldur's Gate File Format Hacking Project) со структурой, аналогичной файлу с исправлениями; - tra (WeiDU-формат) со структурой, аналогичной файлу с исправлениями; - tlk (Bioware-формат) версий V1 и V3.0. |
ПРИМЕЧАНИЯ: при создании пользовательского файла можно пользоваться опциями "с текущей позиции" (будет создан файл, содержащий все строки, начиная с текущей), "x совпадений" (будет создан файл, содержащий указанное количество строк с начальной или, если указано, - с текущей) или "в найденном" (будет создан файл, содержащий только найденные строки); указанные опции можно комбинировать для получения требуемого результата сохранения.
Также после любого изменения состояния редактора перед сохранением необходимо выполнить проверку, нажав кнопку "проверить", после чего будут обновлены условия сохранения и станет доступна кнопка "сохранить".
Также после любого изменения состояния редактора перед сохранением необходимо выполнить проверку, нажав кнопку "проверить", после чего будут обновлены условия сохранения и станет доступна кнопка "сохранить".
- сброс состояния поиска и изменений при смене файла;
- автосохранение профильных данных;
- автозагрузка профильных данных;
- создание резервной копий tlk-, txt- или tra-файла при его сохранении;
- добавление текущей даты к имени сохраняемого tlk-, txt- или tra-файла;
- очистка обоих списков изменений после сохранения файла;
- отображение статистики всех запросов пользователя, обрабатываемых сервером;
- коррекция строковых флагов при сохранении файла;
- коррекция переводов строк при сохранении файла;
- отображение скрытого информационного поля сообщений сервера для отладки.
ПРИМЕЧАНИЕ: начиная с версии редактора 2.86, все представленные здесь настройки, состояния режимов обработки файлов и текста, а также значение строки для быстрого замещения ("*") сохраняются в динамически подключаемый js-файл при изменении любой из перечисленных настроек. Совместимость со старыми Cookies-настройками не обеспечивается.
