Página Visão Geral do Esquema

Sobre Esta Página

Esta página de formulário permite identificar e documentar um esquema de ponto de extensão. Permite também incluir e utilizar gramáticas definidas por outros esquemas de ponto de extensão compartilhados.

Seções da Página

Esta página é formada pelas seguintes seções:

Seção de Informações Gerais

Esta seção identifica exclusivamente o esquema de ponto de extensão editado. O formato de um ID de esquema de ponto de extensão é o mesmo que o ID completo de seu ponto de extensão correspondente: <plugin-id>.<point-id>

Seção de Informações Gerais

Campos da Seção de Informações Gerais

Edite o campo ID do Plug-in para especificar a parte do qualificador do ID do esquema de ponto de extensão exclusivo. Esse valor de campo deve corresponder ao ID do plug-in no qual está definido o ponto de extensão correspondente desse esquema.

Edite o campo ID do Ponto para especificar a parte do ID do esquema de ponto de extensão exclusivo. Esse valor de campo deve corresponder ao ID utilizado para definir o ponto de extensão correspondente do esquema.

Edite o campo Nome do Ponto para especificar um nome legível para o esquema de ponto de extensão. Esse valor de campo deve corresponder ao nome utilizado para definir o ponto de extensão correspondente do esquema.

Seção de Inclusões do Esquema

Esta seção permite incluir e utilizar a gramática de outros esquemas de pontos de extensão compartilhados.

Seção de Inclusões de Esquema

Campos da Seção de Inclusões de Esquema

O campo do visualizador lista os esquemas de pontos de extensão compartilhados cujas gramáticas são incluídas e utilizadas pelo esquema de ponto de extensão editado.

Os esquemas de pontos de extensão compartilhados localizados no mesmo plug-in do esquema de ponto de extensão editado podem ser incluídos. Esses esquemas são representados no visualizador por um caminho relativo para o seu nome de arquivo: <relative-path>/<schema-file-name>

Os esquemas de pontos de extensão compartilhados localizados no plug-in do espaço de trabalho podem ser incluídos. Esses esquemas são representados no visualizador por um caminho absoluto especial para seu nome de arquivo: schema://<defining-plugin-id>/<path>/<schema-file-name>

Ações da Seção de Inclusões do Esquema

Clique no botão Incluir... para abrir o diálogo Seleção de Arquivos, a fim de incluir e utilizar a gramática de um ponto de extensão compartilhado existente no esquema editado. O diálogo apresenta uma visualização hierárquica filtrada de todos os esquemas de pontos de extensão do espaço de trabalho. Se um esquema de ponto de extensão contido em um plug-in diferente do esquema editado for selecionado, um caminho absoluto especial será construído e inserido no campo do visualizador. Se um esquema de ponto de extensão contido no mesmo plug-in do esquema editado for selecionado, um caminho relativo do esquema editado para o esquema selecionado será calculado no campo do visualizador.

Clique no botão Remover, para remover a gramática do esquema de ponto de extensão compartilhado selecionado da inclusão e uso pelo esquema de ponto de extensão editado. Essa ação estará disponível apenas quando um esquema for selecionado no campo do visualizador.

Dê um clique duplo em um esquema de ponto de extensão no campo do visualizador para abrir esse esquema em um novo Editor de Esquema de Ponto de Extensão.

Seção de Documentação

Esta seção permite documentar o esquema de ponto de extensão editado. Seu conteúdo será utilizado para compor o documento de referência do esquema de ponto de extensão editado. Como resultado, a marcação HTML válida poderá ser utilizada em qualquer um dos campos da seção.

Esta seção contém as seguintes guias:

Seção de Documentação

Campos da Seção de Documentação

Edite o campo da guia Descrição para especificar uma descrição detalhada da definição do ponto de extensão desse esquema editado. Geralmente, esse campo é utilizado para descrever a finalidade, a utilidade e os conceitos associados do ponto de extensão.

Edite o campo da guia Desde para especificar a primeira versão incluída do Eclipse do esquema. Por exemplo, se esse esquema editado foi incluído inicialmente no Eclipse 3.0, o valor do campo deverá ser 3.0. A suposição é que a gramática do esquema editado seja a API que persiste liberada para a versão depois de introduzida e é mantida para compatibilidade retroativa. Esse campo é análogo à tag Javadoc @since do Java.

Edite o campo da guia Exemplos para especificar um trecho XML válido da extensão que está de acordo com a gramática desse esquema editado. Tente utilizar um exemplo que ilustre um caso de uso típico da extensão.

Edite o campo da guia Informações da API para descrever a estrutura, o conteúdo e a semântica dos elementos e atributos do ponto de extensão.

Edite o campo da guia Implementação Fornecida para especificar se o plug-in que define o ponto de extensão desse esquema editado contribui também com extensões para ele. Esse campo aponta o usuário para uma implementação de extensão real que pode ser utilizada como um modelo ou referência para definição de suas próprias extensões.

Edite o campo da guia Copyright para descrever os direitos legais exclusivos para reproduzir, publicar, vender ou distribuir o esquema editado.

Links Relevantes