Uvažanje datotek formata "GIFT"

GIFT je najbolj vsestranska oblika zapisa za uvoz vprašanj Moodle kviza iz datoteke z besedilom. Podpira večkratno izbiro, drži - ne drži, kratek odgovor, ujemanje in številčna vprašanja, kakor tudi obliko za vstavljanje ____ za zapis Manjkajočih besed. Različne vrste vprašanj so lahko mešane v eni datoteki besedila in oblika podpira tudi vrstice s komentarji, imena vprašanj, povratno informacijo in odstotke oz. utežene ocene.

Kodiranje vaše datoteke z besedilom mora biti UTF-8 (razen če uporabljate samo nabor znakov ASCII). Primer datoteke vprašanj z besedilom najdete tu: gift/examples.txt.

Osnove

Vsako posamezno vprašanje v datoteki GIFT ne sme vsebovati praznih vrstic. Vsako vprašanje razmejuje vsaj ena prazna vrstica. Če v svojem vprašanju potrebujete prazno vrstico, lahko uporabite entiteto \n. Kjerkoli v datoteki lahko uporabite komentarje, vendar se morajo vedno začeti z dvema poševnicama (//) na začetku vrstice.

VRSTE VPRAŠANJ

Večkratna izbira:
Za vprašanja z večimi izbirami imajo napačni odgovori kot predpono tildo (~) in pravilni odgovori kot predpono uporabljajo znak enakosti (=).

     Kdo je pokopan v Grantovi grobnici?{~Grant ~Jefferson =nihče}

Oblika Manjkajoče besede samodejno vstavi prazno črto (kot to _____) na sredo stavka. Za uporabo zapisa Manjkajoče besede, vstavite odgovore kjer želite, da se v stavku pojavi črta.

     Grant je {~pokopan =položen ~živ} v Grantovi grobnici.

Če se odgovori pojavijo pred zaključnim ločilom pike, bo vstavljena vrstica za vpis vstavljena za obliko "manjkajoče besede". Vse vrste vprašanj lahko napišete v zapisu Manjkajoče besede.

Med vprašanji mora biti ločilna prazna vrstice (dvojna nova vrstica). Za večjo preglednost, so lahko odgovori zapisani v ločenih vrsticah in celo zamaknjeni. Na primer:

     Ameriški praznik Dan zahvalnosti se praznuje {
         ~drugi
         ~tretji
         =četrti
     } četrtek v novembru.
     
     Iz katere države prvotno izvirajo Japonski znaki? {
         ~Indije
         =Kitajske
         ~Koreje
         ~Egipta}

Kratek odgovor:
Odgovori v vrsti vprašanja Kratkih odgovorov imajo vsi predpono znaka enakost (=) in nakazujejo, da so vsi odgovori pravilni. Odgovori ne smejo vsebovati tilde.

     Kdo je pokopan v Grantovi grobnici?{=nihče =nobeden}

     Dva plus dva je {=štiri =4}.

Če je samo en pravilen Kratki odgovor, ga lahko zapišemo brez predpone znaka enakosti, če le ne more biti zamenjan za Drži-Ne drži.

Drži/Ne drži:
V tej vrsti vprašanja odgovor nakazuje ali je trditev pravilna ali napačna. Odgovor mora biti zapisan kot {TRUE} ali {FALSE}, oziroma okrajšano {T} ali {F}.

     Grant je pokopan v Grantovi grobnici.{F}

     Sonce vzide na vzhodu.{T}

Ujemanje:
Pari za povezovanje se začnejo z znakom enakosti (=) in so ločeni s tem simbolom "->". Morajo biti vsaj trije pari za ujemanje.

     Vprašanje ujemanja. {
         =podvprašanje 1 -> pododgovor 1
         =podvprašanje 2 -> pododgovor 2
         =podvprašanje 3 -> pododgovor 3
         }
     
     Poveži sledeče države z njihovimi glavnimi mesti. {
         =Kanada -> Ottawa
         =Italija -> Rim
         =Japonska -> Tokio
         =Indija  -> New Delhi
         }

Vprašanja ujemanja ne podpirajo povratne informacije ali uteži odgovorov v odstotkih.

Številčno:
Odsek odgovora za številčna vprašanja se mora pričeti z uveljavljenim znakom za število (#) oz. "lojtro". številčni odgovori lahko vključujejo mejo napake, ki je zapisana za pravilnim odgovorom ločena z dvopičjem. Če je na primer pravilen odgovor karkoli med 1,5 in 2,5 potem bi bilo to zapisano kot sledi {#2:0.5}. To nakazuje, da je 2 znotraj meja napake 0,5 pravilno (npr. razpon od 1,5 do 2,5). Če meja napake ni navedena, se predvideva, da je nič.

     Kdaj je bil rojen Ulysses S. Grant? {#1822}

     Koliko je vrednost števila pi (na 3 decimalke)? {#3.1415:0.0005}.

Dodatno so lahko številčni odgovori zapisani kot obseg v naslednji obliki {#Najmanjša vrednost..Največja vrednost}.

     Koliko je vrednost števila pi (na 3 decimalke)? {#3.141..3.142}.

Moodle vmesnik brskalnika ne podpira večkratnih številčnih odgovorov, a to zmore Moodle koda in tudi GIFT. To lahko uporabite za določanje številčnih večkratnih obsegov, kar je lahko posebej uporabno ob kombinaciji z odstotki uteži ocen. Če so uporabljeni večkratni odgovori, morajo biti ločeni z znakom enakosti, kot vprašanja s kratkimi odgovori.

     Kdaj je bil rojen Ulysses S. Grant? {#
         =1822:0
         =%50%1822:2}

Vedite, da zato, ker Moodle brskalnikov uporabniški vmesnik ne podpira večih odgovorov za številčna vprašanja, ni nobenega načina, da bi jih videli ali uredili prek Moodle. Edini način za spremembo številčnega odgovora za prvim je, da izbrišete vprašanje in ga ponovno uvozite (ali kaj podobnega phpMyAdmin).

Esej:
Esejsko vprašanje je enostavno vprašanje s praznim vnosnim poljem za odgovor. Med zavitimi oklepaji ni nič dovoljeno.

Napišite kratko biografijo za Ulysses S. Grant {}

Opis:
"Vprašanje" vrste opis sploh nima dela z odgovorom.

Naslednji niz vprašanj se bo nanašal na aritmetiko

MOŽNOSTI

Poleg teh osnovnih vrst vprašanj, ponuja ta filter naslednje možnosti: vrstice komentarjev, imena vprašanj, povratno informacijo in odstotek uteži vprašanja.

Vrstice komentarjev:
Komentarji, ki ne bodo uvoženi v Moodle, so lahko vključeni v datoteko z besedilom. To lahko uporabite za naslove ali dodatne informacije o vprašanjih. Vse vrstice, ki se začnejo z dvojno poševnico nazaj (ne štejejo tabulatorji ali presledki) bo filter prezrl.

     // Podnaslov: Spodaj številčna vprašanja
     Koliko je 2 plus 2? {#4}

Ime vprašanja:
Ime vprašanja je možno določiti tako, da ga vmestite pred vprašanje in obdate z dvojnim dvopičjem.

     ::Izvor pisave Kanji::Japonski znaki prvotno
     prihajajo iz iste države? {=Kitajske}

     ::Datum dneva zahvalnosti::Ameriški praznik Dan zahvalnosti se praznuje {~drugi ~tretji =četrti} četrtek v novembru.

Če ime vprašanja ni določeno, bo kot privzeto za ime uporabljeno celotno vprašanje.

Povratna informacija:
Povratna informacija je lahko vključena za vsak odgovor z nadaljevanjem (po vprašanju) z znakom za število (# poznano tudi kot lojtra) in povratno informacijo.

     Kakšen je odgovor na to vprašanje z večimi izbirami?{
     ~napačen odgovor#povratna informacija za napačen odgovor
     ~še en napačen odgovor#povratna informacija za ta napačen odgovor
     =pravilen odgovor#Zelo dobro!}
     
     Kdo je pokopan v Grantovi grobnici?{
     =nihče#izvrsten odgovor!
     =nobeden$izvrsten odgovor!}
     
     Grant je pokopan v Grantovi grobnici.{FALSE#Nihče ni pokopan v Grantovi grobnici.}

Za vprašanja z večimi možnostmi, je povratna informacija prikazana samo za odgovor, ki ga je udeleženec izbral. Za kratke odgovore je povratna informacija prikazana samo takrat, ko udeleženci vnesejo ustrezen pravilni odgovor. Za vprašanja Drži / Ne drži je uvožene povratna informacija shranjena tako, da bo prikazano, če udeleženec izbere napačen odgovor. Tako bi v gornjih primerih, udeleženci videli povratno informacijo samo, če izbere TRUE kot odgovor.

Uteži odstotkov in uteži:
Uteži odgovorov v odstotkih so na voljo tako za vprašanja z večimi izbirami, kot kratkimi odgovori. Odstotki uteži za odgovor se lahko vključijo tako, da sledijo tildi (za več izbir) ali znaku enakosti (za kratek odgovor) z želenim odstotkom obdanim z znakoma za odstotek (npr. %50%). To možnost je mogoče kombinirati s komentarji povratne informacije.

     Težko vprašanje.{~napačen odgovor ~%50%odgovor za pol točk =odgovor vreden vseh točk}
          
     ::Jezusov domači kraj::Domači kraj Jezusa Kristusa je bil {
     ~Jeruzalem#To je bilo pomembno mest, a odgovor je napačen.
     ~%25%Betlehem#Tam je bil rojen, a tam ni bil doma.
     ~%50%Galileja#Morate biti bolj natančni.
     =Nazaret#Da! To je pravilno!}.
     
     ::Jezusov domači kraj:: Domači kraj Jezusa Kristusa je bil {
     =Nazaret#Da! To je pravilno!
     =%75%Nazeret#Pravilno, a narobe črkovano!
     =%25%Betlehem#Tam je bil rojen, a tam ni bil doma.}

Vedite, da sta zadnja dva primera v bistvu enaki vprašanji, najprej je vprašanje z večimi izbirami in nato s kratkim odgovorom.

Vedite, da je možno določiti uteži za odgovore v odstotkih, ki NISO na voljo prek vmesnika spletnega pregledovalnika. Takšne uteži za odgovore bodo pravilno izračunane (glede na dodeljene vrednosti ob uvozu) in bodo prikazane udeležencem. Vendar take uteži ne bodo pravilno prikazane izvajalcem, ko jih bodo urejali prek Moodle vmesnika za urejanje vprašanja. Spustni meni omogoča samo določene fiksne vrednosti in če se utež popolnoma ne ujema z eno izmed vnaprej določenih vrednosti, ne bo prikazana pravilno. Če tako vprašanje urejate s spletnim vmesnikom, se bo utež odgovora spremenila v prikazano vrednost.

Določanje oblikovanja besedila za vprašanje
Besedila vprašanja imajo lahko dodatno določen zapis oblikovanja besedila. Trenutno so na voljo zapisi oblikovanja moodle (Moodle samodejno oblikovanje), HTML (oblika HTML), golo (oblika golega besedila) in Markdown (oblika Markdown). Oblika zapisa je določena v oglatih oklepajih neposredno pred besedilom vprašanja. Več informacij o oblikah besedil v okolju Moodle.

[markdown]*Ameriški praznik Dan zahvalnosti* se praznuje {
         ~drugi
         ~tretji
         =četrti
     } četrtek v novembru.    

Več odgovorov:
Možnost večih odgovorov se uporabi pri vprašanjih večih izbir, kjer morata biti izbrana dva ali več odgovorov, za osvojitev vseh točk. Možnost večih odgovorov se omogoči z dodelitvijo uteži delnega odgovora večim odgovorom in se nobenemu posameznemu odgovoru ne dodeli vseh točk.

     Kateri dve osebi sta v Grantovi grobnici? {
          ~Nihče
          ~%50%Grant
          ~%50%Grantova žena
          ~Grantov oče }

Bodite pozorni na to, da ni pred nobenim odgovorom znaka enakosti (=) in vsota odgovorov ne sme preseči 100%, sicer bo Moodle sporočil napako. Da bi se izognili težavi, da bi udeleženci samodejno prejeli 100 % s preprostim označevanjem vseh odgovorov, je najbolje vključiti nekativne uteži odgovorov za napačne odgovore.

     Kateri dve osebi sta v Grantovi grobnici? {
          ~%-50%Nihče
          ~%50%Grant
          ~%50%Grantova žena
          ~%-50%Grantov oče }

Posebni znaki ~ = # { } :
Ti simboli ~ = # { } nadzirajo operacije tega filtra in se jih ne sme uporabiti kot navadno besedilo v vprašanjih. Ker imajo ti simboli posebno vlogo v določanju operacij tega filtra se imenujejo "kontrolni znaki". Včasih boste želeli uporabiti katerega izmed teh znakov, na primer za prikaz matematične formule v vprašanju. Tej težavi se izognete z ubežnim znakom pred kontrolnimi znaki. To pomeni enostavno vstavljanje poševnice nazaj (\) pred kontrolni znak, da bo filter vedel, da ga želite uporabiti dobesedno kot znak namesto njegove uporabe kot kontrolnega znaka. Na primer:

     Kateri odgovor da 5? {
          ~ \= 2 + 2
          = \= 2 + 3
          ~ \= 2 + 4  }

     ::GIFT kontrolni znaki::
     Kateri izmed naslednjih NI kontrolni znak v zapisu GIFT? {
        ~ \~     # \~ je kontrolni znak.
        ~ \=     # \= je kontrolni znak.
        ~ \#     # \# je kontrolni znak.
        ~ \{     # \{ je kontrolni znak.
        ~ \}     # \} je kontrolni znak.
        = \     # Pravilno! \ (poševnica nazaj) ni kontrolni znak. VENDAR,
                   se uporablja kot ubežni znak za kontrolne znake.
     }

Ko se vprašanje obdeluje se poševnica nazaj odstrani in ni shranjena v Moodle.

Določanje kategorij

V datoteki GIFT je možno spremeniti kategorijo, v katero so dodana vprašanja. V datoteki lahko kategorijo vprašanj poljubno spremenite. Vsa vprašanja po točki spreminjanja do naslednje točke spreminjanja bodo dodana v določeno kategorijo. Do prve točke spreminjanja bo uporabljena kategorija, ki jo boste določili na obrazcu za uvoz. Pri tem bodite pozorni na to, da bo to delalo samo v primeru, da pri uvozu odkljukate kvadratek iz datoteke:.

Za vstavljanje točke spreminjanja za kategorijo, vključite vrstico podobno tej (s prazno vrstico pred in po vrstici):

$CATEGORY: tom/dick/harry

ali enostavno

$CATEGORY: mojakategorija

... prvi primer določa pot ugnezdene kategorije. V tem primeru bodo vprašanja šla v kategorijo harry. Če kategorije ne obstajajo, bodo ustvarjene.

Druge možnosti:
Vprašanja s kratkimi odgovori lahko razlikujejo velike in male črke, ke spremenite "0" v "1" v naslednji vrstici:
$question->usecase = 0; // ne razlikuj velikosti črk