# El manual de &kwordquiz;

## Introducción

&kwordquiz; es una potente herramienta que le permite aprender nuevos vocabularios. Estos pueden ser de un idioma o relacionados con cualquier otro tipo de terminología.

### Fácil de usar

Con &kwordquiz; puede crear sus propios documentos de vocabulario de una forma fácil e intuitiva. Su diseño básico es el de una hoja de cálculo con dos columnas; en una columna puede teclear las entradas del vocabulario en una forma que ya conozca, y en la otra columna esa otra forma que desea aprender. Puede cambiar los títulos de las columnas para reflejar lo que está practicando.

#### Modos de práctica

Before you start a quiz you select how you want to practice. &kwordquiz; offers five different modes to make practicing more efficient. The different modes make it possible to have the quiz go through your vocabulary in sequential or random order in one or both directions.

#### Tipos de pruebas

When you have entered your vocabulary and selected a mode you are ready to start a quiz. Maybe you want to start with a flashcard session, then 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.

#### Documentos de vocabulario

&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 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.

## Guía de órdenes

### The File Menu

&Ctrl;N File New

- New creates a new blank vocabulary document

&Ctrl;O File Open...

- Open one or more existing vocabulary documents.

File Open Recent

- Open a recently used vocabulary document.

&Ctrl;G File Download New Vocabularies...

- Downloads new vocabularies. Downloaded vocabularies can be found in `$XDG_DATA_HOME/kvtml` directory. `$XDG_DATA_HOME` is usually a hidden folder in your Home folder called `.local`.

&Ctrl;S File Save

- Save the active vocabulary document to disk.

&Ctrl;&Shift;S File Save As...

- Save the active vocabulary document with a new name.

&Ctrl;P File Print...

- Print the active vocabulary document. &kwordquiz; provides several options for printing your vocabularies.

File Print Preview

- Show preview of the active vocabulary document printed by &kwordquiz;.

&Ctrl;W File Close

- Close the active vocabulary document.

&Ctrl;Q File Quit

- Quit &kwordquiz;

### The Edit Menu

&Ctrl;Z Edit Undo

- Undo the last command. The name of this item will change to reflect what will be undone.

&Ctrl;&Shift;Z Edit Redo

- Redo the last command. The name of this item will change to reflect what will be redone.

&Ctrl;X Edit Cut

- Cut the current selection and place it on the clipboard.

&Ctrl;C Edit Copy

- Copy the current selection and place it on the clipboard.

&Ctrl;V Edit Paste

- Paste the content of the clipboard to the current selection. If only one cell is selected &kwordquiz; will activate smart pasting and calculate the space required for pasting and add rows if necessary.

Del Edit Clear

- Clear the current selection.

&Ctrl;I Edit Insert Row

- Insert a new row at the current selection. If the selection extends over more than one row, an equal number of rows will be inserted.

&Ctrl;K Edit Delete Row

- Delete the selected row. If the selection extends over more than one row, all selected rows will be deleted.

&Ctrl;M Edit Mark as Blank

- Mark as Blank marks selected text (or the word where the caret is) as a blank for a 'Fill-in-the-blank' quiz, &ie; it's enclosed in brackets. Only available if Fill-in-the-blank is enabled.

Edit Unmark Blanks

- Unmark Blanks clears previously assigned blanks, &ie; brackets are removed. Only available if Fill-in-the-blank is enabled.

### The Vocabulary Menu

&Ctrl;L Vocabulary Column Settings...

- Define the titles, the keyboard layouts, and the widths of the two columns in the vocabulary. Displays a dialog.

Vocabulary Font...

- Change the font used to display the vocabulary.

Vocabulary Link Image...

- Specify the image that should be linked with the current entry.

Vocabulary Link Sound...

- Specify the sound that should be linked with the current entry.

Vocabulary Adjust Row Heights

- Adjust the height of the rows to fit the content.

Vocabulary Shuffle

- Shuffle the vocabulary entries in a random order. The order of the entries in the actual vocabulary document is not changed.

### The Mode Menu

The menu provides five different modes for the quiz.

Note that the menu names will change to reflect the column titles of the currently active vocabulary document. The mode must be selected before a quiz is started. The selected mode will apply to Flashcard, Multiple Choice and Question & Answer.

Mode 1 Column 1 -> Column 2 In Order

- During the quiz you will be given the entries of Column 1 and asked to provide the corresponding Column 2 entries. This will be done in the order the entries appear in the vocabulary document.

Mode 2 Column 2 -> Column 1 In Order

- During the quiz you will be given the entries of Column 2 and asked to provide the corresponding Column 1 entries. This will be done in the order the entries appear in the vocabulary document.

Mode 3 Column 1 -> Column 2 Randomly

- During the quiz you will be given the entries of Column 1 and asked to provide the corresponding Column 2 entries. This will be done in a random order, but each entry will be asked once.

Mode 4 Column 2 -> Column 1 Randomly

- During the quiz you will be given the entries of Column 2 and asked to provide the corresponding Column 1 entries. This will be done in random order, but each entry will be asked once.

Mode 5 Column 1 <-> Column 2 Randomly

- During the quiz you will be given an entry of either Column 1 or Column 2 and asked to provide the corresponding entry in the other column. This will be done in a random order for both column and entry. Each possible combination will be asked once.

### The Quiz Menu

Return Quiz Check

- Check if your answer is correct

K Quiz I Know

- Count as correct during a flashcard session.

D Quiz I Do Not Know

- Count as error during a flashcard session. You can later repeat these cards by selecting Quiz Repeat Errors.

&Ctrl;H Quiz Hint

- Get the next correct letter during a Question & Answer session.

&Ctrl;B Quiz Play Audio

- Play sound that was linked to the entry with Vocabulary Link Sound.

&Ctrl;R Quiz Restart

- Restart the quiz session from the beginning. Will reset the scores.

&Ctrl;E Quiz Repeat Errors

- Repeat any questions you answered incorrectly. Becomes available once you have answered all questions once.

Quiz Export Errors As...

- Export any questions you answered incorrectly as a new vocabulary document. Becomes available once you have answered all questions once.

### The Settings and Help Menu

Apart from the common &kde; Settings and Help menu items described in the Settings Menu and Help Menu of the &kde; Fundamentals &kwordquiz; this additional menu entry:

Settings Show Search

- Toggle display of the search bar.

## The Main Window

The main window has a navigation panel on the left side from which the main components of the program can be activated.

The editor can be activated by pressing F6.

A flashcard session can be started by pressing F7.

A multiple choice session can be started by pressing F8.

A question and answer session can be started by pressing F9.

The Main Window The Main Window

## El editor de vocabulario

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 selecting Vocabulary Column Settings.... The row headers number the rows consecutively.

The column headers can also be used to sort the vocabulary. Simply click on the header of the column you want to sort by.

You can click in a cell of the grid to make it the active cell. You can select several cells for copying or other editing by dragging over them with the left mouse button down. To select entire rows click in the header.

El editor de vocabulario El editor de vocabulario

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 pressing F2 and make 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. You can customize this behavior by selecting Settings Configure &kwordquiz;.... When you reach the bottom row of the grid, a new row will be added as you press return, so you can just continue to type. When a new window is created it has 20 rows, but there is really no limit to the number of rows you can have in a document.

## Sesión de tarjetas

Select Flashcard from the navigation panel to start a flashcard session on the entries of the active vocabulary document. 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 space available. The font size will also influence how much will fit in the different parts of the window. By selecting Settings Configure &kwordquiz;... you can configure the appearance of the flashcards.

Sesión de tarjetas Sesión de tarjetas

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

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

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

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

The score sections at the bottom 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.

All items on the Quiz menu are available on the Quiz toolbar that is displayed on the right by default.

## Sesión de elección múltiple

Select Multiple Choice from the navigation panel to start a multiple choice quiz on the entries in the active vocabulary document. The mode selected in the Mode menu will be used. If you change mode during a session, the session will be restarted.

Si está trabajando con expresiones largas, puede redimensionar la ventana para tener más espacio disponible. El tamaño de letra (seleccionado por el editor) también influirá en lo que puede o no caber en las diferentes partes de la ventana.

En el ejemplo que se muestra a continuación, el usuario ha contestado incorrectamente a la pregunta anterior. En este momento está a punto de responder a la siguiente pregunta.

Sesión de elección múltiple Sesión de elección múltiple

Your choices are shown on the top left. Select the one you think is correct. Use Quiz Check to see if the answer is correct. If you have activated the automatic mode in Settings Configure &kwordquiz;... your selection is checked immediately.

The previous question is shown below the current. The answer you gave is also displayed. If you answered incorrectly the correct answer is shown.

Select Quiz Repeat Errors to repeat the questions you answered incorrectly.

Select Quiz Restart to start the session from the beginning again. If you are using a random mode the questions will be reshuffled.

The score sections at the bottom 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.

All items on the Quiz menu are available on the Quiz toolbar that is displayed on the right by default.

## Sesión de pregunta y respuesta

Seleccione «Pregunta y respuesta» en el panel de navegación para iniciar un sesión de pregunta y respuesta usando las entradas del vocabulario activo. Se utilizará el modo seleccionado en el menú Modo. Si cambia el modo durante una sesión, esta se reiniciará.

Si está trabajando con expresiones largas, puede redimensionar la ventana para tener más espacio disponible. El tamaño de letra (seleccionado por el editor) también influirá en lo que puede o no caber en las diferentes partes de la ventana.

En el ejemplo que se muestra a continuación, el usuario proporcionó una respuesta incorrecta a la pregunta anterior (para saber más acerca de cómo se manejan las respuestas incorrectas, consulte el capítulo Elección múltiple). En este momento está a punto de responder la siguiente pregunta.

Sesión de pregunta y respuesta Sesión de pregunta y respuesta

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

The previous question is shown below the current. The answer you gave is also displayed. If you answered incorrectly the correct answer is shown.

Select Quiz Hint to get the next correct letter of the answer. In Settings Configure &kwordquiz;... you can select that questions where you use the hint function are always counted as incorrect.

Select Quiz Repeat Errors to repeat the questions you answered incorrectly.

Select Quiz Restart to start the session from the beginning again. If you are using a random mode the questions will be reshuffled.

The score sections at the bottom 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.

All items on the Quiz menu are available on the Quiz toolbar that is displayed on the right by default.

## Rellenado de espacios

'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. In order to use this feature you must turn it on in the configuration dialog.

Considere la siguiente tabla. Puede ser un vocabulario en &kwordquiz;:

| Español | Alemán
1 | Somos propietarios de un ordenador | Wir besitzen einen Computer
2 | Somos propietarios de un ordenador | Wir [besitzen] einen Computer
3 | Somos propietarios de un ordenador | Wir [besitzen einen] Computer
4 | Somos propietarios de un ordenador | Wir [besitzen] einen [Computer]

Lo importante aquí es darse cuenta de la posición de los corchetes. Estos le indican a &kwordquiz; cómo debe realizar la prueba.

En 1 no hay corchetes. Considerando que «Inglés» es la pregunta y que «Alemán» es la respuesta, tendrá que proporcionar la expresión completa «Wir besitzen einen Computer» para que la respuesta sea considerada como correcta.

En 2, &kwordquiz; le mostrará la pregunta, pero también parte de la respuesta: «Wir ........ einen Computer». Para que la respuesta se considere correcta es suficiente con escribir «besitzen».

En 3 se le mostrará un espacio formado por más de una palabra. La respuesta correcta es «besitzen einen».

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

Los espacios marcados en blanco solo son relevantes si aparecen en la respuesta, de lo contrario se ignoran los corchetes. Más aún, los corchetes no tienen ningún efecto en las pruebas de elección múltiple. Para simplificar la creación de vocabularios con «rellenado de espacios» existen unas órdenes de menú con las que se pueden marcar y eliminar espacios en blanco. Por supuesto, siempre podrá introducir simplemente los corchetes. &kwordquiz; comprueba la sintaxis. Si el texto aparece en rojo es que hay un problema con los corchetes y, por lo tanto, no podrá comenzar una prueba.

The 'Fill-in-the-blank' features can be turned on and off in the Configuration dialog. Turning them off will make it possible to use fonts that map other characters to the positions of the brackets. It will also speed up performance slightly.

## Impresión

&kwordquiz; provides the ability to print vocabulary documents in several different ways. When selecting File Print... you are presented with the standard &kde; print dialog. In order to get access to the special &kwordquiz; features you need to click on the Options>> to see the Vocabulary Options tab. On this tab you can select to print the document as a vocabulary list (&ie; as displayed in the editor), a vocabulary exam, or as flashcards.

Opciones de impresión del vocabulario Opciones de impresión del vocabulario

## Lista de vocabulario

El vocabulario se imprimirá tal y como aparece en el editor, es decir, con el mismo tipo de letra, altura de filas y anchura de columnas. Asegúrese de que las columnas son lo suficientemente estrechas como para caber en una página.

Imprimir lista de vocabulario Imprimir lista de vocabulario

## Examen de vocabulario

El vocabulario se imprimirá tal y como se muestra en el editor, excepto por la columna de la derecha, que permanecerá vacía, y porque se añadirá una tercera columna para registrar la puntuación. El vocabulario se imprimirá usando el mismo tipo de letra, altura de filas y anchura de columnas. Asegúrese de que las columnas son lo suficientemente estrechas como para caber en una página.

Imprimir examen de vocabulario Imprimir examen de vocabulario

## Tarjetas

Se imprimen dos tarjetas de 7,6 x 12,7 cm por página. Las tarjetas se imprimirán siempre en modo apaisado.

Imprimir tarjetas Imprimir tarjetas

## Diálogos

### Preferencias generales

Preferencias generales Preferencias generales

Puede seleccionar la sesión con la que quiere comenzar cuando abra un vocabulario nuevo. En caso de que vaya directamente a una prueba, evitará ver de antemano las entradas del vocabulario.

Select Defaults to restore all settings to predefined defaults. Select Apply to make your changes without closing the dialog. Select OK to make your changes and close the dialog. Select Cancel to close the dialog without making any changes.

### Editor Settings

Editor Settings Editor Settings

You can configure the behavior of the &Enter; key when working in the editor.

You can also select if the functions for Fill-in-the-blank should be activated. Turning them off will speed up performance a little.

Select Defaults to restore all settings to predefined defaults. Select Apply to make your changes without closing the dialog. Select OK to make your changes and close the dialog. Select Cancel to close the dialog without making any changes.

### Quiz Settings

Quiz Settings Quiz Settings

For flashcard sessions you can select if the cards should be flipped automatically, and if they should be counted as correct or incorrect. Enter a time delay in seconds for the automatic flipping.

For multiple choice sessions you can select if your choice should be checked immediately or if you have to select Quiz Check first.

For question & answer sessions you can select if questions where you use Quiz Hint should be counted as incorrect.

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

Select Defaults to restore all settings to predefined defaults. Select Apply to make your changes without closing the dialog. Select OK to make your changes and close the dialog. Select Cancel to close the dialog without making any changes.

### Flashcard Appearance Settings

Flashcard Appearance Settings Flashcard Appearance Settings

For flashcard sessions you can select the Font: and the colors of text, card and frames. Click the Flip to switch between the Front and the Back of the cards.

Select Defaults to restore all settings to predefined defaults. Select Apply to make your changes without closing the dialog. Select OK to make your changes and close the dialog. Select Cancel to close the dialog without making any changes.

### Special Characters Settings

Special Characters Settings Special Characters Settings

Nine configurable actions are available for insertion of special characters into the vocabulary. Select one of the actions in the list and then click the Character... button to select a character for that action. A larger preview of the current character is displayed.

Changing the keyboard shortcut associated with each action can be done by selecting Settings Configure Shortcuts....

Select Defaults to restore all settings to predefined defaults. Select Apply to make your changes without closing the dialog. Select OK to make your changes and close the dialog. Select Cancel to close the dialog without making any changes.

### Preferencias de las columnas

You can open this dialog from the menubar with Vocabulary Column Settings...

Preferencias de las columnas Preferencias de las columnas

Use this dialog to define the column titles, keyboard layouts and widths of the vocabulary. Select OK to make your changes or Cancel to discard any changes.

### Special Characters

Click the Character... button on the Special Characters page in &kwordquiz; settings dialog to open this window.

Special Characters Special Characters

Use this dialog to select any special character you want to associate with the current special character action.

## Créditos y licencia

&kwordquiz;

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

Derechos de autor de la documentación, 2003-2004 Peter B. Hedlund peter.hedlund@kdemail.net.

Traducido por Rocío Gallego traducciones@rociogallego.com, Santiago Fernández Sancho santi@kde-es.org y Leticia Martín Hernández leticia.martin@gmail.com.

&underFDL; &underGPL;
&documentation.index;