asker-tool 2.1.2 → 2.1.7

data/docs/inputs/templates.md

@@ -1,87 +0,0 @@
-
-[<< back](README.md)
-
-# Learn templates
-
-Now, we are going to learn `template` keyword.
-
----
-
-# Powerfull tables
-
-Table is usefull keyword to add information associated to concepts using table struct (That means with rows and columns scheme).
-
-## Example 01: repetitive rows
-
-Let's see this repetitive row example about OS commands:
-
-```
-  %concept
-    %names command
-    %tags computing,directive,computer,perform,specific,task
-    %def In computing, is a directive to a computer program to perform a specific task.
-    %table{:action, :description}
-      %row
-        %col mkdir Endor
-        %col Create Endor directory
-      %row
-        %col mkdir Naboo
-        %col Create Naboo directory
-      %row
-        %col mkdir Dagobah
-        %col Create Dagobah directory
-```
-
-## Example 02: Using template
-
-To be more productive, we could use `template` keyword.
-
-```
-  %concept
-    %names command
-    %tags computing,directive,computer,perform,specific,task
-    %def In computing, is a directive to a computer program to perform a specific task.
-    %table{:action, :description}
-      %template{:DIRNAME => 'Endor,Naboo,Dabobah'}
-        %row
-          %col mkdir DIRNAME
-          %col Create DIRNAME directory
-```
-
-We see example 01 produce the same result, but with less input lines.
-Template will be apply to every definition inside.
-
-| Param    | Description |
-| -------- | ----------- |
-| template | Begin template definition |
-| DIRNAME | Token o variable that will be replaced with value list |
-| Endor,Naboo,Dagobah |Comma separated value list |
-
-## Example 03: Going crazy
-
-```
-  %concept
-    %names command
-    %tags computing,directive,computer,perform,specific,task
-    %def In computing, is a directive to a computer program to perform a specific task.
-    %table{:action, :description}
-      %template{:NAME => 'Endor,Naboo,Dabobah'}
-        %row
-          %col mkdir NAME
-          %col Create NAME directory
-        %row
-          %col rmdir NAME
-          %col Delete NAME directory
-        %row
-          %col touch NAME
-          %col Create NAME file
-        %row
-          %col rm NAME
-          %col Delete NAME file
-        %row
-          %col useradd NAME
-          %col Create user NAME
-        %row
-          %col userdel NAME
-          %col Delete user NAME
-```

data/docs/install/README.md

@@ -1,38 +0,0 @@
-
-[<< back](../../README.md)
-
-# Installation
-
-* Installation process:
-    1. Install Ruby on your system.
-    2. `gem install asker-tool`
-* Run `asker version` to check that your installation is ok.
-
-> **PROBLEMS**: If you have problems to find `asker`command (OpenSUSE distro), try this:
-> * `find / -name asker`, to find absolute path to teuton command.
-> * As superuser do `ln -s /PATH/TO/bin/asker /usr/local/bin/asker`, to create symbolic link to asker command.
-> * Try again as normal user.
-
-* **Update** Asker with `gem asker update`.
-* **Uninstall** Asker with `gem uninstall asker`
-
-> Others ways to install Asker:
-> * [Installation scripts](scripts.md)
->* [Manual installation](manual.md)
-
----
-# Configuring Asker
-
-There exist `config.ini`file, into Asker base directory with some configurable options.
-
-| Section     | Param    | Default | Values    | Description |
-| ----------- | -------- | ------- | --------- | ----------- |
-| [global]    | internet | no      | yes or no | Accept to connect Google and download find images URLs |
-| [questions] | exclude  |         | Comma separated strings| Exclude questions with this texts into their names |
-
----
-# Download input examples
-
-If you want to download our repository with asker input files:
-
-`git clone https://github.com/dvarrui/asker-inputs.git`

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,26 +0,0 @@
-
-[<< back](README.md)
-
-# Using installation scripts
-
-## GNU/Linux installation script
-
-Run as `root` user:
-```
-wget -qO- https://raw.githubusercontent.com/dvarrui/asker/devel/install/linux_asker_install.sh | bash
-```
-
-Run `asker version` as normal user.
-
-## Windows installation script
-
-Requirements:
-* Windows 7+ / Windows Server 2003+
-* PowerShell v2+
-
-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/davel/install/windows_asker_install.ps1'))
-```
-
-Run `asker version` as normal user.

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.