Ayuda:Quiz

Esta es la página de ayuda para la extensión Quiz.

La extensión Quiz consiste en un marcado muy simple. Esta página es larga debido a las posibilidades que ofrece. Para una guía más simple visita la página con la introducción a los formatos de preguntas de la extensión Quiz.

Información general

Versión

La versión 1.0 de la extensión Quiz está^{(20 May 2007)}activa en Wikiversidad.
Esta documentación cubre las principales características y la mayoría de las características menores.
Algunas características exóticas aun no están cubiertas, como el control aleatorio usando las etiquetas {X} {!X} {/X}.

Consideraciones pedagógicas

¿Dónde están las debilidades y fortalezas de las pruebas en Wikiversidad?
¿Cómo puedes usar de la mejor manera la extensión Quiz como herramienta de enseñanza?

Como insertar una prueba en una página

La etiqueta quiz

wiki texto
(lo que escribes)

renderizado
(lo que ves)

comentarios

<quiz>
inserte pregunta aquí
</quiz>

La etiqueta quiz hace lo siguiente:

Inserta algunas opciones de prueba estandar hasta arriba y una clave de colores para marcar. La clave solo aparece cuando la pregunta esta marcada.
Añade un botón de "enviar" al fondo para cuando el estudiante haya finalizado la prueba y quiera marcarlo.
Todo lo que esté entre las etiquetas quiz sera interpretado por la extensión y se convertirá en pregunta si es posible.

Teóricamente es posible poner la etiqueta quiz alrededor de cada pregunta individual, permitiendo al estudiante marcar cada una en un turno.

Preguntas aleatorias : si el botón de preguntas aleatorias se muestra,las preguntas pueden cambiar de orden presionando el botón. Esto solo funciona mientras el aplicante no haya contestado las preguntas. Una vez que el aplicante empieza, el orden se bloquea.

<quiz display=simple>
inserte pregunta aquí
</quiz>

Importante: la adición de "display=simple" como atributo en la etiqueta quiz remueve la tabla de puntos en la parte superior.
Esto es útil para para pruebas cortas, y especialmente para situaciones donde se inserta una sola pregunta entre bloques de texto.

<quiz shuffle=none>
inserte pregunta aquí
</quiz>

Si deseas mantener la table de puntos pero eliminar el botón para preguntas aleatorias, usa shuffle=none como se muestra.

Insertar preguntas

Los tipos de preguntas se muestran más abajo. Es importante tener en cuenta que debe haber una línea en blanco entre cada pregunta, de lo contrario se mostrarán como una sola.

Cómo usar los ejemplos

En los ejemplos de esta página, hay tanto wikitexto como renderizado. El wikitexto muestra el código, que puedes copiar y pegar en tus páginas, o simplemente aprenderlo. El renderizado permite ver el resultado final.

Copiar y pegar

El código se ha simplificado ligeramente para facilitar la comprensión. Si lo copias, es necesario insertar las etiquetas <quiz> antes y </quiz> al final. Puede ser conveniente usar la opción "display=simple" como explicado anteriormente.

En los ejemplos a continuación se han usado tablas por claridad. Si una actividad o quiz se inserta en una tabla, la apariencia cambia; por ejemplo, aparece un recuadro alrededor de ciertos elementos. Si no se usa la tabla, estos recuadros desaparecen y tendrá un diseño más sencillo.

Después de copiar un código, asegúrate de que todos los símbolos están alineados con el margen izquierdo, es decir, que no hay espacios, ya que podría generar errores de formato.

Demostraciones

Todos los ejemplos de esta sección deberían functionar. No dudes en probarlos haciendo clic en "Enviar".

Tipos básicos de preguntas

Opción múltiple / respuesta única

wiki texto

renderizado

comentarios

{Pregunta
|type="()"}
+ Respuesta correcta.
- Distractor.
- Distractor.
- Distractor.

Este tipo de pregunta permite una sola respuesta correcta y cualquier numero de distractores (3 distractores son mostrados, pero pueden ser uno, o nueve, o cualquier otro número).
La respuesta correcta puede estar en cualquier posición, y está marcada con un signo de mas. Los distractores están marcados con un signo de menos.
El wiki texto mostrado puede ser insertado entre las etiquetas <quiz> como se muestra arriba.
Las respuestas aparecen en el mismo orden que en las marcas, así que es recomendable cambiar su orden antes de ponerlas en las marcas.
Cada símbolo, como |, +, - y cualquier otro símbolo listado mas abajo, debe estar en una nueva línea.
Los símbolos deben empezar la nueva linea —sin espacios antes de ellos—.
Los bordes son resultado del borde alrededor de la wiki tabla. Son opcionales.
Un distractor es un término estándar para una opción de elección múltiple que es errónea. * El simbolo () en el atributo type se supone parecido a un botón circular.
Un segundo click en un botón circular (uno click en un botón ya seleccionado) lo deseleccionara.

Preguntas de Verdadero/Falso

wiki texto

renderizado

comentarios

{Bulgaria y Rumania se unieron a
la Unión Europea en 2007.
|type="()"}
+ VERDADERO.
- FALSO.

{Suiza es un miembro de
la Unión Europea.
|type="()"}
- VERDADERO.
+ FALSO.

{Cualquiera puede ser un
reportero ciudadano.
|type="()"}
+ VERDADERO.
- FALSO.

	VERDADERO.
	FALSO.

	VERDADERO.
	FALSO.

	VERDADERO.
	FALSO.

En muchos sistemas de prueba, las preguntas de verdadero/falso se muestran como un tipo separado de preguntas, aunque en realidad no son mas que una variedad de opción múltiple con respuesta única. La extensión quiz trata correctamente las preguntas verdadero/falso como de múltiple opción con respuesta única. Están implementadas en la misma forma exactamente como arriba.
El primero de los dos ejemplos muestras una pregunta verdadero/falso donde la respuesta correcta es "verdadero".
El segundo de los dos ejemplos muestras una pregunta verdadero/falso donde la respuesta correcta es "falso".
Los ejemplos se pueden intentar ahora mismo.
Si necesitas un gran número de preguntas verdadero/falso, una forma más eficiente de organizarlas sería usar las respuestas únicas tabuladas que se describen abajo.

Opción múltiples / respuesta múltiple

wikitext

rendering

comments

{Pregunta
|type="[]"}
+ Respuesta correcta.
- Incorrecta.
+ Respuesta correcta.
- Incorrecta.

Este tipo de pregunta es de selección múltiple donde más de una respuesta podría ser correcta.
Las respuestas correctas se indican con el signo positivo, y las incorrectas con menos.
El wikitexto de la izquierda debe ser insertado entre etiquetas <quiz>.
Las respuestas aparecen en el mismo orden que en el marcado, porlo que se recomienda mezclarlas antes de exportarlas al código.
Todo símbolo, p.ej. |, +, - y otros listados abajo, debe estar en una nueva línea.
Los símbolos deben empezar justo en la nueva línea —sin espacios—.
Los bordes son el resultado de los bordes de la wiki tabla. Son opcionales.
El símbolo [] en el atributo de tipo debería parecerse a una casilla.

Cuadro de texto (respuesta escrita corta)

wiki texto

renderizado

comentarios

{ &nbsp;
|type="{}"}
¿Dónde nació Aristóteles? 
{ Stageira }

{ &nbsp;
|type="{}"}
Nombra al mentor más famoso de Aristóteles. 
{ Platón }

{ &nbsp;
|type="{}"}
{ Alejandro Magno } fue el alumno más
famoso de Aristóteles.

En una respuesta escrita el estudiante teclea una respuesta en un cuadro de texto.
El tipo de pregunta se indica con "{}" en el argumento del tipo.
Un cuadro de texto se inserta con llaves en la posición deseada para el cuadro.
- Nótese que las llaves únicamente no crean el cuadro de texto. También deben tener espacios entre ellos y algo de texto. { Respuesta } funciona, pero {Respuesta} no funciona.
- La respuesta correcta se debe insertar entre las llaves.
- El cuadro de texto se puede posicionar en cualquier lugar del texto. El texto que haya antes y después del cuadro se mostrará como texto normal.
Los bordes los ha generado la wiki tabla y son opcionales.
Se ha insertado un espacio duro entre { y |type= porque plugin requiere que haya algo de texto en esa posición (un pequeño fallo).

{  
|type="{}"}
Nombra un filósofo griego famoso. 
{ Aristóteles|Platón }

Las respuestas escritas a menudo tienen más de una respuesta posible. Puedes listar todas las respuestas posibles dentro de las llaves separadas con una barra vertical.
En el ejemplo, hay dos respuestas posibles. Puedes comprobarlo —es una demostración funcional—.

{  
|type="{}"}
Nombra al famoso mentor de Aristóteles. 
{ Platón _6 }

Para modificar la longitud de un campo de texto, añade una barra baja y un número entero tras la respuesta y entre las llaves para representar el número de caracteres.
Puede variar, sin embargo, debería ser en torno a n+2 (donde n es el número de letras en la respuesta).

{ Complete cada caja con un sinónimo de las siguientes palabras
|type="{}"}
# gratuito: { gratis _6 }
# ejecicio: { deporte _9 }

Puedes agrupar varios elementos en una sola pregunta.

{  
|type="{}"}
¿Dónde murió Aristóteles? 
{ Calcis (i) }

Coincidencia de mayúsculas: las respuestas escritas distinguen mayúsculas y minúsculas a no ser que se añada (i) en la posición mostrada. La (i) viene de case-insensitive.
Si algunas preguntas tienen más de una respuesta posible, se debe incluir una (i) para cada una de ellas.

Gapfill / cloze

wikitext

{Complete el texto del artículo de Wikipedia sobre [[w:Aristóteles|Aristòteles]].
|type="{}"}
Aristóteles nació en el año { Stageira _8 } en Calcídica. Sus padres fueron { Phaestis _8 } 
y { Nicomachus _10 }, quien se convirtió en médico del Rey Amyntas de Macedonia. Aristóteles
fue educado como miembro de la aristocracia. Aproximadamente a la edad de { eighteen|18 _8}, 
el fue a  { Athens _6 } para continuar su educación en la academia { Plato _5 }. 
Aristóteles permaneció en la Academia durante casi veinte años, sin irse hasta después de 
la muerte de Platón en { 347 _3 } BC.

rendering

comments

Gap Fills (o ejercicios cloze) se crean casi de la misma manera que las respuestas tipeadas. La diferencia es que solo escribes un poco más de texto y agregas algunos campos de texto más.
El espacio de relleno anterior se colocó adicionalmente en una caja y se centró utilizando una tabla wiki.

Numerical response

wikitext

rendering

comments

{In which year was Plato born?
|type="{}"}
He was born in { 427-428 _5 } BC.

At Wikiversity, numerical responses are a subtle modification of typed responses. The syntax is identical, except for some additions which allow numerical ranges and numerical tolerances if the answer is a number.
In the example to the right, the uncertainty over Plato's date of birth is reflected in the answer by using a range. A simple hyphen between the numbers permits all numbers inbetween.

{How far is the earth from the sun?
|type="{}"}
{ 91-95 _3 } million miles.

This is another example of a range.
The _3 ensures that the textfield doesn't get too wide.

{What is 10 times 10?
|type="{}"}
{ 100 5% _3 }

This is an example of specifying a tolerance. The critical part is "5%", which specifies the expected tolerance of 5%. In this example, values between 95 and 105 should work, but try it.
At the time of writing, the underscore method of limiting the size of the textfield does not yet work in combination with a tolerance specification, so a range may be a better method of specifying numerical accuracy.

Because numerical responses are, programmatically, a sub-variety of typed response, numerical and text responses can be freely mixed in a gapfill as shown to the left.

Respuestas únicas tabuladas

wikitexto

Representación

Comentarios

 {Pregunta
 |type="()"}
 | A | B | C 
 +-- A es correcta.
 -+- B es correcta.
 --+ C es correcta.

Agregue botones de opción adicionales reduplicando los signos +/- al comienzo de cada fila.
Solo debe haber un signo más en cada fila.
Especifique encabezados de columnas mediante el uso de tuberías en la parte superior.

Tabular response type with checkboxes

wikitext

rendering

comments

{Question
|type="[]"}
| Option A | Option B | Option C 
++- Question 1 
(Clue: A and B are correct).
-++ Question 2 (
Clue: B and C are correct).
--+ Question 3 
(Clue: C is correct).

This type of question has multiple everything.
Correct answers are indicated by plus signs, incorrect ones by minus signs. By reduplicating the +/- signs at the beginning of each row, extra checkboxes can be added.
The column headers are defined using pipes at the top as shown.

Cosas avanzadas

Inserción de comentarios

wikitext

representación

comentarios

 {Pregunta
 |type="()"}
 + La respuesta correcta.
 || Comentarios para la respuesta correcta.
 - Distractor.
 || Comentario para distractor.
 - Distractor.
 || Comentario para distractor.
 - Distractor.
 || Comentario para distractor.

La retroalimentación es texto que inicialmente está oculto y luego se muestra al usuario cuando envía la prueba para su corrección. La retroalimentación generalmente sirve para los propósitos de aliento, explicación, felicitación y conmiseración.
La retroalimentación se establece con todos los tipos mediante el uso de una doble línea vertical || inmediatamente después de una respuesta.
Las tuberías que comienzan la sección de retroalimentación deben estar en una nueva línea.
A diferencia de otros sistemas de cuestionarios, todos los ítems de retroalimentación se muestran en la corrección. Con otros sistemas de cuestionarios, la norma es mostrar los comentarios solo para aquellos elementos que fueron seleccionados por el usuario.
Para probar el efecto de retroalimentación, elija una respuesta y haga clic en el botón de corrección. Los comentarios aparecerán.

Insertar bloques de texto entre preguntas

wikitext

rendering

comments

{Esta es la primera pregunta
|type="()"}
+ La respuesta correcta.
- Distractor.
- Distractor.

{Este es un bloque de texto.}

{Esta es la segunda pregunta.
|type="()"}
+ La respuesta correcta.
- Distractor.
- Distractor.

Los bloques de texto se pueden insertar entre las preguntas colocándolas entre llaves{....}.
Los bloques de texto pueden contener etiquetas wiki, tales como imágenes, hipervínculos y etiquetas de formato, como se muestra en este ejemplo.

Using images as answers

wikitext

rendered

comments

<quiz display=simple>
{ Which of these are not nuts? }
- [[Image:Walnut03.jpg|100px]]
+ [[Image:Peanuts.jpg|100px]]
+ [[Image:Malus-Idared on tree.jpg|100px]]
- [[Image:Pistachios in a bag.jpg|100px]]
- [[Image:Chestnut.jpg|100px]]
+ [[Image:P10802511.JPG|100px]]
</quiz>

Unfortunately there does not yet seem to be a way of putting these into a row or tabularising the layout.
Although this has not been done here for reasons of space, it is generally good practice to specify some kind of tooltip text for the images, but try to avoid text which gives away the answer.

Using images in the question

wikitext

rendered

comments

<quiz display=simple>
{ What is this? [[Image:Butterfly tongue.jpg|100px| ]]
| type="()" }
- Tiger
+ Butterfly
- Bee
- Fly
</quiz>

In this example, the image is part of the question. You just use normal wiki-markup to insert the image(s).

Using animations

The section adds no new technical tricks, but it looks pretty.

Hipervínculos y otras marcas

Marcados que funciona dentro de cuestionarios

Hipervínculos: [[....]].
Imagenes: [[Image:....]].
Otros medios: [[....]].
Negrita y cursiva.<b></b> and <i></i>

Marcado que parcialmente funciona dentro de cuestionarios

Plantillas: {{....}}.
- subst no funciona.
Tablas: {|....|}.
Encabezados: e.j. ===....===.
- Cuidado: Por el momento hay un problema con el toc.
Listas y sangrías: utilizando #, * y :

Agregar música y efectos de sonido

Esto es similar a la inserción de imágenes. Se utiliza el marcado estándar de wiki.

Configuring points

wikitext
(what you write)

rendering
(what you see)

comments

<quiz points="3/1!">
{Try this question now.} 
+ Plus 3 points for this one.
- Minus 1 point for this one.
</quiz>

By default, there is 1 point for a correct answer and 0 for a wrong answer.
You can change this for the whole quiz by using a points attribute for the quiz tag.
The format is "X/Y!", where X gives the points for a correct answer and Y the points for a wrong answer. The Y points are expressed as a positive integer but are subtracted from the score.
Due to a bug, the points attribute has no effect if display=simple is used (version 0.9.2).
Values like 1.25 or 2.5 are allowed

<quiz display=simple>
{Try this question now.
|type="()" } 
+ 1 points for this one.
- 0 points for this one.

{Try this question now. 
|type="()" coef="2"} 
+ 2 points for this one.
- 0 points for this one.

{Try this question now. 
|type="()" coef="4"} 
+ 4 points for this one.
- 0 points for this one.

{Try this question now. 
|type="()" coef="0.5"} 
+ 1/2 point for this one.
- 0 points for this one.
</quiz>

A coefficient is a way of giving a weighting to a specific question. Normally all the questions have the same number of points. By default, they all have one point. By specifying a coefficient for each or any question, you can multiply the number of points for that question by the coefficient.
Coefficients can be both numbers above one and numbers between 0 and 1. If the coefficient is above 1, the question will receive greater weighting. If the coefficient is less than 1, the question will receive less weighting.
You must put inverted commas around the argument of the coef attribute.

Solución de problemas

No puedes probar el cuestionario mientras edita una página, porque el botón enviar está atenuado. Si desea probar su nueva prueba, primero cree una página de espacio aislado en otro lugar (por ejemplo, como una subpágina de su página de usuario), luego pruebe la prueba y finalmente transfiera la prueba a su ubicación final (y vuelva a probarla de todos modos) .
El cuestionario fue desarrollado para IE6, IE7, Firefox (y Opera?), Pero la calidad de visualización en Opera puede no ser óptima, y puede haber diferencias de visualización entre los navegadores.
Un recordatorio: cada pregunta debe estar separada por una línea en blanco, de lo contrario las preguntas se fusionan en una sola pregunta.

Cambios futuros

Puedes encontrar información adicional sobre la extensión en su página de desarrollo en MediaWiki.org. La lista de cambios futuros, defectos reportados y solicitudes de nuevas funcionalidades está disponible en la lista de tareas de desarrollo abiertas para la extensión en Phabricator.

La página «Cómo informar de un error» en MediaWiki contiene instrucciones y consejos útiles para solicitar nuevas funcionalidades o reportar defectos.

Véase también

Wikiversidad

Wikipedia

MediaWiki

El proyecto en MediaWiki de la extensión Quiz, donde la discusión y desarrollo se llevan acabo.