Importimi i skedarėve nė formatin "GIFT"

GIFT ėshtė formati i importimeve mė i kuptueshėm pėr importimin e pyetjeve tė quiz-it tė Moodle nga njė skedar teksti. Ai suporton pyetjet Me zgjedhje tė shumėfishė, pyetjet E Vėrtetė-False, Pėrgjigje tė Shkurtra, pyetjet me korespondim dhe ato numerike, si edhe futjen e njė _____ pėr formatin "Fjalė munguar". Tipet e ndryshme tė pyetjeve mund tė jenė tė pėrziera nė njė skedar tė vetėm teksti, dhe formati suporton edhe futjen e komenteve, emrave tė pyetjeve, rezultatet dhe notat e peshuara nė pėrqindje.

The text encoding of your text file must be the same as your Moodle installation. An example questions text file can be found here: gift/examples.txt.

### TIPET E PYETJEVE

Me shumė Zgjedhje:
Pėr pyetjet me shumė zgjedhje, pėrgjigjet e gabuara kanė pėrpara tildė (~) dhe pėrgjigjte korrekte kanė para njė shenjė barazimi (=).

         Kush ėshtė varrosur nė varrin e Grantit?{~Grant ~Jefferson =asnjė}

Formati Fjalė Munguar fut automatikisht njė rresht pėr t'u plotėsuar (si ky _____) nė mes tė fjalisė. Per tė pėrdorur kėtė format, vendos pėrgjigjen aty ku shfaqet rreshti nė fjali.

         Grant ėshte {~buried =varrosur ~living} nė varrin e Grantit.

Nėse pėrgjigjet bien para pikės qe perfundon fjalinė, do futet njė rėsht per t'u plotėsuar pėr formatin "fjalė munguar". Tė gjitha tipet e pyetjeve mund tė shkruhen nė formatin Fjalė Munguar.

There must be a blank line (double carriage return) separating questions. Pėr qartėsi, pėrgjigjet mund tė shkruhen nė rreshta tė ndarė. Psh:

         Festa Amerikane Falenderimeve festohet nė {
             ~tė dytėn
             ~tė tretėn
             =tė katėrten
         } Tė Enjte tė Nėndorit.

         Germat Japaneze e kanė prejardhjen nga cili vend? {
             ~India
             =Kina
             ~Korea
             ~Egjipti}

Pėrgjigje shkurt:
Pėrgjigjet nė kėtė ti pyetjesh kanė tė gjitha pėrpara njė shenjė barazimi (=), qė tregon se ato jnaė pėrgjigje korrekte. Pėrgjigjet duhet tė mos pėrmbajnė nje tildė (~).

         Kush ėshte varrosur nė varrin e Grantit?{=asnjė =askush}

         Dy plus dy janė baraz me {=katėr =4}.

Nėse ka vetėm njė pėrgjigje korrekte, ajo mund tė shkruhet pa shenjėn e barazimit pėrpara, kur nuk ngatėrrohet me E vėrtete-False.

E vėrtete-False:
Nė kėte tip pyetjesh pėrgjigja tregon nėse pohimi ėshtė i vėrtetė ose i gabuar. Pėrgjigja duhet tė shkruhet si {E VERTETE} ose {FALSE}, ose shkurt {T} ose {F}.

         Granti ėshte varrosur nė varrin e Grantit.{F}

         Dielli lind nė Lindjet.{T}

Korrespondues:
Ēiftet korrespondues fillojnė me njė shenjė barazimi (=) dhe janė tė ndara nga ky simbol "->". Duhet tė ketė tė paktėn tre ēifte korresponduese.

         Pyetje me korresponduesa. {
             =subquestion1 -> subanswer1
             =subquestion2 -> subanswer2
             =subquestion3 -> subanswer3
             }

         Pėr shtetet e mėposhtėm korrespondo kryeqytetet. {
             =Canada -> Ottawa
             =Italy  -> Rome
             =Japan  -> Tokyo
             =India  -> New Delhi
             }

Pyetjet me koresonduesa nuk e suportojnė rezultatin ose peshimet nė pėrqindje.

Numerike:
Seksioni i pėrgjigjeve pėr pyetjet Numerike duhet tė fillojnė me njė shenjėn e numrit (#). Pėrgjigjet numerike mund tė pėrfshijnė kufi gabimi, i cili shkruhet nė pasim tė pėrgjigjes korrekte, tė ndara me dy pikat (:). Psh, nėse pėrgjigja korrekte ėshte ēfardo numri midis 1.5 dhe 2.5, atėhere ai do tė shkruhej si mė poshtė {#2:0.5}. Kjo tregon se 2 me njė kufi gabimi 0.5 ėshtė korrekte. Nėse asnjė kufi gabimi nuk ėshte specifikuar, do supozohet se ai ėshtė zero.

         When was Ulysses S. Grant born? {#1822}

         What is the value of pi (to 3 decimal places)? {#3.1415:0.0005}.

Optionally, numerical answers can be written as a span in the following format {#MinimumValue..MaximumValue}.

         What is the value of pi (to 3 decimal places)? {#3.141..3.142}.

Moodle's browser interface does not support multiple numerical answers, but Moodle's code can and so does GIFT. This can be used to specify numerical multiple spans, and can be particularly usefully when combined with percentage weight grades. If multiple answers are used, they must be separated by an equal sign, like short answer questions.

         Kur ka lindur Ulysses S. Grant? {#
             =1822:0
             =%50%1822:2}

Vini re se meqė GUI e brauzerit tė Moodle nuk suporton pėrgjigje tė shumėfishta pėr pyetjet Numerike, nuk ka mėnyrė qė t'i shikosh apo ndryshosh ato nėpėrmjet Moodle. E vetmja mėnyrė qė tė ndryshosh njė pėrgjigje numerike, ėshtė ta fshish pyetjen dhe ta ri-importosh atė.

### OPSIONET

Ky filtėr, si shtojcė e tipeve bazė tė pyetjeve, ofron opsionet e mėposhtme: komentet rresht, emra pyetjesh, rezulatat (jehonė) dhe koeficientė peshimi nė pėrqindje.

Komente rresht:
Komentet qė nuk importohen nė Moodle, mund tė futen nė skedar teksti. Kjo mund tė pėrdoret pėr tė futur koka ose informacione mbi pyetjet. Tė gjitha rreshtat qė fillojnė me dy backslash-e (pa llogaritur tab-et ose spaciot) do tė injorohen nga filtri.

         // Subheading: Pyetjaq numerike me poshtė
         Sa ėshtė 2 plus 2? {#4}

Emra Pyetjesh:
Njė emėr pyetjeje mund tė specifikohet duke e vendosur atė tė parėn dhe duke e mbyllur mė dy dypikėshe (::).

         ::Kanji Origins::Japanese characters originally
         came from what country? {=China}

         ::Thanksgiving Date::The American holiday of Thanksgiving is
         celebrated on the {~second ~third =fourth} Thursday of November.

nėse emri i pyetjes nuk ėshtė specifikuar, e gjithė pyetja do pėrdoret si emėr i saj nė mėnyrė default.

Rezultati (Feedback):
Feedback mund tė pėrfshihet te ēdo pėrgjigje duke pasuar pėrgjigjen me njė shenjė numri (#) dhe feedback-un.

         What's the answer to this multiple-choice question?{
         ~wrong answer#feedback comment on the wrong answer
         ~another wrong answer#feedback comment on this wrong answer
         =right answer#Very good!}

         Who's buried in Grant's tomb?{
         =no one#excellent answer!
         =nobody#excellent answer!}

         Grant is buried in Grant's tomb.{FALSE#No one is buried in Grant's tomb.}

Pėr pyetjet me shumė zgjedhje, feedback-u shfaqet vetėm pėr pėrgjigjen qė ka zgjedhur studenti. Pėr pėrgjigjet shkurt, feedback-u shfaqet vetėm kur studenti fut pėrgjigjen korresponduese korrekte. Pėr pyetjet true-false, feedback-u i importuar ruhet nė mėnyrė qė ajo tė shfaqet kur studenti zgjedh pėrgjigjen e gabuar. Kėshte, nė shembullin e fundit me lart, studenti do tė shohė feedback vetėm nėse ka zgjedhur si pėrgjigje TRUE.

Koeficientėt e peshimit nė %:
Kėta janė tė vlefshėm pėr tė dyja tipet e pyetjeve Me zgjedhje tė shumėfishte dhe Pėrgjigje Shkurt. Ata mund tė inkludohen duke pasuar shenjė tildė (pėr Me shumė Zgjedhje) ose shenjėn e barazimit (pėr Pėrgjigje shkurt) me pėrqindjen e dėshiruar midis shenjave tė pėrqindjes (psh, %50%). Ky opsion mund tė kombinohet me komentet feedback.

         Pyetje e vėshtirė.{~pėrgjigje gabim ~%50%pėrgjigje gjysėm e besueshme =pėrgjigje me tė gjithė pikėt}

         ::Jesus' hometown::Jesus Christ was from {
         ~Jerusalem#This was an important city, but the wrong answer.
         ~%25%Bethlehem#He was born here, but not raised here.
         ~%50%Galilė#You nėd to be more specific.
         =Nazareth#Yes! That's right!}.

         ::Jesus' hometown:: Jesus Christ was from {
         =Nazareth#Yes! That's right!
         =%75%Nazereth#Right, but misspelled.
         =%25%Bethlehem#He was born here, but not raised here.}

Vini re se dy shembujt e fundit janė kryesisht e njėjta pyetje, sė pari nė formėn Me shmė zgjedhje dhe mandej si pėrgjigje shkurt.

Vini re se ėshtė e mundur tė specifikosh peshat e pėrgjigjeve nė pėrqindje qė nuk janė tė vlefshme nėperemjet interfejsit tė brauzerit. Kėto pėrgjigje-tė peshuara do kalkulohen korrektėsisht (sipas vlerės sė shėnuar kur importohen), dhe do t'u shfaqen normalisht studentėve. Por kėto pėrgjigje tė peshuara nuk do t'u shfaqen korektėsisht mėsuesve kur edituhen nėpėrmjet Moodle. Menuja qė shfaqet nė interfejsin e editimit tė pyetjeve lejon vetėm disa vlera tė fiksuara, dhe nėse pesha nuk pėrputhet me njė nga kėto vlera tė paracaktuara, atėhere ajo nuk do tė shfaqet korrektėsish. Nėse editoni njė pyetje tė tille nga interfejsi i brauzerit, pesha e pėrgjigjes do tė ndryshojė nga ajo e shfaqur.

Pėrgjigjet e shumefishtas:
Ky opsion pėrdoret pėr pyetjet me shumė zgjedhje, kur dy ose mė shumė pėrgjigje duhet tė zgjidhen qė tė marresh kreditet e plota. Ky opsion ėshtė aktivizohet duke caktuar peshat e pėrgjigjeve tė pjesėshme ndaj pėrgjigjeve tė shumėfishta, duke mos lejuar qė pėrgjigja e vetme tė marre kredite te plota.

         What two people are entombed in Grant's tomb? {
              ~No one
              ~%50%Grant
              ~%50%Grant's wife
              ~Grant's father }

Vini re se nuk ka shenjė barazimi (=) nė asnjė pėrgjigjė dhe pėrgjigjet duhet tė jenė nė total jo mė shumė se 100%, pėrndryshe Moodle do tė njoftojė njė gabim. Pėr tė mėnjanuar problemin qė studentėt tė marrin automatikisht 100% thjeshtė duke ēekuar tė gjitha pėrgjigjet, ėshte mirė qė tė futen pesha negative pė pėrgjit e gabuara.

         What two people are entombed in Grant's tomb? {
              ~%-50%No one
              ~%50%Grant
              ~%50%Grant's wife
              ~%-50%Grant's father }

Karakteret Speciale ~ = # { } :
Kėto simbole ~ = # { } kontrollojnė operacionin e kėtij filtri dhe nuk mund tė pėrdoren si tekst normal brenda pyetjeve. Meqė kėto simbole kanė njė rol special nė pėrcaktimin e operacionit tė kėtij filtri, ato quhen "karaktere kontrolli." por, nganjėherė ju mund tė doni tė pėrdorni njė nga kėto karaktere, psh pėr tė shfaqur njė formulė matematike nė njė pyetje. Mėnyra pėr tė mėnjanuar kėtė problem ėshtė "escaping" i karaktereve tė kontrollit. Kjo dmth thjeshtė tė vendosėsh njė backslash (\) para njė karakteri kontrolli, kėshtu qė filtri do ta kuptojė qė ju doni ta pėrdorni atė si njė karakter tė zakonshėm. Psh:

         Cila pėrgjigje barazon 5? {
              ~ \= 2 + 2
              = \= 2 + 3
              ~ \= 2 + 4  }

         ::GIFT Control Characters::
         Cila nga mė poshtė NUK ėshtė njė karakter kontrolli pėr formatin e importimit GIFT? {
            ~ \~     # \~ is a control character.
            ~ \=     # \= is a control character.
            ~ \#     # \# is a control character.
            ~ \{     # \{ is a control character.
            ~ \}     # \} is a control character.
            = \     # Correct! \ (backslash) is not a control character. BUT,
                       it is used to escape the control characters.
         }

Kur pyetja procesohet, backslash-i hiqet dhe nuk ruhet nė Moodle.

Optione tė tjera:
Pyetjet me pėrgjigje shkurt mund tė bėhen tė ndjeshme ndaj lloit tė germave (tė vogla apo kapitale)cduke ndryshuar "0" me "1" nė reshtin qė pason:
`$question->usecase = 0; // Ignore case`

Opsione tė tjera janė tė vlefshme duke edituar filtrin e importimit gift/format.php.

### KREDITET

Ky filtėr ėshtė shkruar nėpėrmjet bashkpunimit tė shumė antarėve nga komuniteti i Moodle. Fillimisht ėshtė bazuar mbi formatin FjalėMunguar, i cili pėrfshinte kode nga Martin Dougiamas dhe Thomas Robb. Paul Tsuchido Shew shkroi kėte nė Dhjetor 2003 duke inkorporuar sugjerimet e komunitetit. Emri ėshtė koceptuar nga shkurtimet e "General Import Format Technology" .

Filtri GIFT dhe dokumentimi nga Paul Tsuchido Shew http://ac.shew.jp. Last updated 27 Feb 2004.