====== Connector de qüestionaris ======

Aquest connector serveix per a incloure qüestionaris d'autoavaluació als continguts.

La sintaxi és:

<code>
<questionari>
//Afegiu el text d'un qüestionari en format Moodle GIFT
//Exemple de preguntes de tipus cert o fals amb retroacció

El sol surt per l'est?{T#Segur?#Molt bé}

Un dia té 30 hores?{TRUE#No et semblen masses hores?#Correcte}
</questionari>
</code>

Que bàsicamen es resumeix en:

{{ :wiki:connectors:questionari:la-sintaxi-del-connector-questionari.md.png?nolink |}}


Les preguntes serán en format [[https://docs.moodle.org/all/es/Formato_GIFT | Moodle GIFT]], a Moodle les categories del banc de preguntes es poden exportar en format GIFT i copiar el contingut del fitxer. El connector farà que el qüestionari sigui operatiu, funcional i es pugui exportar amb la resta de continguts. Si voleu és pot fer servir Moodle per editar les preguntes amb un editor i un cop exportades incorpora-les a les pàgines wiki.

A l'editor és pot fer servir el botó {{:wiki:connectors:questionari:boto-de-questionaris-a-leditor-wiki.png?nolink|}} per incloure la sintaxi.

Es poden afegir més d'un qüestionari per pàgina.
===== Qüestionari d'exemple =====

<questionari limit="0" solact="true">
$CATEGORY: Cultura general


Exercicis d'autoavaluació per valorar el progrés


El sol surt per l'oest?
{ F }

El sol surt per l'est?
{ T }

Un sinònim d'entrebanc
{
	=obstacle
	=impediment
	=destorb
	=nosa
	=dificultat
}

Quan va arribar Colon a Amèrica per primera vegada? (l'any exacte)
{
	#1492:0
	#### El valor introduït ha de ser l'any exacte
}

Quina és la teva temperatura de confort per treballar?
{
	#23:3
	#### La temperatura de confort és un rang, s'accepta una temperatura que estigui dintre del rang recomanat.
}

Quan són 2 més dos?
{
	~Cinc 
	~1 
	=Quatre 
}

Quins són els resultats possibles de l'arrel quadrada de quatre?
{
	~%0%5 
	~%50%+2 
	~%50%-2 
}

Aparella el menjar amb el tipus al qual pertany
{
	=cigró -> Llegum
	=poma -> Fruita
	=Blat -> Cereal
	=tomàquet -> Fruita
	#### Pensa en grups d'aliments
}

Dona la teva opinió sobre els sistemes d'avaluació
{	#### Consulta el material pedagògic i les experiencies dels docents
}

L'aigua bull a 100 graus
{ T }

</questionari>





===== El format GIFT, Sintaxi =====

El format GIFT (General Import Format Technology) és un format de text per a la creació de qüestionaris. 

La seva sintaxi es descriu en diversos llocs amb la intenció d’esdevenir un estàndard. 

En aquest connector per a dokuwiki es farà servir com a font les referències de la documentació de Moodle.

Aquesta taula només és a nivell introductori i com a material de consulta ràpida. Es recomana que consulteu la referència a la documentació de Moodle per obtenir més detalls.

^Sintaxi ^ Descripció^
|%%::Títol::%% | **Nom o títol de la pregunta** (opcional)|
|text | **Enunciat** o text de la pregunta|
|[format] | El **format del text** del fragment següent. Les opcions són [html], [moodle], [plain] i [markdown]. El valor per defecte és [plain] (text sense format) per al text de la pregunta; altres parts de la pregunta tenen el format utilitzat per al text de la pregunta.|
|{ | **Inici de les respostes**, sense l'inici, el text és una descripció o aclariment|
|{T} or {F} | **Resposta vertadera o falsa**; també {TRUE} i {FALSE}|
|{ ... = text d'una opció correcta ... } | **Resposta correcta** d'una pregunta d'opció múltiple amb resposta única|
|{ ... ~ text d'una opció errònia ... } | **Resposta incorrecta** d'una pregunta d'opció múltiple amb resposta única|
|{ ... ~%n%resposta ... } | **Resposta correcta o incorrecta en un percentatge de valor n** d'una pregunta d'opció múltiple amb resposta múltiple|
|%%{ ... =element -> parella ... }%% | **Parella de resposta** per a preguntes d'aparellament|
|#feedback text | **Retroacció de la resposta** per a respostes múltiples, numèriques o verdader/fals|
|####general feedback | **Retroacció general**|
|%%{#%% | Inici d'una **pregunta numèrica**|
|%%{#%% resposta:tolerància } | **Resposta numèrica amb marge d'error** correcta si es troba d'intre del marge d'error o tolerància|
|%%{#%% mínim..màxim }| **Rexposta numèrica dins d'un rang de valors** correcta si la resposta es troba entre el valor mínim i el màxim|
|} | Marca **el final de la pregunta**, seguida d'una línia en blanc|
|\caràcter | La barra invertida (backslash) **permet escapar i fer servir els caràcters especials** que formen part de la sintaxicom per exemple **%%~, =, #, {, }, and :%%**|
|\n | Insereix **un salt de línia** al text de la pregunta, és important diferenciar entre un salt de línia i una línia en blanc perquè les línies en blanc delimiten les preguntes|
|%%// text%% | **Comentari**, inclou el text des de la marca fins al final de la línia (opcional)|
|$CATEGORY: text | **Categoria**, Una categoria agrupa les preguntes posteriors fins a la següent categoria o al final del qüestionari |