El objetivo de este software es convertir un archivo de LaTeX que contiene preguntas de una misma categoría en un archivo Moodle-XML, para poder importar todas las preguntas de forma eficiente al Banco de Preguntas de Moodle. Es compatible con cualquier plataforma basada en Moodle, como por ejemplo PEDCO.
Los archivos de salida pueden ser editados para agregar opciones adicionales. Por defecto, este software genera preguntas de tipo "ensayo" (essay) con un cuadro de texto (opcional) de 15 líneas y permite adjuntar archivos de imagen y documentos tipo "word", "excel", etc. Los nombres de las preguntas se colocan automáticamente, con el formato category_x, donde category es el nombre de la categoría y x es la posición de la pregunta en el documento (empieza en 0).
(Cualquier duda, escribir a [email protected])
Por ahora, la única versión ejecutable para Windows 10 está disponible para descargar en la carpeta standalone del repositorio. El archivo se llama txmood.exe. Para usarlo, basta con colocarlo en una carpeta y ejecutarlo desde la línea de comandos. Para ello, pulsar la tecla de Windows y teclear cmd. Debe aparecer una aplicación que es como una cajita negra ("consola"). Abrirla. Luego, navegar hasta el directorio donde se encuentra el archivo ejecutable y escribir el código que corresponda según lo que se quiera hacer (los comandos entre corchetes son argumentos opcionales):
txmood <filename> [parent_category] [tex_dir] [xml_dir] [q_type] [q_format]
Acá, <filename> es el nombre del archivo .tex a convertir (obligatorio).
txmood -a [parent_category] [tex_dir] [xml_dir] [q_type] [q_format].
Argumentos opcionales:
[parent_category]: nombre de la categoría progenitora en el Banco de Preguntas. Por defecto es 'top'. La categoría "hija" es el nombre del archivo original (sin la extensión).
[tex_dir]: nombre de la carpeta que contiene el(los) archivo(s) .tex. Por defecto es 'questions_tex'. Esta carpeta debe estar contenida en la carpeta que tiene el archivo ejecutable.
[xml_dir]: nombre de la carpeta donde se guardarán el(los) archivo(s) .xml. Por defecto es 'questions_xml'.
[q_type]: tipo de pregunta. Por defecto es 'essay'. NOTA: todavía no se han probado/implementado otros tipos.
[q_format]: formato del texto. Default is 'html'. NOTA: por ahora es el único que funciona.
Por ahora, la única versión ejecutable para Linux está disponible para descargar en la carpeta standalone del repositorio. El archivo se llama txmood (es igual al de Windows, pero sin extensión). Para usarlo, basta con colocarlo en una carpeta y ejecutarlo desde la terminal de Linux. La ejecución es idéntica a la de Windows, pero debe agregarse ./ antes del nombre del programa, es decir ./txmood en vez de txmood. El resto es igual.
NOTA: hay ejemplos en la carpeta ejemplos de este repositorio. El archivo de entrada tiene que ser un documento de LaTeX con extensión .tex que compile bien. Puede también contener imágenes insertadas con el comando \includegraphics (las mismas serán embebidas en el archivo final .xml). La estructura del documento debe ser similar a la siguiente (hay 3 preguntas en este ejemplo):
...
\begin{document}
\begin{enumerate}
\item
%q
...
...
\item
%q
...
...
\item
%q
...
...
%q
\end{enumerate}
\end{document}
La parte previa a \begin{document} es el preámbulo, y es irrelevante. El bloque enumerate engloba todas las preguntas. Cada pregunta inicia con un \item seguido inmediatamente por un comentario %q en la siguiente línea. Además, debe haber un comentario %q al final de la última pregunta (justo antes del \end{enumerate}). Si se respeta este formato, aunque el archivo de salida sea único, Moodle identificará todas las preguntas de forma individual.
Hasta el momento, sólo se permite el uso de bloques de tipo enumerate (lista numerada), itemize (lista con viñetas), center (centrado), includegraphics (imagen) y equation (ecuación). Estas funcionalidades deben ser utilizadas en su mínima expresión, sin opciones especiales de formato.
Todos estos bloques tienen que estar escritos de manera prolija, de la forma siguiente (el ejemplo es un bloque enumerate):
\begin{enumerate}
\item ...
...
\end{enumerate}
Es muy importante que los comandos \begin{X} y \end{X} estén bien escritos, sin espacios en blanco entre los caracteres. Pueden anidarse bloques, por ejemplo enumerate dentro de enumerate, itemize dentro de enumerate, etc.
En el caso de insertar una imagen, se recomienda el siguiente formato:
\begin{center}
\includegraphics[width= 0.8\textwidth]{image.png}
\end{center}
Aquí, el ancho se puede ajustar como se desee. La imagen estará embebida en el archivo final .xml, por lo que no será necesario adjuntarla de ninguna manera durante la importación en PEDCO.
Hasta el momento, se admite texto en cursiva (\textit{...}) y negrita (\textbf{...}). No obstante, todavía no se pueden anidar estos comandos de formato.
Hasta ahora, sólo se ha resuelto el uso del "símbolo peso", que se escapa como \$ dentro de una ecuación.
- En la página principal del curso, hacer click en la rueda "menú de acciones" y seleccionar "Más...".
- En la sección "Banco de preguntas", hacer click en "Importar".
- En la sección "Formato de archivo", seleccionar "Formato Moodle XML".
- Más abajo, en la sección "Importar preguntas de un archivo", hacer click en "Seleccione un archivo...".
- Se abrirá la ventana del "Selector de archivos". Hacer click en "Subir archivo", luego "Browse" y seleccionar el archivo que se desee. Luego, hacer click en "Subir este archivo".
- Finalmente, hacer click en "Importar". Se recibirá un mensaje indicando el éxito o fracaso de la operación de importación.
