Данная форма позволяет определить и задокументировать схему точки расширения. На этой странице можно применять грамматику, определенную в других общих схемах точек расширения.
Данная страница складывается из следующих разделов:
Данный раздел уникально идентифицирует отредактированную схему точки расширения. Формат ИД схемы точки расширения совпадает с полным ИД точки расширения, связанной с этой схемой: <ИД-модуля>.<ИД-точки>
В поле ИД модуля указывается часть классификатора уникального ИД схемы точки расширения. Значение этого поля должно совпадать с ИД модуля, в котором определена соответствующая схеме точка расширения.
В поле ИД точки указывается часть ИД уникального идентификатора схемы точки расширения. Значение этого поля должно совпадать с ИД точки расширения, связанного со схемой.
В поле Имя точки указывается понятное пользователю имя схемы точки расширения. Значение этого поля должно совпадать с именем, определяющим соответствующую схеме точку расширения.
Данный раздел позволяет включить и применить грамматику из других общих схем точек расширения.
В поле просмотра показываются общие схемы точек расширения, грамматика которых включена в редактируемую схему.
Могут быть включены общие схемы, относящиеся к тому же модулю, что и редактируемая схема. В окне просмотра эти схемы представлены относительными путями к файлам: <относительный-путь>/<имя-файла-схемы>
Могут быть включены схемы, находящиеся в других модулях рабочей области. В окне просмотра эти схемы представлены особыми абсолютными путями к файлам: schema://<ИД-определяющего-модуля>/<путь>/<имя-файла-схемы>
По кнопке Добавить... открывается окно Выбор файла, позволяющее включить в редактируемую схему грамматику из имеющейся общей схемы точки расширения. В этом окне отображается фильтрованный иерархический список всех схем точек расширения рабочей области. Если выбранная схема содержится не в том же модуле, что и редактируемая, то будет сформирован абсолютный путь, который отобразится в поле просмотра. Если же выбранная схема содержится в том же модуле, что и редактируемая, то будет рассчитан относительный путь от редактируемой схемы к выбранной.
Кнопка Удалить позволяет удалить грамматику выбранной общей схемы точки расширения из списка включенных и не применять ее в редактируемой схеме. Этот раздел доступен только если в поле просмотра выбрана схема.
Если дважды щелкнуть на схеме точки расширения в поле просмотра, то эта схема откроется в Редакторе схем точек расширения.
В этом разделе можно задокументировать редактируемую схему точки расширения. Данные этого раздела применяются для создания справочного документа по редактируемой схеме. В результату в любом поле раздела схемы можно применять правильную разметку HTML.
Раздел содержит следующие вкладки:
В поле вкладки Описание указывается подробное описание определения точки расширения для редактируемой схемы. Обычно это поле служит для описания назначения точки расширения, утилит и связанных с ними понятий.
В поле вкладки Начиная с указывается версия Eclipse, в которую была впервые добавлена редактируемая схема. Например, если схема впервые была добавлена в 3.0, то в этом поле должно стоять значение 3.0. Считается, что грамматика редактируемой схемы - это API, который сохраняется с момента первого добавления от выпуска к выпуску и поддерживается только для обратной совместимости. Это поле аналогично тегу @since в Javadoc Java.
В поле Примеры указывается правильный фрагмент кода XML расширения, совместимого с грамматикой данной редактируемой схемы. Попробуйте применить пример, иллюстрирующий типичный вариант использования расширения.
В поле Сведения об API задается описание структуры, содержимого и семантики элементов и атрибутов точки расширения.
В поле Поставляемая реализация указывается, предоставляет ли модуль, определяющий точку расширения для данной схемы, сами расширения для этой точки. Это поле указывает пользователю на действующую реализацию расширения, которую он может применять в качестве шаблона или справочника для определения собственных расширений.
В поле Авторские права описывается исключительные права на воспроизведение, публикацию, продажу и распространение редактируемой схемы.