Criando as Entidades

Uma entidade é um atalho utilizado para representar cadeias complexas ou símbolos que seriam impossíveis, difíceis ou repetitivos de outra maneira para incluir manualmente.
Antes de Iniciar
Por Que e Quando Desempenhar Esta Tarefa

Por exemplo, é necessário colocar uma notificação de copyright (por exemplo, Copyright 2004. MyCompany publishing.) no final de cada página de um manual. Em vez de escrevê-la a cada vez, é possível criar uma entidade que representa este texto: <!ENTITY copyright "Copyright 2004. MyCompany publishing."> em que copyright é o nome da entidade e "Copyright 2004. MyCompany publishing" é o texto que a entidade copyright representa.

Para criar uma entidade, siga estas etapas:

  1. Abra o DTD no editor de DTD.
  2. Na visualização Esboço, clique com o botão direito no DTD Este gráfico é o ícone do DTD. e clique em Add Entity (Incluir Entidade).
  3. Na visualização Properties (Propriedades), digite o novo nome da entidade no campo Name (Nome).
  4. Na lista Entity Type (Tipo de Entidade), selecione General (Geral) ou Parameter (Parâmetro). As entidades gerais são utilizadas nos arquivos XML, onde as entidades de parâmetros são utilizadas apenas no DTD e não possuem nenhum uso em um arquivo XML.
  5. Selecione a caixa de opção External (Externo), se deseja declarar a entidade como uma entidade externa. Uma entidade externa referencia um documento ou dados externos.
  6. Se você tornou a entidade externa, os seguintes campos aparecem:
    • ID Público (Public ID) (Opcional). Digite o caminho do DTD que você deseja referenciar. É possível então utilizar os recursos no arquivo que está sendo referenciado.
    • ID do Sistema (System ID). Digite o caminho dos dados externos ou documento que deseja referenciar ou procure por ele. É possível então utilizar os recursos no arquivo que está sendo referenciado.

    É necessário apenas especificar o ID de Público (Public ID) ou o ID do Sistema (System ID), não ambos. Se, no DTD, você desejar utilizar qualquer um dos recursos (como elementos ou atributos) contidos no documento referenciado, é necessário fazer desta entidade uma entidade Parâmetro (Parameter) e "expandir" a entidade, criando uma referência de entidade de parâmetro externo (clique com o botão direito no DTD Este gráfico é o ícone de DTD., clique em Incluir Referência da Entidade de Parâmetro (Add Parameter Entity Reference) e selecione a entidade recém criada).

  7. Se você não tornou a entidade externa, é possível especificar o valor da entidade no campo Valor da Entidade (Entity value).
  8. Clique na guia Documentação (Documentation) se desejar fornecer informações sobre a entidade. A página Documentação (Documentation) é utilizada para o material legível aos humanos, como uma descrição da entidade.
O que Fazer Depois
Os links a seguir explicam as diferentes formas de poder reutilizar as entidades:

Feedback