Brukermanual for Quizbuilder 1. juni 2010 Innhold 1 Installasjon av Quizbuilder 2 1.1 Installasjon fra Kildekode........................ 2 1.2 Installasjon fra Zip-fil.......................... 2 2 Quizbuilder 3 2.1 Opprettelse av oppgaver......................... 3 2.2 Settings.................................. 4 2.3 Tilleggsfunksjoner............................ 5 2.4 Lagring, kryptering og åpning...................... 6 1
1 Installasjon av Quizbuilder Det er i utgangspunktet 2 måter å installere Quizbuilder på, man kan få programmene ferdig kompilert i form av en zip-fil eller man kan bygge de fra kildekoden. For å bygge Quizbuilder fra kildekode trenger man: Ant Java 1.6.0 SDK Kildekoden til det programmet man ønsker å bygge 1.1 Installasjon fra Kildekode Quizbuilder bygges med ant fra terminalen slik: naviger deg inn rot-katalogen til applikasjonen skriv: ant dist Quizbuilder kjøres nå likt som du gjør fra Zip-fil. 1.2 Installasjon fra Zip-fil Har du fått en zippet versjon av Quizbuilder er det bare å pakke ut rotkatalogen der du måtte ønske å installere programmet. Man trenger Java SE 1.6 eller nyere for å kunne kjøre applikasjonen. Man må kjøre installasjonsskriptet for exist en gang før man kjører Quizbuilder, det trengs ikke kjøres igjen. For å kjøre Quizbuilder kan man dobbelt-klikke på filene, det vil fungere for noen skript i Windows, i POSIX må man kanskje høyre klikke og velge kjør med noen rettigheter. Hvis ikke det fungerer så må man navigere seg til mappen dist og skrive følgende kommandoer i terminalen: Installering av database(gjøres bare en gang): sh InstalleXist.sh(i POSIX) InstalleXist.bat (i Windows) Kjøring av quizbuilder: sh Quizbuilder.sh(i POSIX) Quizbuilder.bat (i Windows) Kjøring av UserEncrypt: sh UserEncrypt.sh (i POSIX) UserEncrypt.bat (i Windows) UserEncrypt spør etter XML-filen for brukerene, så skriver den ut den krypterte versjonen til det dokumentet i samme katalogen som programmet er i og filnavnet er users.xml, den filen plasseres så i SolveIt, i katalogen dist/data. 2
2 Quizbuilder 2.1 Opprettelse av oppgaver Oppgavesettene er strukturert i 4 lag; kurs, prøve, spørsmål og svar. Kurs inneholder prøver, som igjen inneholder spørsmål. Spørsmål har flere svar. Figur 1: Hiearkiet i kurssamling Opprettelse av disse kan gjøres på tre måter. Ved klikking på menybaren øverst, på knappene rett under eller ved å klikke høyre museknapp på elementene i kurssamlingen. Man har også mulighet til å slette, flytte, kopiere og lime inn elementer i hiearkiet. Dette gjøres ved å klikke høyre-museknapp på elementet man ønsker å manipulere. Man kan også flytte rundt på elementer ved å dra de rundt med musen. Kurs Her opprettes kurset som prøvene skal holdes i. Et kontaktfelt er der for å tilby kontaktinformasjon til elevene Prøve Prøvene i kurset spesifiserer man med navn og eventuelt hvor lang tid man har på å besvare. Dette baserer seg på valget av quiz-type, enten det er eksamen eller prøve. Eksamen En tidsbegrensning blir satt som elevene må forholde seg til. Når tiden løper ut, har man ikke lenger mulighet til å besvare flere oppgaver. Prøve Tidsbruken blir bare registrert og setter ingen begrensninger for eleven Spørsmål Defineres med en oversikt, en tag (stikkord) som beskriver innholdet i spørsmålet og vanskelighetsgraden. Under skriver man inn selve spørsmålet Svar Svar-elementene fungerer som svaralternativer. Man gir svaret et navn, poengsum, et valg om det er riktig eller galt. I poengsummen kan man gi negative verdier hvis man ønsker å trekke fra poengsummen hvis elevene velger dette svaralternativet. I tillegg har man to tekstfelt: Svartekst Dette er selve teksten på svaralternativet 3
Forklaring Dette er teksten som beskriver hvorfor svaret er riktig eller galt Figur 2 og 3 er eksempler på hvordan et spørsmål og svar i quizbuilder ville sett ut i SolveIt. Som man kan se dukker forklaringen på svaret opp hvis brukeren har valgt dette svaralternativet, med rød farge på tilkoblet bokstav for å illustrere at valget var feil. Figur 2: Eksempel på en oppgave i Quizbuilder 2.2 Settings I settings kan man gjøre følgende endringer: URL for database Her kan man sette en adresse til en extern exist-database for ekstern lagring av oppgavesett. Per default er stien satt til den lokalinstallerte exist-databasen brukernavn for database Brukernavnet som gir tilgang til databasen. Default: admin 4
Figur 3: Tilsvarende spørsmål besvart i solveit Passord for database Passordet, default er tomt passord. det bør settes nytt. Utseende Her velger man hvilket utseende man ønsker å ha på applikasjonen. Noen er platform-spesfikke som GTK+ for gnome i linux og os x for mac. Metal er default. Programspråk Hvilket språk man ønsker teksten i programmet skal ha. MERK: Endring av språk krever omstart av programmet. 2.3 Tilleggsfunksjoner Brukermanual Dette er en enkel brukermanual som lett kan aksesseres via Hjelp->Brukermanual, og tilbyr enkel forklaring på knapper og hendelser i systemet. Den gir en mer detaljert guideline for spesifikke handlinger som ikke beskrives i brukerveiledningen du nå leser. Forhåndsvisning Et dokument som genereres ut ifra oppgavesettet som er under produksjon og gir lesbart inntrykk av hvordan oppgavesettet ser ut. Generer Prøve Benyttes hvis det er ønskelig å hente ut oppgaver fra andre oppgavesett som er lagret på databasen. Dermed er det mulig lage varianter av andre oppgavesett, uten å måtte lage alle helt fra bunnen av. Detaljert bruksanvisning finnes i brukermanualen 5
Teksteditor Tekst som brukes i spørsmål og svar kan formatteres ved hjelp av in-place editorer (Se figur 2). Man kan: Endre skriftstørrelse og font Formatere med fet, understreket og skråstilt tekst Lime, kopiere og klippe tekst Sette inn matematiske tegn som man ellers ikke finner på tastaturet 2.4 Lagring, kryptering og åpning I quizbuilder er det flere måter å lagre og organisere oppgavesettene på. 1. Lagre lokalt Klikk fil->lagre eller lagre som. Da får du opp en fildialog som lar deg spesifisere hvor du vil lagre oppgavesettet (MERK: oppgavesettet er ikke kryptert) 2. Lagre lokalt kryptert Dette er en lik operasjon som ved lagring lokalt med unntaket av at oppgavesettet blir kryptert og blir uleselig alle utenom Quizbuilder og SolveIt. Er spesielt nyttig ved eksamen. 3. Lagre på database Klikk fil->lagre til database. Dette valget lagrer en kurssamling på databasen. Database kan kjøre lokalt på din maskin (se kap 1.2) eller eksternt. Man får muligheten til å spesifisere og legge til kurssamling som valgt kurs skal være en del av, samt navnet på kurset. Trykk OK for å sende samlingen til databasen. Åpning av oppgaver foregår på lik måte som ved lagring. 1. Åpne fra fil En dialog oppstår som lar deg navigere i filsystemet og velge et oppgavesett. 2. Åpne fra database I dialogen som kommer får man mulighet til å åpne et kurs. velg ønsket samling, og kurset som skal brukes. 6