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

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

## Público e indicadores de logro

Profesores y administrador de red

Indicadores de logro

- Puede crear un archivo de secuencia y verificarlo.

- Puede organizar un plan de estudios para diversas materias y diversos grados.

- Prepara las herramientas de `repasa` para usarlas en un una red, por ejemplo para realizar una autoevaluación a estudiantes de un curso.

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

  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`

Anterior |  | Siguiente
5. Más sobre las interfaces de repaso `repasa` y `repasatk` | Inicio | 2. Plan de estudios en un colegio