Tabla de contenidos
Público e indicadores de logro
Profesores y administrador de red
Indicadores de logroEl siguiente ejemplo complementa los presentados hasta ahora. Se trata de un posible orden para la clasificación sobre fe en Jesús (ver Sección 1, “Ejemplo de clasificación”)[8]:
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE secuencia PUBLIC "-//Structio//DTD secuencia 1.1" "sec.dtd">
<secuencia formato="texto" tipos="periodo">
<desc>Secuencia sobre fe en Jesús</desc>
<derechos tipo="Dominio público" tiempo="2003">Liberado al dominio público. No se ofrecen garantías</derechos>
<biblio>http://de.geocities.com/nuestroamigojesus/bdp</biblio>
<autor fecha="2003">Vladimir Támara</autor>
<sec tipo="periodo" id="p1"><desc>Primer periodo</desc>
<refcla tipo="Indicador" idcla="contexto.geografía"/>
<refcla tipo="Indicador" idcla="contexto.historia"/>
</sec>
<sec tipo="periodo" id="p2"><desc>Segundo periodo</desc>
<refcla tipo="Indicador" idcla="establece.reflexiona"/>
</sec>
</secuencia>
Si el nombre del archivo es ejsimple.sec
puede verificarse con:
$ repchq ejsimple.sec Procesando archivo 'ejsimple.sec' Archivo de clasificaciones por defecto:ejsimple.cla Cantidad de notas de derechos 1 Cantidad de bibliografías 1 Cantidad de autores 1 Cantidad de referencias a clasificaciones 3 Cantidad de secuencias 2 Cantidad de anotaciones 0
Una secuencia es análoga a una clasificación, se trata de un
árbol en un archivo XML (con extensión .sec) en
el que pueden referenciarse clasificaciones. El orden
en el que se escriba este árbol determina el orden de presentación,
puede decirse que una clasificación organiza QUE
temas se estudiarán, mientras que una secuencia organiza
CUANDO se presentan.
En el ejemplo presentado hay sólo dos secuencias sin
subsecuencias[9], ambas
son de tipo Periodo. La primera tiene
identificación p1 y referencia las 2 clasificaciones
que se presentarían en el primer periodo, la segunda con
identificación p2 referencia una sola clasificación
que se estudiaría en el segundo periodo. Si se deseara podrían
introducirse subsecuencias por ejemplo para dividir los periodos en
meses o semanas.
Las clasificaciones se referencian con el elemento
refcla, que como atributos debe tener
id con la identificación
de la clasificación y tipo con el
tipo de la clasificación. El archivo de clasificaciones puede
especificarse como parte del identificador, precediendo la
identificación y separando archivo de identificación con el caracter
':' por ejemplo ejsimple.cla:contexto.geografía.
Si no se especifica un archivo, se emplea
el archivo de clasificaciones por defecto el cual se especifica
a repchq, repasa y
repasatk con la opción
-c , o que
de no especificarse corresponde al archivo cuyo nombre sea el
mismo que el de la secuencia pero con extensión
archivo.cla
Algunos detalles por notar en una secuencia son:
Pueden darse créditos de forma análoga a clasificaciones con los elementos
biblio,autoryderechos(ver Sección 2, “Créditos y términos de reproducción en una clasificación”. Así mismo pueden agregarse anotaciones con el elementoanota.Pueden escribirse descripciones de las secuencias en uno de los formatos soportados para definiciones y clasificaciones (ver Sección 3, “Formato de un archivo de definiciones”). El tipo por defecto es texto plano, otros tipos (
docbookotex) pueden especificarse en el atributoformatodel elementosecuencia.Los tipos de una secuencia son análogos a los de una clasificación, se especifican en orden en el atributo
tiposdel elementosecuenciao se indican desde la línea de comandos de repchq con la opción-j(ver Sección 3, “Tipos en una clasificación”).ordenAl especificar una secuencia como archivo de entrada a las herramientas de repaso repasa y repasatk y a menos que se especifique la opción
-todas, el usuario podrá elegir las secuencias por repasar. Es decir las preguntas que se formulen se sacarán sólo de las secuencias elegidas.
Además a menos que se especifique la opción
-pressec-no, al contestar una pregunta de forma errada, la herramienta de repaso presenta la primera secuencia en la que se referencia la primera clasificación en la que se referencia la definición (para que quien repasa tenga la oportunidad de consultar antes de continuar).
Dado que los archivos de repasa emplean XML, es posible
emplear herramientas creadas para este lenguaje de marcado, en
particular es posible emplear XSLT para traducir del formato
de repasa a otro.
En el directorio de ejemplos
(/usr/local/share/repasa[10]) hay una hoja de estilo
XSLT (sec2html.xsl) para convertir a HTML
una secuencia junto con las clasificaciones
que referencia y las definiciones referenciadas en estas.
Para emplearla se requiere un procesador de XSLT como por ejemplo
xsltproc que hace parte de libxslt
(ver [libxslt]).
Empleando xsltproc puede convertir
la secuencia ejsimple.sec que emplea la
clasificación por defecto ejsimple.cla y esta
a su vez emplea el archivo por definiciones por defecto
ejsimple.def con:
xsltproc --catalogs --stringparam nomcla ejsimple.cla \
--stringparam nomdef ejsimple.def sec2html.xsl ejsimple.sec
Para que funcione apropiadamente tendrá que ajustar las rutas
de los archivos y tal vez agregar a la variable de ambiente
SGML_CATALOG_FILES la ruta del archivo con
el catálogo de tipos de documento XML para repasa, por ejemplo:
export SGML_CATALOG_FILES=/usr/local/share/xml/structio/catalog