# The &kwordquiz; Handbook

## Introduction

&kwordquiz; is a tool that gives you a powerful way to master new vocabularies. It may be a language or any other kind of terminology.

### Easy to use

With &kwordquiz; you build your own vocabulary documents in a simple and intuitive way. The basic layout is a two-column spreadsheet where you type vocabulary entries in one form that you know and in another form that you want to learn. You change the titles of the columns to reflect what you are practicing.

#### Quiz types

When you have entered your vocabulary, you are ready to start a quiz. Maybe you want to start with a flashcard session. Later you can move on to a multiple choice quiz, or do the powerful question and answer quiz. You get instant feedback on correct and incorrect answers, and you have the option to repeat any errors, further improving your learning efficiency. If you need a little extra help you can use the hint function.

#### Practice modes

You can select how you want to practice. &kwordquiz; offers three different modes to make practicing more efficient. The different modes make it possible to decide which column is used as a question, answer or both. Additionally you can choose whether to use a sequential or random order.

#### Vocabulary documents

&kwordquiz; can open several types of vocabulary data. The default format is `.kvtml`, a file format shared by several &kde; programs. &kwordquiz; should also open `.wql` files created by &kwordquiz; for &Windows;, `.csv` files with comma separated text, `.voc` files created by the old version of Vokabeltrainer, `.xdxf` files, and `.xml.gz` files created by the old versions of Pauker.

&kwordquiz; can save your vocabulary documents in several different formats. The default is the `.kvtml` format used by other &kde; programs. Another available option is comma separated text `.csv`.

You can have several files open at the same time, and easily copy or move entries between files.

## Command Reference

### The Options Menu

The menu provides 3 different options for the quiz which are not mutually exclusive.

The menu names will change to reflect the column titles of the currently active vocabulary document. The selected mode will apply to Flashcard, Multiple Choice and Question & Answer.

Options Shuffle

- During the quiz you will be given the entries in a random order, but each entry will be processed once.

Options Column 1 -> Column 2

- During the quiz you will be given the entries of Column 1 and asked to provide the corresponding Column 2 entries.

Mode Column 2 -> Column 1

- During the quiz you will be given the entries of Column 2 and asked to provide the corresponding Column 1 entries.

## The Welcome Page

When opening KWordQuiz, you will land on the welcome page. This page will list all the previously opened deck. Additionally it lets you create a new deck, open a deck from a file or download deck from the internet. Finally you can also choose which main mode you want to use.

The Welcome Page The Welcome Page

## The Vocabulary Editor

The vocabulary document area has the appearance of a spreadsheet-like grid. The grid consists of cells organized in two columns and a number of rows. Each column and row has a header. The column headers are used to specify the titles of the vocabulary document. They can be set by editing the first row.

You can click in a cell of the grid to make it the active cell. You can use the up and down arrow to move up and down in the table and tab to move to the next element.

The Vocabulary Editor The Vocabulary Editor

In the document, you build a vocabulary of pair-wise entries in the two columns. You can enter text into the active cell simply by starting to type. The cell will now be in edit mode and you can select all or part of the text. You can also edit a cell by double-clicking it or by pressing F2 and making changes directly in the cell.

When you have finished typing one entry, press the return key and the next cell will automatically become active. Hence, it's easy to quickly type several entries. There is really no limit to the number of rows you can have in a document.

## Flashcard Session

Select Flashcard from the navigation panel to start a flashcard session on the entries of the active vocabulary document. The mode selected in the Options menu will be used. If you change the options during a session, the session will be restarted.

If you are working with long expressions, the window can be resized to make more space available. The font size will also influence how much will fit in the different parts of the window.

Flashcard Session Flashcard Session

Initially the front of the card is displayed. Use the Check to see the other side.

To move on to the next card, either select I Know to count the card as correct or I Don't Know to count the card as incorrect.

Select Repeat Errors to repeat the cards you have counted as incorrect.

Select Try again to start the session from the beginning again. If you are using a random mode the cards will be reshuffled.

The score section at the top of the screen shows the number of cards, the number of cards you have seen, the number of cards counted as correct, and the number counted as incorrect.

## Multiple Choice Session

Select Multiple Choice in the welcome page to start a multiple choice quiz on the entries in the active vocabulary document. The mode selected in the Options menu will be used. If you change options during a session, the session will be restarted.

If you are working with long expressions the window can be resized to make more room. The font size (selected for the editor) will also influence how much will fit in the different parts of the window.

In the example below the user gave an incorrect answer to the previous question. He/she is now about to answer the next question.

Multiple Choice Session Multiple Choice Session

Your choices are shown on the middle of the screen. Select the one you think is correct. Use Check to see if the answer is correct. If you have activated the automatic mode in Settings your selection is checked immediately.

Select Repeat Errors to repeat the cards you have counted as incorrect.

Select Try again to start the session from the beginning again. If you are using a random mode the cards will be reshuffled.

The score section at the top of the screen shows the number of questions, the number of questions you have answered, the number of correct answers, and the number of incorrect answers.

## Question & Answer Session

Select Question & Answer from the navigation panel to start a question & answer session on the entries in the active vocabulary. The mode selected in the Mode menu will be used. If you change mode during a session, the session will be restarted.

If you are working with long expressions, the window can be resized to make more room. The font size (selected for the editor) will also influence how much will fit in the different parts of the window.

In the example below the user gave a correct answer to the previous question (to see how incorrect answers are handled, see the Multiple Choice chapter). He/she is now about to answer the next question.

Question & Answer Session Question & Answer Session

Your question is shown on the center. Type your answer in the edit field. Use Check or &Enter; to see if the answer is correct.

Select Hint to get the next correct letter of the answer. In Settings you may choose to count any questions where you use the hint function as incorrect.

Select Repeat Errors to repeat the cards you have counted as incorrect.

Select Try again to start the session from the beginning again. If you are using a random mode the cards will be reshuffled.

The score section at the top of the screen shows the number of questions, the number of questions you have answered, the number of correct answers, and the number of incorrect answers.

## Fill-in-the-blank

'Fill-in-the-blank' is a powerful way to practice in &kwordquiz;. It is a special kind of question and answer quiz that needs to be described in more detail.

Consider the following table. It could be a vocabulary in &kwordquiz;:

| English | German
1 | We own a computer | Wir besitzen einen Computer
2 | We own a computer | Wir [besitzen] einen Computer
3 | We own a computer | Wir [besitzen einen] Computer
4 | We own a computer | Wir [besitzen] einen [Computer]

The important thing to note is the placement of the brackets. They tell &kwordquiz; how the quiz should be performed.

In 1. there are no brackets. Assuming English is the question and German the answer you have to give the entire expression 'Wir besitzen einen Computer' for a correct answer.

In 2. &kwordquiz; would display the question but also 'Wir ........ einen Computer'. For a correct answer it is sufficient to write 'besitzen'.

3. shows that a blank can consist of more than one word. The correct answer is 'besitzen einen'.

In 4. there are two separate blanks. To specify that in the answer you have to write 'besitzen; Computer', &ie; separate the blanks with a semicolon in order to get a correct answer.

Marked blanks are only of relevance if they appear in the answer. Otherwise the brackets are ignored. Furthermore, brackets have no effect in multiple choice quizzes. To simplify the creation of 'Fill-in-the-blank' vocabularies there are menu commands to mark and unmark blanks. Of course you can also just type the brackets. &kwordquiz; checks the syntax. If the text appears in red there is something wrong with the brackets and a quiz cannot be started.

## Printing

&kwordquiz; provides the ability to print vocabulary documents in several different ways. The printing options are available in the &kwordquiz; editor. When selecting Print... you are presented with a menu where you can select to print the document as a vocabulary list (&ie; as displayed in the editor), a vocabulary exam, or as flashcards. Once the mode is selected, you will be presented with the standard &kde; print dialog.

Vocabulary Printing Options Vocabulary Printing Options

## Vocabulary list

The vocabulary will be printed as displayed in the editor. This includes font, row heights, and column widths. Make sure that the columns are narrow enough to fit on the page.

Print Vocabulary List Print Vocabulary List

## Vocabulary exam

The vocabulary will be printed as displayed in the editor, except that the right column will be left empty and a third column for scoring is added. Settings used include font, row heights, and column widths. Make sure that the columns are narrow enough to fit on the page.

Print Vocabulary Exam Print Vocabulary Exam

## Flashcards

Two 3" x 5" cards per page. The cards will always be printed in landscape.

Print Flashcards Print Flashcards

## Dialogs

### General Settings

General Settings General Settings

You can select what type of session a newly opened vocabulary should start in. Going directly to a quiz can prevent you from seeing any entries in advance.

For all sessions you can select if the scores should be displayed as percentages instead of absolute numbers.

Note that the settings are automatically applied.

### Column Settings

You can open this dialog from the editor.

Column Settings Column Settings

Use this dialog to define the column titles and column languages. Click on a language to selected it or close the dialog to discard any changes.

## Credits and License

&kwordquiz;

Program copyright 2003-2008 Peter B. Hedlund peter.hedlund@kdemail.net 2023 Carl Schwan carl@carlchwan.eu

Documentation copyright 2003-2008 Peter B. Hedlund peter.hedlund@kdemail.net

&underFDL; &underGPL;
&documentation.index;