Capítulo 4. Plan de estudios y usos en un colegio

Tabla de contenidos

1. Ejemplo de secuencia
1.1. Detalles en secuencias
1.2. Convirtiendo a HTML con XSLT
2. Plan de estudios en un colegio
2.1. Edición
2.2. Generación de archivos HTML con plan de estudios
2.3. Consideraciones sobre la integridad
2.4. Automatización
2.5. Consideraciones sobre el control de versiones
2.5.1. Configuración del servidor CVS
2.5.2. Actualización del repositorio
2.5.3. Procedimientos periódicos con el repositorio
2.5.4. Mas ayudas para automatizar
3. Autoevaluación en un colegio con red local
3.1. Preparación de la plataforma S-Helio
3.2. Realización de una autoevaluación

Público e indicadores de logro

Profesores y administrador de red

Indicadores de logro

1. 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 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 archivo, o que de no especificarse corresponde al archivo cuyo nombre sea el mismo que el de la secuencia pero con extensión .cla

1.1. 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 Sección 2, “Créditos y términos de reproducción en una clasificación”. 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 Sección 3, “Formato de un archivo de definiciones”). 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 Sección 3, “Tipos en una clasificación”).

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

    repasatk
		       durante la elección de secuencia.

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

1.2. 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[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
       



[8] Está disponible en la distribución de fuentes de repasa en regr/ejsimple.sec.

[9] Podría introducirse dentro de las secuencias existentes con el elemento <sec>.

[10] Los ejemplos también están disponibles en las fuentes en el directorio ejemplos