As entidades (ambas gerais e de parâmetros) são particularmente úteis quando utilizadas para incluir um arquivo dentro de outro.
Suponha que você possui algum conteúdo para um
livro SGML organizado em arquivos, um arquivo por capítulo,
chamados chapter1.xml
,
chapter2.xml
, e assim por diante, com
um arquivo book.xml
que irá
conter estes capítulos.
A fim de utilizar o conteúdo destes arquivos como
os valores para as suas entidades, você as declara com
a palavra chave SYSTEM
. Isto direciona o
interpretador SGML para utilizar o conteúdo dos
arquivos nomeados como o valor da entidade.
Quando utilizar uma entidade geral para incluir outros
arquivos em um documento, os arquivos que estiverem sendo
inclusos (chapter1.xml
,
chapter2.xml
, etc)
não devem iniciar com uma
declaração DOCTYPE. Isto é um erro
de sintaxe.
Recorde-se que uma entidade de parâmetro só pode ser utilizada dentro de um contexto SGML. Por que então você desejaria incluir um arquivo dentro de um contexto do SGML?
Você pode utilizar isto para assegurar-se de que você pode reutilizar as suas entidades gerais.
Suponha que você possui muitos capítulos em seu documento, e você reutiliza estes capítulos em dois livros diferentes, cada livro organizando os capítulos de uma forma diferente.
Você pode listar as entidades no topo de cada livro, mas isto rapidamente torna-se incomodo de gerenciar.
Em vez de disso, coloque as definições das suas entidades gerais em um arquivo, e utilize uma entidade de parâmetro para incluir este arquivo dentro do seu documento.
Primeiro, coloque as suas definições de
entidades em um arquivo separado, chamado
chapters.ent
. Este arquivo
contém o seguinte:
Agora crie uma entidade de parâmetro para referenciar o conteúdo do arquivo. E então utilize a entidade de parâmetro para carregar o arquivo no seu documento, o que tornará todas as entidades gerais disponíveis para uso. Feito isso, utilize as entidades gerais como antes;
Crie três arquivos,
para1.xml
,
para2.xml
, e
para3.xml
.
Coloque um conteúdo similar ao seguinte em cada arquivo:
Edite o arquivo example.xml
para que ele se pareça com este:
Produza o arquivo
example.html
através da
normalização do arquivo
example.xml
.
%
osgmlnorm -d example.xml > example.html
Carregue o arquivo
example.html
no seu navegador web,
e confirme que os arquivos
para
foram incluídos no n
.xmlexample.html
.
Você deve ter executado os passos anteriores primeiro.
Edite o arquivo
example.xml
para que ele se
pareça com este:
Crie um novo arquivo chamado
entities.xml
, com este
conteúdo:
Produza o arquivo example.html
através da normalização do arquivo
example.xml
.
%
osgmlnorm -d example.xml > example.html
Carregue o arquivo
example.html
no seu navegador web
e confirme que os arquivos
para
foram incluídos no arquivo
n
.xmlexample.html
.
Este, e outros documentos, podem ser obtidos em ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/
Para perguntas sobre FreeBSD, leia a
documentação antes de contatar
<questions@FreeBSD.org>.
Para perguntas sobre esta documentação, envie e-mail para
<doc@FreeBSD.org>.