asker-tool 2.1.2 → 2.1.7

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.

data/docs/revise/ejemplos/README.md

@@ -1,11 +0,0 @@
-
-# Ejemplos
-
-|Ejemplo  | Descripción |
-|-------- |------------ |
-|[ejemplo 01](01/README.md) | Crear un concepto con una definición |
-|[ejemplo 02](02/README.md) | Cambiar XML por HAML |
-|[ejemplo 03](03/README.md) | Añadimos más definiciones y una imagen al concepto |
-|[ejemplo 04](04/README.md) | Incluimos más conceptos dentro del mismo mapa pero sin definirlos |
-|[ejemplo 05](05/README.md) | Añadimos definiciones a todos los conceptos del mapa |
-|[ejemplo 06](06/README.md) | Usamos tablas para añadir más información a un concepto |

data/docs/revise/projects.md

@@ -1,74 +0,0 @@
-
-*Extra configuration params*
-===========================
-
-=begin
-lConfig={ 
-	#category => :none,
-	#formula_weights => [1,1,1],
-	#outputdir => 'output',
-	#logname => 'default.log',
-	#verbose => true,
-	#:show_mode => :default
-	:outputname => 'asir1-idp1314-gift.txt',
-	:lesson_file => 'asir1-idp1314-lesson.txt',
-	:lesson_separator => ' |',
-	:inputdirs => 'input/idp', 
-	:process_file => 'idp-u1.xml'
-}
-=end
-
-
-Los parámetros más importantes son:
-* **:inputdirs**: Una lista de todos los directorios de entrada separados
-  por comas. Por defecto será *input*. Se aconseja hacer subdirectorios
-  dentro de input para organizar los ficheros XML, e incluir los subdirectorios
-  dentro de este parámetro. 
-* **:process_file**: Como los directorios de entrada pueden contener un número
-  elevado de ficheros XML (Cosa además muy recomendable), este parámetro
-  indica el nombre del fichero XML que se desea procesar en este momento.
-
-El resto no es obligatorio especificarlos, y de podrían dejar los valores por defecto.
-
-Ejemplo de script con más parámetros:
-
-	require_relative 'sys/interviewer'
-
-	lConfig={ 
-		:category => :none,
-		:formula_weights => [1,1,1],
-		:outputdir => 'output',
-		:outputname => 'default.txt',
-		:logname => 'default.log',
-		:verbose => true,
-		:show_mode => :full
-		:lesson_file => 'lesson.txt',
-		:lesson_separator => ' |',
-		:inputdirs => 'input/idp,input/etc', 
-		:process_file => 'commands.xml'
-	}
-
-	Interviewer.instance.run(lConfig)
-
-Pero si quieres saber más, ahí van otros parámetros que podemos configurar 
-al ejecutar la herramienta:
-* **:outputdir**: Nombre del directorio de salida. Por defecto será *output*.
-* **:outputname**: Nombre del fichero de salida donde se guardarán las preguntas
-  generadas.
-* **:lesson_file**: Cuando se indica este parámetro se crea un fichero de 
-  salida con el contenido de los conceptos en modo texto.
-* **:lesson_separator**: Por defecto es |. Es un caracter separador para las
-  distintas columnas de las tablas.
-* **:category**: Nombre de la categoría Moodle donde se cargarán las preguntas.
-  Por defecto no se establece ninguna categoría Moodle.
-* **:formula_weights**: Son pesos que se utilizarán en la fórmula que calcula
-  la proximidad o cercanía entre dos conceptos diferentes.
-* **:logname**: Nombre del fichero de log. Este fichero registra las acciones
-  realizadas por script. Por defecto toma el valor *default.log*.
-* **:verbose**: Si es *true* se emiten mensajes por pantalla de los pasos
-  realizados. Por defecto toma el valor *true*.
-* **:show_mode**: Cuando la herramienta termina muestra por pantalla un resumen
-  de los datos procesados. El valor por defecto es *:default*. Además acepta
-  los valores *:none* para no mostrar salida, y *:resume* que muestra un
-  breve resumen.
-

data/lib/asker/code/ai/base_code_ai.rb

@@ -1,48 +0,0 @@
-
-require_relative '../../lang/lang_factory'
-require_relative '../../ai/question'
-
-class BaseCodeAI
-  def name
-    File.basename(@data_object.filename)
-  end
-
-  def num
-    @num += 1
-  end
-
-  def clone_array(array)
-    out = []
-    array.each { |item| out << item.dup }
-    out
-  end
-
-  def lines_to_s(lines)
-    out = ''
-    lines.each_with_index do |line,index|
-      out << "%2d: #{line}\n"%(index+1)
-    end
-    out
-  end
-
-  def lines_to_html(lines)
-    out = ''
-    lines.each_with_index do |line,index|
-      out << "%2d: #{line}</br>"%(index+1)
-    end
-    out
-  end
-
-  def find_make_methods
-    list = self.public_methods.sort
-    list.select! { |name| name.to_s.start_with? 'make_'}
-    list.delete(:make_questions)
-    list
-  end
-
-  def make_questions
-    list = find_make_methods
-    list.each { |m| @questions += self.send m }
-    @questions
-  end
-end

data/lib/asker/code/code.rb

@@ -1,53 +0,0 @@
-require_relative 'ai/code_ai_factory'
-require_relative '../project'
-require_relative '../formatter/code_string_formatter'
-
-# Contains code data input
-class Code
-  attr_reader :dirname, :filename, :type
-  attr_accessor :process, :features
-  attr_reader :lines, :questions
-
-  def initialize(dirname, filename, type)
-    @dirname = dirname
-    @filename = filename
-    @type = type
-    @filepath = File.join(@dirname, @filename)
-    @process = false
-    @features = []
-    @lines = load(@filepath)
-    @questions = []
-    @code_ai = CodeAIFactory.get(self)
-  end
-
-  def process?
-    @process
-  end
-
-  def make_questions
-    return unless process?
-    @questions += @code_ai.make_questions
-  end
-
-  def lines_to_s(lines)
-    out = ''
-    lines.each_with_index do |line, index|
-      out << format("%2d| #{line}\n", (index + 1))
-    end
-    out
-  end
-
-  def debug
-    out = CodeStringFormatter.to_s(self)
-    p = Project.instance
-    p.verbose out
-  end
-
-  private
-
-  def load(filepath)
-    return if filepath.nil?
-    content = File.read(filepath)
-    content.split("\n")
-  end
-end

data/lib/asker/exporter/concept_ai_screen_exporter.rb

@@ -1,115 +0,0 @@
-# frozen_string_literal: true
-
-require 'terminal-table'
-
-# Show ConceptAI info on screen
-class ConceptAIScreenExporter
-  def self.export_all(concepts_ai)
-    @concepts_ai = concepts_ai
-	  project = Project.instance
-    return if project.show_mode == :none
-
-    # Create table HEAD
-    screen_table = Terminal::Table.new do |st|
-      st << ['Concept','Questions','Entries','xFactor',
-             'd','b','f','i','s','t']
-      st << :separator
-    end
-
-    # Create table BODY
-    total = {}
-    total[:q] = total[:e] = total[:c] = 0
-    total[:sd] = total[:sb] = total[:sf] = 0
-    total[:si] = total[:ss] = total[:st] = 0
-
-    @concepts_ai.each do |concept_ai|
-      if concept_ai.process?
-        e = concept_ai.texts.size
-        concept_ai.tables.each { |t| e += t.fields.size * t.rows.size }
-
-        sd = concept_ai.questions[:d].size
-        sb = concept_ai.questions[:b].size
-        sf = concept_ai.questions[:f].size
-        si = concept_ai.questions[:i].size
-        ss = concept_ai.questions[:s].size
-        st = concept_ai.questions[:t].size
-        t = sd + sb + sf + si + ss + st
-
-        if e == 0
-          factor = 'Unkown'
-        else
-          factor = (t.to_f/e.to_f).round(2).to_s
-        end
-        screen_table.add_row [Rainbow(concept_ai.name(:screen)).green.bright,
-          t, e, factor, sd, sb, sf, si, ss, st]
-
-        total[:q] += t ; total[:e] += e; total[:c] += 1
-        total[:sd] += sd; total[:sb] += sb; total[:sf] += sf
-        total[:si] += si; total[:ss] += ss; total[:st] += st
-      end
-    end
-    return if total[:c] == 0 # No concepts to be process?
-
-    # Add row with excluded questions
-    export_excluded_questions(screen_table, @concepts_ai)
-
-    # Create table TAIL
-    screen_table.add_separator
-    screen_table.add_row [Rainbow("TOTAL = #{total[:c]}").bright,
-                          Rainbow(total[:q].to_s).bright,
-                          Rainbow(total[:e].to_s).bright,
-                          Rainbow((total[:q].to_f/total[:e].to_f).round(2)).bright,
-                          total[:sd], total[:sb], total[:sf],
-                          total[:si], total[:ss], total[:st]]
-    export_notes
-    project.verbose screen_table.to_s + "\n"
-  end
-
-  def self.export_excluded_questions(screen_table, concepts_ai)
-    # Create table BODY
-    total = {}
-    total[:q] = total[:c] = 0
-    total[:sd] = total[:sb] = total[:sf] = 0
-    total[:si] = total[:ss] = total[:st] = 0
-
-    concepts_ai.each do |concept_ai|
-      if concept_ai.process?
-        sd = concept_ai.excluded_questions[:d].size
-        sb = concept_ai.excluded_questions[:b].size
-        sf = concept_ai.excluded_questions[:f].size
-        si = concept_ai.excluded_questions[:i].size
-        ss = concept_ai.excluded_questions[:s].size
-        st = concept_ai.excluded_questions[:t].size
-        t = sd + sb + sf + si + ss + st
-
-        total[:q] += t ; total[:c] += 1
-        total[:sd] += sd; total[:sb] += sb; total[:sf] += sf
-        total[:si] += si; total[:ss] += ss; total[:st] += st
-      end
-    end
-    screen_table.add_row [Rainbow('Excluded questions').yellow.bright,
-                          total[:q], '-', '-',
-                          total[:sd], total[:sb],
-                          total[:sf], total[:si],
-                          total[:ss], total[:st]]
-  end
-
-  def self.export_notes
-    p = Project.instance
-    p.verbose "\n[INFO] Showing CONCEPT statistics\n"
-    p.verbose ' * Exclude questions: ' +
-              Application.instance.config['questions']['exclude'].to_s
-    p.verbose ' * Annotations:'
-    p.verbose '   ├── (d) Definitions     <= Concept.def'
-    p.verbose '   ├── (b) Table Matching  <= ' \
-              'Concept.table.rows.columns'
-    p.verbose '   ├── (f) Tables 1 Field  <= Concept.table.fields.size==1'
-    p.verbose '   ├── (i) Images URL      <= ' \
-              "Concept.def{:type => 'image_url'}"
-    p.verbose '   ├── (s) Sequences       <= ' \
-              "Concept.table{:sequence => '...'}"
-    p.verbose '   └── (t) Table Rows&Cols <= ' \
-              'Concept.table.rows.columns'
-    p.verbose "\n"
-  end
-end