Ejemplo de banco de definiciones básico

Además de los ejemplos del directorio /usr/local/share/repasa/ejemplos (donde quedan después de instalar repasa) puede basarse en el siguiente, que supondremos está en un archivo con nombre ejsimple.def[1]:

<?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>

Para revisar la sintaxis puede emplear el programa repchq (ver repchq(1)), que además de reportar posibles errores presenta algunos datos del archivo:

$ repchq ejsimple.def 

Procesando archivo 'ejsimple.def'

Cantidad de palabras 6
Cantidad de significados 7
Cantidad de despistes 0
Cantidad de pistas 0

Cantidad de anotaciones 0
Cantidad de notas de derechos 1
Cantidad de bibliografías 1
Cantidad de autores 1


 

Este programa permite chequear los siguientes tipos de archivos: definiciones, clasificaciones, secuencia y progreso.

Si cuenta con el programa ispell y diccionario en español para este programa[2], podrá revisar la ortografía de un archivo de definiciones o de clasificaciones o de secuencias o en general de un documento HTML o XML empleando la opción -h de ispell. Puede corregir intercativamente con:

ispell -d spanish -h ejsimple.def

o puede generar una lista de todas las palabras que no se encuentran en el diccionario con:

ispell -d spanish -h -l < ejsimple.def

Con la opción -h de este programa podrá revisar la ortografía de un documento HTML o XML, como los archivos para repasa

Un archivo de definiciones sin errores puede ser empleado por los programas repasa o repasatk para hacer una autoevaluación con preguntas abiertas o de selección múltiple:

El ejemplo anterior se inició con repasatk ejsimple.def, a continuación se presenta parte de la salida de la herramienta de repaso con interfaz texto iniciada con repasa ejsimple.def:

Archivo de progreso: /home/pepe/.repasa.prd
----------------------------------------
Preguntas que faltan 5   
En este rio Juan Bautista bautizaba a los habitantes de Judea. (6
letras)
Jordán
----------------------------------------
Preguntas que faltan 4   
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.
a) Jesús
b) Jordán
c) Jerusalén
d) Dios
Respuesta: 

Si ya instaló apropiadamente repasa, este comando inicia la herramienta gráfica de repaso para repasar algunas definiciones del archivo biologia.def

Algunos detalles por notar son:

• En preguntas abiertas la respuesta debe tener exactamente la misma ortografía que la palabra del archivo. Es posible que para algunos significados se ignore diferencia entre mayúsculas y minúsculas usando el atributo heur del elemento sig con valor indist. Por ejemplo:

  <pal l id="denario">
    <sig id="denario.marcos" fecha="19/2/2003" heur="indist">Moneda romana que 
      equivalía al jornal de un día para un trabajador del campo</sig>
  </pal>

  Puede agregar este atributo con valor indist a un significado en un archivo de definiciones para indicar que no debe tenerse en cuenta diferencia entre minúsculas y mayúsculas al valorar una respuesta.

• El tipo de cada pregunta (es decir abierta o selección múltiple) en este caso es aleatorio. Puede indicarse a repasa/repasatk que sólo se hagan preguntas abiertas con la opción -forma_abierta o sólo de selección múltiple con -forma_multiple.

  Esta opción de repasa y repasatk indica que sólo se hagan preguntas de selección múltiple.

  Esta opción de repasa y repasatk indica que sólo se hagan preguntas abiertas.

• La máxima cantidad de preguntas en una sesión de repasa o repasatk es por defecto 10, valor que puede variarse con la opción -maxpreg número.

  Con esta opción de repasa y repasatk puede establecer el número máximo de preguntas por formular.

• Cuando la sesión de preguntas concluye, se salvan los resultados en un archivo de progreso. Por defecto es ~/.repasa.prd aunque puede especificarse otro con la opción -prd archivo.

  

  Con esta opción de repasa y repasatk puede establecer el archivo de progreso por usar

  Al concluir la sesión las posibles sugerencias que haya hecho el usuario (al contestar mal una pregunta se tiene la oportunidad de escribir una sugerencia) son enviadas por correo electrónico a la dirección de contacto por defecto o a la fijada con la opción -correo correo. El correo por defecto es <structio-info@lists.sourceforge.net> que puede cambiarse durante la instalación.

  Con esta opción de repasa y repasatk puede establecer el correo al cual enviar sugerencias.

• Las preguntas que son realizadas en una sesión de repasa/repasatk dependen de la política de estudio que se escoga, tal como se explica en el capítulo siguiente (ver la sección de nombre Más sobre las interfaces de repaso repasa y repasatk en Capítulo 3) o en el manual de repasatk (ver repasatk(1)).