Компилирование и компилятор DSL

Общие сведения

Графический интерфейс пользователя

Командная строка

Отчёт об ошибках

Для использования словарей DSL в программе Lingvo их необходимо преобразовать в формат LSD. LSD является форматом, изложенным на машинно-ориентированном языке, т.е. предназначенным для лучшего понимания компьютером. Кроме того, LSD — это своеобразный контейнер, в который помещаются объединённые, сжатые и перекодированные данные исходных файлов DSL, а также упаковываются связанные медиа-файлы, если такие есть в словаре. Процесс преобразования называется компилированием, а утилита, выполняющая процесс — компилятором.

Во время компилирования также осуществляется синтаксическая проверка конструкций языка DSL и диагностика ошибок.

Компилятор входил в состав дистрибутива Lingvo, начиная с первых версий. До версии 6.0 это был небольшой исполняемый файл LC.EXE (сокращение от Lingvo Converter), работающий только из командной строки. В версии 6.0 утилита получила графический интерфейс и новое название DSL Compiler, которое сохраняется до настоящего времени. Современный DSL Compiler может работать в двух режимах: через диалоговое окно графического интерфейса и из командной строки.

Значение большинства элементов диалогового окна DSL Compiler самоочевидно и не нуждается в комментариях, поэтому данное описание выборочно коснётся лишь некоторых из них.

• Элемент Icon. Когда в комплекте DSL словаря есть иконка, она отображается в данном элементе (как на снимке). Иногда файл иконки есть, но она не отображается. Причины могут быть следующими:
1. В имени файла иконки содержатся нерекомендуемые символы, например, точка .. Подробнее см. в главе Наименование файлов словаря.
2. Не соблюдены необходимые свойства графического файла. Подробнее см. в главе Иконка.
• Радиокнопка LUD. Предназначена для преобразования исходного файла в формат пользовательского редактируемого словаря Lingvo. Становится доступной только в тех случаях, когда исходным файлом является:
1. Пользовательский редактируемый словарь ADC — устаревший формат, существовавший в первых версиях Lingvo до 5.0 включительно. Для успешного преобразования при файле *.adc необходимо наличие дополняющей его части — файла *.adt, содержащего тела словарных статей.
2. Пользовательский редактируемый словарь LUD, созданный в предыдущих версиях Lingvo. Для успешного преобразования при файле *.lud необходимо наличие дополняющей его части — файла *.adх, содержащего тела словарных статей.
• Радиокнопка DSL. Предназначена для декомпилирования словарей LSD в исходный набор файлов словаря DSL, а также, начиная с Lingvo 9, словарей LUD в DSL. В компиляторах, входящих в официальный дистрибутив ABBYY Lingvo, при выборе LSD файла эта кнопка всегда недоступна.
• Переключатель Output warnings. Влияет на содержимое отчёта об ошибках. Не влияет на появление во время компилирования диалоговых окон с предупреждениями (об отсутствии иконки, аннотации и т.п.).
• Переключатель Create dictionary ready for indexing:
• Включает автоматическую разметку, при которой тело каждой словарной статьи заключается в тэги зоны индексирования переводов. Наличие зон индексирования необходимо для осуществления поиска слов по тексту словаря. Подробнее см. в разделе Тэги поисковой обработки.
• Для создания разметки компиляторы с 6.5 по ранние версии x5 использовали тэги [trn]. Это порождало конфликт вложенности одинаковых тэгов в случае если до начала компилирования словарь уже содержал [trn], расставленные вручную. Во избежание подобных ситуаций в Lingvo 15.0.847.0 был введён в употребление специальный тэг автоматической разметки [trn1], вследствие чего упомянутый конфликт более не возникает. Подробнее см. в главе Тэг [trn1].
• В связи с вышесказанным отметим, что замечание официального справочного руководства Lingvo x6 о неприменимости автоматической разметки к словарям с предварительно расставленными [trn] является устаревшим и относится к компиляторам ранних версий^[1].
• Автоматическую разметку следует отключать при компилировании вспомогательных словариков аббревиатур *_abrv.dsl. Подробнее см. в главе Вспомогательный словарь аббревиатур.

Помимо стандартного способа через диалоговое окно, управление компилятором также осуществляется из командной строки. При этом дополнительно становится доступна функция пакетной (массовой) обработки словарей. Как известно, в своих первых версиях компилятор был только консольным. В Lingvo 6.0 ему на смену пришёл оконный. В Lingvo x5 оба интерфейса воссоединились. О «возвращении» консольного интерфейса стало известно из сообщения службы тех-поддержки ABBYY на форуме Lingvo. В ответ на просьбы пользователей специалист службы описал параметры консольного режима в общих чертах и отметил, что они являются недокументированными и компания не гарантирует стабильность их работы.

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

Общий синтаксис. Параметры состоят из имени и значения. Перед именем ставится знак дефиса -. Разделитель между именем и значением — знак равенства =. Некоторые значения должны заключаться в двойные кавычки. В левой колонке списка приводится параметр со значением по умолчанию, в правой перечисляются все возможные значения.

Список известных параметров:

Dslcomp.exe -src="c:\MyDictionaries\New" -encoding=a -dst="c:\Destination\Result" -dde=1 -warnings=1 -message=0 -replace -index=1 -log=1

В процессе компилирования словаря производится проверка синтаксиса DSL и работоспособности словарных конструкций. Результаты проверки могут быть записаны в специальный файл отчёта. Запись отчёта включается в окне компилятора переключателем Create error log file. Отметим, что данный переключатель влияет только на создание отчёта. Синтаксическая проверка выполняется в любом случае, в независимости от его состояния.

Отчёт создаётся в папке с исходными файлами. Файлу отчёта присваивается имя файла основного текста и расширение *.dde.

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

Вся отчётная информация в DDE заключается в тэги служебных комментариев {{…}}.

В начало DDE помещается информация о выявленных проблемах. Для этого из исходного текста копируются проблемные статьи. Копируются полностью, от начала до конца. Отладочные сообщения помещаются внутри статей на проблемные строки, в конец строк. Каждое подобное сообщение содержит:

1. Указание типа проблемы: ошибка или предупреждение.
2. Краткое описание проблемы.
3. Указание исходного файла, в котором найдена проблема (полный путь, имя, расширение).
4. Указание номера строки, где найдена проблема (согласно счёту строк в исходном файле).

number sign
	[m1]1) [trn]признак числа, знак "#"[/trn][/m]{{Error: Pre-processor command must be placed at the beginning of the line. (File: "C:\TestDir\TestDic.dsl", Line: 69351)}} 
	[m1]2) [trn]знак числа (плюс или минус)[/trn][/m]

accessible
	[m1]1) [trn]доступный; достижимый.[/trn][/m]
	[m1]2) [trn]общедоступный, понятный.[/trn][/m]
	[m1]3) [trn]поддающийся; податливый.[/trn] [p]Syn[/p]: [ref]pliant[/ref].[/m]{{Warning: Suspended reference "pliant". (File: "C:\TestDir\SubDir\TestDic.dsl", Line: 263)}} 
	[m1]4) [p]тех.[/p] [trn]удобный.[/trn][/m]

Далее выводится информация об общем количестве проблем отдельно по каждому типу:

{{Errors: 1. Warnings: 6.}}

Далее выводится список отсутствующих медиа-файлов. Медиа-файл попадает в список в том случае, когда ссылка на него содержится в тексте словаря, а сам файл отсутствует в папке словаря во время компилирования.

C:\TestDir\TestPicture.jpg was not found.
C:\TestDir\TestSound.wav was not found.

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

{{Number of headwords: 118647. Number of entries: 114843.}}

При подсчёте статей учитывается наличие дочерних статей, которые в этом случае расцениваются как самостоятельные. Так, например, если словарь состоит из 2х статей и одна из них содержит 3 дочерние, то их общее количество в отчёте будет равным 5.

Данные о количестве статей из этой части отчёта обычно используются в аннотациях.

Список известных ошибок

На сегодняшний день выявлено и воспроизведено 77 ошибок.

Список известных предупреждений

На сегодняшний день выявлено и воспроизведено 10 предупреждений.

Справочник по DSL • Версия 1.1 • 12.08.2023

Public Domain 2023 yozhic. Свободный контент. Все права открыты и неограничены. Никаких гарантий и ответственности.