`sec`
Anterior | Documentación de referencia de formatos | Siguiente

## Nombre de referencia

`sec` — Formato de archivo: secuencia

## Descripción y ejemplos

Una secuencia permite especificar un orden de presentación para una clasificación, es decir indica CUANDO se estudian subclasificaciones de una clasificación (la clasificación indica QUE se estudia).

Una secuencia es normalmente escrita por el orientador de una asignatura para dar un orden a la presentación de los temas ya organizados en una clasificación (y posiblemente con definiciones, ejemplos y ejercicios). Al separar QUE se estudia de CUANDO se presenta, puede reutilizarse una misma clasificación de temas con diversas secuencias (por ejemplo dependiendo del estilo del profesor o del público) y en el marco del plan decenal de educación en Colombia abre la puerta para una valoración de acuerdo al ritmo propio de cada estudiante[28].

La siguiente es una posible secuencia para la clasificación de ejemplo (ver clasif(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="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>

Algunas características por destacar son:

- El identificador público es

      PUBLIC "-//Structio//DTD secuencia 1.1" "sec.dtd"

- Emplea los elementos comunes: `desc`, `biblio`, `derechos` y `autor`

- Puede dividirse el tiempo total de presentación del tema en periodos, niveles u otro tipo, con diversos niveles de granularidad. Por ejemplo los tipos podrían ser `año;periodo;semana`:

      <secuencia formato="texto" tipos="año;periodo;semana">

  que indicarían que un año se compone de periodos y estos a su vez de semanas, y permitiría escribir subsecuencias con ese orden (subsecuencias tipo `semana` dentro de subsecuencias tipo `periodo`, y estas dentro de secuencias tipo `año`).

- Dentro de una secuencia se referencian las clasificaciones que se desarrollan (en el ejemplo, la clasificación tipo `Indicador` identificada como `establece.reflexiona` se desarrolla en el primer periodo).

## Descripción detallada de cada elemento

### `secuencia` - Raíz de una secuencia

El elemento raíz `clasificacion` puede emplear los atributos `formato` y `longitud` que indican el formato que tendrán las descripciones de la clasificación y la máxima longitud que cada una debe tener y que será chequeada por repchq (ver atributo `formato` en comunrepasa(5)). De forma análoga a un archivo de clasificaciones (ver clasif(5)) puede tener un atributo tipos que especifica y da un orden a los tipos que puede aparecer en el documento y que también puede chequearse de forma estricta con la opción `-e` de repchq (ver repchq(1)).

Como subelementos debe tener primero una descripción en el formato del archivo (con la marquilla `desc`) y a continuación puede tener los elementos comunes (`elementos-comunes`(5)) o subsecuencias introducidas con la marquilla `sec`

### `sec` - Subsecuencia

Este elemento delimita una subsecuencia, que debe tener una identificación y un tipo (que esté en el orden de los tipos admisibles para el archivo si es que estos se especificaron en el elemento raíz). La identificación se especifica en el atributo `id`, además de ser una identificación XML (ver xmlintro()), puede constar de todo caracter excepto '/', ':' (el uso de '.' es restringido), debe comenzar con la identificación de la secuencia madre (si la hay) seguida del caracter '.'. El tipo se especifica en el atributo `tipo` y puede tener caracteres arbitrarios excepto ';'.

Pueden especificarse las fechas de inicio y finalización de estudio de la secuencia en los atributos `inicio` y `fin` respectivamente. Las fechas de estos atributos pueden constar de día, mes y año o sólo mes y año o sólo año (ver sintaxis en la sección "Progreso en un significado" del manual prdef(5)). La fecha final debe ser mayor a la inicial. De haber una serie de secuencias, sus rangos de fechas no deben ser traslapados y deben estar en orden, es decir el rango de fechas de la segunda secuencia debe ser posterior al rango de fechas de la primera y así sucesivamente. En el caso de subsecuencias el rango de fechas debe estar dentro del rango de fechas de la secuencia madre.

Como subelementos debe tener primero una descripción (elemento `desc`) y a continuación puede tener los elementos comunes (`autor`, `derechos` y `biblio`) o nuevas subsecuencias hijas con la marquilla `sec` o con la marquilla `refcla` referencias a las clasificaciones que se esperan cubrir en la secuencia. Cada clasificación puede referenciarse a lo sumo una vez en una secuencia.

### `refcla` - Referencia a una clasificación

La clasificación referenciada se identifica con: el tipo en el atributo `tipo` y la identificación de la clasificación en el atributo `idcla`, esta puede ir precedida por el archivo en el que está (i.e archivo.cla:id) Así por ejemplo si en el archivo de clasificaciones se desea referenciar la subclasificación con identificación "animal.primate" del archivo `taxo.cla`, se emplearía en el atributo `id` el valor "taxo.cla:animal.primate". Sugerimos referenciar clasificaciones sin subclasificaciones.

## Ver también

repchq(1), clasif(5) def(5)

## Historia

Este DTD se originó al buscar organizar la información de la forma propuesta propuesta por el plan decenal de educación 1995-2005 en Colombia. En particular de la división de los contenidos en logros e indicadores, independientes del momento en el que se estudian.

[28] Consideramos que es posible la valoración de acuerdo al ritmo de cada estudiante, si están bien separados los temas (clasificación) del orden de presentación (secuencia), y si se valora con respecto a la clasificación en lugar de valorar con respecto a la secuencia.

Anterior | Subir | Siguiente
`clasif` | Inicio | `prdef`