doc/kwordquiz/index.docbook

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
   3  "dtd/kdex.dtd" [
   4   <!ENTITY kwordquiz "<application>KWordQuiz</application>">
   5   <!ENTITY kappname "&kwordquiz;">
   6   <!ENTITY package "kdeedu">
   7   <!ENTITY % addindex "IGNORE">
   8   <!ENTITY % English "INCLUDE"><!-- change language only here -->
   9 ]>
  10
  11 <book lang="&language;">
  12
  13 <bookinfo>
  14 <title>The &kwordquiz; Handbook</title>
  15
  16 <authorgroup>
  17 <author>
  18 <firstname>Peter</firstname>
  19 <othername></othername>
  20 <surname>Hedlund</surname>
  21 <affiliation>
  22 <address><email>peter@peterandlinda.com</email></address>
  23 </affiliation>
  24 </author>
  25 </authorgroup>
  26
  27 <!-- TRANS:ROLES_OF_TRANSLATORS -->
  28
  29 <copyright>
  30   <year>2003</year>
  31   <year>2004</year>
  32   <holder>Peter B. Hedlund</holder>
  33 </copyright>
  34
  35 <legalnotice>&FDLNotice;</legalnotice>
  36
  37
  38 <date>2004-03-06</date>
  39 <releaseinfo>0.5</releaseinfo>
  40
  41 <abstract>
  42 <para>
  43 &kwordquiz; is a flashcard and vocabulary learning program for &kde;.
  44 </para>
  45 </abstract>
  46
  47 <keywordset>
  48 <keyword>KDE</keyword>
  49 <keyword>kdenonbeta</keyword>
  50 <keyword>KWordQuiz</keyword>
  51 <keyword>flashcard</keyword>
  52 <keyword>vocabulary</keyword>
  53 <keyword>language</keyword>
  54 <keyword>education</keyword>
  55 <keyword>school</keyword>
  56 <keyword>college</keyword>
  57 <keyword>university</keyword>
  58 </keywordset>
  59
  60 </bookinfo>
  61
  62 <chapter id="introduction">
  63 <title>Introduction</title>
  64 <para>
  65 &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.
  66 </para>
  67 <sect1 id="easy-to-use">
  68 <title>Easy to use</title>
  69
  70 <para>
  71 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.
  72 </para>
  73
  74 <sect2 id="practice-modes">
  75 <title>Practice modes</title>
  76
  77 <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.</para>
  78 </sect2>
  79 <sect2 id="quiz-types">
  80 <title>Quiz types</title>
  81
  82 <para>When you have entered your vocabulary and selected a mode you are ready to start a quiz. The vocabulary document is hidden during the quiz so you can't cheat. 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.</para>
  83 </sect2>
  84 <sect2 id="vocabulary-documents">
  85 <title>Vocabulary documents</title>
  86 <para>
  87 &kwordquiz; can open several types of vocabulary data. Supported are .kvtml used by other KDE programs such as KVocTrain, .wql used by WordQuiz for Windows, .csv files with comma-separated text, and .xml.gz files created by Pauker (http://pauker.sourceforge.net). You can automatically combine several documents to one large list if you need to practice for e. g. a final exam.
  88 </para>
  89 <para>
  90 &kwordquiz; can save your vocabulary documents several different formats. The default is the .kvtml format used by other KDE programs. Other available options are the .wql format used by WordQuiz for Windows allowing exchange with Windows users, .csv, and .html.
  91 </para>
  92 <para>
  93 You can have several files open at the same time and easily copy or move entries between files.
  94 </para>
  95 </sect2>
  96 </sect1>
  97 </chapter>
  98
  99 <chapter id="commands">
 100 <title>Command Reference</title>
 101
 102 <sect1 id="file_menu">
 103 <title>The <guimenu>File</guimenu> Menu</title>
 104
 105 <variablelist>
 106   <varlistentry>
 107     <term>
 108       <menuchoice>
 109         <shortcut>
 110           <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
 111         </shortcut>
 112         <guimenu>File</guimenu>
 113         <guimenuitem>New</guimenuitem>
 114       </menuchoice>
 115     </term>
 116     <listitem>
 117       <para>
 118         <action>New</action> creates a new blank vocabulary document
 119       </para>
 120     </listitem>
 121   </varlistentry>
 122
 123   <varlistentry>
 124     <term>
 125       <menuchoice>
 126         <shortcut>
 127           <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
 128         </shortcut>
 129         <guimenu>File</guimenu>
 130         <guimenuitem>Open</guimenuitem>
 131       </menuchoice>
 132     </term>
 133     <listitem>
 134       <para>
 135         <action>Open</action> one or more existing vocabulary documents. Several documents can be combined to one larger list.
 136       </para>
 137     </listitem>
 138   </varlistentry>
 139
 140   <varlistentry>
 141     <term>
 142       <menuchoice>
 143 <!--         <shortcut>
 144           <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
 145         </shortcut> -->
 146         <guimenu>File</guimenu>
 147         <guimenuitem>Open Recent</guimenuitem>
 148       </menuchoice>
 149     </term>
 150     <listitem>
 151       <para>
 152         <action>Open</action> a recently used vocabulary document
 153       </para>
 154     </listitem>
 155   </varlistentry>
 156
 157   <varlistentry>
 158     <term>
 159       <menuchoice>
 160         <shortcut>
 161           <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
 162         </shortcut>
 163         <guimenu>File</guimenu>
 164         <guimenuitem>Save</guimenuitem>
 165       </menuchoice>
 166     </term>
 167     <listitem>
 168       <para>
 169         <action>Save</action> the active vocabulary document to disk
 170       </para>
 171     </listitem>
 172   </varlistentry>
 173
 174   <varlistentry>
 175     <term>
 176       <menuchoice>
 177         <!-- <shortcut>
 178           <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
 179         </shortcut> -->
 180         <guimenu>File</guimenu>
 181         <guimenuitem>Save As</guimenuitem>
 182       </menuchoice>
 183     </term>
 184     <listitem>
 185       <para>
 186         <action>Save</action> the active vocabulary document with a new name
 187       </para>
 188     </listitem>
 189   </varlistentry>
 190
 191   <varlistentry>
 192     <term>
 193       <menuchoice>
 194         <shortcut>
 195           <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
 196         </shortcut>
 197         <guimenu>File</guimenu>
 198         <guimenuitem>Print</guimenuitem>
 199       </menuchoice>
 200     </term>
 201     <listitem>
 202       <para>
 203         <action>Print</action> the active vocabulary document. &kwordquiz; provides several options for <link linkend="printing">printing</link> your vocabularies.
 204       </para>
 205     </listitem>
 206   </varlistentry>
 207
 208   <varlistentry>
 209     <term>
 210       <menuchoice>
 211         <shortcut>
 212           <keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>
 213         </shortcut>
 214         <guimenu>File</guimenu>
 215         <guimenuitem>Close</guimenuitem>
 216       </menuchoice>
 217     </term>
 218     <listitem>
 219       <para>
 220         <action>Close</action> the active vocabulary document
 221       </para>
 222     </listitem>
 223   </varlistentry>
 224
 225   <varlistentry>
 226     <term>
 227       <menuchoice>
 228         <shortcut>
 229           <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
 230         </shortcut>
 231         <guimenu>File</guimenu>
 232         <guimenuitem>Quit</guimenuitem>
 233       </menuchoice>
 234     </term>
 235     <listitem>
 236       <para>
 237         <action>Quit</action> &kwordquiz;
 238       </para>
 239     </listitem>
 240   </varlistentry>
 241
 242 </variablelist>
 243 </sect1>
 244
 245 <sect1 id="edit-menu">
 246 <title>The <guimenu>Edit</guimenu> Menu</title>
 247
 248 <variablelist>
 249
 250   <varlistentry>
 251     <term>
 252       <menuchoice>
 253         <shortcut>
 254           <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
 255         </shortcut>
 256         <guimenu>Edit</guimenu>
 257         <guimenuitem>Undo</guimenuitem>
 258       </menuchoice>
 259     </term>
 260     <listitem>
 261       <para>
 262         <action>Undo</action> the last command. The name of this item will change to reflect what will be undone.
 263       </para>
 264     </listitem>
 265   </varlistentry>
 266
 267   <varlistentry>
 268     <term>
 269       <menuchoice>
 270         <shortcut>
 271           <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
 272         </shortcut>
 273         <guimenu>Edit</guimenu>
 274         <guimenuitem>Cut</guimenuitem>
 275       </menuchoice>
 276     </term>
 277     <listitem>
 278       <para>
 279         <action>Cut</action> the current selection and place it on the clipboard
 280       </para>
 281     </listitem>
 282   </varlistentry>
 283
 284   <varlistentry>
 285     <term>
 286       <menuchoice>
 287         <shortcut>
 288           <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
 289         </shortcut>
 290         <guimenu>Edit</guimenu>
 291         <guimenuitem>Copy</guimenuitem>
 292       </menuchoice>
 293     </term>
 294     <listitem>
 295       <para>
 296         <action>Copy</action> the current selection and place it on the clipboard
 297       </para>
 298     </listitem>
 299   </varlistentry>
 300
 301   <varlistentry>
 302     <term>
 303       <menuchoice>
 304         <shortcut>
 305           <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
 306         </shortcut>
 307         <guimenu>Edit</guimenu>
 308         <guimenuitem>Paste</guimenuitem>
 309       </menuchoice>
 310     </term>
 311     <listitem>
 312       <para>
 313         <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.
 314       </para>
 315     </listitem>
 316   </varlistentry>
 317
 318   <varlistentry>
 319     <term>
 320       <menuchoice>
 321         <!-- <shortcut>
 322           <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
 323         </shortcut> -->
 324         <guimenu>Edit</guimenu>
 325         <guimenuitem>Clear</guimenuitem>
 326       </menuchoice>
 327     </term>
 328     <listitem>
 329       <para>
 330         <action>Clear</action> the current selection
 331       </para>
 332     </listitem>
 333   </varlistentry>
 334
 335   <varlistentry>
 336     <term>
 337       <menuchoice>
 338         <shortcut>
 339           <keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
 340         </shortcut>
 341         <guimenu>Edit</guimenu>
 342         <guimenuitem>Insert</guimenuitem>
 343       </menuchoice>
 344     </term>
 345     <listitem>
 346       <para>
 347         <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.
 348       </para>
 349     </listitem>
 350   </varlistentry>
 351
 352   <varlistentry>
 353     <term>
 354       <menuchoice>
 355         <shortcut>
 356           <keycombo action="simul">&Ctrl;<keycap>K</keycap></keycombo>
 357         </shortcut>
 358         <guimenu>Edit</guimenu>
 359         <guimenuitem>Delete</guimenuitem>
 360       </menuchoice>
 361     </term>
 362     <listitem>
 363       <para>
 364         <action>Delete</action> the selected row. If the selection extends over more than one row, all selected rows will be deleted.
 365       </para>
 366     </listitem>
 367   </varlistentry>
 368
 369   <varlistentry>
 370     <term>
 371       <menuchoice>
 372         <shortcut>
 373           <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
 374         </shortcut>
 375         <guimenu>Edit</guimenu>
 376         <guimenuitem>Mark Blank</guimenuitem>
 377       </menuchoice>
 378     </term>
 379     <listitem>
 380       <para>
 381         <action>Mark 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, i.e. it's enclosed in brackets. Only available if <link linkend="dlg-config-editor">Fill-in-the-blank</link> is enabled.
 382       </para>
 383     </listitem>
 384   </varlistentry>
 385
 386   <varlistentry>
 387     <term>
 388       <menuchoice>
 389         <!-- <shortcut>
 390           <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
 391         </shortcut> -->
 392         <guimenu>Edit</guimenu>
 393         <guimenuitem>Unmark Blank</guimenuitem>
 394       </menuchoice>
 395     </term>
 396     <listitem>
 397       <para>
 398         <action>Unmark Blank</action> clears previously assigned blanks, i.e. brackets are removed. Only available if <link linkend="dlg-config-editor">Fill-in-the-blank</link> is enabled.
 399       </para>
 400     </listitem>
 401   </varlistentry>
 402
 403
 404 </variablelist>
 405 </sect1>
 406
 407 <sect1 id="go-to-menu">
 408 <title>The <guimenu>Go to</guimenu> Menu</title>
 409
 410 <variablelist>
 411
 412   <varlistentry>
 413     <term>
 414       <menuchoice>
 415         <shortcut>
 416           <keycombo action="simul"><keycap>F6</keycap></keycombo>
 417         </shortcut>
 418         <guimenu>Go to</guimenu>
 419         <guimenuitem>Editor</guimenuitem>
 420       </menuchoice>
 421     </term>
 422     <listitem>
 423       <para>
 424         <action>Activate</action> the vocabulary <link linkend="editor">editor</link>
 425       </para>
 426     </listitem>
 427   </varlistentry>
 428
 429   <varlistentry>
 430     <term>
 431       <menuchoice>
 432         <shortcut>
 433           <keycombo action="simul"><keycap>F7</keycap></keycombo>
 434         </shortcut>
 435         <guimenu>Go to</guimenu>
 436         <guimenuitem>Flashcard</guimenuitem>
 437       </menuchoice>
 438     </term>
 439     <listitem>
 440       <para>
 441         <action>Start</action> a <link linkend="flashcard">flashcard</link> session
 442       </para>
 443     </listitem>
 444   </varlistentry>
 445
 446   <varlistentry>
 447     <term>
 448       <menuchoice>
 449         <shortcut>
 450           <keycombo action="simul"><keycap>F8</keycap></keycombo>
 451         </shortcut>
 452         <guimenu>Go to</guimenu>
 453         <guimenuitem>Multiple Choice</guimenuitem>
 454       </menuchoice>
 455     </term>
 456     <listitem>
 457       <para>
 458         <action>Start</action> a <link linkend="multiple">multiple choice</link> quiz
 459       </para>
 460     </listitem>
 461   </varlistentry>
 462
 463   <varlistentry>
 464     <term>
 465       <menuchoice>
 466         <shortcut>
 467           <keycombo action="simul"><keycap>F9</keycap></keycombo>
 468         </shortcut>
 469         <guimenu>Go to</guimenu>
 470         <guimenuitem>Question &amp; Answer</guimenuitem>
 471       </menuchoice>
 472     </term>
 473     <listitem>
 474       <para>
 475         <action>Start</action> a <link linkend="question-and-answer">question &amp; answer</link> quiz
 476       </para>
 477     </listitem>
 478   </varlistentry>
 479
 480 </variablelist>
 481 </sect1>
 482
 483 <sect1 id="vocabulary-menu">
 484 <title>The <guimenu>Vocabulary</guimenu> Menu</title>
 485
 486 <variablelist>
 487
 488   <varlistentry>
 489     <term>
 490       <menuchoice>
 491         <shortcut>
 492           <keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo>
 493         </shortcut>
 494         <guimenu>Vocabulary</guimenu>
 495         <guimenuitem>Column Titles...</guimenuitem>
 496       </menuchoice>
 497     </term>
 498     <listitem>
 499       <para>
 500         <action>Define</action> the titles of the two columns in the vocabulary. Displays a <link linkend="dlg-languages">dialog</link>.
 501       </para>
 502     </listitem>
 503   </varlistentry>
 504
 505   <varlistentry>
 506     <term>
 507       <menuchoice>
 508         <!-- <shortcut>
 509           <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
 510         </shortcut> -->
 511         <guimenu>Vocabulary</guimenu>
 512         <guimenuitem>Font...</guimenuitem>
 513       </menuchoice>
 514     </term>
 515     <listitem>
 516       <para>
 517         <action>Change</action> the font used to display the vocabulary. If you are in flashcard session the font used to diplay the card will be changed. Displays the standard KDE font dialog.
 518       </para>
 519     </listitem>
 520   </varlistentry>
 521
 522   <!-- <varlistentry>
 523     <term>
 524       <menuchoice>
 525         <shortcut>
 526           <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
 527         </shortcut>
 528         <guimenu>Vocabulary</guimenu>
 529         <guimenuitem>Special Characters...</guimenuitem>
 530       </menuchoice>
 531     </term>
 532     <listitem>
 533       <para>
 534         <action>Select</action> a special character for insertion in the vocabulary. Displays a <link linkend="dlg-special-characters">dialog</link>.
 535       </para>
 536     </listitem>
 537   </varlistentry>-->
 538
 539   <varlistentry>
 540     <term>
 541       <menuchoice>
 542         <!-- <shortcut>
 543           <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
 544         </shortcut> -->
 545         <guimenu>Vocabulary</guimenu>
 546         <guimenuitem>Rows/Columns...</guimenuitem>
 547       </menuchoice>
 548     </term>
 549     <listitem>
 550       <para>
 551         <action>Specify</action> the number of rows in the vocabulary, or define the height of selected rows or the width of selected columns. Displays a <link linkend="dlg-rows-columns">dialog</link>.
 552       </para>
 553     </listitem>
 554   </varlistentry>
 555
 556   <varlistentry>
 557     <term>
 558       <menuchoice>
 559         <!-- <shortcut>
 560           <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
 561         </shortcut> -->
 562         <guimenu>Vocabulary</guimenu>
 563         <guimenuitem>Sort...</guimenuitem>
 564       </menuchoice>
 565     </term>
 566     <listitem>
 567       <para>
 568         <action>Sort</action> the vocabulary entries. Displays a <link linkend="dlg-sort">dialog</link>.
 569       </para>
 570     </listitem>
 571   </varlistentry>
 572
 573   <varlistentry>
 574     <term>
 575       <menuchoice>
 576         <!-- <shortcut>
 577           <keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
 578         </shortcut>  -->
 579         <guimenu>Vocabulary</guimenu>
 580         <guimenuitem>Shuffle</guimenuitem>
 581       </menuchoice>
 582     </term>
 583     <listitem>
 584       <para>
 585         <action>Shuffle</action> the vocabulary entries in a random order
 586       </para>
 587     </listitem>
 588   </varlistentry>
 589
 590 </variablelist>
 591 </sect1>
 592
 593 <sect1 id="mode-menu">
 594 <title>The <guimenu>Mode</guimenu> Menu</title>
 595 <para>
 596 The menu provides five different modes for the quiz.</para>
 597 <para>
 598 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 &amp; Answer.
 599 </para>
 600 <variablelist>
 601
 602   <varlistentry>
 603     <term>
 604       <menuchoice>
 605         <!-- <shortcut>
 606           <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
 607         </shortcut> -->
 608         <guimenu>Mode</guimenu>
 609         <guimenuitem>Column 1 -&gt; Column 2 in order</guimenuitem>
 610       </menuchoice>
 611     </term>
 612     <listitem>
 613       <para>
 614         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.
 615       </para>
 616     </listitem>
 617   </varlistentry>
 618
 619   <varlistentry>
 620     <term>
 621       <menuchoice>
 622         <!-- <shortcut>
 623           <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
 624         </shortcut> -->
 625         <guimenu>Mode</guimenu>
 626         <guimenuitem>Column 2 -&gt; Column 1 in order</guimenuitem>
 627       </menuchoice>
 628     </term>
 629     <listitem>
 630       <para>
 631         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.
 632       </para>
 633     </listitem>
 634   </varlistentry>
 635
 636   <varlistentry>
 637     <term>
 638       <menuchoice>
 639         <!-- <shortcut>
 640           <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
 641         </shortcut> -->
 642         <guimenu>Mode</guimenu>
 643         <guimenuitem>Column 1 -&gt; Column 2 randomly</guimenuitem>
 644       </menuchoice>
 645     </term>
 646     <listitem>
 647       <para>
 648         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.
 649       </para>
 650     </listitem>
 651   </varlistentry>
 652
 653   <varlistentry>
 654     <term>
 655       <menuchoice>
 656         <!-- <shortcut>
 657           <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
 658         </shortcut> -->
 659         <guimenu>Mode</guimenu>
 660         <guimenuitem>Column 2 -&gt; Column 1 randomly</guimenuitem>
 661       </menuchoice>
 662     </term>
 663     <listitem>
 664       <para>
 665         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.
 666       </para>
 667     </listitem>
 668   </varlistentry>
 669
 670   <varlistentry>
 671     <term>
 672       <menuchoice>
 673         <!-- <shortcut>
 674           <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
 675         </shortcut> -->
 676         <guimenu>Mode</guimenu>
 677         <guimenuitem>Column 1 &lt;-&gt; Column 2 randomly</guimenuitem>
 678       </menuchoice>
 679     </term>
 680     <listitem>
 681       <para>
 682         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.
 683       </para>
 684     </listitem>
 685   </varlistentry>
 686
 687 </variablelist>
 688 </sect1>
 689
 690 <sect1 id="quiz-menu">
 691 <title>The <guimenu>Quiz</guimenu> Menu</title>
 692
 693 <variablelist>
 694
 695   <varlistentry>
 696     <term>
 697       <menuchoice>
 698         <shortcut>
 699           <keycombo action="simul"><keycap>Return</keycap></keycombo>
 700         </shortcut>
 701         <guimenu>Quiz</guimenu>
 702         <guimenuitem>Check</guimenuitem>
 703       </menuchoice>
 704     </term>
 705     <listitem>
 706       <para>
 707         <action>Check</action> if your answer is correct
 708       </para>
 709     </listitem>
 710   </varlistentry>
 711
 712   <varlistentry>
 713     <term>
 714       <menuchoice>
 715         <shortcut>
 716           <keycombo action="simul"><keycap>K</keycap></keycombo>
 717         </shortcut>
 718         <guimenu>Quiz</guimenu>
 719         <guimenuitem>I Know</guimenuitem>
 720       </menuchoice>
 721     </term>
 722     <listitem>
 723       <para>
 724         <action>Count</action> as correct during a flashcard session.
 725       </para>
 726     </listitem>
 727   </varlistentry>
 728
 729   <varlistentry>
 730     <term>
 731       <menuchoice>
 732         <shortcut>
 733           <keycombo action="simul"><keycap>D</keycap></keycombo>
 734         </shortcut>
 735         <guimenu>Quiz</guimenu>
 736         <guimenuitem>I Don't Know</guimenuitem>
 737       </menuchoice>
 738     </term>
 739     <listitem>
 740       <para>
 741         <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>.
 742       </para>
 743     </listitem>
 744   </varlistentry>
 745
 746   <varlistentry>
 747     <term>
 748       <menuchoice>
 749         <shortcut>
 750           <keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
 751         </shortcut>
 752         <guimenu>Quiz</guimenu>
 753         <guimenuitem>Hint</guimenuitem>
 754       </menuchoice>
 755     </term>
 756     <listitem>
 757       <para>
 758         <action>Get</action> the next correct letter during a Question &amp; Answer session.
 759       </para>
 760     </listitem>
 761   </varlistentry>
 762
 763   <varlistentry>
 764     <term>
 765       <menuchoice>
 766         <shortcut>
 767           <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo>
 768         </shortcut>
 769         <guimenu>Quiz</guimenu>
 770         <guimenuitem>Restart</guimenuitem>
 771       </menuchoice>
 772     </term>
 773     <listitem>
 774       <para>
 775         <action>Restart</action> the quiz session from the beginning. Will reset the scores.
 776       </para>
 777     </listitem>
 778   </varlistentry>
 779
 780   <varlistentry>
 781     <term>
 782       <menuchoice>
 783         <shortcut>
 784           <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>
 785         </shortcut>
 786         <guimenu>Quiz</guimenu>
 787         <guimenuitem>Repeat Errors</guimenuitem>
 788       </menuchoice>
 789     </term>
 790     <listitem>
 791       <para>
 792         <action>Repeat</action> any questions you answered incorrectly. Becomes available once you have answered all questions once.
 793       </para>
 794     </listitem>
 795   </varlistentry>
 796
 797 </variablelist>
 798 </sect1>
 799
 800 <sect1 id="settings-menu">
 801 <title>The <guimenu>Settings</guimenu> Menu</title>
 802
 803 <variablelist>
 804   <varlistentry>
 805     <term>
 806       <menuchoice>
 807         <guimenu>Settings</guimenu>
 808         <guimenuitem>Toolbars</guimenuitem>
 809         <guimenuitem>Show Main</guimenuitem>
 810       </menuchoice>
 811     </term>
 812     <listitem>
 813       <para>
 814         <action>Toggle</action> the Main Toolbar
 815       </para>
 816     </listitem>
 817   </varlistentry>
 818
 819   <varlistentry>
 820     <term>
 821       <menuchoice>
 822         <guimenu>Settings</guimenu>
 823         <guimenuitem>Toolbars</guimenuitem>
 824         <guimenuitem>Show Go to</guimenuitem>
 825       </menuchoice>
 826     </term>
 827     <listitem>
 828       <para>
 829         <action>Toggle</action> the Go to Toolbar
 830       </para>
 831     </listitem>
 832   </varlistentry>
 833
 834   <varlistentry>
 835     <term>
 836       <menuchoice>
 837         <guimenu>Settings</guimenu>
 838         <guimenuitem>Toolbars</guimenuitem>
 839         <guimenuitem>Show Quiz</guimenuitem>
 840       </menuchoice>
 841     </term>
 842     <listitem>
 843       <para>
 844         <action>Toggle</action> the Quiz Toolbar
 845       </para>
 846     </listitem>
 847   </varlistentry>
 848
 849   <varlistentry>
 850     <term>
 851       <menuchoice>
 852         <guimenu>Settings</guimenu>
 853         <guimenuitem>Show Status bar</guimenuitem>
 854       </menuchoice>
 855     </term>
 856     <listitem>
 857       <para>
 858         <action>Toggle</action> the Status bar
 859       </para>
 860     </listitem>
 861   </varlistentry>
 862
 863   <varlistentry>
 864     <term>
 865       <menuchoice>
 866         <guimenu>Settings</guimenu>
 867         <guimenuitem>Configure Shortcuts...</guimenuitem>
 868       </menuchoice>
 869     </term>
 870     <listitem>
 871       <para>
 872         <action>Configure</action> the keyboard keys you use to access the different actions.
 873       </para>
 874     </listitem>
 875   </varlistentry>
 876
 877   <varlistentry>
 878     <term>
 879       <menuchoice>
 880         <guimenu>Settings</guimenu>
 881         <guimenuitem>Configure Toolbars...</guimenuitem>
 882       </menuchoice>
 883     </term>
 884     <listitem>
 885       <para>
 886         <action>Configure</action> the items you want to put in the toolbar
 887       </para>
 888     </listitem>
 889   </varlistentry>
 890
 891   <varlistentry>
 892     <term>
 893       <menuchoice>
 894         <guimenu>Settings</guimenu>
 895         <guimenuitem>Configure Notifications...</guimenuitem>
 896       </menuchoice>
 897     </term>
 898     <listitem>
 899       <para>
 900         <action>Configure</action> notifications for certain events in &kwordquiz;
 901       </para>
 902     </listitem>
 903   </varlistentry>
 904
 905   <varlistentry>
 906     <term>
 907       <menuchoice>
 908         <guimenu>Settings</guimenu>
 909         <guimenuitem>Configure &kwordquiz;...</guimenuitem>
 910       </menuchoice>
 911     </term>
 912     <listitem>
 913       <para>
 914         <action>Configure</action> preferences for the vocabulary editor and the quizzes. Displays a <link linkend="dlg-config-editor">dialog</link>.
 915       </para>
 916     </listitem>
 917   </varlistentry>
 918
 919 </variablelist>
 920 </sect1>
 921
 922 <sect1 id="help-menu">
 923 <title>The <guimenu>Help</guimenu> Menu</title>
 924 &help.menu.documentation;
 925 </sect1>
 926 </chapter>
 927
 928 <chapter id="editor">
 929 <title>The Vocabulary Editor</title>
 930
 931 <para>
 932 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 Titles...</guimenuitem></menuchoice>. The row headers number the rows consecutively.
 933 </para>
 934 <para>
 935 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 or columns click in the headers.
 936 </para>
 937
 938
 939 <screenshot>
 940   <screeninfo>The Vocabulary Editor</screeninfo>
 941   <mediaobject>
 942     <imageobject>
 943       <imagedata fileref="kwq-editor.png" format="PNG" />
 944     </imageobject>
 945     <textobject>
 946       <phrase>The Vocabulary Editor</phrase>
 947     </textobject>
 948   </mediaobject>
 949 </screenshot>
 950
 951 <para>
 952 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.
 953 </para>
 954 <para>
 955 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 50 rows, but there is really no limit to the number of rows you can have in a document.
 956 </para>
 957 </chapter>
 958
 959 <chapter id="flashcard">
 960
 961 <title>Flashcard Session</title>
 962
 963 <para>Select <menuchoice><guimenu>Go to</guimenu><guimenuitem>Flashcard</guimenuitem></menuchoice> 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.</para>
 964
 965 <para>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>Vocabulary</guimenu><guimenuitem>Font</guimenuitem></menuchoice> you can specify the font used for the flashcards.
 966 </para>
 967
 968 <screenshot>
 969   <screeninfo>Flashcard Session</screeninfo>
 970   <mediaobject>
 971     <imageobject>
 972       <imagedata fileref="kwq-flashcard.png" format="PNG" />
 973     </imageobject>
 974     <textobject>
 975       <phrase>Flashcard Session</phrase>
 976     </textobject>
 977   </mediaobject>
 978 </screenshot>
 979 <para>
 980 Initially the front of the card is displayed. Use <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Check</guimenuitem></menuchoice> to see the other side.
 981 </para>
 982 <para>
 983 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 <guimenu>Quiz</guimenu><guimenuitem>I Don't Know</guimenuitem> to count the card as incorrect.
 984 </para>
 985 <para>
 986 Select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Repeat Errors</guimenuitem></menuchoice> to repeat the cards you have counted as incorrect.
 987 </para>
 988 <para>
 989 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.
 990 </para>
 991 <para>
 992 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.
 993 </para>
 994
 995 <tip>
 996 <para>All items on the <guimenu>Quiz</guimenu> menu are available on the Quiz toolbar that is displayed on the right by default.</para>
 997 </tip>
 998
 999 </chapter>
1000
1001 <chapter id="multiple">
1002
1003 <title>Multiple Choice Session</title>
1004
1005 <para>
1006 Select <menuchoice><guimenu>Go to</guimenu><guimenuitem>Multiple Choice</guimenuitem></menuchoice> 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.
1007 </para>
1008 <para>
1009 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.
1010 </para>
1011 <para>
1012 In the example below the user gave an incorrect answer to the previous question. He/she is now about to answer the next question.
1013 </para>
1014
1015 <screenshot>
1016   <screeninfo>Multiple Choice Session</screeninfo>
1017   <mediaobject>
1018     <imageobject>
1019       <imagedata fileref="kwq-multiple.png" format="PNG" />
1020     </imageobject>
1021     <textobject>
1022       <phrase>Multiple Choice Session</phrase>
1023     </textobject>
1024   </mediaobject>
1025 </screenshot>
1026 <para>
1027 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.
1028 </para>
1029 <para>
1030 The previous question is shown below the current. The answer you gave is also displayed. If you answered incorrectly the correct answer is shown.
1031 </para>
1032 <para>
1033 Select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Repeat Errors</guimenuitem></menuchoice> to repeat the questions you answered incorrectly.
1034 </para>
1035 <para>
1036 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.
1037 </para>
1038 <para>
1039 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.
1040 </para>
1041
1042 <tip>
1043 <para>All items on the <guimenu>Quiz</guimenu> menu are available on the Quiz toolbar that is displayed on the right by default.</para>
1044 </tip>
1045 </chapter>
1046
1047
1048 <chapter id="question-and-answer">
1049
1050 <title>Question &amp; Answer Session</title>
1051 <para>
1052 Select <menuchoice><guimenu>Go to</guimenu><guimenuitem>Question &amp; Answer</guimenuitem></menuchoice> 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.
1053 </para>
1054 <para>
1055 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.
1056 </para>
1057 <para>
1058 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.
1059 </para>
1060
1061 <screenshot>
1062   <screeninfo>Question &amp; Answer Session</screeninfo>
1063   <mediaobject>
1064     <imageobject>
1065       <imagedata fileref="kwq-qanda.png" format="PNG" />
1066     </imageobject>
1067     <textobject>
1068       <phrase>Question &amp; Answer Session</phrase>
1069     </textobject>
1070   </mediaobject>
1071 </screenshot>
1072 <para>
1073 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 <keycap>Enter</keycap> to see if the answer is correct.
1074 </para>
1075 <para>
1076 The previous question is shown below the current. The answer you gave is also displayed. If you answered incorrectly the correct answer is shown.
1077 </para>
1078 <para>
1079 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 can select that questions where you use the hint function are always counted as incorrect.
1080 </para>
1081 <para>
1082 Select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Repeat Errors</guimenuitem></menuchoice> to repeat the questions you answered incorrectly.
1083 </para>
1084 <para>
1085 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.
1086 </para>
1087 <para>
1088 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.
1089 </para>
1090
1091 <tip>
1092 <para>All items on the <guimenu>Quiz</guimenu> menu are available on the Quiz toolbar that is displayed on the right by default.</para>
1093 </tip>
1094 </chapter>
1095
1096 <chapter id="fill-in-the-blank">
1097 <title>Fill-in-the-blank</title>
1098
1099 <para>
1100 '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.
1101 </para>
1102
1103 <para>
1104 Consider the following table. It could be a vocabulary in &kwordquiz;:
1105 </para>
1106
1107 <informaltable><tgroup cols="3">
1108 <thead>
1109 <row>
1110 <entry></entry>
1111 <entry>English</entry>
1112 <entry>German</entry>
1113 </row>
1114 </thead>
1115
1116 <tbody>
1117 <row>
1118 <entry>1</entry>
1119 <entry>We own a computer</entry>
1120 <entry>Wir besitzen einen Computer</entry>
1121 </row>
1122
1123 <row>
1124 <entry>2</entry>
1125 <entry>We own a computer</entry>
1126 <entry>Wir [besitzen] einen Computer</entry>
1127 </row>
1128
1129 <row>
1130 <entry>3</entry>
1131 <entry>We own a computer</entry>
1132 <entry>Wir [besitzen einen] Computer</entry>
1133 </row>
1134
1135 <row>
1136 <entry>4</entry>
1137 <entry>We own a computer</entry>
1138 <entry>Wir [besitzen] einen [Computer]</entry>
1139 </row>
1140 </tbody>
1141 </tgroup>
1142 </informaltable>
1143
1144 <para>
1145 The important thing to note is the placement of the brackets. They tell &kwordquiz; how the quiz should be performed.
1146 </para>
1147 <para>
1148 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.
1149 </para>
1150 <para>
1151 In 2. &kwordquiz; would display the question but also 'Wir ........ einen Computer'. For a correct answer it is sufficient to write 'besitzen'.
1152 </para>
1153 <para>
1154 3. shows that a blank can consist of more than one word. The correct answer is 'besitzen einen'.
1155 </para>
1156 <para>
1157 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.
1158 </para>
1159 <para>
1160 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 toolbar and 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 can not be started.
1161 </para>
1162 <para>
1163 The 'Fill-in-the-blank' features can be turned on and off in the Options dialog. Turning them of will make it possible to use fonts that map other characters to the positions of the brackets. It will also speed up performance slightly.
1164 </para>
1165 </chapter>
1166
1167 <chapter id="printing">
1168 <title>Printing</title>
1169 <para>
1170 &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>Expand</guibutton> to see the Vocabulary Options tab. On this tab you can select to print the document as a vocabulary list (i.e as displayed in the editor), a vocabulary exam, or as flashcards.
1171 </para>
1172 <screenshot>
1173   <screeninfo>Vocabulary Printing Options</screeninfo>
1174   <mediaobject>
1175     <imageobject>
1176       <imagedata fileref="kwq-dlg-print-type.png" format="PNG" />
1177     </imageobject>
1178     <textobject>
1179       <phrase>Vocabulary Printing Options</phrase>
1180     </textobject>
1181   </mediaobject>
1182 </screenshot>
1183
1184 <formalpara>
1185 <title>Vocabulary list</title>
1186 <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>
1187 </formalpara>
1188 <screenshot>
1189   <screeninfo>Print Vocabulary List</screeninfo>
1190   <mediaobject>
1191     <imageobject>
1192       <imagedata fileref="kwq-dlg-print-list.png" format="PNG" />
1193     </imageobject>
1194     <textobject>
1195       <phrase>Print Vocabulary List</phrase>
1196     </textobject>
1197   </mediaobject>
1198 </screenshot>
1199
1200 <formalpara>
1201 <title>Vocabulary exam</title>
1202 <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>
1203 </formalpara>
1204 <screenshot>
1205   <screeninfo>Print Vocabulary Exam</screeninfo>
1206   <mediaobject>
1207     <imageobject>
1208       <imagedata fileref="kwq-dlg-print-exam.png" format="PNG" />
1209     </imageobject>
1210     <textobject>
1211       <phrase>Print Vocabulary Exam</phrase>
1212     </textobject>
1213   </mediaobject>
1214 </screenshot>
1215
1216 <formalpara>
1217 <title>Flashcard</title>
1218 <para> Two 3" x 5" cards per page. The cards will always be printed in landscape.</para>
1219 </formalpara>
1220 <screenshot>
1221   <screeninfo>Print Flashcards</screeninfo>
1222   <mediaobject>
1223     <imageobject>
1224       <imagedata fileref="kwq-dlg-print-flashcard.png" format="PNG" />
1225     </imageobject>
1226     <textobject>
1227       <phrase>Print Flashcards</phrase>
1228     </textobject>
1229   </mediaobject>
1230 </screenshot>
1231
1232 </chapter>
1233
1234 <chapter id="dialogs">
1235 <title>Dialogs</title>
1236 <sect1 id="dlg-config-editor">
1237 <title>Configure Editor</title>
1238 <screenshot>
1239   <screeninfo>Configure Editor</screeninfo>
1240   <mediaobject>
1241     <imageobject>
1242       <imagedata fileref="kwq-dlg-configure-editor.png" format="PNG" />
1243     </imageobject>
1244     <textobject>
1245       <phrase>Configure Editor</phrase>
1246     </textobject>
1247   </mediaobject>
1248 </screenshot>
1249 <para>
1250 You can configure the behavior of the <keycap>Enter</keycap> key when working in the editor.
1251 </para>
1252 <para>
1253 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.
1254 </para>
1255 <para>
1256 Select <guibutton>Default</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.
1257 </para>
1258 </sect1>
1259
1260 <sect1 id="dlg-config-quiz">
1261 <title>Configure Quiz</title>
1262 <screenshot>
1263   <screeninfo>Configure Quiz</screeninfo>
1264   <mediaobject>
1265     <imageobject>
1266       <imagedata fileref="kwq-dlg-configure-quiz.png" format="PNG" />
1267     </imageobject>
1268     <textobject>
1269       <phrase>Configure Quiz</phrase>
1270     </textobject>
1271   </mediaobject>
1272 </screenshot>
1273 <para>
1274 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.
1275 </para>
1276 <para>
1277 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.
1278 </para>
1279 <para>
1280 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.
1281 </para>
1282 <para>
1283 For all sessions you can select if the scores should be displayed as percent instead of absolute numbers.
1284 </para>
1285 <para>
1286 Select <guibutton>Default</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.
1287 </para>
1288
1289 </sect1>
1290
1291 <sect1 id="dlg-config-characters">
1292 <title>Configure Special Characters</title>
1293 <screenshot>
1294   <screeninfo>Configure Special Characters</screeninfo>
1295   <mediaobject>
1296     <imageobject>
1297       <imagedata fileref="kwq-dlg-configure-characters.png" format="PNG" />
1298     </imageobject>
1299     <textobject>
1300       <phrase>Configure Special Characters</phrase>
1301     </textobject>
1302   </mediaobject>
1303 </screenshot>
1304 <para>
1305 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.
1306 </para>
1307 <para>
1308 Changing the keyboard shortcut associated with each action can be done by selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice>.
1309 </para>
1310
1311 <para>
1312 Select <guibutton>Default</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.
1313 </para>
1314
1315 </sect1>
1316
1317 <sect1 id="dlg-languages">
1318 <title>Column Titles</title>
1319 <screenshot>
1320   <screeninfo>Column Titles</screeninfo>
1321   <mediaobject>
1322     <imageobject>
1323       <imagedata fileref="kwq-dlg-languages.png" format="PNG" />
1324     </imageobject>
1325     <textobject>
1326       <phrase>Column Titles</phrase>
1327     </textobject>
1328   </mediaobject>
1329 </screenshot>
1330 <para>
1331 Use this dialog to define the column titles of the vocabulary. Select <guibutton>OK</guibutton> to make your changes or <guibutton>Cancel</guibutton> to discard any changes.
1332 </para>
1333 </sect1>
1334
1335 <sect1 id="dlg-special-characters">
1336 <title>Special Characters</title>
1337 <screenshot>
1338   <screeninfo>Special Characters</screeninfo>
1339   <mediaobject>
1340     <imageobject>
1341       <imagedata fileref="kwq-dlg-characters.png" format="PNG" />
1342     </imageobject>
1343     <textobject>
1344       <phrase>Special Characters</phrase>
1345     </textobject>
1346   </mediaobject>
1347 </screenshot>
1348 <para>
1349 Use this dialog to select any special character you want to associate with the current special character <link linkend="dlg-config-characters">action</link>.
1350 </para>
1351
1352 </sect1>
1353
1354 <sect1 id="dlg-rows-columns">
1355 <title>Rows/Columns</title>
1356 <screenshot>
1357   <screeninfo>Rows/Columns</screeninfo>
1358   <mediaobject>
1359     <imageobject>
1360       <imagedata fileref="kwq-dlg-rowscolumns.png" format="PNG" />
1361     </imageobject>
1362     <textobject>
1363       <phrase>Rows/Columns</phrase>
1364     </textobject>
1365   </mediaobject>
1366 </screenshot>
1367 <para>
1368 Use this dialog to specify the number of rows you want in the vocabulary. You can also adjust the width (in pixels) of the selected columns and the height (in pixels) of the selected rows. Select <guibutton>OK</guibutton> to make your changes or <guibutton>Cancel</guibutton> to discard any changes.
1369 </para>
1370 <warning>
1371 <para>
1372 Specifying a number of rows lower than what currently is in the vocabulary may lead to loss of data.
1373 </para>
1374 </warning>
1375
1376 </sect1>
1377
1378 <sect1 id="dlg-sort">
1379 <title>Sort</title>
1380 <screenshot>
1381   <screeninfo>Sort</screeninfo>
1382   <mediaobject>
1383     <imageobject>
1384       <imagedata fileref="kwq-dlg-sort.png" format="PNG" />
1385     </imageobject>
1386     <textobject>
1387       <phrase>Sort</phrase>
1388     </textobject>
1389   </mediaobject>
1390 </screenshot>
1391 <para>
1392 Use this dialog to sort the vocabulary alphabetically. You can specify if the sort should be based on the left (French in this example) or right (English in this example) column and if it should be in ascending or descending order. Select <guibutton>OK</guibutton> to do the sort or <guibutton>Cancel</guibutton> to leave the vocabulary unchanged.
1393 </para>
1394 </sect1>
1395
1396 </chapter>
1397
1398 <chapter id="faq">
1399 <title>Questions and Answers</title>
1400
1401 &reporting.bugs;
1402 &updating.documentation;
1403
1404 <qandaset id="faqlist">
1405
1406   <qandaentry>
1407     <question>
1408       <para>
1409         Can I combine several vocabularies to one.
1410       </para>
1411     </question>
1412     <answer>
1413       <para>
1414         Yes, when you select <menuchoice><guimenu>File</guimenu><guimenuitem>Open...</guimenuitem></menuchoice> you can highlight more than one file in the dialog. By default they will be opened in separate windows, but if you select the checkbox <guibutton>Join selected files into one list</guibutton>, then the data in all files will be combined into one new list.
1415       </para>
1416     </answer>
1417   </qandaentry>
1418
1419 </qandaset>
1420 </chapter>
1421
1422 <chapter id="credits">
1423
1424 <title>Credits and License</title>
1425
1426 <para>
1427 &kwordquiz;
1428 </para>
1429 <para>
1430 Program copyright 2003-2004 Peter B. Hedlund <email>peter AT peterandlinda DOT com</email>
1431 </para>
1432
1433 <para>
1434 Documentation copyright 2003-2004 Peter B. Hedlund <email>peter AT peterandlinda DOT com</email>
1435 </para>
1436
1437 &underFDL;   <!-- FDL: do not remove -->
1438 &underGPL;   <!-- GPL License -->
1439
1440 </chapter>
1441
1442 <appendix id="installation">
1443 <title>Installation</title>
1444
1445 <sect1 id="getting-kwordquiz">
1446 <title>How to obtain &kwordquiz;</title>
1447
1448 &install.intro.documentation;
1449
1450 </sect1>
1451
1452 <sect1 id="compilation">
1453 <title>Compilation and installation</title>
1454
1455 &install.compile.documentation;
1456
1457 </sect1>
1458 </appendix>
1459
1460 &documentation.index;
1461 </book>
1462 <!--
1463 Local Variables:
1464 mode: sgml
1465 sgml-minimize-attributes: nil
1466 sgml-general-insert-case: lower
1467 sgml-indent-step:0
1468 sgml-indent-data:nil
1469 End:
1470 -->