Entidades de parámetro: referencias a ficheros de declaración de entidades
Una entidad de parámetro es un fichero que contiene declaraciones de entidad, declaraciones de anotación y referencias a otros ficheros de declaraciones de entidad y anotación. Una entidad de fichero de parámetro declarada dentro de una instancia de documento es una manera de hacer referencia a entidades de texto comunes que están almacenadas en un fichero externo sin involucrar al autor del DTD. Antes, estas referencias sólo se permitían dentro del DTD.
Se deberán declarar entidades de fichero de parámetro mediante SGML en un editor ASCII o editar el documento mediante el método edit -current -untagged. El documento se mostrará en formato SGML; en la parte superior del mismo, aparecerá un subconjunto interno que contiene todas las declaraciones de entidad.
Declaración de entidades de fichero de parámetro
1. Guarde el documento.
2. Pulse en la línea de comandos y escriba: edit -current -untagged. Pulse INTRO.
Si no se muestra la línea de comandos, seleccione el cuadro de diálogo > . Elija la categoría Ventana y active la preferencia Línea de comandos.
El documento se mostrará en formato SGML. Observe las declaraciones de entidad del subconjunto interno, en la parte superior del documento (entre corchetes de apertura y cierre). Éste es un ejemplo de subconjunto interno con dos declaraciones de entidad generales:
<!DOCTYPE BOOK PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
<!--Arbortext, Inc., 1988-1999, v.xxx-->
<!ENTITY prodname "Arbortext Editor">
<!ENTITY release "9.0">
]>
<book>
Las dos declaraciones de entidad generales (prodname y release) se podrían colocar en un fichero al que varios documentos puedan hacer referencia. Las declaraciones de entidad del ejemplo anterior se reemplazarían con una declaración de entidad de parámetro y una referencia. La entidad de parámetro señala al fichero con las declaraciones de entidad generales. Esto se muestra a continuación:
<!DOCTYPE BOOK PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
<!--Arbortext, Inc., 1988-1997, v.xxx-->
<!ENTITY % parament PUBLIC “-//Arbortext//ENTITIES common entdecls//EN">
%parament;
]>
<book>
Para asignar el identificador público al fichero real que contiene las declaraciones de entidad, se utilizaría una entrada en un fichero de catálogo.
3. Puede añadir una declaración de entidad de parámetro en cualquier punto del subconjunto interno, entre los corchetes de apertura y cierre.
4. Pulse en Guardar para guardar el documento y, a continuación, pulse en Salir.
5. Las entidades añadidas estarán disponibles la próxima vez que pulse en Abrir para abrir el documento.