LATEX2REP(1)

NAME
latex2rep - Extrae archivos para repasa de un documento LaTeX con convenciones

SYNOPSIS

latex2rep [archivo...]

DESCRIPCIÓN

El script latex2rep convierte uno o más archivos escritos en LaTeX con convenciones para repasa en tres archivos XML con definiciones (def(5)), clasificación (clasif(5)) y secuencia (sec(5)). Los archivos generados y las convenciones son apropiadas para procesar material de estudio organizado de acuerdo a la legislación colombiana vigente para colegios (Ley 115/1994).

Este script no recibe opciones por la línea de comando, pero puede adaptarse empleando las siguientes variables de ambiente:

DEF Nombre del archivo de definiciones por generar.

CLA Nombre del archivo de clasificaciones por generar.

SEC Nombre del archivo de secuencia por generar.

DESC
    Descripción por emplear en los archivos que se generan.

FECHA
    Fecha de actualización que debe emplearse.

BIBLIO
    Bibliografía por agregar en los archivos que se generan.

TIPO_DERECHOS
    Tipo de derechos de reproducción por emplear en archivos que se generan.

TIEMPO_DERECHOS
    Año(s) en los que comienzan a regir derechos de reproducción

DERECHOS
    Términos de reproducción completos.

AUTORES
    Nombres de los autores.

IDSIGNIFICADO
    Es la cadena con la que se completan identificadores de significados. Si no se especifica una se emplea sig.

Para extraer esta información hemos supuesto que el documento LaTeX es material de referencia para estudiantes, que ha sido escrito por uno o más profesores, y que emplea un formato más o menos estándar:

•   Cuenta con logros y sus indicadores de logros escritos, por ejemplo, al comienzo de una guía o sección o capítulo.

•   Incluye definiciones importantes diferenciadas del resto del documento y valoradas de acuerdo a su relevancia. Estas definiciones deben relacionarse con los indicadores de logro que desarrollan. Las palabras podrían servir como elementos del índice del documento, o junto con las definiciones podrían emplearse en un glosario.

•   Ejercicios relacionados con indicadores de logro y sus soluciones. Las soluciones podrían emplearse para generar un solucionario.

•   Un orden para presentar los logros e indicadores de acuerdo al periodo en el que se presenten.

Esta información es extractada y dejada en archivos XML para repasa, que emplean el formato tex. Queda separada así:

•   Las definiciones y significados quedan en el archivo para definiciones

•   Los logros e indicadores quedan en el archivo de clasificación con tipos Logro y Indicador. Dentro de la clasificación de un indicador quedan referenciados los significados que se relacionen con el indicador junto con el peso, y quedan incluidos los ejercicios que se relacionen con el indicador.

•   La división en periodos queda en el archivo de secuencia con tipo Periodo. Dentro de cada secuencia quedan referenciados los indicadores del periodo correspondiente.

CONVENCIONES PARA DOCUMENTOS LATEX

Para adaptar LaTeX hemos definido algunos macros que se presentan en detalle a continuación

  Periodos

El orden en el que se especifiquen y procesen los archivos fuente debe corresponder al orden de presentación del material en periodos. El inicio del material para un periodo se especifica con el macro periodo cuyo argumento es el periodo. Se supone que el material de un periodo termina si no hay más archivos por procesar o al iniciarse material para un nuevo periodo. Se espera que como parte del material para un periodo se especifique al menos un indicador de logro. Por ejemplo:

     \periodo{p1}

  Logros e indicadores-de-logro

Tanto un logro como un indicador de logro se esperan especificados con el macro clasif cuyo primer parámetro debe ser logro o indicador, cuyo segundo parámetro debe ser el identificador y como tercer parámetro debe tener el logro o indicador. Por ejemplo:

     \clasif{indicador}{contexto.geografía}{Identifica la zona
     geográfica en la que vivió Jesús entre los años 0 y 33d.}

El logro que desarrolla uno o más indicadores debe especificarse antes (digamos los logros al comienzo de un capítulo mientras que los indicadores al comienzo de una sección), y los indicadores deben especificarse cómo parte de algún periodo.

  Definiciones

Una definición debe constar de una palabra,un significado, un peso y un indicador de logro asociado (en realidad pueden ser varias palabras separadas por espacio o números o caracteres arbitrarios)

Para especificar una palabra se emplea el macro pal, cuyo primer parámetro debe ser la palabra, el segundo parámetro será la identificación del indicador de logro seguida de una identificación para la palabra (si se omite se emplea la palabra misma), el tercer parámetro es el peso, el cuarto la definición, el quinto posibles pistas y el sexto posibles despistes. Las pistas/despistes se separan unas de otras con | (y se usa || para representar |). El peso representa la importancia de la palabra con respecto a otras (se sugiere un número de 1 a 5, siendo 5 las más importantes) y si se desea, separada con el caracter dos puntos (':'), la heurística que una herramienta de repaso (ver repasa(1) o repasatk(1)) debería emplear al valorar respuestas de quien estudie la definición ---repasa y repasatk soportan dist e indist para tener en cuenta o no diferencia entre mayúsculas y minúsculas en respuestas abiertas. Por ejemplo:

     \pal{Denario}{contexto.historia.denario}{3:indist}{Moneda empleada por los romanos del tiempo de Jesús, equivalía al jornal de un día de trabajo agrícola.}{Asarion|Oro}{}
      Tenga en cuenta que el paquete para LaTeX de repasa no presenta los párrafos con definiciones.

De emplear la misma palabra con diversos significados agregue a la identificación una cadena que distinga unas de otras separadas con el caracter '.' Por ejemplo una segunda definición para "denario" podría tener como identificación contexto.historia.denario.2

  Ejercicios

En medio de un ambiente \enumerate, pueden incluirse ejercicios con el macro ejercicio que remplaza al macro \item. La respuesta puede ir a continuación en el ambiente respuesta. El enunciado del ejercicio abarca hasta una línea que comience con una de las siguientes:

•   \item

•   \ejercicio

•   \end{enumerate}

•   \begin{respuesta}

 El parámetro del macro ejercicio es la identificación que debe comenzar con la identificación del indicador/logro seguida de punto y una identificación particular para el ejercicio que que lo distinga de otros del mismo indicador. Tanto en el enunciado del ejercicio como en la respuesta, evite emplear las cadenas %-% y %;%.

     \ejercicio{dh.busca.carta}
     Un camino directo que puede seguir para buscar determinar
     si cierta información de derechos humanos es cierta o falsa es
     preguntar por confirmación directamente a quienes la información
     afecte. ¿Dónde puede consultar casos actuales de derechos humanos
     en Colombia y direcciones donde pueda escribir solicitando confirmación?
     \begin{respuesta}
     Entre las organizaciones que mantienen información
     reciente sobre casos en Colombia están:
     \begin{itemize}
     \item Amnistía Internacional. http://www.amnesty.org
     Además de mantener información
     publicada (reportes, cartas, acciones urgentes), cuenta con una lista de
     distribución abierta de acciones urgentes. Estas acciones incluyen
     direcciones a las cuales escribir.
     \item Human Right Watch. http://www.hrw.org
     Publica reportes con regularidad. Cuenta con lista de noticias.
     \item Banco de violencia política de Justicia y Paz \&
     CINEP. http://www.nocheyniebla.org
     Registra # todos los casos de violación a derechos humanos de los
     que se tiene noticia, así como reportes periódicos. Cuenta con lista
     de noticias.
     \end{itemize}
     \end{respuesta}