latex2rep — Extrae archivos para repasa de un documento LaTeX con convenciones
latex2rep [archivo...]
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:
Nombre del archivo de definiciones por generar.
Nombre del archivo de clasificaciones por generar.
Nombre del archivo de secuencia por generar.
Descripción por emplear en los archivos que se generan.
Fecha de actualización que debe emplearse.
Bibliografía por agregar en los archivos que se generan.
Tipo de derechos de reproducción por emplear en archivos que se generan.
Año(s) en los que comienzan a regir derechos de reproducción
Términos de reproducción completos.
Nombres de los autores.
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.
Para adaptar LaTeX hemos definido algunos macros que se presentan en detalle a continuación
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}
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.
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
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}