Pomoc:Quiz: Różnice pomiędzy wersjami

Usunięta treść Dodana treść

Jednokolumnowy

Wersja z 20:31, 29 sie 2010

To jest strona pomocy dla rozszerzenia quiz.

To rozszerzenie składa się z kilku prostych komend, a ta strona jest tak długa tylko ze względu na możliwe kombinacje pomiędzy nimi.

Jak zrobić Quiz w podręczniku

Tag quiz

wikitekst
(to co piszesz)

rendering
(to co widzisz)

uwagi

<quiz>
tutaj umieść pytanie
</quiz>

Tagi quiz umożliwiają następujące rzeczy:

Umieścić standardowe opcje quizów i pokazanie odpowiedzi za pomocą kolorów. Klucz odpowiedzi wg kolorów pojawia się tylko jeśli zostały zaznaczone odpowiedzi.
Dodanie przycisku "wyślij" na dole, kiedy użytkownik skończy quiz i będzie chciał poznać odpowiedzi.
Wszystko pomiędzy tagami "quiz" jest parsowane przez rozszerzenie Quiz i zamieniane w pytanie, jeśli jest to tylko możliwe.

Teoretycznie możliwe jest użycie tagów quiz osobno przy każdym pytaniu, pozwalając odpowiadać na nie po kolei.

Shuffling questions: if the shuffle questions button is shown, the questions can be shuffled by clicking the button. This only works so long as the quiz-taker has not started to answer the questions. Once the quiz-taker starts answering, the order is locked.

<quiz display=simple>
tutaj umieść pytanie
</quiz>

Importantly, the addition of "display=simple" as an attribute of the quiz tag removes the points table at the top.
This is useful for short quizzes, and especially for situations where you insert single questions between text blocks.

<quiz shuffle=none>
insert questions here
</quiz>

If you'd like to keep the points table but get rid of the button for shuffling questions, use shuffle=none as shown.

Umieszczanie pytań

Typy pytań znajdują się poniżej. Co ważne, każde pytanie w jednym quzie musi być oddzielone pustym wierszem, inaczej zostaną one potraktowane jako jedno długie pytanie.

Jak czytać przykłady

Przykłady na tej stronie są pokazane na dwa sposoby: jako wikitekst oraz w postaci zrenderowanej. Wikitekst pokazuje kod, który można skopiować do własnego quizy, natomiast rendering pokazuje efekt użytego kodu.

Kopiowanie i wklejanie

The markup has been slightly simplified in order to help understanding. If you copy and paste, you must insert <quiz> tags before and after the markup. You may wish to use the quiz tags with the "display=simple" option as shown above.

Note that the actual example below also use tables for clarity. If a quiz is inserted into a table, this modifies the appearance of a quiz - for example, boxes appear around some elements in the quiz. If you don't use a table, these boxes disappear and your quiz will look plainer.

When pasting, ensure that all the symbols are aligned with the left of the page - i.e. if any line begins with a space, formating errors may occur.

Przykłady

Wszystkie poniższe przykłady powinny działać. Nie bój się je wypróbować. Użycie przycisków nie spowoduje uszkodzeń ani zmian w samej stronie.

Podstawowe typy pytań

Wiele możliwości i jedna odpowiedź

wikitekst

rendering

uwagi

{Pytanie
|type="()"}
+ Prawda
- Fałsz
- Fałsz
- Fałsz

Ten typ pytań posiada jedną dobrą odpowiedź i dowolną liczbę złych (pokazane są trzy złe, ale ich liczba jest nieograniczona).
Poprawna odpowiedź może być w dowolnym wierszu, a żeby ją wyróżnić przed nią musi zostać umieszczony znak "+". Przed nieprawidłowymi odpowiedziami należy użyć znaku "-".
Wikitekst powinien być umieszczony pomiędzy tagami <quiz> i </qiuz>.
Odpowiedzi pojawiają się w tej samej kolejności co w kodzie, więc należy je wymieszać przed dodaniem ich do kodu.
Każdy symbol, jak np. |, "+", "-" i każdy tego typu, musi znaleźć się na początku każdego nowego wiersza.
Symbol oznaczający prawdziwość odpowiedzi ("+" i "-") musi znajdować się na początku nowej linii - przed nim nie może pojawić się nawet spacja.
The borders are a result of the border around the wiki table. They are optional.
A distractor is the standard term for a multiple choice option which is wrong.
Nawias () w atrybucie "type" symbolizuje odpowiedzi jednokrotnego wyboru (radio).
To see the full colour code (with four colours), try doing the quiz and clicking the correction button.
A second click on a radio button (i.e. a click on an already clicked radio button) will deselect it.

Pytania Prawda/Fałsz

wikitekst

rendering

uwagi

{Bułgaria i Rumunia 
dołączyły do Unii Europejskie w 2007.
|type="()"}
+ Prawda
- Fałsz

{Szwajcaria jest 
członkiem Unii Europejskiej.
|type="()"}
- Prawda
+ Fałsz

	Prawda
	Fałsz

	Prawda
	Fałsz

W wielu quizach pytanie typu Prawda/Fałsz są uważane jako osobny typ, chociaż tak naprawdę są one wariacją wielu możliwości z jedną poprawną odpowiedzią. To rozszerzenie traktuje oba rodzaje quizów identycznie i ich wywołanie wygląda identycznie, jedyna różnica to ilość możliwych odpowiedzi.
Pierwszy przykład pokazuje, że poprawną odpowiedzią jest "Prawda".
Drugi przykład pokazuje, że poprawną odpowiedzią może być też "Fałsz".
Przykłady są aktywne i można je sprawdzić teraz.
If you have a large number of true/false questions, a more efficient way to lay them out would be to use the tabular response type with radio buttons documented below.

Test wielokrotnego wyboru

wikitekst

rendering

uwagi

{Pytanie
|type="[]"}
+ Poprawna odpowiedź
- Błędna odpowiedź
+ Poprawna odpowiedź
- Błędna odpowiedź

Ten typ quizów umożliwia istnienie więcej poprawnych odpowiedzi niż jedna.
Poprawne odpowiedz w kodzie poprzedzone są znakiem "+", fałszy "-".
Wikitekst powinien być umieszczony pomiędzy tagami <quiz> i </qiuz>.
Answers appear in the same order as in the markup, so it is advisable to shuffle them before exporting into markup.
Każdy symbol, jak np. |, "+", "-" i każdy tego typu, musi znaleźć się na początku każdego nowego wiersza.
Symbol oznaczający prawdziwość odpowiedzi ("+" i "-") musi znajdować się na początku nowej linii - przed nim nie może pojawić się nawet spacja.
The borders are a result of the border around the wiki table. They are optional.
Oznaczenie [] jest atrybutem wskazującym na tworzenie testu wielokrotnego wyboru (checkbox).

Krótkie odpowiedzi

wikitekst

rendering

uwagi

{ &nbsp;
|type="{}"}
Gdzie urodził się Arystoteles?
{ Stagira }

{ &nbsp;
|type="{}"}
Imię nauczyciela Arystotelesa? 
{ Platon }

{ &nbsp;
|type="{}"}
{ Aleksander } był 
najsłynniejszym uczniem Arystotelesa.

W teście otwartym użytkownik sam wpisuje odpowiedzi.
Typ pytania jest sygnalizowany poprzez użycie "{}" jako typu.
Pole tekstowe jest umieszczane w kodzie przy pomocy klamer, które wskazują miejsce jego pojawienia się.
- Same klamry nie tworzą pola tekstowego. Pomiędzy klamrami a odpowiedzią musi być jeden znak przerwy (spacja), czyli zadziała { Odpowiedź }, ale już nie zadziała {Odpowiedź}.
- Poprawna odpowiedź musi być umieszczona pomiędzy klamrami.
- Pole tekstowe może być umieszczone gdziekolwiek w tekście. Tekst za nim i przed nim będzie normalnie wyświetlany.
Obramowanie wynika wyłącznie z wikitabelki.

{  
|type="{}"}
Imię słynnego greckiego filozofa.
{ Arystoteles|Platon }

Zwykle w tego typu testach jest prawidłowa więcej niż jedna odpowiedź, dlatego większą ilość odpowiedzi można umieszczać w klamrach, oddzielając je pipem ("|").
W przykładzie są 2 możliwe odpowiedzi, śmiało je wypróbuj.

{  
|type="{}"}
Imię sławnego mentora Arystotelesa?
{ Plato _6 }

Aby ustalić wielkość pola tekstowego, należy najpierw wpisać podkreślnik ("_"), a następnie liczbę pól jakie ma zająć wyraz.
Liczba pól powinna być równa liczbie znaków w odpowiedzi, jednak zaleca się, aby była większa o 2 od znaków w odpowiedzi.

{ Uzupełnij pola synonimami słów.
|type="{}"}
<ol>
<li>bonus: { gratis _6 }</li>
<li>nieźle: { dobrze _8 }</li>
</ol>

Można grupować wiele pól odpowiedzi w jednym pytaniu.
Nie używaj w różnych wierszach </li> and <li> (nie korzystaj z enterów).

{  
|type="{}"}
Gdzie umarł Arystoteles? 
{ Chalkis (i) }

Wielkość liter: Odpowiedzi wpisane przez użytkowników muszą mieć taką samą wielkość, jak podane przez twórcę, chyba że w kodzie zostanie umieszczone oznaczenie (i) tuż po odpowiedzi.
Jeśli jakieś pytanie ma więcej możliwych odpowiedzi, to powinieneś użyć (i) dla każdego z nich osobno.

Uzupełnianki

wikitekst

{Uzupełnij tekst na podstawie artykułu z 
Wikipedii:[[w:Arystoteles|Arystoteles]].
|type="{}"}
Arystoteles urodził się w roku { 384 _3 } p.n.e. w greckiej kolonii { Stagira _7 }
 (τα Στάγειρα) (dlatego mówi się o nim także Stagiryta), u wybrzeży Tracji. Jego 
ojciec { Nikomachos _10 } był nadwornym lekarzem macedońskiego króla Amyntasa. 
Matka Arystotelesa miała na imię { Phaestis _8 } (Fajstiada).

rendering

uwagi

Uzupełnianki są bardzo podobne do odpowiedzi słownych. Różnicą jest tylko to, że użyta jest większa ilość tekstu i więcej pól do uzupełnienia.
Uzupełniankę dodatkowo umieszczono w ramce i wyśrodkowano przy użyciu wiki tabeli.

Odpowiedź liczbowa

wikitekst

rendering

uwagi

{W którym roku urodził się Platon?
|type="{}"}
Urodził się w { 427-428 _5 } p.n.e.

W tym rozszerzeniu test liczbowy nieznacznie różni się od testu z odpowiedziami tekstowymi. Różnicą jest to, że odpowiedzi mogą zawierać pewien margines błędu.
W przykładzie po prawej pytanie dotyczy roku, w którym urodził się Platon. Podając możliwe odpowiedz połączone myślnikiem, spowodujemy, że wszystkie wartości z zakresu będą poprawne.

{Ile kilometrów od Słońca
 znajduje się Ziemia?
|type="{}"}
{ 148-151 _3 } miliony kilometrów.

Oznaczenie _3 pozwala mieć pewność, że pole przeznaczone na tekst nie będzie zbyt szerokie.

{Ile to jest 10 razy 10?
|type="{}"}
{ 100 5% _3 }

To jest przykład tolerancji wyniku. Tutaj główne znaczenie ma oznaczenie "5%", które powoduje pięcioprocentową tolerancję wyniku. W tym przykładzie prawidłową wartością powinno być zarówno 95 jak i 105.
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.

Ziemia, zamieszkana przez miliony gatunków, wliczając w to człowieka, jest jedynym znanym miejscem we wszechświecie, w którym występuje

. Planeta uformowała się

miliarda lat temu, a życie pojawiło się na jej powierzchni w ciągu

miliarda lat po uformowaniu.

The Earth formed around

billion years ago and its only known natural satellite, the

, began orbiting it around

billion years ago. At present, the Earth orbits the

once for every roughly

times it rotates about its axis.

Uzupełnianie liczb i słów można dowolnie mieszać.

Test wielokrotnego wyboru przy pomocy pól jednokrotnego wyboru

wikitekst

rendering

uwagi

 {Pytanie
 |type="()"}
 | A | B | C 
 +-- A jest poprawne.
 -+- B jest poprawne.
 --+ C jest poprawne.

Dodaje dodatkowe pola jednokrotnego wybory w linii za pomocą znaków +/- użytych po sobie.
W każdym wierszu powinien wystąpić wyłącznie jeden znak "+".
Poszczególne nagłówki kolumn powstały za pomocą pionowych kresek użytych między nimi.

Tabular response type with checkboxes

wikitekst

rendering

uwagi

{Pytanie
|type="[]"}
| Opcja A | Opcja B | Opcja C 
++- Pytanie 1
(Podpowiedź: A i B są poprawne).
-++ Pytanie 2 (
Podpowiedź: B i C są poprawne).
--+ Pytanie 3 
(Podpowiedź: C jest poprawne).

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.

Zaawansowane możliwości

Umieszczenie dodatkowych wyjaśnień

wikitekst

rendering

uwagi

 {Pytanie
 |type="()"}
 + Prawidłowa odpowiedź
 || Wyjaśnienie dla prawidłowej odpowiedzi
 - Fałszywa odpowiedź
 || Wyjaśnienie dla fałszywej odpowiedzi
 - Fałszywa odpowiedź
 || Wyjaśnienie dla fałszywej odpowiedzi
 - Fałszywa odpowiedź
 || Wyjaśnienie dla fałszywej odpowiedzi

Dodatkowe wyjaśnienie to tekst, który początkowo jest ukryty i pojawia się po pokazaniu odpowiedzi. Tak umieszczone informacje zwykle zawierają wytłumaczenie, komenatarz itp.
Wyjaśnienia mogą być umieszczone przy każdej odpowiedzi, wystarczy, że w wiersz poniżej zostanie rozpoczęty od "||".
Symbol wyjaśnień musi znajdować się na początku wiersza.
W odwrotności do innych typów testów tutaj do każdej odpowiedzi może być podany komentarz.
Żeby sprawdzić system wyjaśnień wybierz odpowiedź i zatwierdź test, komentarz pojawi się tuż po tym.

Umieszczanie bloków tekstu między kolejnymi pytaniami

wikitekst

rendering

uwagi

{To jest pierwsze pytanie.
|type="()"}
+ Prawidłowa odpowiedź
- Zła odpowiedź
- Zła odpowiedź

{To jest blok tekstu}

{To jest drugie pytanie.
|type="()"}
+ Prawidłowa odpowiedź
- Zła odpowiedź
- Zła odpowiedź

	Prawidłowa odpowiedź
	Zła odpowiedź
	Zła odpowiedź

Arktyka – obszar Ziemi otaczający biegun północny. Jej granice określa się w różny sposób. Według definicji klimatyczno-ekologicznej wyznacza ją lipcowa izoterma +10 °C, która w przybliżeniu pokrywa się również z północną granicą wegetacji drzew. Według innej, Arktykę ogranicza koło podbiegunowe północne, co jednak sprawia, że w jej obrębie znajdują się również duże obszary Norwegii i Szwecji o dość umiarkowanym klimacie. Arktyka obejmuje część Rosji, Kanady, Norwegii, Szwecji, Finlandii, Alaskę (Stany Zjednoczone), Grenlandię (terytorium duńskie), Islandię oraz Ocean Arktyczny.

	Prawidłowa odpowiedź
	Zła odpowiedź
	Zła odpowiedź

Bloki tekstu mogą być umieszczone pomiędzy pytaniami, kiedy są umieszczone między klamrami - {....}.
Bloki tekstu mogą zawierać grafiki, linki i formatowanie, tak jak widać na przykładzie.

Używanie grafik jako odpowiedzi

wikitekst

rendered

uwagi

<quiz display=simple>
{ Która grafika nie przedstawia orzechów? }
- [[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.

Używanie grafik w pytaniach

wikitekst

rendering

uwagi

<quiz display=simple>
{ Co to jest? [[Image:Butterfly tongue.jpg|100px| ]]
| type="()" }
- Tygrys
+ Motyl
- Pszczoła
- Mucha
</quiz>

W tym przykładzie grafika jest częścią pytania. Do jej wstawiania używasz standardowych tagów.

Używanie animacji

W tej sekcji nie pojawia się nic nowego, ale jest dość efektowna :)

Hiperłącza i inne znaczniki

Znaczniki działające w quizach

Hiperłącza: [[....]].
Multimedia [[Plik:....]].
Pogrubienie i kursywa.
<big> and <br />

Markup that partly works inside quizzes

Templates: {{....}}.
- subst doesn't work.
Tables: {|....|}.
Headings: e.g. ===....===.
- Warning: At the moment there is a problem with the toc.
Lists and indents: using #, * and :

Umieszczanie utworów muzycznych i dźwieków

Jest to podobne do używania grafik. Działają tutaj standardowe komendy wikikodu.

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.

Troubleshooting

You cannot test out the quiz while editing a page, because the submit button is grayed out. If you wish to test your new quiz, then create a sandbox page somewhere else first (e.g. as a subpage of your user page), then test the quiz there, and finally transfer the quiz to its final location (and test it again anyway).
The quiz was developed for IE6, IE7, Firefox (and Opera?), but display quality on Opera may not be optimal, and there may be display differences between browsers.
A reminder: each question must be separated by a blank line, otherwise the questions are merged together into one question.

Future stuff

Information about future developments is mainly available at the project space on MediaWiki. Lots of things are in planning.

Zobacz też

MediaWiki

The quiz extension project at MediaWiki where discussion and development of the quiz extension takes place.