Подготовка содержания словаря

Смотрите на MyDictionary.xml файл обеспечил в шаблоне проекта. Ваш словарь должен следовать за этой формой, с помощью кодирования UTF-8. Можно изменить имя файла на что-то другое, чем MyDictionary, но если Вы изменяете имя, необходимо отредактировать DICT_SRC_PATH переменная в make-файле.

Пользовательский интерфейс словаря и Разметка), описывает XML-схему, которую необходимо использовать для разработки словаря. Схема использует RELAX язык схемы NG, описанный на этом веб-сайте:

http://www .relaxng.org/

Необходимо проверить источник словаря до создавания нового словаря, можно использовать RELAX программы блоков проверки допустимости NG, которые доступны от этого веб-сайта:

http://www .relaxng.org/#validators

Можно также проверить XML, использующий jing следующим образом:

$ java -jar <path to jing.jar> <schema definition> <XML to validate>

От project_template папки, с jing, расположенным в../jing/, командная строка следующие:

$ java -jar ../jing/bin/jing.jar ../documents/DictionarySchema/AppleDictionarySchema.rng MyDictionary.xml

Для получения дополнительной информации о jing см.:

http://www .thaiopensource.com/relaxng/jing.html

Подготовка таблицы стилей

Можно подготовить таблицу стилей для использования для содержания словаря путем редактирования MyDictionary.css файл обеспечил шаблоном проекта. Если Вы изменяете имя этого css файла, необходимо отредактировать CSS_PATH переменная в make-файле.

Необходимо минимально отредактировать таблицу стилей. Приложение Словаря и управление окном Dictionary используют их собственные определения стилей, чтобы гарантировать, чтобы содержание соответствовало дисплею. Для лучших результатов не указывайте абсолютный шрифт или размер шрифта.

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

Файл списка свойств для словаря является текстовым файлом XML. Шаблон проекта содержит файл в качестве примера —MyInfo.plist— чье содержание показано в Перечислении 2-1. Можно отредактировать этот файл так, чтобы он содержал записи, подходящие для словаря. Таблица 2-1 объясняет значения, что необходимо предусмотреть словарь.

Перечисление 2-1  пример файла списка свойств для словаря

<key>CFBundleDevelopmentRegion</key>

<string>English</string>

<key>CFBundleDisplayName</key>

<string>My Dictionary</string>

<key>CFBundleIdentifier</key>

<string>com.apple.dictionary.MySample</string>

<key>CFBundleName</key>

<string>MyDictionary</string>

<key>CFBundleShortVersionString</key>

<string>1.0</string>

<key>DCSDictionaryCopyright</key>

<string>Copyright (c) Apple Computer, Inc.</string>

<key>DCSDictionaryManufacturerName</key>

<string>Apple Computer, Inc.</string>

Если Вы изменяете имя файла списка свойств, необходимо отредактировать PLIST_PATH переменная в make-файле.

Добавление необходимых ресурсов словарем

Необходимо поместить любые ресурсы (например, изображения), в котором словарь нужен в папке OtherResources в project_template папка. Когда Вы создаете словарь, ресурсы копируются в созданный словарь.

Например, если Ваш словарь использует имя файла образа test.png, необходимо поместить его в следующее расположение:

project_template/OtherResources/Images/test.png

Папка изображений копируется в словарь. Когда для словаря нужно изображение, он использует для относительного пути —Images/test.png— который записан в XML-файл во время процесса сборки.

Подготовка make-файла

Назовите свой словарь и затем отредактируйте DICT_NAME переменная в make-файле. Это имя используется в качестве имени папки для словаря. Например, когда DICT_NAME = “My Dictionary”, созданный словарь My Dictionary.dictionary.

Если Вы изменяете местоположение Комплекта разработчика Словаря от /Developer/Extras/Dictionary Development Kit, необходимо изменить DICT_BUILD_TOOL_DIR переменная в make-файле для отражения изменения.

Создавание словаря

Для создавания словаря выполните эти шаги:

1. Запустите Терминальное приложение.

2. Используйте cd команда для изменения на надлежащее расположение:

   /Developer/Extras/Dictionary Development Kit

3. Войти make.

4. После того, как сделать процесс заканчивается успешно, тип делают установку для копирования нового словаря в:

   ~/Library/Dictionaries/

После выполнения make install команда, можно удалить все промежуточные файлы в папке объектов. В Окне терминала войдите, делают чистыми для удаления папки объектов.

Теперь можно запустить приложение Словаря и протестировать новый словарь.

Как Вы видите от рассмотрения make-файла, процесс здания использует сценарий build_dict.sh, расположенный в /Developer/Extras/Dictionary Development Kit/bin. Этот сценарий берет 4 параметра —dictionary_name, dictionary_source_path, StyleSheet_path, и InfoPlist_path. Это создает новый каталог в /objects папка.

Подготовьте запись к передней стороне и аппарату

В XML-файле для словаря необходимо указать запись переднего аппарата с помощью id припишите, чье значение установлено в front_back_matter как показано в следующем простом примере:

<d:entry id="front_back_matter" d:title="Front/Back Matter">

    <h1><b>My Dictionary</b></h1>

    <h2>Front/Back Matter</h2>

    <p>

        This is a front matter page of the sample dictionary.<br/>

    </p>

    ...

</d:entry>

Измените файл Info.plist

Необходимо изменить список свойств для словаря путем добавления DCSDictionaryFrontMatterReferenceID ключ к Info.plist файл. Присваиваемое значение является строкой, указывающей id оцените Вас используемый в XML-файле. Следующее показывает, что строка, используемая в, Подготавливает Запись к Передней стороне и Аппарату.

<key>DCSDictionaryFrontMatterReferenceID</key>

<string>front_back_matter</string>

Добавьте элемент индекса (Необязательно)

Этот пример не использует a <d:index> элемент, что означает, что страница не обнаружится в поиске. Если Вы хотите, чтобы передняя сторона и аппарат показали в поиске, добавьте<d:index> элемент. Иначе, пользователи могут просмотреть переднюю сторону и аппараты путем выбора Go> Front/Back Matter из приложения Словаря.

Измените содержание словаря соответственно

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

<d:entry id="make_1" d:title="make">

    ...

    <h1>make</h1>

    <span class="syntax">

        <span d:pr="US">| māk |</span>

        <span d:pr="US_IPA">| meɪk |</span>

        <span d:pr="UK_IPA">| meɪk |</span>

    </span>

    ...

</d:entry>

Обратите внимание на то, что XML не указывает который фонетическая транскрипция показать. Вы сделаете это в следующем разделе путем создания файла XSLT.

Подготовьте файл XSLT для применения к словарным статьям

Файлы XSLT содержат инструкции, что Dictionary Services применяется к каждой записи прежде, чем вывести на экран это. В этом примере необходимо обеспечить инструкции для удаления неиспользованной фонетической транскрипции. Для этого используйте $pronunciation переменная, которая является предоставлением глобальной переменной приложением Словаря, как показано в следующем примере.

<xsl:template match="*[@d:pr='US']">

    <xsl:if test="$pronunciation = '0'">

        <xsl:copy>

            <xsl:apply-templates select="@*|node()" />

        </xsl:copy>

    </xsl:if>

</xsl:template>

<xsl:template match="*[@d:pr='IPA']">

    <xsl:if test="$pronunciation = '1'">

        <xsl:copy>

            <xsl:apply-templates select="@*|node()" />

        </xsl:copy>

    </xsl:if>

    <xsl:if test="$pronunciation = '2'">

        <xsl:copy>

            <xsl:apply-templates select="@*|node()" />

        </xsl:copy>

    </xsl:if>

</xsl:template>

<xsl:template match="*[@d:pr='US_IPA']">

    <xsl:if test="$pronunciation = '1'">

        <xsl:copy>

            <xsl:apply-templates select="@*|node()" />

        </xsl:copy>

    </xsl:if>

</xsl:template>

<xsl:template match="*[@d:pr='UK_IPA']">

    <xsl:if test="$pronunciation = '2'">

        <xsl:copy>

            <xsl:apply-templates select="@*|node()" />

        </xsl:copy>

    </xsl:if>

</xsl:template>

Реализуйте Предпочтительный Пользовательский интерфейс

Необходимо обеспечить файл XHTML, указывающий пользовательский интерфейс для представления в окне Dictionary Preferences в приложении Словаря. Следующий пример показывает, как установить предпочтения фонетической транскрипции. Пользователь рассмотрит три выбора, выведенный на экран как переключатели. После делания выбора Dictionary Services сохраняет это и передает выбор инструкциям XSLT. Инструкции тогда применяются к словарным статьям.

<html xmlns="http://www.w3.org/1999/xhtml">

    <head>

        <meta http-equiv="content-type" content="text/html; charset=UTF-8" />

    </head>

    <body>

        <div id="copyright"></div>

        <hr />

        <div class="query">

            <input type="hidden" name="version" value="1" />

        </div>

        <div class="query">

            Pronunciation:<br />

            <input type="radio" name="pronunciation" value="0">US English (Diacritical)</input><br />

            <input type="radio" name="pronunciation" value="1">US English (IPA)</input><br />

            <input type="radio" name="pronunciation" value="2">British English (IPA)</input><br />

        </div>

    </body>

</html>

Измените файл Info.plist

Необходимо добавить ключи к Info.plist файл к индикации, что словарь имеет свои собственные предпочтения. Значения для этого примера показаны в следующей записи списка свойств. Необходимо изменить значения на, которые являются подходящими для словаря. Значения, ожидаемые для каждого из ключей, показаны в Таблице 2-2.

<key>DCSDictionaryDefaultPrefs</key>

    <dict>

        <key>pronunciation</key>

        <string>0</string>

        <key>version</key>

        <string>1</string>

    </dict>

    <key>DCSDictionaryPrefsHTML</key>

    <string>MyDictionary_prefs.html</string>

    <key>DCSDictionaryXSL</key>

    <string>MyDictionary.xsl</string>