Warning, /education/kwordquiz/doc/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
0003  "dtd/kdedbx45.dtd" [
0004   <!ENTITY % addindex "IGNORE">
0005   <!ENTITY % English "INCLUDE"><!-- change language only here -->
0006 ]>
0007 
0008 <book id="kwordquiz" lang="&language;">
0009 
0010 <bookinfo>
0011 <title>The &kwordquiz; Handbook</title>
0012 
0013 <authorgroup>
0014 <author>
0015 <firstname>Peter</firstname>
0016 <surname>Hedlund</surname>
0017 <affiliation>
0018 <address><email>peter.hedlund@kdemail.net</email></address>
0019 </affiliation>
0020 </author>
0021 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0022 </authorgroup>
0023 
0024 
0025 <copyright>
0026   <year>2003</year>
0027   <year>2004</year>
0028   <year>2005</year>
0029   <year>2008</year>
0030   <holder>Peter B. Hedlund</holder>
0031 </copyright>
0032 
0033 <legalnotice>&FDLNotice;</legalnotice>
0034 
0035 
0036 <date>2021-01-30</date>
0037 <releaseinfo>Applications 20.12</releaseinfo>
0038 
0039 <abstract>
0040 <para>
0041 &kwordquiz; is a flashcard and vocabulary learning program by &kde;.
0042 </para>
0043 </abstract>
0044 
0045 <keywordset>
0046 <keyword>KDE</keyword>
0047 <keyword>kdeedu</keyword>
0048 <keyword>KWordQuiz</keyword>
0049 <keyword>flashcard</keyword>
0050 <keyword>vocabulary</keyword>
0051 <keyword>language</keyword>
0052 <keyword>education</keyword>
0053 <keyword>school</keyword>
0054 <keyword>college</keyword>
0055 <keyword>university</keyword>
0056 </keywordset>
0057 
0058 </bookinfo>
0059 
0060 <chapter id="introduction">
0061 <title>Introduction</title>
0062 <para>
0063 &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.
0064 </para>
0065 <sect1 id="easy-to-use">
0066 <title>Easy to use</title>
0067 
0068 <para>
0069 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.
0070 </para>
0071 
0072 <sect2 id="practice-modes">
0073 <title>Practice modes</title>
0074 
0075 <para>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.
0076 </para>
0077 </sect2>
0078 
0079 <sect2 id="quiz-types">
0080 <title>Quiz types</title>
0081 
0082 <para>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. 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.
0083 </para>
0084 </sect2>
0085 
0086 <sect2 id="vocabulary-documents">
0087 <title>Vocabulary documents</title>
0088 <para>
0089 &kwordquiz; can open several types of vocabulary data. The default format is <filename class="extension">.kvtml</filename>, a file format shared by several &kde; programs. &kwordquiz; should also open <filename class="extension">.wql</filename> files created by &kwordquiz; for &Windows;, <filename class="extension">.csv</filename> files with comma separated text, <ulink url="http://www.vokabeln.de/v1/download.htm"><filename class="extension">.voc</filename> files</ulink> created by the old version of Vokabeltrainer, <ulink url="https://sourceforge.net/projects/xdxf/files/dicts-XDXF/"><filename class="extension">.xdxf</filename> files</ulink>, and <filename class="extension">.xml.gz</filename> files created by the old versions of <ulink url="http://pauker.sourceforge.net">Pauker</ulink>.
0090 </para>
0091 <para>
0092 &kwordquiz; can save your vocabulary documents in several different formats. The default is the <filename class="extension">.kvtml</filename> format used by other &kde; programs. Another available option is comma separated text <filename class="extension">.csv</filename>.
0093 </para>
0094 <para>
0095 You can have several files open at the same time, and easily copy or move entries between files.
0096 </para>
0097 </sect2>
0098 </sect1>
0099 </chapter>
0100 
0101 <chapter id="commands">
0102 <title>Command Reference</title>
0103 
0104 <sect1 id="file_menu">
0105 <title>The File Menu</title>
0106 
0107 <variablelist>
0108   <varlistentry>
0109     <term>
0110       <menuchoice>
0111         <shortcut>
0112           <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
0113         </shortcut>
0114         <guimenu>File</guimenu>
0115         <guimenuitem>New</guimenuitem>
0116       </menuchoice>
0117     </term>
0118     <listitem>
0119       <para>
0120         <action>New</action> creates a new blank vocabulary document
0121       </para>
0122     </listitem>
0123   </varlistentry>
0124 
0125   <varlistentry>
0126     <term>
0127       <menuchoice>
0128         <shortcut>
0129           <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
0130         </shortcut>
0131         <guimenu>File</guimenu>
0132         <guimenuitem>Open...</guimenuitem>
0133       </menuchoice>
0134     </term>
0135     <listitem>
0136       <para>
0137         <action>Open</action> one or more existing vocabulary documents.
0138       </para>
0139     </listitem>
0140   </varlistentry>
0141 
0142   <varlistentry>
0143     <term>
0144       <menuchoice>
0145         <guimenu>File</guimenu>
0146         <guisubmenu>Open Recent</guisubmenu>
0147       </menuchoice>
0148     </term>
0149     <listitem>
0150       <para>
0151         <action>Open</action> a recently used vocabulary document.
0152       </para>
0153     </listitem>
0154   </varlistentry>
0155 
0156   <varlistentry>
0157     <term>
0158       <menuchoice>
0159         <shortcut>
0160           <keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo>
0161         </shortcut>
0162         <guimenu>File</guimenu>
0163         <guimenuitem>Download New Vocabularies...</guimenuitem>
0164       </menuchoice>
0165     </term>
0166     <listitem>
0167       <para>
0168         <action>Downloads</action> new vocabularies. Downloaded vocabularies can
0169         be found in the <filename class="directory">$XDG_DATA_HOME/kvtml</filename>
0170         folder. <envar>$XDG_DATA_HOME</envar> is usually a hidden folder in your
0171         Home folder called <filename class="directory">.local</filename>.
0172       </para>
0173     </listitem>
0174   </varlistentry>
0175 
0176   <varlistentry>
0177     <term>
0178       <menuchoice>
0179         <shortcut>
0180           <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
0181         </shortcut>
0182         <guimenu>File</guimenu>
0183         <guimenuitem>Save</guimenuitem>
0184       </menuchoice>
0185     </term>
0186     <listitem>
0187       <para>
0188         <action>Save</action> the active vocabulary document to disk.
0189       </para>
0190     </listitem>
0191   </varlistentry>
0192 
0193   <varlistentry>
0194     <term>
0195       <menuchoice>
0196         <shortcut>
0197           <keycombo action="simul">&Ctrl;&Shift;<keycap>S</keycap></keycombo>
0198         </shortcut>
0199         <guimenu>File</guimenu>
0200         <guimenuitem>Save As...</guimenuitem>
0201       </menuchoice>
0202     </term>
0203     <listitem>
0204       <para>
0205         <action>Save</action> the active vocabulary document with a new name.
0206       </para>
0207     </listitem>
0208   </varlistentry>
0209 
0210   <varlistentry>
0211     <term>
0212       <menuchoice>
0213         <shortcut>
0214           <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
0215         </shortcut>
0216         <guimenu>File</guimenu>
0217         <guimenuitem>Print...</guimenuitem>
0218       </menuchoice>
0219     </term>
0220     <listitem>
0221       <para>
0222         <action>Print</action> the active vocabulary document. &kwordquiz; provides several options for <link linkend="printing">printing</link> your vocabularies.
0223       </para>
0224     </listitem>
0225   </varlistentry>
0226 
0227   <varlistentry>
0228     <term>
0229       <menuchoice>
0230         <guimenu>File</guimenu>
0231         <guimenuitem>Print Preview</guimenuitem>
0232       </menuchoice>
0233     </term>
0234     <listitem>
0235       <para>
0236         <action>Show</action> preview of the active vocabulary document printed by &kwordquiz;.
0237       </para>
0238     </listitem>
0239   </varlistentry>
0240 
0241   <varlistentry>
0242     <term>
0243       <menuchoice>
0244         <shortcut>
0245           <keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>
0246         </shortcut>
0247         <guimenu>File</guimenu>
0248         <guimenuitem>Close</guimenuitem>
0249       </menuchoice>
0250     </term>
0251     <listitem>
0252       <para>
0253         <action>Close</action> the active vocabulary document.
0254       </para>
0255     </listitem>
0256   </varlistentry>
0257 
0258   <varlistentry>
0259     <term>
0260       <menuchoice>
0261         <shortcut>
0262           <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
0263         </shortcut>
0264         <guimenu>File</guimenu>
0265         <guimenuitem>Quit</guimenuitem>
0266       </menuchoice>
0267     </term>
0268     <listitem>
0269       <para>
0270         <action>Quit</action> &kwordquiz;
0271       </para>
0272     </listitem>
0273   </varlistentry>
0274 
0275 </variablelist>
0276 </sect1>
0277 
0278 <sect1 id="edit-menu">
0279 <title>The Edit Menu</title>
0280 
0281 <variablelist>
0282 
0283   <varlistentry>
0284     <term>
0285       <menuchoice>
0286         <shortcut>
0287           <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
0288         </shortcut>
0289         <guimenu>Edit</guimenu>
0290         <guimenuitem>Undo</guimenuitem>
0291       </menuchoice>
0292     </term>
0293     <listitem>
0294       <para>
0295         <action>Undo</action> the last command. The name of this item will change to reflect what will be undone.
0296       </para>
0297     </listitem>
0298   </varlistentry>
0299 
0300   <varlistentry>
0301     <term>
0302       <menuchoice>
0303         <shortcut>
0304           <keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo>
0305         </shortcut>
0306         <guimenu>Edit</guimenu>
0307         <guimenuitem>Redo</guimenuitem>
0308       </menuchoice>
0309     </term>
0310     <listitem>
0311       <para>
0312         <action>Redo</action> the last command. The name of this item will change to reflect what will be redone.
0313       </para>
0314     </listitem>
0315   </varlistentry>
0316 
0317   <varlistentry>
0318     <term>
0319       <menuchoice>
0320         <shortcut>
0321           <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
0322         </shortcut>
0323         <guimenu>Edit</guimenu>
0324         <guimenuitem>Cut</guimenuitem>
0325       </menuchoice>
0326     </term>
0327     <listitem>
0328       <para>
0329         <action>Cut</action> the current selection and place it on the clipboard.
0330       </para>
0331     </listitem>
0332   </varlistentry>
0333 
0334   <varlistentry>
0335     <term>
0336       <menuchoice>
0337         <shortcut>
0338           <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
0339         </shortcut>
0340         <guimenu>Edit</guimenu>
0341         <guimenuitem>Copy</guimenuitem>
0342       </menuchoice>
0343     </term>
0344     <listitem>
0345       <para>
0346         <action>Copy</action> the current selection and place it on the clipboard.
0347       </para>
0348     </listitem>
0349   </varlistentry>
0350 
0351   <varlistentry>
0352     <term>
0353       <menuchoice>
0354         <shortcut>
0355           <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
0356         </shortcut>
0357         <guimenu>Edit</guimenu>
0358         <guimenuitem>Paste</guimenuitem>
0359       </menuchoice>
0360     </term>
0361     <listitem>
0362       <para>
0363         <action>Paste</action> 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.
0364       </para>
0365     </listitem>
0366   </varlistentry>
0367 
0368   <varlistentry>
0369     <term>
0370       <menuchoice>
0371         <shortcut>
0372           &Del;
0373         </shortcut>
0374         <guimenu>Edit</guimenu>
0375         <guimenuitem>Clear</guimenuitem>
0376       </menuchoice>
0377     </term>
0378     <listitem>
0379       <para>
0380         <action>Clear</action> the current selection.
0381       </para>
0382     </listitem>
0383   </varlistentry>
0384 
0385   <varlistentry>
0386     <term>
0387       <menuchoice>
0388         <shortcut>
0389           <keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
0390         </shortcut>
0391         <guimenu>Edit</guimenu>
0392         <guimenuitem>Insert Row</guimenuitem>
0393       </menuchoice>
0394     </term>
0395     <listitem>
0396       <para>
0397         <action>Insert</action> a new row at the current selection. If the selection extends over more than one row, an equal number of rows will be inserted.
0398       </para>
0399     </listitem>
0400   </varlistentry>
0401 
0402   <varlistentry>
0403     <term>
0404       <menuchoice>
0405         <shortcut>
0406           <keycombo action="simul">&Ctrl;<keycap>K</keycap></keycombo>
0407         </shortcut>
0408         <guimenu>Edit</guimenu>
0409         <guimenuitem>Delete Row</guimenuitem>
0410       </menuchoice>
0411     </term>
0412     <listitem>
0413       <para>
0414         <action>Delete</action> the selected row. If the selection extends over more than one row, all selected rows will be deleted.
0415       </para>
0416     </listitem>
0417   </varlistentry>
0418 
0419   <varlistentry>
0420     <term>
0421       <menuchoice>
0422         <shortcut>
0423           <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
0424         </shortcut>
0425         <guimenu>Edit</guimenu>
0426         <guimenuitem>Mark as Blank</guimenuitem>
0427       </menuchoice>
0428     </term>
0429     <listitem>
0430       <para>
0431         <action>Mark as Blank</action> marks selected text (or the word where the caret is) as a blank for a <link linkend="fill-in-the-blank">'Fill-in-the-blank'</link> quiz, &ie;, it's enclosed in brackets. Only available if <link linkend="dlg-config-editor">Fill-in-the-blank</link> is enabled.
0432       </para>
0433     </listitem>
0434   </varlistentry>
0435 
0436   <varlistentry>
0437     <term>
0438       <menuchoice>
0439         <guimenu>Edit</guimenu>
0440         <guimenuitem>Unmark Blanks</guimenuitem>
0441       </menuchoice>
0442     </term>
0443     <listitem>
0444       <para>
0445         <action>Unmark Blanks</action> clears previously assigned blanks, &ie;, brackets are removed. Only available if <link linkend="dlg-config-editor">Fill-in-the-blank</link> is enabled.
0446       </para>
0447     </listitem>
0448   </varlistentry>
0449 
0450 
0451 </variablelist>
0452 </sect1>
0453 
0454 <sect1 id="vocabulary-menu">
0455 <title>The Vocabulary Menu</title>
0456 
0457 <variablelist>
0458 
0459   <varlistentry>
0460     <term>
0461       <menuchoice>
0462         <shortcut>
0463           <keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo>
0464         </shortcut>
0465         <guimenu>Vocabulary</guimenu>
0466         <guimenuitem>Column Settings...</guimenuitem>
0467       </menuchoice>
0468     </term>
0469     <listitem>
0470       <para>
0471         <action>Define</action> the titles, the keyboard layouts, and the widths of the two columns in the vocabulary. Displays a <link linkend="dlg-languages">dialog</link>.
0472       </para>
0473     </listitem>
0474   </varlistentry>
0475 
0476   <varlistentry>
0477     <term>
0478       <menuchoice>
0479         <guimenu>Vocabulary</guimenu>
0480         <guimenuitem>Font...</guimenuitem>
0481       </menuchoice>
0482     </term>
0483     <listitem>
0484       <para>
0485         <action>Change</action> the font used to display the vocabulary.
0486       </para>
0487     </listitem>
0488   </varlistentry>
0489 
0490   <varlistentry>
0491     <term>
0492       <menuchoice>
0493         <guimenu>Vocabulary</guimenu>
0494         <guimenuitem>Link Image...</guimenuitem>
0495       </menuchoice>
0496     </term>
0497     <listitem>
0498       <para>
0499         <action>Specify</action> the image that should be linked with the current entry.
0500       </para>
0501     </listitem>
0502   </varlistentry>
0503   
0504   <varlistentry>
0505     <term>
0506       <menuchoice>
0507         <guimenu>Vocabulary</guimenu>
0508         <guimenuitem>Link Sound...</guimenuitem>
0509       </menuchoice>
0510     </term>
0511     <listitem>
0512       <para>
0513         <action>Specify</action> the sound that should be linked with the current entry.
0514       </para>
0515     </listitem>
0516   </varlistentry>
0517 
0518  <varlistentry>
0519     <term>
0520       <menuchoice>
0521         <guimenu>Vocabulary</guimenu>
0522         <guimenuitem>Adjust Row Heights</guimenuitem>
0523       </menuchoice>
0524     </term>
0525     <listitem>
0526       <para>
0527         <action>Adjust</action> the height of the rows to fit the content.
0528       </para>
0529     </listitem>
0530   </varlistentry>
0531 
0532   <varlistentry>
0533     <term>
0534       <menuchoice>
0535         <guimenu>Vocabulary</guimenu>
0536         <guimenuitem>Shuffle</guimenuitem>
0537       </menuchoice>
0538     </term>
0539     <listitem>
0540       <para>
0541         <action>Shuffle</action> the vocabulary entries in a random order. The order of the entries in the actual vocabulary document is not changed.
0542       </para>
0543     </listitem>
0544   </varlistentry>
0545 
0546 </variablelist>
0547 </sect1>
0548 
0549 <sect1 id="mode-menu">
0550 <title>The Mode Menu</title>
0551 <para>
0552 The menu provides five different modes for the quiz.</para>
0553 
0554   <note><para>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 &amp; Answer.</para>
0555   </note>
0556 <variablelist>
0557 
0558   <varlistentry>
0559     <term>
0560       <menuchoice>
0561         <guimenu>Mode</guimenu>
0562         <guimenuitem>1 Column 1 -&gt; Column 2 In Order</guimenuitem>
0563       </menuchoice>
0564     </term>
0565     <listitem>
0566       <para>
0567         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.
0568       </para>
0569     </listitem>
0570   </varlistentry>
0571 
0572   <varlistentry>
0573     <term>
0574       <menuchoice>
0575         <guimenu>Mode</guimenu>
0576         <guimenuitem>2 Column 2 -&gt; Column 1 In Order</guimenuitem>
0577       </menuchoice>
0578     </term>
0579     <listitem>
0580       <para>
0581         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.
0582       </para>
0583     </listitem>
0584   </varlistentry>
0585 
0586   <varlistentry>
0587     <term>
0588       <menuchoice>
0589         <guimenu>Mode</guimenu>
0590         <guimenuitem>3 Column 1 -&gt; Column 2 Randomly</guimenuitem>
0591       </menuchoice>
0592     </term>
0593     <listitem>
0594       <para>
0595         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 processed once.
0596       </para>
0597     </listitem>
0598   </varlistentry>
0599 
0600   <varlistentry>
0601     <term>
0602       <menuchoice>
0603         <guimenu>Mode</guimenu>
0604         <guimenuitem>4 Column 2 -&gt; Column 1 Randomly</guimenuitem>
0605       </menuchoice>
0606     </term>
0607     <listitem>
0608       <para>
0609         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 processed once.
0610       </para>
0611     </listitem>
0612   </varlistentry>
0613 
0614   <varlistentry>
0615     <term>
0616       <menuchoice>
0617         <guimenu>Mode</guimenu>
0618         <guimenuitem>5 Column 1 &lt;-&gt; Column 2 Randomly</guimenuitem>
0619       </menuchoice>
0620     </term>
0621     <listitem>
0622       <para>
0623         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 processed once.
0624       </para>
0625     </listitem>
0626   </varlistentry>
0627 
0628 </variablelist>
0629 </sect1>
0630 
0631 <sect1 id="quiz-menu">
0632 <title>The Quiz Menu</title>
0633 
0634 <variablelist>
0635 
0636   <varlistentry>
0637     <term>
0638       <menuchoice>
0639         <shortcut>
0640           <keycombo action="simul"><keycap>Return</keycap></keycombo>
0641         </shortcut>
0642         <guimenu>Quiz</guimenu>
0643         <guimenuitem>Check</guimenuitem>
0644       </menuchoice>
0645     </term>
0646     <listitem>
0647       <para>
0648         <action>Check</action> if your answer is correct
0649       </para>
0650     </listitem>
0651   </varlistentry>
0652 
0653   <varlistentry>
0654     <term>
0655       <menuchoice>
0656         <shortcut>
0657           <keycombo action="simul"><keycap>K</keycap></keycombo>
0658         </shortcut>
0659         <guimenu>Quiz</guimenu>
0660         <guimenuitem>I Know</guimenuitem>
0661       </menuchoice>
0662     </term>
0663     <listitem>
0664       <para>
0665         <action>Count</action> as correct during a flashcard session.
0666       </para>
0667     </listitem>
0668   </varlistentry>
0669 
0670   <varlistentry>
0671     <term>
0672       <menuchoice>
0673         <shortcut>
0674           <keycombo action="simul"><keycap>D</keycap></keycombo>
0675         </shortcut>
0676         <guimenu>Quiz</guimenu>
0677         <guimenuitem>I Do Not Know</guimenuitem>
0678       </menuchoice>
0679     </term>
0680     <listitem>
0681       <para>
0682         <action>Count</action> as error during a flashcard session. You can later repeat these cards by selecting <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Repeat Errors</guimenuitem></menuchoice>.
0683       </para>
0684     </listitem>
0685   </varlistentry>
0686 
0687   <varlistentry>
0688     <term>
0689       <menuchoice>
0690         <shortcut>
0691           <keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
0692         </shortcut>
0693         <guimenu>Quiz</guimenu>
0694         <guimenuitem>Hint</guimenuitem>
0695       </menuchoice>
0696     </term>
0697     <listitem>
0698       <para>
0699         <action>Get</action> the next correct letter during a Question &amp; Answer session.
0700       </para>
0701     </listitem>
0702   </varlistentry>
0703 
0704   <varlistentry>
0705     <term>
0706       <menuchoice>
0707         <shortcut>
0708           <keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo>
0709         </shortcut>
0710         <guimenu>Quiz</guimenu>
0711         <guimenuitem>Play Audio</guimenuitem>
0712       </menuchoice>
0713     </term>
0714     <listitem>
0715       <para>
0716         <action>Play</action> sound that was linked to the entry with <menuchoice><guimenu>Vocabulary</guimenu> <guimenuitem>Link Sound</guimenuitem></menuchoice>.
0717       </para>
0718     </listitem>
0719   </varlistentry>
0720   
0721   <varlistentry>
0722     <term>
0723       <menuchoice>
0724         <shortcut>
0725           <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo>
0726         </shortcut>
0727         <guimenu>Quiz</guimenu>
0728         <guimenuitem>Restart</guimenuitem>
0729       </menuchoice>
0730     </term>
0731     <listitem>
0732       <para>
0733         <action>Restart</action> the quiz session from the beginning. This will reset the scores.
0734       </para>
0735     </listitem>
0736   </varlistentry>
0737 
0738   <varlistentry>
0739     <term>
0740       <menuchoice>
0741         <shortcut>
0742           <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>
0743         </shortcut>
0744         <guimenu>Quiz</guimenu>
0745         <guimenuitem>Repeat Errors</guimenuitem>
0746       </menuchoice>
0747     </term>
0748     <listitem>
0749       <para>
0750         <action>Repeat</action> any questions you answered incorrectly. This becomes available once you have answered all the questions once.
0751       </para>
0752     </listitem>
0753   </varlistentry>
0754 
0755   <varlistentry>
0756     <term>
0757       <menuchoice>
0758         <guimenu>Quiz</guimenu>
0759         <guimenuitem>Export Errors As...</guimenuitem>
0760       </menuchoice>
0761     </term>
0762     <listitem>
0763       <para>
0764         <action>Export</action> any questions you answered incorrectly as a new vocabulary document. This becomes available once you have answered all the questions once.
0765       </para>
0766     </listitem>
0767   </varlistentry>
0768 
0769 </variablelist>
0770 </sect1>
0771 
0772 <sect1 id="settings-help-menu">
0773 <title>The Settings and Help Menu</title> 
0774 <para>Apart from the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
0775 menu items described in the <ulink url="help:/fundamentals/menus.html#menus-settings"
0776 >Settings Menu</ulink> and <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
0777 of the &kde; Fundamentals &kwordquiz; this additional menu entry is provided:
0778 </para>
0779 
0780 <variablelist>
0781   <varlistentry>
0782     <term>
0783       <menuchoice>
0784         <guimenu>Settings</guimenu>
0785         <guimenuitem>Show Search</guimenuitem>
0786       </menuchoice>
0787     </term>
0788     <listitem>
0789       <para>
0790         <action>Toggle</action> display of the search bar.
0791       </para>
0792     </listitem>
0793   </varlistentry>
0794 
0795 </variablelist>
0796 </sect1>
0797 
0798 </chapter>
0799 
0800 <chapter id="main-window">
0801 <title>The Main Window</title>
0802 
0803 <para>
0804 The main window has a navigation panel on the left side from which the main components of the program can be activated.
0805 </para>
0806 <para>
0807 The <link linkend="editor">editor</link> can be activated by pressing <menuchoice><shortcut><keycombo action="simul"><keycap>F6</keycap></keycombo></shortcut><interface></interface></menuchoice>.
0808 </para>
0809 <para>
0810 A <link linkend="flashcard">flashcard</link> session can be started by pressing <menuchoice><shortcut><keycombo action="simul"><keycap>F7</keycap></keycombo></shortcut><interface></interface></menuchoice>.
0811 </para>
0812 <para>
0813 A <link linkend="multiple">multiple choice</link> session can be started by pressing <menuchoice><shortcut><keycombo action="simul"><keycap>F8</keycap></keycombo></shortcut><interface></interface></menuchoice>.
0814 </para>
0815 <para>
0816 A <link linkend="question-and-answer">question and answer</link> session can be started by pressing <menuchoice><shortcut><keycombo action="simul"><keycap>F9</keycap></keycombo></shortcut><interface></interface></menuchoice>.
0817 </para>
0818 
0819 <screenshot>
0820   <screeninfo>The Main Window</screeninfo>
0821   <mediaobject>
0822     <imageobject>
0823       <imagedata fileref="kwq-editor.png" format="PNG" />
0824     </imageobject>
0825     <textobject>
0826       <phrase>The Main Window</phrase>
0827     </textobject>
0828   </mediaobject>
0829 </screenshot>
0830 </chapter>
0831 
0832 <chapter id="editor">
0833 <title>The Vocabulary Editor</title>
0834 
0835 <para>
0836 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 <menuchoice><guimenu>Vocabulary</guimenu><guimenuitem>Column Settings...</guimenuitem></menuchoice>. The row headers number the rows consecutively.
0837 </para>
0838 <para>
0839 The column headers can also be used to sort the vocabulary. Simply click on the header of the column you want to sort by. 
0840 </para>
0841 <para>
0842 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.
0843 </para>
0844 
0845 <screenshot>
0846   <screeninfo>The Vocabulary Editor</screeninfo>
0847   <mediaobject>
0848     <imageobject>
0849       <imagedata fileref="kwq-editor.png" format="PNG" />
0850     </imageobject>
0851     <textobject>
0852       <phrase>The Vocabulary Editor</phrase>
0853     </textobject>
0854   </mediaobject>
0855 </screenshot>
0856 
0857 <para>
0858 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 <keycap>F2</keycap> and making changes directly in the cell.
0859 </para>
0860 <para>
0861 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 <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kwordquiz;...</guimenuitem></menuchoice>. 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.
0862 </para>
0863 </chapter>
0864 
0865 <chapter id="flashcard">
0866 
0867 <title>Flashcard Session</title>
0868 
0869 <para>Select Flashcard from the navigation panel to start a flashcard session on the entries of the active vocabulary document. The mode selected in the <guimenu>Mode</guimenu> menu will be used. If you change mode during a session, the session will be restarted.
0870 </para>
0871 
0872 <para>
0873 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 <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kwordquiz;...</guimenuitem></menuchoice> you can configure the appearance of the flashcards.
0874 </para>
0875 
0876 <screenshot>
0877   <screeninfo>Flashcard Session</screeninfo>
0878   <mediaobject>
0879     <imageobject>
0880       <imagedata fileref="kwq-flashcard.png" format="PNG" />
0881     </imageobject>
0882     <textobject>
0883       <phrase>Flashcard Session</phrase>
0884     </textobject>
0885   </mediaobject>
0886 </screenshot>
0887 <para>
0888 Initially the front of the card is displayed. Use <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Check</guimenuitem></menuchoice> to see the other side.
0889 </para>
0890 <para>
0891 To move on to the next card, either select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>I Know</guimenuitem></menuchoice> to count the card as correct or <menuchoice><guimenu>Quiz</guimenu><guimenuitem>I Don't Know</guimenuitem></menuchoice> to count the card as incorrect.
0892 </para>
0893 <para>
0894 Select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Repeat Errors</guimenuitem></menuchoice> to repeat the cards you have counted as incorrect.
0895 </para>
0896 <para>
0897 Select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Restart</guimenuitem></menuchoice> to start the session from the beginning again. If you are using a random mode the cards will be reshuffled.
0898 </para>
0899 <para>
0900 The score section 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.
0901 </para>
0902 
0903 <tip>
0904 <para>All items on the <guimenu>Quiz</guimenu> menu are available on the Quiz toolbar that is displayed on the right by default.</para>
0905 </tip>
0906 
0907 </chapter>
0908 
0909 <chapter id="multiple">
0910 
0911 <title>Multiple Choice Session</title>
0912 
0913 <para>
0914 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 <guimenu>Mode</guimenu> menu will be used. If you change mode during a session, the session will be restarted.
0915 </para>
0916 <para>
0917 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.
0918 </para>
0919 <para>
0920 In the example below the user gave an incorrect answer to the previous question. He/she is now about to answer the next question.
0921 </para>
0922 
0923 <screenshot>
0924   <screeninfo>Multiple Choice Session</screeninfo>
0925   <mediaobject>
0926     <imageobject>
0927       <imagedata fileref="kwq-multiple.png" format="PNG" />
0928     </imageobject>
0929     <textobject>
0930       <phrase>Multiple Choice Session</phrase>
0931     </textobject>
0932   </mediaobject>
0933 </screenshot>
0934 <para>
0935 Your choices are shown on the top left. Select the one you think is correct. Use <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Check</guimenuitem></menuchoice> to see if the answer is correct. If you have activated the automatic mode in <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kwordquiz;...</guimenuitem></menuchoice> your selection is checked immediately.
0936 </para>
0937 <para>
0938 The previous question is shown below the current one. The answer you gave is also displayed. If you answered incorrectly the correct answer is shown.
0939 </para>
0940 <para>
0941 Select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Repeat Errors</guimenuitem></menuchoice> to repeat the questions you answered incorrectly.
0942 </para>
0943 <para>
0944 Select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Restart</guimenuitem></menuchoice> to start the session from the beginning again. If you are using a random mode the questions will be reshuffled.
0945 </para>
0946 <para>
0947 The score section 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.
0948 </para>
0949 
0950 <tip>
0951 <para>All items on the <guimenu>Quiz</guimenu> menu are available on the Quiz toolbar that is displayed on the right by default.</para>
0952 </tip>
0953 </chapter>
0954 
0955 
0956 <chapter id="question-and-answer">
0957 
0958 <title>Question &amp; Answer Session</title>
0959 <para>
0960 Select Question &amp; Answer from the navigation panel to start a question &amp; answer session on the entries in the active vocabulary. The mode selected in the <guimenu>Mode</guimenu> menu will be used. If you change mode during a session, the session will be restarted.
0961 </para>
0962 <para>
0963 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.
0964 </para>
0965 <para>
0966 In the example below the user gave a correct answer to the previous question (to see how incorrect answers are handled, see the <link linkend="multiple">Multiple Choice</link> chapter). He/she is now about to answer the next question.
0967 </para>
0968 
0969 <screenshot>
0970   <screeninfo>Question &amp; Answer Session</screeninfo>
0971   <mediaobject>
0972     <imageobject>
0973       <imagedata fileref="kwq-qanda.png" format="PNG" />
0974     </imageobject>
0975     <textobject>
0976       <phrase>Question &amp; Answer Session</phrase>
0977     </textobject>
0978   </mediaobject>
0979 </screenshot>
0980 <para>
0981 Your question is shown on the top left. Type your answer in the edit field. Use <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Check</guimenuitem></menuchoice> or &Enter; to see if the answer is correct.
0982 </para>
0983 <para>
0984 The previous question is shown below the current one. The answer you gave is also displayed. If you answered incorrectly the correct answer is shown.
0985 </para>
0986 <para>
0987 Select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Hint</guimenuitem></menuchoice> to get the next correct letter of the answer. In <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kwordquiz;...</guimenuitem></menuchoice> you may choose to count any questions where you use the hint function as incorrect.
0988 </para>
0989 <para>
0990 Select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Repeat Errors</guimenuitem></menuchoice> to repeat the questions you answered incorrectly.
0991 </para>
0992 <para>
0993 Select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Restart</guimenuitem></menuchoice> to start the session from the beginning again. If you are using a random mode the questions will be reshuffled.
0994 </para>
0995 <para>
0996 The score section 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.
0997 </para>
0998 
0999 <tip>
1000 <para>All items on the <guimenu>Quiz</guimenu> menu are available on the Quiz toolbar that is displayed on the right by default.</para>
1001 </tip>
1002 </chapter>
1003 
1004 <chapter id="fill-in-the-blank">
1005 <title>Fill-in-the-blank</title>
1006 
1007 <para>
1008 '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 <link linkend="dlg-config-editor">configuration dialog</link>.
1009 </para>
1010 
1011 <para>
1012 Consider the following table. It could be a vocabulary in &kwordquiz;:
1013 </para>
1014 
1015 <informaltable><tgroup cols="3">
1016 <thead>
1017 <row>
1018 <entry></entry>
1019 <entry>English</entry>
1020 <entry>German</entry>
1021 </row>
1022 </thead>
1023 
1024 <tbody>
1025 <row>
1026 <entry>1</entry>
1027 <entry>We own a computer</entry>
1028 <entry>Wir besitzen einen Computer</entry>
1029 </row>
1030 
1031 <row>
1032 <entry>2</entry>
1033 <entry>We own a computer</entry>
1034 <entry>Wir [besitzen] einen Computer</entry>
1035 </row>
1036 
1037 <row>
1038 <entry>3</entry>
1039 <entry>We own a computer</entry>
1040 <entry>Wir [besitzen einen] Computer</entry>
1041 </row>
1042 
1043 <row>
1044 <entry>4</entry>
1045 <entry>We own a computer</entry>
1046 <entry>Wir [besitzen] einen [Computer]</entry>
1047 </row>
1048 </tbody>
1049 </tgroup>
1050 </informaltable>
1051 
1052 <para>
1053 The important thing to note is the placement of the brackets. They tell &kwordquiz; how the quiz should be performed.
1054 </para>
1055 <para>
1056 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.
1057 </para>
1058 <para>
1059 In 2. &kwordquiz; would display the question but also 'Wir ........ einen Computer'. For a correct answer it is sufficient to write 'besitzen'.
1060 </para>
1061 <para>
1062 3. shows that a blank can consist of more than one word. The correct answer is 'besitzen einen'.
1063 </para>
1064 <para>
1065 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.
1066 </para>
1067 <para>
1068 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.
1069 </para>
1070 <para>
1071 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.
1072 </para>
1073 </chapter>
1074 
1075 <chapter id="printing">
1076 <title>Printing</title>
1077 <para>
1078   &kwordquiz; provides the ability to print vocabulary documents in several different ways. When selecting <menuchoice><guimenu>File</guimenu><guimenuitem>Print...</guimenuitem></menuchoice> 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 <guibutton>Options &gt;&gt;</guibutton> to see the <guilabel>Vocabulary Options</guilabel> 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.
1079 </para>
1080 <screenshot>
1081   <screeninfo>Vocabulary Printing Options</screeninfo>
1082   <mediaobject>
1083     <imageobject>
1084       <imagedata fileref="kwq-dlg-print-type.png" format="PNG" />
1085     </imageobject>
1086     <textobject>
1087       <phrase>Vocabulary Printing Options</phrase>
1088     </textobject>
1089   </mediaobject>
1090 </screenshot>
1091 
1092 <formalpara>
1093 <title>Vocabulary list</title>
1094 <para>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.</para>
1095 </formalpara>
1096 <screenshot>
1097   <screeninfo>Print Vocabulary List</screeninfo>
1098   <mediaobject>
1099     <imageobject>
1100       <imagedata fileref="kwq-dlg-print-list.png" format="PNG" />
1101     </imageobject>
1102     <textobject>
1103       <phrase>Print Vocabulary List</phrase>
1104     </textobject>
1105   </mediaobject>
1106 </screenshot>
1107 
1108 <formalpara>
1109 <title>Vocabulary exam</title>
1110 <para>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.</para>
1111 </formalpara>
1112 <screenshot>
1113   <screeninfo>Print Vocabulary Exam</screeninfo>
1114   <mediaobject>
1115     <imageobject>
1116       <imagedata fileref="kwq-dlg-print-exam.png" format="PNG" />
1117     </imageobject>
1118     <textobject>
1119       <phrase>Print Vocabulary Exam</phrase>
1120     </textobject>
1121   </mediaobject>
1122 </screenshot>
1123 
1124 <formalpara>
1125 <title>Flashcards</title>
1126 <para> Two 3" x 5" cards per page. The cards will always be printed in landscape.</para>
1127 </formalpara>
1128 <screenshot>
1129   <screeninfo>Print Flashcards</screeninfo>
1130   <mediaobject>
1131     <imageobject>
1132       <imagedata fileref="kwq-dlg-print-flashcard.png" format="PNG" />
1133     </imageobject>
1134     <textobject>
1135       <phrase>Print Flashcards</phrase>
1136     </textobject>
1137   </mediaobject>
1138 </screenshot>
1139 
1140 </chapter>
1141 <!--FIXME not ported to kf5
1142 <chapter id="tutor">
1143 <title>The Tutor Mode</title>
1144 
1145 <para>
1146   &kwordquiz; can be started in the Tutor mode. In this mode application pops up words in the chosen vocabulary randomly at certain time intervals. To start &kwordquiz; in the Tutor mode press <keycombo>&Alt;<keycap>F2</keycap></keycombo> and enter <userinput><command>kwordquiz</command> <option>-g tutor <replaceable>vocabulary_file.kvtml</replaceable></option></userinput>. The part with <replaceable>vocabulary_file.kvtml</replaceable> can be omitted.
1147 </para>
1148 <screenshot>
1149   <screeninfo>Welcome message of the Tutor mode</screeninfo>
1150   <mediaobject>
1151     <imageobject>
1152       <imagedata fileref="kwq-tutor-welcome.png" format="PNG" />
1153     </imageobject>
1154     <textobject>
1155       <phrase>Welcome message of the Tutor mode</phrase>
1156     </textobject>
1157   </mediaobject>
1158 </screenshot>
1159 
1160 <para>
1161   After pressing <guibutton>OK</guibutton> button, &kwordquiz; continues to work in background. You can control &kwordquiz; using tray icon <inlinemediaobject> <imageobject> <imagedata fileref="kwordquiz-icon.png" format="PNG"/> </imageobject> </inlinemediaobject> menu (it can be opened with &RMB; click on the icon).
1162 </para>
1163 
1164 <para>
1165   There are four items in this menu:
1166    <variablelist>
1167      <varlistentry>
1168        <term><guimenuitem>Start Exercise</guimenuitem></term>
1169        <listitem>
1170          <para>
1171            <action>Start</action> the Tutor exercise.
1172          </para>
1173        </listitem>
1174      </varlistentry>
1175      <varlistentry>
1176        <term><guimenuitem>Open...</guimenuitem></term>
1177        <listitem>
1178          <para>
1179            <action>Open</action> an existing vocabulary document.
1180          </para>
1181        </listitem>
1182      </varlistentry>
1183      <varlistentry>
1184        <term><guimenuitem>Configure &kwordquiz; Tutor...</guimenuitem></term>
1185        <listitem>
1186          <para>
1187            <action>Open</action> the Tutor configuration dialog.
1188          </para>
1189          <screenshot>
1190            <screeninfo>The Tutor Settings page</screeninfo>
1191            <mediaobject>
1192              <imageobject>
1193                <imagedata fileref="kwq-tutor-settings.png" format="PNG" />
1194              </imageobject>
1195              <textobject>
1196                <phrase>The Tutor Settings page</phrase>
1197              </textobject>
1198            </mediaobject>
1199          </screenshot>
1200          <para>
1201            Using the <guilabel>Tutor Settings</guilabel> page you can configure time intervals between the flashcards changes, flashcard appearance, and choose the option to <guilabel>Start exercise as soon as the user opens vocabulary file</guilabel>.
1202          </para>
1203          <para>
1204            In the current version, you can choose between <guilabel>Native</guilabel> and <guilabel>Minimalistic</guilabel> flashcard appearances.
1205          </para>
1206          <screenshot>
1207            <screeninfo>The Native flashcard appearance</screeninfo>
1208            <mediaobject>
1209              <imageobject>
1210                <imagedata fileref="kwq-tutor-popup-native.png" format="PNG" />
1211              </imageobject>
1212              <textobject>
1213                <phrase>The Native flashcard appearance</phrase>
1214              </textobject>
1215              <caption>
1216                <para>
1217                  Use Native appearance for the fancy vocabularies with images.
1218                </para>
1219              </caption>
1220            </mediaobject>
1221          </screenshot>
1222          <screenshot>
1223            <screeninfo>The Minimalistic flashcard appearance</screeninfo>
1224            <mediaobject>
1225              <imageobject>
1226                <imagedata fileref="kwq-tutor-popup-minimalistic.png" format="PNG" />
1227              </imageobject>
1228              <textobject>
1229                <phrase>The Minimalistic flashcard appearance</phrase>
1230              </textobject>
1231              <caption>
1232                <para>
1233                  Use Minimalistic appearance for the simple vocabularies.
1234                </para>
1235              </caption>
1236            </mediaobject>
1237          </screenshot>
1238          <screenshot>
1239            <screeninfo>The Shortcuts Settings page</screeninfo>
1240            <mediaobject>
1241              <imageobject>
1242                <imagedata fileref="kwq-tutor-shortcuts.png" format="PNG" />
1243              </imageobject>
1244              <textobject>
1245                <phrase>The Shortcuts Settings page</phrase>
1246              </textobject>
1247            </mediaobject>
1248          </screenshot>
1249          <para>
1250            Using the <guilabel>Shortcuts Settings</guilabel> page you can configure shortcuts for the Tutor actions. The defaults are <keycombo>&Ctrl;&Alt;<keycap>J</keycap></keycombo> for the closing and <keycombo>&Ctrl;&Alt;<keycap>H</keycap></keycombo> for the flipping of the flashcard.
1251          </para>
1252        </listitem>
1253      </varlistentry>
1254      <varlistentry>
1255        <term><guimenuitem>Quit</guimenuitem></term>
1256        <listitem>
1257          <para>
1258            <action>Quit</action> &kwordquiz;.
1259          </para>
1260        </listitem>
1261      </varlistentry>
1262    </variablelist>
1263 </para>
1264 </chapter>
1265 -->
1266 
1267 <chapter id="dialogs">
1268 <title>Dialogs</title>
1269 
1270 <sect1 id="dlg-config-general">
1271 <title>General Settings</title>
1272 <screenshot>
1273   <screeninfo>General Settings</screeninfo>
1274   <mediaobject>
1275     <imageobject>
1276       <imagedata fileref="kwq-dlg-configure-general.png" format="PNG" />
1277     </imageobject>
1278     <textobject>
1279       <phrase>General Settings</phrase>
1280     </textobject>
1281   </mediaobject>
1282 </screenshot>
1283 <para>
1284 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.
1285 </para>
1286 <para>
1287 Select <guibutton>Defaults</guibutton> to restore all settings to predefined defaults. Select <guibutton>Apply</guibutton> to make your changes without closing the dialog. Select <guibutton>OK</guibutton> to make your changes and close the dialog. Select <guibutton>Cancel</guibutton> to close the dialog without making any changes.
1288 </para>
1289 </sect1>
1290 
1291 <sect1 id="dlg-config-editor">
1292 <title>Editor Settings</title>
1293 <screenshot>
1294   <screeninfo>Editor Settings</screeninfo>
1295   <mediaobject>
1296     <imageobject>
1297       <imagedata fileref="kwq-dlg-configure-editor.png" format="PNG" />
1298     </imageobject>
1299     <textobject>
1300       <phrase>Editor Settings</phrase>
1301     </textobject>
1302   </mediaobject>
1303 </screenshot>
1304 <para>
1305 You can configure the behavior of the &Enter; key when working in the editor.
1306 </para>
1307 <para>
1308 You can also select if the functions for <link linkend="fill-in-the-blank">Fill-in-the-blank</link> should be activated. Turning them off will speed up performance a little.
1309 </para>
1310 <para>
1311 Select <guibutton>Defaults</guibutton> to restore all settings to predefined defaults. Select <guibutton>Apply</guibutton> to make your changes without closing the dialog. Select <guibutton>OK</guibutton> to make your changes and close the dialog. Select <guibutton>Cancel</guibutton> to close the dialog without making any changes.
1312 </para>
1313 </sect1>
1314 
1315 <sect1 id="dlg-config-quiz">
1316 <title>Quiz Settings</title>
1317 <screenshot>
1318   <screeninfo>Quiz Settings</screeninfo>
1319   <mediaobject>
1320     <imageobject>
1321       <imagedata fileref="kwq-dlg-configure-quiz.png" format="PNG" />
1322     </imageobject>
1323     <textobject>
1324       <phrase>Quiz Settings</phrase>
1325     </textobject>
1326   </mediaobject>
1327 </screenshot>
1328 <para>
1329 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.
1330 </para>
1331 <para>
1332 For multiple choice sessions you can select if your choice should be checked immediately or if you have to select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Check</guimenuitem></menuchoice> first.
1333 </para>
1334 <para>
1335 For question &amp; answer sessions you can select if questions where you use <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Hint</guimenuitem></menuchoice> should be counted as incorrect.
1336 </para>
1337 <para>
1338 For all sessions you can select if the scores should be displayed as percentages instead of absolute numbers.
1339 </para>
1340 <para>
1341 Select <guibutton>Defaults</guibutton> to restore all settings to predefined defaults. Select <guibutton>Apply</guibutton> to make your changes without closing the dialog. Select <guibutton>OK</guibutton> to make your changes and close the dialog. Select <guibutton>Cancel</guibutton> to close the dialog without making any changes.
1342 </para>
1343 </sect1>
1344 
1345 <sect1 id="dlg-config-appearance">
1346 <title>Flashcard Appearance Settings</title>
1347 <screenshot>
1348   <screeninfo>Flashcard Appearance Settings</screeninfo>
1349   <mediaobject>
1350     <imageobject>
1351       <imagedata fileref="kwq-dlg-configure-appearance.png" format="PNG" />
1352     </imageobject>
1353     <textobject>
1354       <phrase>Flashcard Appearance Settings</phrase>
1355     </textobject>
1356   </mediaobject>
1357 </screenshot>
1358 <para>
1359 For flashcard sessions you can select the <guilabel>Font:</guilabel> and the colors of text, cards, and frames. Click the <guibutton>Flip card</guibutton> button to switch between the <guilabel>Front</guilabel> and the <guilabel>Back</guilabel> of the cards.
1360 </para>
1361 <para>Select <guibutton>Defaults</guibutton> to restore all settings to predefined defaults. Select <guibutton>Apply</guibutton> to make your changes without closing the dialog. Select <guibutton>OK</guibutton> to make your changes and close the dialog. Select <guibutton>Cancel</guibutton> to close the dialog without making any changes.
1362 </para>
1363 </sect1>
1364 
1365 <sect1 id="dlg-config-characters">
1366 <title>Special Characters Settings</title>
1367 <screenshot>
1368   <screeninfo>Special Characters Settings</screeninfo>
1369   <mediaobject>
1370     <imageobject>
1371       <imagedata fileref="kwq-dlg-configure-characters.png" format="PNG" />
1372     </imageobject>
1373     <textobject>
1374       <phrase>Special Characters Settings</phrase>
1375     </textobject>
1376   </mediaobject>
1377 </screenshot>
1378 <para>
1379 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 <guibutton>Character...</guibutton> button to <link linkend="dlg-special-characters">select</link> a character for that action. A larger preview of the current character is displayed.
1380 </para>
1381 <para>
1382 Changing the keyboard shortcut associated with each action can be done by selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice>.
1383 </para>
1384 
1385 <para>
1386 Select <guibutton>Defaults</guibutton> to restore all settings to predefined defaults. Select <guibutton>Apply</guibutton> to make your changes without closing the dialog. Select <guibutton>OK</guibutton> to make your changes and close the dialog. Select <guibutton>Cancel</guibutton> to close the dialog without making any changes.
1387 </para>
1388 </sect1>
1389 
1390 <sect1 id="dlg-languages">
1391 <title>Column Settings</title>
1392 <para>You can open this dialog from the menubar with <menuchoice><guimenu>Vocabulary</guimenu><guimenuitem>Column Settings...</guimenuitem></menuchoice></para>
1393 <screenshot>
1394   <screeninfo>Column Settings</screeninfo>
1395   <mediaobject>
1396     <imageobject>
1397       <imagedata fileref="kwq-dlg-languages.png" format="PNG" />
1398     </imageobject>
1399     <textobject>
1400       <phrase>Column Settings</phrase>
1401     </textobject>
1402   </mediaobject>
1403 </screenshot>
1404 <para>
1405 Use this dialog to define the column titles, keyboard layouts and widths of the vocabulary. Select <guibutton>OK</guibutton> to make your changes or <guibutton>Cancel</guibutton> to discard any changes.
1406 </para>
1407 </sect1>
1408 
1409 <sect1 id="dlg-special-characters">
1410 <title>Special Characters</title>
1411 <para>Click the <guibutton>Character...</guibutton> button on the <guilabel>Special Characters</guilabel> page in &kwordquiz; settings dialog to open this window.</para>
1412 <screenshot>
1413   <screeninfo>Special Characters</screeninfo>
1414   <mediaobject>
1415     <imageobject>
1416       <imagedata fileref="kwq-dlg-characters.png" format="PNG" />
1417     </imageobject>
1418     <textobject>
1419       <phrase>Special Characters</phrase>
1420     </textobject>
1421   </mediaobject>
1422 </screenshot>
1423 <para>
1424 Use this dialog to select any special character you want to associate with the current special character <link linkend="dlg-config-characters">action</link>.
1425 </para>
1426 
1427 </sect1>
1428 
1429 </chapter>
1430 
1431 <chapter id="credits">
1432 
1433 <title>Credits and License</title>
1434 
1435 <para>
1436 &kwordquiz;
1437 </para>
1438 <para>
1439 Program copyright 2003-2008 Peter B. Hedlund <email>peter.hedlund@kdemail.net</email>
1440 </para>
1441 
1442 <para>
1443 Documentation copyright 2003-2008 Peter B. Hedlund <email>peter.hedlund@kdemail.net</email>
1444 </para>
1445 
1446 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
1447 
1448 &underFDL;   <!-- FDL: do not remove -->
1449 &underGPL;   <!-- GPL License -->
1450 
1451 </chapter>
1452 
1453 &documentation.index;
1454 </book>
1455 <!--
1456 Local Variables:
1457 mode: sgml
1458 sgml-minimize-attributes: nil
1459 sgml-general-insert-case: lower
1460 sgml-indent-step:0
1461 sgml-indent-data:nil
1462 End:
1463 -->