asker-tool 2.1.3 → 2.1.5

data/docs/install/manual.md

@@ -1,26 +0,0 @@
-
-[<< back](README.md)
-
-# Manual installation
-
-1. Git installation
-    * Install Git.
-    * Run `git --version` to show current version
-1. Ruby installation
-    * Install ruby.
-    * Run `ruby -v` to show current version
-1. Rake installation
-    * Run `gem install rake`, then
-    * `rake --version` to show current version.
-1. Download this project
-    * (a) `git clone https://github.com/dvarrui/asker.git` or
-    * (b) Download and unzip [file](https://github.com/dvarrui/asker/archive/master.zip).
-1. Move into repo folder
-    * Run `cd asker`
-1. Gems installation.
-    * `rake install:gems`, to install required gems.
-1. Only for developers
-    * Run `rake install:debian` or
-    * `rake install:opensuse`, install gem for developers.
-1. Final check
-    * `rake`

data/docs/install/scripts.md

@@ -1,38 +0,0 @@
-
-[<< back](README.md)
-
-# Installation scripts
-
----
-## GNU/Linux
-
-**Install**: Run as `root` user.
-```
-wget -qO- https://raw.githubusercontent.com/dvarrui/asker/devel/install/linux/install_asker.sh | bash
-```
-
-Run `asker version` as normal user.
-
-**Uninstall**: Run as `root` user.
-```
-wget -qO- https://raw.githubusercontent.com/dvarrui/asker/devel/install/linux/uninstall_asker.sh | bash
-```
-
----
-## Windows
-
-Requirements:
-* Windows 7+ / Windows Server 2003+
-* PowerShell v2+
-
-**Install**: Run this coomand as Administrator user on PowerShell (PS):
-```
-Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/dvarrui/asker/devel/install/windows/install_asker.ps1'))
-```
-
-Run `asker version` as normal user.
-
-**Uninstall**: Run this coomand as Administrator user on PowerShell (PS):
-```
-Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/dvarrui/asker/devel/install/windows/uninstall_asker.ps1'))
-```

data/docs/revise/asker-file.md

@@ -1,41 +0,0 @@
-
-> **Output file format**
->
-> * At this moment, the output text file format is GIFT. But in the
-future will be posible to choose between several output formats.
-> * The GIFT format is very common format in elearning software as Moodle.
-
-# Demo
-
-Vamos a ver un ejemplo.
-
----
-
-## Input (Mapa conceptual)
-
-Primero hay que crear un fichero de entrada con el mapa conceptual que queremos
-trabajar. Vamos a usar de ejemplo [`input/es/demo/jedi.haml`](../../../input/es/demo/jedi.haml)
-
----
-
-## Ejecutar el programas
-
-Para ejecutar el programa *darts* con este fichero de entrada hacemos:
-```
-$ ./darts input/es/demo/jedi.yaml
-```
-
-Veremos en pantalla la siguiente [información](./jedi-log.txt).
-
-Este informe muestra qué tal ha ido el proceso de generación, mostrando
-estadísticas al final.
-
----
-
-## Output
-
-En el directorio `output` se guardan los ficheros de salida.
-
-* [Fichero con las preguntas](./jedi-gift.txt) en formato GIFT.
-* [Fichero con log del proceso](./jedi-log.txt).
-* [Fichero con los contenidos](./jedi-doc.txt) en formato TXT más legible.

data/docs/revise/buenas-practicas/01-convocatoria.md

@@ -1,30 +0,0 @@
-
-
-La presente convocatoria tiene por objeto la detección, supervisión, reconocimiento y difusión de las buenas prácticas docentes, como actividades de interés educativo, entendiendo como tales aquellas que forman parte del trabajo diario y habitual del docente, que deberán poseer las siguientes características:
-
-1. Innovadoras, aquellas que ponen en práctica diferentes modelos de enseñanza desde un enfoque competencial.
-2. Eficaces y eficientes, aquellas que generan un impacto positivo y tangible en el proceso de enseñanza y aprendizaje.
-3. Sostenibles, aquellas que hacen uso de recursos personales y materiales que hacen posible su continuidad en el tiempo.
-4. Transferibles, aquellas cuya aplicación son viables en otros centros y enseñanzas.
-
-
-
-1. El docente que desee participar en la presente convocatoria deberá presentar solicitud de participación y descripción de la buena práctica.
-
-2. Relación de documentación a presentar, demostrativa de los rasgos habituales del quehacer profesional del docente:
-
-    • Programación didáctica del área, materia, ámbito o módulo cuya buena práctica se presenta.
-    • Unidad didáctica, unidad de programación, unidad de trabajo o situación de aprendizaje correspondiente a la experiencia de enseñanza y aprendizaje realizada.
-    • Evidencias de cada uno de los apartados de la rúbrica de evaluación.
-
-La documentación se presentará exclusivamente por medios electrónicos (ficheros en formato pdf y rutas de acceso a espacios donde estén alojados ficheros de audio y/o vídeo) y se corresponderá con la información referida en el Anexo II. (Acceder al Formulario de solicitud).
-
-3. Conforme al artículo 83 de la Ley 39/2015, de 1 de octubre, del Procedimiento Administrativo Común de las Administraciones Públicas, para la presentación de solicitudes se establece el plazo de un mes a contar a partir de la publicación del anuncio en el Boletín Oficial de Canarias.
-
-- Fecha de publicación: 2-11-2018.
-
-Presentación de solicitudes: hasta el 2 de diciembre de 2018.
-
-Convocatoria.
-
-    Resolución de 24 de octubre de 2018 (BOC Nº 212. Viernes 2 de Noviembre de 2018).

data/docs/revise/buenas-practicas/02-formulario.md

@@ -1,35 +0,0 @@
-
-FORMULARIO DE PRESENTACIÓN DE
-SOLICITUDES PARA LA CONVOCATORIA DE LA VICECONSEJERÍA DE EDUCACIÓN Y UNIVERSIDADES PARA EL PROCEDIMIENTO DE DETECCIÓN, SUPERVISIÓN, RECONOCIMIENTO Y DIFUSIÓN DE BUENAS PRÁCTICAS EN LOS PROCESOS DE ENSEÑANZA Y APRENDIZAJE DURANTE EL CURSO ESCOLAR 2018/2019
-
----
-
-* Para cumplimentar correctamente la solicitud deberá contestar todas los apartados solicitados en las dos secciones principales de la presente convocatoria:
-
-a) Datos generales de la buena práctica
-
-b) Criterios que cumple la buena práctica (podrá adjuntar una evidencia para cada criterio)
-
-> No se dará por presentada la solicitud hasta que Vd. no haga clic en "Confirmar Solicitud", hasta ese momento podrá modificar los datos que ya ha introducido.
-
-* Una vez que confirme la solicitud, no podrá modificarla, ni aportar evidencias. Si quisiera modificar la solicitud confirmada tendrá que ponerse en contacto con uno de los siguientes teléfonos: 928455492 / 928455453, y solamente si la convocatoria tiene el plazo de inscripción abierto.
-
-Seleccione la opción que desee:
-
-* Crear Solicitud/Modificar
-* Consultar estado de la solicitud
-
-> Problemas con este aplicativo web: 928 45 54 92 / 53
-
----
-
-NO SE DARÁ POR PRESENTADA SU SOLICITUD HASTA QUE VD. NO HAGA CLIC EN EL BOTÓN "CONFIRMAR SOLICITUD" DISPUESTO AL FINAL DE ESTA PÁGINA.
-
-Para la correcta presentación de su Buena Práctica deberá cumplimentar los datos solicitados en los dos apartados siguientes:
-
-CUMPLIMENTAR LOS DATOS INICIALES	CUMPLIMENTAR LOS CRITERIOS
-RECUERDE QUE NO TIENE PRESENTADA LA SOLICITUD HASTA QUE VD. HAGA CLIC EN EL BOTÓN "CONFIRMAR SOLICITUD". UNA VEZ CONFIRMADA NO PODRÁ MODIFICAR LOS DATOS.
-
-Problemas con este aplicativo web: 928 45 54 92 / 53
-
-ImprimirVolver

data/docs/revise/buenas-practicas/03-descripcion.md

@@ -1,63 +0,0 @@
-
-
-# Descripción de la práctica
-
-**darts-of-teacher** es un programa informático de licencia Open Source,
-que ayuda al profesor a crear una gran cantidad de preguntas
-de forma sencilla, a partir de una mapa conceptual.
-
-Los pasos son:
-1. El profesor crea un fichero con el mapa conceptual que quiere trabajar.
-2. Ejecutamos el programa *darts*.
-3. La aplicación lee el fichero de entrada y crea un fichero de salida con las preguntas del tema o unidad didáctica.
-
----
-
-# El problema de corregir
-
-Como profesor, una de las tareas más aburridas es corregir el mismo ejercicio
-repetido a cada alumno del grupo, todos los años igual. Los cuestionarios
-tipo test son actividades para los que ya existen aplicaciones que los corrigen
-de forma automática. Por ejemplo, tenemos los cuestionarios de la plataforma
-de e-learning Moodle.
-
-En estos casos, el profesor dispone de tiempo para emplearlo en el análisis de
-los resultados obtenidos. Y para aplicar dicho conocimiento en la mejora del
-trabajo, intentado nuevas formas de hacer las cosas, crear nuevas actividades
-o modificar las existentes o depurar el contenido de los temas, para
-encontrar una manera de mejorar el proceso de enseñanza-aprendizaje.
-
----
-
-# El problema de crear preguntas
-
-El gran problema con los cuestionarios tipo test es que sólo son útiles para
-evaluar características medibles o cuantificables. De modo que podemos
-estar limitados si queremos evaluar aspectos más abstractos o generales.
-Pero podemos enfocar este problema desde otro punto de vista. Veamos.
-
-Si tengo un problema abierto y abstracto, su solución tendrá un conjunto de
-pasos o hítos que pueden ser medibles. De modo que podemos transformar
-un problema abierto en un conjunto de muchos microproblemas cerrados.
-Y ahí es donde vamos a concentrar nuestra atención para medir esas
-características cuantificables.
-
-Además, si "bombardeamos" al estudiante con una gran cantidad de preguntas
-diferentes sobre el mismo concepto, probablemente podremos estar cerca de
-conocer/medir el grado de asimilación por parte del estudiante de dichos
-conceptos.
-
-El problema que teníamos de dedicar tiempo a corregir lo hemos eliminado
-pero ahora tenemos el problema de dedicar tiempo a crear las preguntas.
-
----
-
-# La solución
-
-Para resolver el problema de crear las preguntas tenemos **darts-of-teacher**.
-Este programa multiplataforma de licencia libre se encarga de crear
-cientos de preguntas por nosotros a partir de un mapa conceptual de la unidad
-o del tema que queramos trabajar.
-
-Podemos descargar la aplicación del siguiente URL:
-https://github.com/dvarrui/darts-of-teacher

data/docs/revise/buenas-practicas/04-resultados.md

@@ -1,17 +0,0 @@
-
-# Resultados
-
-## Para el profesor
-
-Con la herramienta **darts-of-teacher** el profesor consigue reducir drásticamente
-el tiempo necesario para crear bancos de preguntas de los cuestionarios.
-
-Si manualmente se puede tardar 1 mes en hacer 500 preguntas, con
-**darts-of-teacher** tardamos 30 minutos.
-
-El profesor está más feliz porque no pierde tanto tiempo.
-
-## Para los alumnos
-
-Los alumnos están contentos de que algunas (no todas) de las actividades
-sean cuestionarios puesto que de esta forma consiguen un feedback inmediato.

data/docs/revise/buenas-practicas/05-reproducir.md

@@ -1,10 +0,0 @@
-
-# Para reproducir la práctica docente
-
-1. Ir a la web del proyecto: https://github.com/dvarrui/darts-of-teacher
-2. Leer la documentación para instalar el programa.
-3. Aprender a usar la herramienta:
-    * Leer la documentación.
-    * Consultar los ejemplos para saber cómo empezar.
-    * Ver los vídeos de YouTube y/o
-    * Consultar con <dvarrui@gmail.com>.

data/docs/revise/ejemplos/01/README.md

@@ -1,27 +0,0 @@
-
-# Ejemplo 01
-
-Vamos crear un concepto sobre los personajes de StarWars.
-
-## Input
-
-Creamos el fichero [`starwars.xml`](./starwars.xml),
-con el concepto `obiwan` con una definición.
-
-> Entendemos por `definición` una descripción textual que identifica de
-forma inequívoca al concepto al que se refiere.
-
-## Ejecución
-
-Para ejecutar *darts* usando como entrada el fichero las definiciones del concepto,
-hacemos:
-
-`./darts file docs/es/ejemplos/01/starwars.xml`,
-
-Vemos que aparece en pantalla la siguiente [información](./starwars.xml-log.txt).
-
-## Output
-
-Dentro del directorio `output`, se han creado varios ficheros de salida.
-Entre ellos, el fichero [starwars-gift.txt](./starwars-gift.txt) con las preguntas
-en formato Gift, preparadas para cargarse en un cuestionario como los de Moodle.

data/docs/revise/ejemplos/02/README.md

@@ -1,31 +0,0 @@
-
-# Ejemplo 02
-
-En el ejemplo anterior usamos un fichero en formato XML, en este ejemplo vamos
-a usar el mismo contenido pero usando formato HAML.
-
-HAML produce un XML equivalente. La diferencia está en que no hay etiquetas
-de cierre, las etiquetas comenzan por % y para crear anidamiento se usan 2 espacios.
-
-## Input
-
-Vamos ahora el fichero fichero del ejercicio anterior [`starwars.haml`](./starwars.haml)
-pero en formato HAML, con el concepto `obiwan` con una definición.
-
-> Entendemos por `definición` una descripción textual que identifica de
-forma inequívoca al concepto al que se refiere.
-
-## Ejecución
-
-Para ejecutar *darts* usando como entrada el fichero las definiciones del concepto,
-hacemos:
-
-`./darts file docs/es/ejemplos/02/starwars.haml`,
-
-Vemos que aparece en pantalla la siguiente [información](./starwars-log.txt).
-
-## Output
-
-Dentro del directorio `output`, se han creado varios ficheros de salida.
-Entre ellos, el fichero [starwars-gift.txt](./starwars-gift.txt) con las preguntas
-en formato Gift, preparadas para cargarse en un cuestionario como los de Moodle.

data/docs/revise/ejemplos/03/README.md

@@ -1,31 +0,0 @@
-
-# Ejemplo 03
-
-Vamos a ampliar las definiciones del concepto `obiwan`.
-
-## Input
-
-Hemos modificado el fichero [`starwars.haml`](./starwars.haml),
-ampliando las definiciones del concepto `obiwan`.
-
-Además hemos incluido
-una definición de tipo `image_url`. Esto es, un URL a una imagen, la cual
-identifica de forma inequívoca el conceto al cual se refiere.
-
-> Por tanto, podemos tener definiciones de texto y URL a una imagen.
-
-## Ejecución
-
-Para ejecutar *darts* usando como entrada el fichero con los conceptos, hacemos:
-
-`./darts file docs/es/ejemplos/03/starwars.haml`
-
-Vemos que aparece en pantalla la siguiente [información](./starwars-log.txt).
-
-## Output
-
-Se ha generado este [fichero](./starwars-gift.txt) con las preguntas en
-format Gift, preparadas para cargarse en Moodle.
-
-> Podemos comprobar como al aumentar las definiciones aumenta significativamente
-el número de preguntas que se generan.

data/docs/revise/ejemplos/04/README.md

@@ -1,37 +0,0 @@
-
-# Ejemplo 04
-
-Vamos a incluir más conceptos que tengan que ver con personajes de starwars
-dentro del mismo mapa.
-
-## Input
-
-Consultar el fichero [`starwars.haml`](./starwars.haml) de entrada,
-con los nuevos conceptos.
-
-Hemos incluido en cada concepto una etiqueta con el nombre "tags". tags es una
-lista de términos que ayuda a definir el concepto. Es como una nube de palabras.
-Esta lista (tags) se usa para evaluar cuańto de cerca está la definición de un
-concepto con respecto a otro semánticamente. Bueno, es una aproximación.
-
-Esta valor de distancia semántica entre conceptos ayuda a formar preguntas
-más difíciles para el alumno, proponiéndole varias alternativas, no al azar, sino
-aquellas que tengan una "semántica" más parecida.
-
-Cuantos más conceptos tenga el mapa, más complejas serán las preguntas y más
-difícil responder al alumno.
-
-## Ejecución
-
-Para ejecutar *darts* usando como entrada el fichero con los conceptos, hacemos:
-
-`./darts file docs/es/ejemplos/04/starwars.haml`
-
-Vemos que aparece en pantalla la siguiente [información](./starwars-log.txt).
-
-## Output
-
-Se ha generado este [fichero](./starwars-gift.txt) con las preguntas en
-format Gift, preparadas para cargarse en Moodle.
-
-Podemos comprobar como al incluir más conceptos aumentan las preguntas.

data/docs/revise/ejemplos/05/README.md

@@ -1,25 +0,0 @@
-
-# Ejemplo 05
-
-Vamos a ampliar aún más el mapa conceptual añadiendo definiciones a todos
-los conceptos del mapa.
-
-## Input
-
-Hemos modificado el fichero [`starwars.haml`](./starwars.haml),
-añadiendo definiciones al resto de conceptos del mapa.
-
-## Ejecución
-
-Para ejecutar *darts* usando como entrada el fichero con los conceptos, hacemos:
-
-`./darts file docs/es/ejemplos/05/starwars.haml`
-
-Vemos que aparece en pantalla la siguiente [información](./starwars-log.txt).
-
-## Output
-
-Se ha generado este [fichero](./starwars-gift.txt) con las preguntas en
-format Gift, preparadas para cargarse en Moodle.
-
-Al incluir más conceptos aumenta el número de preguntas que se generan.

data/docs/revise/ejemplos/06/README.md

@@ -1,43 +0,0 @@
-
-# Ejemplo 06
-
-Vamos a ampliar aún más el concepto `obiwan`, pero ahora vamos a incluir
-nueva información en forma de "tablas".
-
-## Input
-
-Hemos modificado el fichero [`starwars.haml`](./starwars.haml),
-ampliando la información del concepto `obiwan` con "tablas". Éstas sirven
-para incluir nueva información que acompaña al concepto pero
-que no puede ser "definición" porque no identifica al concepto
-(No es un valor único de dicho concepto).
-
-> Usamos **definiciones** para representar información que sólo posee dicho concepto.
-Es informacion única para él.
-> Usamos las **tablas** para representar información asociada al concepto pero
-no de forma única. Estos datos se pueden repetir en otros conceptos del mapa conceptual.
-
-Por ejemplo, vamos a añadir "tabla" con información de "atributo,valor".
-Esto es un conjunto de atributos del personaje "obiwan" junto con el valor de
-cada uno.
-
-Las "tablas" pueden tener tienen uno o dos campos. Cada campo tiene que tener
-un nombre.
-
-> En el futuro se podrán hacer tablas con más de 2 campos. Por ahora, no.
-
-## Ejecución
-
-Para ejecutar *darts* usando como entrada el fichero con los conceptos, hacemos:
-
-`./darts file docs/es/ejemplos/06/starwars.haml`
-
-Vemos que aparece en pantalla la siguiente [información](./starwars-log.txt).
-
-## Output
-
-Se ha generado este [fichero](./starwars-gift.txt) con las preguntas en
-format Gift, preparadas para cargarse en Moodle.
-
-> Podemos comprobar como al incluir las tablas sigue aumentando
-el número de preguntas que se generan.