Manual Tecnico Para Google Course Builder Libre

Embed Size (px)

Citation preview

  • 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.