asker-tool 2.1.3 → 2.2.0

data/docs/inputs/jedi.md

@@ -1,68 +0,0 @@
-
-# Jedi
-
-Inputs
-======
-
-Into *maps* directory we save our own concept map files. We could use subdirectories to
-better organization. As example we have the file `maps/demo/starwars/jedi.haml`, that
-contains one concept map about Jedi characters of StarWars film into HAML format.
-
-Let's take a look (Spanish example, I know. Soon I'll write the english version):
-```
-%map{ :lang => 'en', :context => 'character, starwars', :version => '1'}
-
-  %concept
-    %names obiwan
-    %tags jedi, teacher, annakin, skywalker, pupil, quigon-jinn
-    %def Jedi, teacher of Annakin  Skywalker
-    %def Jedi, pupil of Quigon-Jinn
-    %table{ :fields => 'attribute, value' }
-      %title Associate every attribute with their value
-      %row
-        %col race
-        %col human
-      %row
-        %col laser sabel color
-        %col green
-      %row
-        %col hair color
-        %col red
-
-  %concept
-    %names yoda
-    %tags teacher, jedi
-    %def Jedi, teacher of all jedis
-    %def The Main Teacher of Jedi and one of the most important members of the Main Jedi Council, in the last days of Star Republic.
-    %def He has exceptional combat abilities with light sable, using acrobatics tecnics from Ataru.
-    %def He was master of all light sable combat styles and was considered during years as a Sword Master.    
-    %table{ :fields => 'attribute, value' }
-      %row
-        %col color laser sabel
-        %col green
-      %row
-        %col hair color
-        %col white
-      %row
-        %col skin color
-        %col green
-      %row
-        %col high
-        %col 65 centimetres
-...
-```
-As we see, we defined 2 concepts about Jedi characters. This are `obiwan` and `yoda`.
-And we use special sintax (tags) to define it.
-
-At now we have a this list of tags to define our own sintax for build conceptual maps:
-* **context**: List of comma separated words, that identify the context where this concept "lives" or "exists".
-* **names**: List of one or more names that identify the concept. At least one is requiered, of course!.
-* **tags**: List of comma separated words, that briefly describe the concept. I mean, a short list of words
-that came in mind when we think in it, and are useful for their identification.
-* **def**: We use this tags as many times we need. In it, we write using natural language descriptions
-asssociated to the concept. This are definitions/descriptions that are uniques
-for this concept, but don't write the name of the concept into the text.
-* **table**: Other way to build more sofisticated definitions/schemas is using "tables". It's similar
-to HTML tag. I mean, with this "table", we build tables of knowledge into the concept. We use "row",
-and "col", to defines table-rows and row-cols, of course. We could see an
-example into `input/en/starwars/jedi.haml`.

data/docs/inputs/tables.md

@@ -1,112 +0,0 @@
-
-[<< back](README.md)
-
-# Learn tables
-
-Now, we are going to learn keywords:
-* table
-* row
-* col
-
-Let's go!.
-
----
-
-# Def limits
-
-We have learn that:
-* **map** serves to identify an input file.
-* **concept**, **names** and **tags** serves to identify a concept.
-* **def** serves to add meaning to a concept.
-
-But, it's not enough. **def** only contains meaning that could only be associated to one unique concept. For example:
-```
-  %concept
-    %names AC/DC, ACDC
-    %tags rock, band, australia
-    %def Australian rock band formed by Scottish-born brothers Malcolm and Angus Young
-```
-
-**def** is good but we need other keyword to add meaning that isn't uniquely associated to one concept. That is **table** keyword.
-
----
-# Tables
-
-## Table with 1 field
-
-Example, adding meaning using 1 field table. Field called `members`:
-
-```
-%concept
-  %names AC/DC, ACDC
-  %tags single, seat, leg, backrest
-  %tags rock, band, australia
-  %table{ :fields => 'members'}
-    %row Bon Scott
-    %row Angus Young
-    %row Malcolm Young
-    %row Phil Rudd
-    %row Cliff Williams
-```
-
-| Param  | Description |
-| ------ | ----------- |
-| table  | Group rows  |
-| fields | Comma separated values with field name |
-| row    | Field value |
-
-## Table with 2 fields
-
-Example, adding meaning using 2 fields table. Fields called `attribute` and `value`:
-
-```
-  %concept
-    %names AC/DC, ACDC
-    %tags single, seat, leg, backrest
-    %tags rock, band, australia
-    %table{ :fields => 'attribute, value'}
-      %row
-        %col Genres
-        %col Hard rock blues rock rock and roll
-      %row
-        %col Years active
-        %col 1973–present
-      %row
-        %col Origin
-        %col Sydney
-```
-
-| Param  | Description        |
-| ------ | ------------------ |
-| table  | Group rows         |
-| fields | Comma separated values with field names |
-| row    | Group cols         |
-| col    | Field column value |
-
-## Table with Sequence
-
-Sometimes we have a 1 field table where rows are sorted or form a sequence. In that cases we also could take advantage defining a `sequence`, like:
-
-```
-%concept
-  %names AC/DC, ACDC
-  %tags single, seat, leg, backrest
-  %tags rock, band, australia
-  %table{ :fields => 'Albums', :sequence => 'Albums sorted by date'}
-    %row Albums High Voltage
-    %row Powerage
-    %row Highway to Hell
-    %row Back in Black
-    %row Ballbreaker
-    %row Rock or Bust
-```
-
-| Param    | Description        |
-| -------- | ------------------ |
-| table    | Group rows         |
-| fields   | Field name         |
-| sequence | Label form ordered values |
-| row      | Field value        |
-
-Example:
-* [acdc.haml](../examples/bands/acdc.haml)

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
-
-* **Install** Asker:
-    1. Install Ruby on your system.
-    2. `gem install asker-tool`
-
-Run `asker version` to check that your installation is ok.
-
-> **FIND asker COMMAND**: 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.
-
-* **Update** Asker with `gem asker-tool update`.
-* **Uninstall** Asker with `gem uninstall asker-tool`
-
-> 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,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.