도움말:퀴즈

큰숲백과에서는 이용자들의 편의성을 높이기 위해 다양한 확장기능을 지원하고 있습니다. 그 중에 하나가 바로 문제지 형식의 위키 문서를 제작할 수 있게 도와주는 퀴즈 확장기능 입니다.

확장기능 사용하는 이유

퀴즈 확장기능은 사용자가 풀 수 있게 하는 문제 형식을 제공합니다. 이를 통해 사용자가 직접 문제를 풀고 학습할 수 있게 도와줍니다.

퀴즈 만드는 방법

퀴즈 태그 사용하기

위키 문법(작성 방법)

표현 결과

비고

퀴즈 태그는 다음과 같은 기능이 있습니다.

퀴즈 문제 위에 정답/오답 점수 배정, 채점 무시기능, 문제 섞기 기능을 설정할 수 있습니다.
문제 왼쪽에는 라디오 단추 형태의 선택 옵션이 있으며, 사용자가 선택할 때 선택한 값이 표시됩니다.
사용자가 자신이 푼 퀴즈 문제에 대한 채점 결과를 확인할 수 있는 제출 버튼이 있습니다.
퀴즈 태그 안의 내용은 퀴즈 확장기능이 문제 형식으로 출력해줍니다.
하나의 퀴즈 태그에 있는 퀴즈 내용은 채점 시에 묶어서 처리합니다. 따라서 사용자는 한 문제마다 채점하기 위해서는 각각의 문제에 퀴즈 태그 하나를 감싸는 방식으로 처리할 수 있습니다.
- <quiz>(문제1)</quiz> <quiz>(문제2)</quiz>

사용 가능한 옵션은 다음과 같습니다.
- 문제의 정답을 맞출 때 추가점수 지정
- 문제의 오답을 고를 때 감점되는 점수 지정
- 점수 지정하지 않기 옵션
- 문제 순서 섞기 - 처음 출력될 때는 퀴즈 태그 안에 작성된 순서대로 작성되지만 문제 섞기 버튼을 눌러서 문제 순서를 섞을 수 있습니다. 한 문제 이하만 있을 경우 나타나지 않습니다.

퀴즈 태그 안에 선택자를 display=simple로 지정하면 퀴즈 문제의 점수 지정과 문제 섞기 버튼 등을 숨길 수 있습니다.
문제 사이에 글을 집어넣는 등 퀴즈 문제를 짧게 표시해야 할 때 유용한 옵션입니다.

quiz 태그의 속성자를 shuffle=none으로 지정할 경우 문제 섞기 버튼을 없앨 수 있습니다.

문제 미리 섞기 : quiz 태그의 속성자를 shuffleanswers=true로 지정할 경우 문제의 선택지 순서를 섞을 수 있습니다.
사용자가 문제를 풀지 않을 때에만 이 기능이 작동하며, 한 문제라도 대답할 경우 문제 표시 순서는 고정됩니다.

문제 삽입하기

문제 입력시 주의해야 할 점은 각 문제 사이에는 반드시 공백을 입력하셔야 합니다.

예제 사용하기

In the examples on this page, there is both wikitext and rendering. The wikitext shows you the code, which you can copy and paste into your pages, or just learn and understand. The rendering shows you what the result will look like.

복사 및 붙여넣기

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 beginning of the lines of the page - i.e. if any line begins with a space, formatting errors may occur.

실제 예제

All the examples below should work. Don't be afraid to try them out. Hitting the correction button is OK - it won't change or damage this page.

기본 문제 유형

Note: For multiple choice questions(MCQs) with negative(-) sign and positive(+) sign, the positive sign(+) signifies the correct answer while the negative(-) sign(s) signifies the wrong answer and this is how Quiz know which answer is correct and which one is wrong.

객관식

wikitext

rendering

comments

{Question
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.

This type of question allows a single correct response and any number of distractors (3 distractors are shown, but it could be one, or nine, or any other number).
The correct answer may be in any position, and is marked by a plus sign. Distractors are marked by minus signs.
The wikitext shown should be inserted between <quiz> tags as shown above.
Answers appear in the same order as in the markup, so it is advisable to shuffle them before exporting into markup.
Every symbol, i.e. |, +, - and any other symbols listed further down, must be on a new line.
The symbols must begin the newline - no spaces before them.
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.
The () symbol in the type attribute is supposed to look like a radio button.
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.

진위 선택형

wikitext

rendering

comments

{Bulgaria and Romania joined the 
European Union in 2007.
|type="()"}
+ TRUE.
- FALSE.

{Switzerland is a member of the 
European Union.
|type="()"}
- TRUE.
+ FALSE.

{Anyone can be a Citizen Journalist.
|type="()"}
+ TRUE.
- FALSE.

In many quiz systems, true/false questions are listed as a separate kind of question, although they are really nothing more than a variety of multiple choice with a single response. The Wikiversity quiz extension correctly treats true/false questions as multiple choice with a single response. They are implemented in exactly the same way as above.
The first of the two examples shows a true/false question where the correct answer is "true".
The second of the two examples shows a true/false question where the correct answer is "false".
The examples are live and can be tried out now.
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.

다중 정답

wikitext

rendering

comments

{Question
|type="[]"}
+ Correct answer.
- Incorrect answer.
+ Correct answer.
- Incorrect answer.

This type of question is a multiple choice where more than one answer could be correct.
Correct answers are indicated by plus signs, incorrect ones by minus signs.
The wikitext shown should be inserted between <quiz> tags as shown above.
Answers appear in the same order as in the markup, so it is advisable to shuffle them before exporting into markup.
Every symbol, i.e. |, +, - and any other symbols listed further down, must be on a new line.
The symbols must begin the newline - no spaces before them.
The borders are a result of the border around the wiki table. They are optional.
The [] symbol in the type attribute is supposed to look like a checkbox.

약술형 문제

wikitext

rendering

comments

{ &nbsp;
|type="{}"}
Where was Aristotle born? 
{ Stageira }

{ &nbsp;
|type="{}"}
Name Aristotle's famous mentor. 
{ Plato }

{ &nbsp;
|type="{}"}
{ Alexander } was Aristotle's most 
famous pupil.

In a typed response the quiz-taker types an answer into a textfield using the keyboard.
The question type is signalled using "{}" as the argument of the type.
A textfield is inserted using curly brackets at the desired position of the textfield.
- Note that curly brackets alone don't create a textfield. The curly brackets must have spaces between them and the enclosed text. { Answer } works, but {Answer} doesn't work.
- The correct answer must be inserted between the curly brackets.
- The textfield can be positioned anywhere in the text. Text before and after the text field will display as normal text.
The borders are a result of the border around the wiki table. They are optional.
A non-breaking space was inserted between { and |type= because some text is required at that position (slightly buggy thing).

{  
|type="{}"}
Name a famous Greek philosopher. 
{ Aristotle|Plato }

Typed responses often have more than one possible answer. You can list all the possible answers inside the curly brackets using a pipe to separate them.
In the example, there are two possible answers. Try it - the demo is live.

{  
|type="{}"}
Name Aristotle's famous mentor. 
{ Plato _6 }

To modify the size of the textfield, add an underscore and an integer following the answer within the curly brackets to represent the number of glyph spaces you need.
This number depends, however it should be around n+2 (where n is the number of glyphs in the answer)

{ Complete each box with a synonym
of the following words
|type="{}"}
#free: { gratis _6 }
#well: { good _4 }

You can group the items into one only question.

{  
|type="{}"}
Where did Aristotle die? 
{ Chalcis (i) }

Case-sensitivity: typed responses are case-sensitive unless you add (i) at the position shown. The (i) stands for case-insensitive.
If some question have more than one possible answer, you should include one (i) for each of them.

빈 칸 채우기

wikitext

{Complete the text from the Wikipedia article on [[w:Aristotle|Aristotle]].
|type="{}"}
Aristotle was born in { Stageira _8 } in Chalcidice. His parents were { Phaestis _8 } 
and { Nicomachus _10 }, who became physician to King Amyntas of Macedon. Aristotle 
was educated as a member of the aristocracy. At about the age of { eighteen|18 _8}, 
he went to { Athens _6 } to continue his education at { Plato _5 }'s Academy. 
Aristotle remained at the Academy for nearly twenty years, not leaving until after 
Plato's death in { 347 _3 } BC.

rendering

comments

Gapfills (or cloze exercises) are created in almost exactly the same way as typed responses. The difference is that you just write a bit more text and add a few more textfields.
The gapfill above was additionally placed in a box and centered using a wiki table.

Numerical response

wikitext

rendering

comments

{In which year was Plato born?
|type="{}"}
He was born in { 427-428 _5 } BC.

At Wikiversity, numerical responses are a subtle modification of typed responses. The syntax is identical, except for some additions which allow numerical ranges and numerical tolerances if the answer is a number.
In the example to the right, the uncertainty over Plato's date of birth is reflected in the answer by using a range. A simple hyphen between the numbers permits all numbers inbetween.

{How far is the earth from the sun?
|type="{}"}
{ 91-95 _3 } million miles.

This is another example of a range.
The _3 ensures that the textfield doesn't get too wide.

{What is 10*10?
|type="{}"}
{ 100 5% _3 }

This is an example of specifying a tolerance. The critical part is "5%", which specifies the expected tolerance of 5%. In this example, values between 95 and 105 should work, but try it.
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.

Because numerical responses are, programmatically, a sub-variety of typed response, numerical and text responses can be freely mixed in a gapfill as shown to the left.

이차원 선다형/ 라디오 단추

wikitext

rendering

comments

{Question
|type="()"}
| A | B | C 
+-- A is correct.
-+- B is correct.
--+ C is correct.

Add extra radio buttons by reduplicating the +/- signs at the beginning of each row.
There should only be one plus sign in each row.
Specify columns headers by using pipes at the top.

이차원 선다형/ 체크상자

wikitext

rendering

comments

{Question
|type="[]"}
| Option A | Option B | Option C 
++- Question 1 
(Clue: A and B are correct).
-++ Question 2 (
Clue: B and C are correct).
--+ Question 3 
(Clue: C is correct).

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.

고급 기능

피드백 추가

wikitext

rendering

comments

 {Question
 |type="()"}
 + The correct answer.
 || Feedback for correct answer.
 - Distractor.
 || Feedback for distractor.
 - Distractor.
 || Feedback for distractor.
 - Distractor.
 || Feedback for distractor.

Feedback is text which is initially hidden, and then shown to the user when they submit the quiz for correction. Feedback typically serves the purposes of encouragement, explanation, congratulation and commiseration.
Feedback is set with all types by using a double vertical line || immediately after a response.
The pipes beginning the feedback section must be on a new line.
Unlike some other quiz systems, all feedback items are displayed on correction. With other quiz systems, the norm is to display the feedback only for those items which were selected by the user.
To try out the feedback effect, choose a response and click the correction button. The feedback will then appear.

문제 사이에 텍스트 상자 집어넣기

wikitext

rendering

comments

{This is the first question.
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.

{This is a block of text.}

{This is the second question.
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.

Text blocks can be inserted between questions by placing it between curly brackets {....}.
The text blocks can contain wiki markup, such images, hyperlinks and formatting tags, as shown in this example.

답안지에 그림 사용

wikitext

rendered

comments

<quiz display=simple>
{ Which of these are not nuts? }
- [[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.

문제에서 그림 사용

wikitext

rendered

comments

<quiz display=simple>
{ What is this? [[Image:Butterfly tongue.jpg|100px| ]]
| type="()" }
- Tiger
+ Butterfly
- Bee
- Fly
</quiz>

In this example, the image is part of the question. You just use normal wiki-markup to insert the image(s).

애니메이션 삽입

The section adds no new technical tricks, but it looks pretty.

하이퍼링크/ 마크업 삽입

퀴즈 확장기능에서 사용 가능한 마크업

Hyperlinks: [[....]].
Images: [[Image:....]].
Other media: [[....]].
Bold and italic.
<big> and <br>

퀴즈 확장기능에서 부분적으로 사용 가능한 마크업

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 :

음악/사운드 삽입

This is similar to insertion of images. Standard wiki markup is used.

점수 책정

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. The "!" stands for "ignore the questions' coefficients".
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.

조작 태그 뒤섞기

wikitext

rendered

comments

<quiz>

{X}

{ Sample Question 1
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.

{ Sample Question 2
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.

{/X}

{!X}

{ Sample Question 3
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.

{ Sample Question 4
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.

{/X}

</quiz>

Conditional shuffling using tags:It can be achieved by using {X},{!X} and {/X} tags inside quiz.Any questions that are within {X} and {/X} are treated as a block and will be shuffled.The questions that are within {!X} and {/X} are not shuffled internally, i.e the order of questions inside {!X} and {/X} remain the same.

In the example Sample Question 1 and 2 can be shuffled but Sample Question 3 and 4 are always in the same order.

문제 해결

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.

참조

Wikipedia

MediaWik i

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

이 문서에는 영어판 위키배움터의 Help:Quiz 문서를 번역한 내용이 포함되어 있습니다.