Siguiendo la filosofía de Unix. Se usa una configuración basada en archivos.

El repositorio debe estructurarse de la siguiente manera:

OMR
│   README.md
│   generate_versions.py
│   
│
└───Exam_1
│   └───content
│   │   │   header.md
│   │   │   1.qd
│   │   │   ...
│   │   exam-versions.json
│
└───Exam_2
│   └───content
│   │   │   header.md
│   │   │   1.qd
│   │   │   ...
│   │   exam-versions.json
│   ...

Examenes

Cada examen tiene su propio directorio, dentro del cual, encontramos:

content/: Subdirectorio que contiene todos los datos del examen:

Archivos .qd (QuizDown) para definir las preguntas del examen.

No importa el nombre de los archivos QuizDown

readme.md: Descripción o instrucciones para responder el examen.
header.md: Encabezado del examen.
footer.md: Pie de pagina del examen.

Todos los archivos MarkDown son opcionales

config.yml: Configuración especifica del examen.

En el archivo config.yml del directorio raiz contiene la configuración predeterminada.

Configuración

General

output:
   size: 12 # Tamaño de la fuente
   linestretch: 10 # Interlineado
   geometry: {"left": "4cm", "right": "3cm", "top": "2.5cm", "bottom": "2.5cm"} # Márgenes
header:
   logo: # URL de una imagen
   institution: # Nombre de la institución
   course: # Nombre de la asignatura
   teacher: # Nombre del profesor
eval:
   subtraction: True
   strict: False
   valuation: 50 # Debe ser mayor o igual al puntaje máximo
   decimals: 0

subtraction: De valor booleano, en caso de ser true realizará una Evaluación sustractiva.

Considerar entonces, que la calificación total será positiva o negativa según el Tipo de evaluación.

strict: De valor booleano, en caso de ser true realizará una Evaluación estricta.

La Evaluación estricta se utiliza para desincentivar que los estudiantes adivinen las respuestas. Esto se logra penalizando más las respuestas incorrectas que las preguntas sin responder, fomentando así una consideración cuidadosa al contestar.

valuation: De valor entero, es la calificación máxima que se puede obtener.
decimals: De valor entero, en caso de ser 0 redondeará el puntaje de evaluación a un número entero,

Especifica

exam:
   type: # Parcial, Final, etc
   title: # Título del examen
   date: 24-02-1988

Contenido