`def`
Anterior | Documentación de referencia de formatos | Siguiente

## Nombre de referencia

`def` — Formato de archivo: definiciones

## Descripción y ejemplos

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`

## Descripción detallada de cada elemento

### `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="&lt;"> ...

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`.

## Ver también

repdef(1), clasif(5) secuencia(5)

## Historia

Este DTD se originó del intento por mantener definiciones por estudiar.

Anterior | Subir | Siguiente
`elementos-comunes` | Inicio | `clasif`