Capítulo 4. Plan de estudios y usos en un colegio
Público e indicadores de logro
Profesores y administrador de red
Ejemplo de secuencia
El siguiente ejemplo complementa los presentados hasta ahora. Se trata de un posible orden para la clasificación sobre fe en Jesús (ver la sección de nombre Ejemplo de clasificación en Capítulo 3)[1]:
<?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="2002">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.
Extensión sugerida para archivos con secuencias.
En el ejemplo presentado hay sólo dos secuencias sin subsecuencias[2], 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 archivo, o que de no especificarse corresponde al archivo cuyo nombre sea el mismo que el de la secuencia pero con extensión .cla
En un archivo de secuencias, en el elemento refcla, para referenciar clasificaciones especificando el archivo en el que están, se escribe el nombre del archivo seguido de la identificación. ¿Cuál es el caracter con el que se separan?
Con este elemento se referencian clasificaciones desde un archivo de secuencia.
Detalles en secuencias
Algunos detalles por notar en una secuencia son:
Pueden darse créditos de forma análoga a clasificaciones con los elementos biblio, autor y derechos (ver la sección de nombre Créditos y términos de reproducción en una clasificación en Capítulo 3. Así mismo pueden agregarse anotaciones con el elemento anota.
Pueden escribirse descripciones de las secuencias en uno de los formatos soportados para definiciones y clasificaciones (ver la sección de nombre Formato de un archivo de definiciones en Capítulo 2). El tipo por defecto es texto plano, otros tipos (docbook o tex) pueden especificarse en el atributo formato del elemento secuencia.
Los tipos de una secuencia son análogos a los de una clasificación, se especifican en orden en el atributo tipos del elemento secuencia o se indican desde la línea de comandos de repchq con la opción -j orden (ver la sección de nombre Tipos en una clasificación en Capítulo 3).
Al 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).
Con esta opción repasa y repasatk eligen todas las secuencias por estudiar (no permiten elegir una secuencia particular al usuario).
Convirtiendo a HTML con XSLT
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[3]) 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]).
Este lenguaje permite convertir archivos XML (como los de repasa) en otros formatos.
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