def — Formato de archivo: definiciones
Un archivo de definiciones consta de palabras, cada una de las cuales puede tener uno o más significados. A continuación se presenta un ejemplo:
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE def PUBLIC "-//Structio//DTD definiciones 1.0" "def.dtd">
<def formato="texto">
<desc>Fe en Jesús</desc>
<biblio>http://de.geocities.com/nuestroamigojesus/bdp</biblio>
<derechos tipo="Dominio público" tiempo="2003">Dominio público</derechos>
<autor fecha="2003">Vladimir Támara</autor>
<pal id="Dios">
<sig id="Dios.fe" fecha="21/01/2003">Aceptado por cristianos como creador de
todo cuanto existe y dador de nuestras vidas.</sig>
</pal>
<pal id="Jesús">
<sig id="Jesús.fe" fecha="21/01/2003">Aceptado por cristianos como Dios mismo
e hijo de Dios pero hecho hombre para darnos ejemplo.</sig>
</pal>
<pal id="Jordán">
<sig id="Jordán.marcos" fecha="18/2/2003">En este rio Juan Bautista bautizaba a
los habitantes de Judea.</sig>
</pal>
<pal id="Jerusalén">
<sig id="Jerusalén.marcos" fecha="19/2/2003">Esta ciudad era la capital de Judea en
el tiempo de Jesús, hoy en día está en Jordania y está siendo invadida por
Israel.</sig>
</pal>
<pal id="Galilea">
<sig id="Galilea.marcos" fecha="19/2/2003">Región en el tiempo de Jesús, donde
estaba Nazaret.</sig>
</pal>
<pal id="Herodes">
<sig id="Herodes.mateo" fecha="14/3/2003">Gobernador de Judea en el tiempo en el
que nació Jesús. Tras ser avisado por los reyes de oriente del nacimiento
del Rey de los Judios, y no queriendo perder su poder, ordenó la ejecución
de todos los niños nacidos en Judea.</sig>
<sig id="Herodes.lucas" fecha="14/3/2003">Gobernador de Judea, también se conoce
como Arquelao, fue sucesor de su padre quien tenía el mismo nombre. Ordenó la ejecución de
Juan Bautista por cumplir una promesa. Conoció a Jesús y fue consultado sobre su
condena a muerte.</sig>
</pal>
</def>
Algunas características que pueden verse en este ejemplo son:
El identificador público para
archivos de definiciones es:
-//Structio//DTD definiciones 1.0
Cada palabra y cada significado tiene un identificador
único especificado en el atributo id
def - Raíz de definiciones
El elemento raíz def puede emplear los
atributos formato y longitud
para definir el formato de las palabras y significados del
archivo (ver atributo formato en
comunrepasa(5)).
Como subelementos puede tener palabras especificadas con
pal y los elementos comunes:
derechos, autor,
biblio y anota
(ver elementos-comunes(5)).
pal - una palabra y sus significados
Este elemento permite especificar una palabra, o más bien una
cadena a la que pueden asociarse significados. Se identifica con
la palabra/cadena misma en
el atributo id o si la cadena contiene caracteres
no válidos para identificadores (ver
xmlintro(5)) o alguno de los
caracteres ':' o '.', la palabra será el
valor del atributo pal.
Por empleando el atributo pal puede definirse:
<pal id="mayor" pal="<"> ...
No deben repetirse identificadores ni palabras en el documento.
Los subelementos hacen referencia a uno o más significados,
cada significado se coloca en el elemento sig,
el cual puede ir seguido de elementos comunes (que harán
referencia al significado que sigan, ver
elementos-comunes(5)), pistas introducidas con
el elemento pista y palabras despiste introducidas
con el elemento despista.
Las palabras despiste son
palabras que tengan significado diferente al especificado pero
que pueden confundirse o resultar un error común (tanto
repasa como repasatk las
presentan como opciones posibles además de la palabra en
preguntas de selección múltiple), las pistas son
indicaciones que ayudan a recordar o descubrir la palabra a
partir del significado, son presentadas por repasa
y repasatk al repetir una pregunta (se inspiran
en las pistas del programa KEduca).
sig - Un significado
El contenido de este elemento corresponde a un significado de la
palabra en la que aparezca. Debe escribirse en el formato del
archivo
(ver atributo formato en
comunrepasa(5)).
un identificador en el atributo id, el cual
debe comenzar con el identificador de la palabra seguido de punto
y a continuación una cadena. Se recomienda emplear una
cadena relacionada con el público y propósito del
significado. Puede emplearse también el atributo
fecha con la fecha de la actualización
más reciente del significado
(día/mes/año
o mes/año o
año).
También puede emplear el atributo heur
para especificar la 'heurística' por emplear al comparar una
respuesta dada por un usuario con la palabra que corresponda al
significado, desde una interfaz (e.g repasatk) en
el caso de una pregunta abierta. En este momento los valores
posibles son dist para distinguir mayúsculas de
minúsculas
e indist para no distinguir. El valor por defecto
si no se especifica uno de estos es dist.