asker-tool 2.1.2

data/docs/inputs/jedi.md

@@ -0,0 +1,68 @@
+
+# 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

@@ -0,0 +1,112 @@
+
+[<< 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

@@ -0,0 +1,87 @@
+
+[<< 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

@@ -0,0 +1,38 @@
+
+[<< 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

@@ -0,0 +1,26 @@
+
+[<< 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

@@ -0,0 +1,26 @@
+
+[<< 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

@@ -0,0 +1,41 @@
+
+> **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

@@ -0,0 +1,30 @@
+
+
+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

@@ -0,0 +1,35 @@
+
+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