2013

Manual Tcnico para Google Course Builder

[Escriba el subttulo del documento]
[Escriba aqu una descripcin breve del documento. Normalmente, una descripcin breve es un resumen corto del contenido del documento. Escriba aqu una descripcin breve del documento. Normalmente, una descripcin breve es un resumen corto del contenido del documento.]

Ana Illanas Vila Servicio de informtica. Universidad de Alicante Versin 1.0. Marzo 2013

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Contenido
Introduccin a los MOOC y al Google Course Builder ............................................................2 MONTAR UN CURSO CON GOOGLE COURSE BUILDER ...........................................................3 Qu necesito? .......................................................................................................................... 3 Montar un sitio multicurso ....................................................................................................... 4 Crear un curso ........................................................................................................................... 5 Aadir unidades y lecciones al curso ........................................................................................ 7 Unidades: .............................................................................................................................. 8 Lecciones: .............................................................................................................................. 9 Crear una actividad ................................................................................................................. 10 Crear assessments (graded test) ............................................................................................. 14 Crear un test ........................................................................................................................ 14 Puntuacin (scoring) ........................................................................................................... 16 Modificar el nmero de assessments ................................................................................. 16 Otros aspectos del desarrollo ............................................................................................. 17 Internacionalizacin ................................................................................................................ 17 Verificar el cdigo.................................................................................................................... 17 Subir la aplicacin (curso) a google..................................................................................... 18

Introduccin a los MOOC y al Google Course Builder Universidad de Alicante

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Introduccin a los MOOC y al Google Course Builder

MOOC. Massive Open Online Course
Open Access: Los estudiantes no tienen que estar matriculados en el centro que los soporta. Scalability: Indefinido nmero de participantes Financiacin: o Las universidades que los lideran, principalmente. o Empresas de inversin capital-riesgo o Empresas (estudiantes = futuros contratados) o Gratis para los alumnos (por ahora). La certificacin podra ser de pago. Evaluacin: o peer assessment (evaluacin entre pares): los propios alumnos se califican entre ellos (Google Course Builder no lo incorpora) o Criterios claramente establecidos rbrica (criterios + estndares)

Google Course Builder.

Incluye: o Lecciones, tutoriales, ejercicios o Actividades para los alumnos o Exmenes y gestin de evaluaciones o Comunidades virtuales, foros Prerrequisitos de uso: o Experiencia en creacin de materiales o Familiarizacin con HTML y JavaScript o Familiarizado con AppEngine (como un plus) Coste: o Cada curso puede consumir un cierto nmero de recursos gratis. o Si se necesita ms, hay que comprarlo Publicacin del curso: o Dominio gratuito: APP_ID.appspot.com o Puedes comprar tu propio dominio Los alumnos tienen que usar cuenta de google.

Introduccin a los MOOC y al Google Course Builder Universidad de Alicante

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

MONTAR UN CURSO CON GOOGLE COURSE BUILDER

Qu necesito?
Instalar el Course Builder Launcher, para compilar y lanzar los cursos en local. Para que funcione necesitas: o Instalar Python o Instalar App Engine

Descargar el curso de ejemplo de Google. Al descomprimirlo en el destino deseado obtienes los archivos siguientes:

(*) (*)

(*)

(*) Estos son los nicos archivos y directorios que aconsejan modificar para elaborar tu curso. El resto deberas evitar modificarlos para simplificar la migracin a futuras versiones de CourseBuilder.

Cargar, compilar y ejecutar el curso de ejemplo de Google en el Launcher.

Compilar

Ejecutar

Abrir

Nota. Debido a incompatibilidades de versiones entre libreras, completar la instalacin y lanzar el curso de prueba en el launcher con xito puede no funcionar a la primera.

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Montar un sitio multicurso

Es posible montar varios cursos en una nica instacia de Course Builder. Esto permitira acceder a cada uno de ellos de la siguiente forma: http://www.uamooc.es/index.html Pgina principal de la plataforma de cursos. http://www.uamooc.es/algebra mooc de algebra http://www.uamooc.es/calculo mooc de calculo

Cambio en la estructura de ficheros: - Se crea una carpeta llamada courses y dentro de ella, tantas carpetas como cursos se necesiten. - Dentro de cada curso, se copian las carpetas asstes, data, view y el fichero course.yaml. Estos archivos sern particulares para cada curso y el resto son comunes para todos:

Aadir las rutas en el archivo app.yaml: En la seccin env_variables del archivo app.yaml hay que aadir tantas reglas GCB_COURSES_CONFIG como cursos tengamos. Una regla GCB_COURSES_CONFIG tiene la siguiente estructura:

GCB_COURSES_CONFIG: course:url_prefix:localizacin_de_los_archivos_fisicos, course:url_prefijo:localizacin_de_los_archivos_fisicos

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Crear un curso
No merece la pena crear un curso desde cero, ya que se genera un Hola Mundo bsico con muy pocos ficheros:

Lo recomendable es modificar el curso de ejemplo que Google te proporciona.

Personalizar la pgina principal

Se necesita modificar el archivo course.yaml para cambiar el ttulo del curso, los textos de la pantalla principal y de otras (como la de registro), los textos y logos de la cabecera y pie, el idioma del curso, el video de bienvenida

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Nota. El fichero tiene un formato rgido y es muy sensible a tabulaciones y caracteres especiales.

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Para modificar la visualizacin de los cursos hay que recurrir a los ficheros (aunque al principio, el directorio view est en la lista de los archivos que te recomiendan no modificar): views/base_registration.html o views/base.html: cabecera y pie para usuarios no registrados o registrados. views/preview.html o views/course.html: contenido del curso para usuarios no registrados o registrados. views/summary.html: descripcin del curso y video introductorio.

Aadir unidades y lecciones al curso

En CourseBuilder, un curso est formado por unidades y cada unidad por lecciones y actividades.

Unidades

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Lecciones

Unidades: Para especificar las unidades del curso hay que editar el archivo: data/unit.csv En l, cada fila corresponde a una unidad con la siguiente informacin: id: identificador de la unidad. Nmeros consecutivos comenzando por 1. type: tipo de unidad. Slo puede tener los siguientes valores: o A: Actividad o U: Unidad o O: Otros (link, video, hongout on air) unit_id: su valor depende del campo type o A: sufijo del fichero js que contiene la actividad (assessment-sufijo.js) o U: identificador de la unidad o O: el link del material externo title: texto con el ttulo de la unidad release_date: fecha a partir de la cual la unidad est disponible. Puede quedarse vacio. now_available: si la unidad est disponible o no para ser cursada (true o false).

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Lecciones: Para especificar las unidades del curso hay que editar el archivo: data/lesson.csv En l, cada fila corresponde a una leccin con la siguiente informacin: unit_id: identificador de la unidad a la que pertenece la leccin. unit_title: ttulo de la unidad a la que pertenece la leccin. lesson_id: identificador de la unidad. Nmero consecutivo comenzando por 1. lesson_title: ttulo de la leccin lesson_activity: si es una actividad (yes) o no (se deja en blanco). lesson_notes: URL de la versin texto de la leccin. lesson_video_id: cdigo de video de youtube lesson_objectives: texto con los objetivos de la leccin (html)

Notas: Lo ttulos de la unidad deben coincidir en el archivo unit.csv y lesson.csv. Al modificar el ttulo de una leccin en unit.csv hay que modificarlo tambin en lesson.csv para que no falle. La versin en texto de la leccin es un enlace externo (lesson_notes), eso quiere decir que algunos datos de la leccin, como por ejemplo el ttulo, podran no coincidir si se modificaron en el archivo .csv pero no en la versin texto.

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Crear una actividad

Los archivos implicados en la pantalla de una actividad son los siguientes: views/base.html: (igual que en las lecciones) para usuarios registrados views/activity.html: define las mismas partes que views/unit.html assets/js/activity-N.M.js: contiene un array JavaScript. Donde: o N: corresponde al nmero de unidad a la que pertenece o M: corresponde al nmero de leccin a la que pertenece.

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

10

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Activity-N.M.js

Consiste en una variable activity que es un array que puede contener: o Una cadena de texto HTML o Una pregunta o Un Answer Information (respuestas seleccionables)

Texto HTML

pregunta

Answer Information

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

11

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Tipos de Answer Information: o Single multiple-choice question

{ questionType: multiple choice, choices: [ [texto de la respuesta, true/false, texto a mostrar si la selecciona ], [texto de la respuesta, true/false, texto a mostrar si la selecciona, ], ] }

Group of multiple-choice questions

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

12

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

{ questionType: multiple choice group, questionsList: [ { questionHTML: texto de la pregunta, choices: [OpcinA, OpcinB, OpcinC, ], correctIndex: 0 }, { questionHTML: }, ], allCorrectOutput: texto que aparecer si acierta todas las preguntas, someIncorrectOutput: texto que aparecer si falla alguna pregunta }

Free text

{ questionType: freetext, correctAnswerRegex: expresin regular para comprobar si la respuesta del alumno es correcta o no. correctAnwerOutput: texto que aparecer si la respuesta es correcta, incorrectAnswerOutput: texto que aparecer si es incorrecta, showAnswerOutput: texto que aparecer si pulsas el botn de Saltar y Mostrar Respuesta, showAnswerPrompt: texto del botn Saltar y Mostrar Respuesta, outputHeight: altura en pxels para la caja de texto }

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

13

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Crear assessments (graded test)

Crear un test Cada test est en un fichero assets/js/assessment-SUFFIX.js que contiene los atributos del cuestionario y sus preguntas correspondientes. assessment-SUFFIX.js

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

14

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Este fichero contiene una variable assessment que es un array de atributos y preguntas:
var assessment = { assessmentName: nombre_unico_del_assessment, preamble: texto HTML que introduce el cuestionario, checkAnswer: true/false, // si los estudiantes pueden comprobar // las respuestas antes de enviar el // cuestionario {Listado_de_preguntas} (*) }

(*) Listado de preguntas: Se refiere a un array de preguntas separadas por comas. Cada pregunta tiene la siguiente estructura:
{ questionHTML: El texto de la pregunta, Lesson: 1.5, // Leccin a la que corresponde (para orientar) Pregunta (**) }

(**) Pregunta: La estructura de este atributo vara dependiendo del tipo de pregunta que sea. Los tipos de preguntas y sus correspondientes estructuras son los siguientes: Pregunta de respuesta mltiple:
choices[respuesta 1, respuesta 2, correct(respuesta 3), respuesta 4] correctAnswerNumeric:

Pregunta de respuesta numrica:

Pregunta de respuesta de texto (case-sensitive): (aceptara hello y Hello como respuestas correctas, pero no hellos) Pregunta de respuesta de texto libre (expresin regular):
correctAnswerRegex: expresin_regular correctAnswerString: hello

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

15

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Puntuacin (scoring) - assets/js/activity-generic.js: checkOrSubmitAnswers determina la puntuacin de cada assessment. La frmula por defecto es un porcentaje simple de preguntas correctas sobre el nmero total de preguntas. - controllers/assessments.py: storeAssessmentData determina cuando se almacena la nota. Por defecto se hace la primera vez que el alumno hace el test y cada vez que supera la nota anterior. Cuando se completa el test final, storeAssessmentData tambin determina cmo se punta el curso entero. Por defecto es un 30% para el test de mitad de curso y 70% para el test final.

Modificar el nmero de assessments Por defecto, Course Builder tiene 3 assessments: precourse assessment, midterm assessment y final assessment. Para modificar esto: 1. Crear un fichero assessment-SUFFIX.js en assets/js para cada cuestionario y rellenar sus atributos. 2. Aadir el assessment en su lugar correspondiente en data/unit.csv utilizando el SUFFIX del archivo .js para referenciarlo. 3. Actualizar el storeAssessmentData en controllers/assessment.py para aadirlo a las notas del alumno utilizando el atributo assessmentName del archivo .js para referenciarlo. 4. Actualizar el archivo views/student_profile.html para que le aparezca el cuestionario al alumno en su perfil. 5. Actualizar views/test_confirmation.html para mostrar un mensaje de confirmacin apropiado para cada cuestionario.

MONTAR UN CURSO CON GOOGLE COURSE BUILDER Universidad de Alicante

16

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Otros aspectos del desarrollo

Internacionalizacin
Se puede traducir el texto visible para los alumnos a varios idiomas. Se refiere a los textos en los ficheros HTML del directorio views. Sintaxis: {% trans %} Texto _a_traducir {% endtrans %} Este framework de internacionalizacin se basa en las tecnologas: webapp2, pybabel, pytx, ji ja2s. Es u desarrollo de u i ooc-tec.

Verificar el cdigo
Consiste en comprobar si los ficheros csv estn correctamente formados antes de subir el curso a google. Se ejecuta por lnea de comandos lo siguiente:
cd APPPATH python tolos/verify.py

Otros aspectos del desarrollo Universidad de Alicante

17

MANUAL TCNICO PARA GOOGLE COURSE BUILDER

Subir la aplicacin (curso) a google

Es necesario una cuenta de google. Registrar la aplicacin (curso) con google: o En este paso es donde te asignan el dominio o Dos formas: Con el navegador: appengine.google.com Con el launcher: Dashboard Subir (upload or deploy) la aplicacin: o Lnea de comandos:
cd APPPATH appcfg.py update.

Modificar una aplicacin en produccin: o Lnea de comandos:

cd APPPATH appcfg.py update.

Se actualizan los ficheros: csv y course.yaml de manera inmediata assessments, activities y views tienen un retardo de 10 minutos.

Subir la aplicacin (curso) a google Universidad de Alicante

18