Post on 18-Oct-2015
5/28/2018 Manual Tecnico Para Google Course Builder Libre
1/19
Manual Tcnico paraGoogle 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.]
2013
Ana Illanas Vila
Servicio de informtica. Universidad de Alicante
Versin 1.0. Marzo 2013
5/28/2018 Manual Tecnico Para Google Course Builder Libre
2/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
Introduccin a los MOOC y al Google Course Builder 1
Universidad de Alicante
Contenido
Introduccin a los MOOC y al Google Course Builder ............................................................ 2
MONTAR UN CURSO CON GOOGLE COURSE BUILDER ........................................................... 3Qu 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
5/28/2018 Manual Tecnico Para Google Course Builder Libre
3/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
Introduccin a los MOOC y al Google Course Builder 2
Universidad de Alicante
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
- Prerrequisitosde 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
- Publicacindel curso:
o Dominio gratuito: APP_ID.appspot.com
o Puedes comprar tu propio dominio
- Los alumnos tienen que usar cuenta de google.
5/28/2018 Manual Tecnico Para Google Course Builder Libre
4/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 3
Universidad de Alicante
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:
- Cargar, compilar y ejecutar el curso de ejemplo de Google en el Launcher.
(*)
(*)
(*)
(*) Estos son los nicos archivos y
directorios que aconsejan modificar para
elaborar tu curso. El resto deberas evitar
modificarlos para simplificar la migracin afuturas versiones de CourseBuilder.
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 ala primera.
Abrir
Compilar Ejecutar
5/28/2018 Manual Tecnico Para Google Course Builder Libre
5/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 4
Universidad de Alicante
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 carpetallamada coursesy dentro de ella, tantas carpetas comocursos se necesiten.
- Dentro de cada curso, se copian las carpetas asstes, data, viewy el ficherocourse.yaml. Estos archivos sern particulares para cada curso y el resto soncomunes para todos:
Aadir las rutas en el archivo app.yaml:
En la seccin env_variablesdel archivo app.yamlhay que aadir tantas reglasGCB_COURSES_CONFIGcomo cursos tengamos.
Una regla GCB_COURSES_CONFIGtiene la siguiente estructura:
GCB_COURSES_CONFIG:
course:url_prefix:localizacin_de_los_archivos_fisicos,
course:url_prefijo:localizacin_de_los_archivos_fisicos
5/28/2018 Manual Tecnico Para Google Course Builder Libre
6/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 5
Universidad de Alicante
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 ejemploque Google te proporciona.
Personalizar la pgina principal
Se necesita modificar el archivocourse.yamlpara cambiar el ttulo del curso, los textosde 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
5/28/2018 Manual Tecnico Para Google Course Builder Libre
7/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 6
Universidad de Alicante
Nota.El fichero tiene un formato rgido y es muy sensiblea tabulaciones y
caracteres especiales.
5/28/2018 Manual Tecnico Para Google Course Builder Libre
8/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 7
Universidad de Alicante
Para modificar la visualizacin de los cursoshay que recurrir a los ficheros (aunque
al principio, el directorio viewest en la lista de los archivos que te recomiendan no
modificar):
- views/base_registration.html o views/base.html: cabecera y pie parausuarios no registrados o registrados.
- views/preview.html o views/course.html: contenido del curso parausuarios 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
5/28/2018 Manual Tecnico Para Google Course Builder Libre
9/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 8
Universidad de Alicante
Unidades:
Para especificar las unidades del curso hay que editar el archivo: data/unit.csvEn l, cada filacorresponde a una unidadcon 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).
Lecciones
5/28/2018 Manual Tecnico Para Google Course Builder Libre
10/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 9
Universidad de Alicante
Lecciones:
Para especificar las unidades del curso hay que editar el archivo: data/lesson.csvEn l, cada filacorresponde a una leccincon 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 unidaddeben 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.
5/28/2018 Manual Tecnico Para Google Course Builder Libre
11/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 10
Universidad de Alicante
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.
5/28/2018 Manual Tecnico Para Google Course Builder Libre
12/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 11
Universidad de Alicante
Activity-N.M.js
- Consiste en una variableactivityque es un arrayque puede contener:o Una cadena de texto HTML
o Una pregunta
o Un Answer Information (respuestas seleccionables)
Texto
HTML
pregunta
Answer
Information
5/28/2018 Manual Tecnico Para Google Course Builder Libre
13/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 12
Universidad de Alicante
- 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,
],
]
}
o Group of multiple-choice questions
5/28/2018 Manual Tecnico Para Google Course Builder Libre
14/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 13
Universidad de Alicante
{ 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
}
o Free text
{ questionType:freetext,
correctAnswerRegex: expresin regular para comprobar si la respuesta
del alumno es correcta o no.
correctAnwerOutput: texto queaparecer 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
}
5/28/2018 Manual Tecnico Para Google Course Builder Libre
15/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 14
Universidad de Alicante
Crear assessments (graded test)
Crear un test
Cada test est en un fichero assets/js/assessment SUFFIX.js que contiene losatributos del cuestionario y sus preguntas correspondientes.
assessment SUFFIX.js
5/28/2018 Manual Tecnico Para Google Course Builder Libre
16/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 15
Universidad de Alicante
Este fichero contiene una variable assessmentque 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]- Pregunta de respuesta numrica:
correctAnswerNumeric:
- Pregunta de respuesta de texto(case-sensitive):correctAnswerString: hello
(aceptara hello y Hello como respuestas correctas, pero no hellos)
- Pregunta de respuesta de texto libre(expresin regular):correctAnswerRegex: expresin_regular
5/28/2018 Manual Tecnico Para Google Course Builder Libre
17/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
MONTAR UN CURSO CON GOOGLE COURSE BUILDER 16
Universidad de Alicante
Puntuacin (scoring)
- assets/js/activity generic.js:checkOrSubmitAnswersdetermina 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:storeAssessmentDatadetermina 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, storeAssessmentDatatambin
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.jsen assets/jspara cada cuestionario yrellenar sus atributos.
2. Aadir el assessment en su lugar correspondiente en data/unit.csvutilizandoel SUFFIXdel archivo .jspara referenciarlo.
3. Actualizar el storeAssessmentDataen controllers/assessment.pyparaaadirlo a las notas del alumno utilizando el atributo assessmentNamedel
archivo .jspara referenciarlo.
4. Actualizar el archivo views/student_profile.htmlpara que le aparezca elcuestionario al alumno en su perfil.
5. Actualizar views/test_confirmation.htmlpara mostrar un mensaje deconfirmacin apropiado para cada cuestionario.
5/28/2018 Manual Tecnico Para Google Course Builder Libre
18/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
Otros aspectos del desarrollo 17
Universidad de Alicante
Otros aspectos del desarrollo
Internacionalizacin
Se puede traducirel 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,
jija2s. Es u desarrollo de uiooc-tec.
Verificar el cdigo
Consiste en comprobar si los ficheros csvestn correctamente formados antes de subir el
curso a google.
Se ejecuta por lnea de comandos lo siguiente:
cd APPPATH
python tolos/verify.py
5/28/2018 Manual Tecnico Para Google Course Builder Libre
19/19
MANUAL TCNICO PARA GOOGLE COURSE BUILDER
Subir la aplicacin (curso) a google 18
Universidad de Alicante
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 dominioo 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 APPPATHappcfg.py update.
o Se actualizan los ficheros:
csvy course.yamlde manera inmediata
assessments, activitiesy viewstienen un retardo de 10 minutos.