[education/kwordquiz] doc: Adapt doc to the new qml rewrite
Carl Schwan
null at kde.org
Thu Jul 27 15:54:00 BST 2023
Git commit f0ffd7c0fdfae318c3abfbdc80be829bf7c368d0 by Carl Schwan.
Committed on 27/07/2023 at 16:53.
Pushed by carlschwan into branch 'master'.
Adapt doc to the new qml rewrite
M +80 -998 doc/index.docbook
M +- -- doc/kwordquiz-icon.png
A +- -- doc/kwq-dlg-config.png
D +- -- doc/kwq-dlg-configure-appearance.png
D +- -- doc/kwq-dlg-configure-characters.png
D +- -- doc/kwq-dlg-configure-editor.png
D +- -- doc/kwq-dlg-configure-general.png
D +- -- doc/kwq-dlg-configure-quiz.png
M +- -- doc/kwq-dlg-languages.png
M +- -- doc/kwq-dlg-print-type.png
M +- -- doc/kwq-editor.png
M +- -- doc/kwq-multiple.png
M +- -- doc/kwq-qanda.png
D +- -- doc/kwq-tutor-popup-minimalistic.png
D +- -- doc/kwq-tutor-popup-native.png
D +- -- doc/kwq-tutor-settings.png
D +- -- doc/kwq-tutor-shortcuts.png
D +- -- doc/kwq-tutor-welcome.png
A +- -- doc/kwq-welcome.png
https://invent.kde.org/education/kwordquiz/-/commit/f0ffd7c0fdfae318c3abfbdc80be829bf7c368d0
diff --git a/doc/index.docbook b/doc/index.docbook
index b6c893ef..4e22c6be 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -33,8 +33,8 @@
<legalnotice>&FDLNotice;</legalnotice>
-<date>2021-01-30</date>
-<releaseinfo>Applications 20.12</releaseinfo>
+<date>2023-07-04</date>
+<releaseinfo>Applications 23.08</releaseinfo>
<abstract>
<para>
@@ -69,761 +69,108 @@
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.
</para>
-<sect2 id="practice-modes">
-<title>Practice modes</title>
-
-<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>
-</sect2>
-
-<sect2 id="quiz-types">
-<title>Quiz types</title>
-
-<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.
-</para>
-</sect2>
-
-<sect2 id="vocabulary-documents">
-<title>Vocabulary documents</title>
-<para>
-&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>.
-</para>
-<para>
-&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>.
-</para>
-<para>
-You can have several files open at the same time, and easily copy or move entries between files.
-</para>
-</sect2>
-</sect1>
-</chapter>
-
-<chapter id="commands">
-<title>Command Reference</title>
-
-<sect1 id="file_menu">
-<title>The File Menu</title>
-
-<variablelist>
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
- </shortcut>
- <guimenu>File</guimenu>
- <guimenuitem>New</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>New</action> creates a new blank vocabulary document
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
- </shortcut>
- <guimenu>File</guimenu>
- <guimenuitem>Open...</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Open</action> one or more existing vocabulary documents.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <guimenu>File</guimenu>
- <guisubmenu>Open Recent</guisubmenu>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Open</action> a recently used vocabulary document.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo>
- </shortcut>
- <guimenu>File</guimenu>
- <guimenuitem>Download New Vocabularies...</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Downloads</action> new vocabularies. Downloaded vocabularies can
- be found in the <filename class="directory">$XDG_DATA_HOME/kvtml</filename>
- folder. <envar>$XDG_DATA_HOME</envar> is usually a hidden folder in your
- Home folder called <filename class="directory">.local</filename>.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
- </shortcut>
- <guimenu>File</guimenu>
- <guimenuitem>Save</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Save</action> the active vocabulary document to disk.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;&Shift;<keycap>S</keycap></keycombo>
- </shortcut>
- <guimenu>File</guimenu>
- <guimenuitem>Save As...</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Save</action> the active vocabulary document with a new name.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
- </shortcut>
- <guimenu>File</guimenu>
- <guimenuitem>Print...</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Print</action> the active vocabulary document. &kwordquiz; provides several options for <link linkend="printing">printing</link> your vocabularies.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <guimenu>File</guimenu>
- <guimenuitem>Print Preview</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Show</action> preview of the active vocabulary document printed by &kwordquiz;.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>
- </shortcut>
- <guimenu>File</guimenu>
- <guimenuitem>Close</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Close</action> the active vocabulary document.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
- </shortcut>
- <guimenu>File</guimenu>
- <guimenuitem>Quit</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Quit</action> &kwordquiz;
- </para>
- </listitem>
- </varlistentry>
-
-</variablelist>
-</sect1>
-
-<sect1 id="edit-menu">
-<title>The Edit Menu</title>
-
-<variablelist>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
- </shortcut>
- <guimenu>Edit</guimenu>
- <guimenuitem>Undo</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Undo</action> the last command. The name of this item will change to reflect what will be undone.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo>
- </shortcut>
- <guimenu>Edit</guimenu>
- <guimenuitem>Redo</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Redo</action> the last command. The name of this item will change to reflect what will be redone.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
- </shortcut>
- <guimenu>Edit</guimenu>
- <guimenuitem>Cut</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Cut</action> the current selection and place it on the clipboard.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
- </shortcut>
- <guimenu>Edit</guimenu>
- <guimenuitem>Copy</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Copy</action> the current selection and place it on the clipboard.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
- </shortcut>
- <guimenu>Edit</guimenu>
- <guimenuitem>Paste</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <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.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- ∇
- </shortcut>
- <guimenu>Edit</guimenu>
- <guimenuitem>Clear</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Clear</action> the current selection.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
- </shortcut>
- <guimenu>Edit</guimenu>
- <guimenuitem>Insert Row</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <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.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>K</keycap></keycombo>
- </shortcut>
- <guimenu>Edit</guimenu>
- <guimenuitem>Delete Row</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Delete</action> the selected row. If the selection extends over more than one row, all selected rows will be deleted.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
- </shortcut>
- <guimenu>Edit</guimenu>
- <guimenuitem>Mark as Blank</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <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.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <guimenu>Edit</guimenu>
- <guimenuitem>Unmark Blanks</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <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.
- </para>
- </listitem>
- </varlistentry>
-
-
-</variablelist>
-</sect1>
-
-<sect1 id="vocabulary-menu">
-<title>The Vocabulary Menu</title>
-
-<variablelist>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo>
- </shortcut>
- <guimenu>Vocabulary</guimenu>
- <guimenuitem>Column Settings...</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <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>.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <guimenu>Vocabulary</guimenu>
- <guimenuitem>Font...</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Change</action> the font used to display the vocabulary.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <guimenu>Vocabulary</guimenu>
- <guimenuitem>Link Image...</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Specify</action> the image that should be linked with the current entry.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <guimenu>Vocabulary</guimenu>
- <guimenuitem>Link Sound...</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Specify</action> the sound that should be linked with the current entry.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <guimenu>Vocabulary</guimenu>
- <guimenuitem>Adjust Row Heights</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Adjust</action> the height of the rows to fit the content.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <guimenu>Vocabulary</guimenu>
- <guimenuitem>Shuffle</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Shuffle</action> the vocabulary entries in a random order. The order of the entries in the actual vocabulary document is not changed.
- </para>
- </listitem>
- </varlistentry>
-
-</variablelist>
-</sect1>
-
-<sect1 id="mode-menu">
-<title>The Mode Menu</title>
-<para>
-The menu provides five different modes for the quiz.</para>
-
- <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 & Answer.</para>
- </note>
-<variablelist>
-
- <varlistentry>
- <term>
- <menuchoice>
- <guimenu>Mode</guimenu>
- <guimenuitem>1 Column 1 -> Column 2 In Order</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- 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.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <guimenu>Mode</guimenu>
- <guimenuitem>2 Column 2 -> Column 1 In Order</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- 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.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <guimenu>Mode</guimenu>
- <guimenuitem>3 Column 1 -> Column 2 Randomly</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- 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.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <guimenu>Mode</guimenu>
- <guimenuitem>4 Column 2 -> Column 1 Randomly</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- 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.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <guimenu>Mode</guimenu>
- <guimenuitem>5 Column 1 <-> Column 2 Randomly</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- 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.
- </para>
- </listitem>
- </varlistentry>
+<sect2 id="quiz-types">
+<title>Quiz types</title>
-</variablelist>
-</sect1>
+<para>When you have entered your vocabulary, you are ready to start a quiz. Maybe you want to start with a flashcard session. Later you can move on to a multiple choice quiz, or do the powerful question and answer quiz. You get instant feedback on correct and incorrect answers, and you have the option to repeat any errors, further improving your learning efficiency. If you need a little extra help you can use the hint function.
+</para>
+</sect2>
-<sect1 id="quiz-menu">
-<title>The Quiz Menu</title>
-<variablelist>
+<sect2 id="practice-modes">
+<title>Practice modes</title>
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul"><keycap>Return</keycap></keycombo>
- </shortcut>
- <guimenu>Quiz</guimenu>
- <guimenuitem>Check</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Check</action> if your answer is correct
- </para>
- </listitem>
- </varlistentry>
+<para>You can select how you want to practice. &kwordquiz; offers three different modes to make practicing more efficient. The different modes make it possible to decide which column is used as a question, answer or both. Additionally you can choose whether to use a sequential or random order.
+</para>
+</sect2>
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul"><keycap>K</keycap></keycombo>
- </shortcut>
- <guimenu>Quiz</guimenu>
- <guimenuitem>I Know</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Count</action> as correct during a flashcard session.
- </para>
- </listitem>
- </varlistentry>
+<sect2 id="vocabulary-documents">
+<title>Vocabulary documents</title>
+<para>
+&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>.
+</para>
+<para>
+&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>.
+</para>
+<para>
+You can have several files open at the same time, and easily copy or move entries between files.
+</para>
+</sect2>
+</sect1>
+</chapter>
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul"><keycap>D</keycap></keycombo>
- </shortcut>
- <guimenu>Quiz</guimenu>
- <guimenuitem>I Do Not Know</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <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>.
- </para>
- </listitem>
- </varlistentry>
+<chapter id="commands">
+<title>Command Reference</title>
+<sect1 id="mode-menu">
+<title>The Options Menu</title>
+<para>
+The menu provides 3 different options for the quiz which are not mutually exclusive.</para>
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
- </shortcut>
- <guimenu>Quiz</guimenu>
- <guimenuitem>Hint</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Get</action> the next correct letter during a Question & Answer session.
- </para>
- </listitem>
- </varlistentry>
+ <note><para>The menu names will change to reflect the column titles of the currently active vocabulary document. The selected mode will apply to Flashcard, Multiple Choice and Question & Answer.</para>
+ </note>
+<variablelist>
<varlistentry>
<term>
<menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo>
- </shortcut>
- <guimenu>Quiz</guimenu>
- <guimenuitem>Play Audio</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Play</action> sound that was linked to the entry with <menuchoice><guimenu>Vocabulary</guimenu> <guimenuitem>Link Sound</guimenuitem></menuchoice>.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo>
- </shortcut>
- <guimenu>Quiz</guimenu>
- <guimenuitem>Restart</guimenuitem>
+ <guimenu>Options</guimenu>
+ <guimenuitem>Shuffle</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
- <action>Restart</action> the quiz session from the beginning. This will reset the scores.
+ During the quiz you will be given the entries in a random order, but each entry will be processed once.
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term>
- <menuchoice>
- <shortcut>
- <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>
- </shortcut>
- <guimenu>Quiz</guimenu>
- <guimenuitem>Repeat Errors</guimenuitem>
- </menuchoice>
- </term>
- <listitem>
- <para>
- <action>Repeat</action> any questions you answered incorrectly. This becomes available once you have answered all the questions once.
- </para>
- </listitem>
- </varlistentry>
<varlistentry>
<term>
<menuchoice>
- <guimenu>Quiz</guimenu>
- <guimenuitem>Export Errors As...</guimenuitem>
+ <guimenu>Options</guimenu>
+ <guimenuitem>Column 1 -> Column 2</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
- <action>Export</action> any questions you answered incorrectly as a new vocabulary document. This becomes available once you have answered all the questions once.
+ During the quiz you will be given the entries of Column 1 and asked to provide the corresponding Column 2 entries.
</para>
</listitem>
</varlistentry>
-</variablelist>
-</sect1>
-
-<sect1 id="settings-help-menu">
-<title>The Settings and Help Menu</title>
-<para>Apart from the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
-menu items described in the <ulink url="help:/fundamentals/menus.html#menus-settings"
->Settings Menu</ulink> and <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
-of the &kde; Fundamentals &kwordquiz; this additional menu entry is provided:
-</para>
-
-<variablelist>
<varlistentry>
<term>
<menuchoice>
- <guimenu>Settings</guimenu>
- <guimenuitem>Show Search</guimenuitem>
+ <guimenu>Mode</guimenu>
+ <guimenuitem>Column 2 -> Column 1</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
- <action>Toggle</action> display of the search bar.
+ During the quiz you will be given the entries of Column 2 and asked to provide the corresponding Column 1 entries.
</para>
</listitem>
</varlistentry>
-
</variablelist>
</sect1>
-
</chapter>
-<chapter id="main-window">
-<title>The Main Window</title>
+<chapter id="welcome-page">
+<title>The Welcome Page</title>
<para>
-The main window has a navigation panel on the left side from which the main components of the program can be activated.
-</para>
-<para>
-The <link linkend="editor">editor</link> can be activated by pressing <menuchoice><shortcut><keycombo action="simul"><keycap>F6</keycap></keycombo></shortcut><interface></interface></menuchoice>.
-</para>
-<para>
-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>.
-</para>
-<para>
-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>.
-</para>
-<para>
-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>.
+When opening KWordQuiz, you will land on the welcome page. This page will list all the previously opened deck. Additionally it lets you create a new deck, open a deck from a file or download deck from the internet. Finally you can also choose which main mode you want to use.
</para>
<screenshot>
- <screeninfo>The Main Window</screeninfo>
+ <screeninfo>The Welcome Page</screeninfo>
<mediaobject>
<imageobject>
- <imagedata fileref="kwq-editor.png" format="PNG" />
+ <imagedata fileref="kwq-welcome.png" format="PNG" />
</imageobject>
<textobject>
- <phrase>The Main Window</phrase>
+ <phrase>The Welcome Page</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -833,14 +180,11 @@ A <link linkend="question-and-answer">question and answer</link> session can be
<title>The Vocabulary Editor</title>
<para>
-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.
-</para>
-<para>
-The column headers can also be used to sort the vocabulary. Simply click on the header of the column you want to sort by.
+The vocabulary document area has the appearance of a spreadsheet-like grid. The grid consists of cells organized in two columns and a number of rows. Each column and row has a header. The column headers are used to specify the titles of the vocabulary document. They can be set by editing the first row.
</para>
+
<para>
-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.
-</para>
+You can click in a cell of the grid to make it the active cell. You can use the up and down arrow to move up and down in the table and tab to move to the next element.</para>
<screenshot>
<screeninfo>The Vocabulary Editor</screeninfo>
@@ -858,7 +202,7 @@ You can click in a cell of the grid to make it the active cell. You can select s
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.
</para>
<para>
-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.
+When you have finished typing one entry, press the return key and the next cell will automatically become active. Hence, it's easy to quickly type several entries. There is really no limit to the number of rows you can have in a document.
</para>
</chapter>
@@ -866,11 +210,11 @@ When you have finished typing one entry, press the return key and the next cell
<title>Flashcard Session</title>
-<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.
+<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>Options</guimenu> menu will be used. If you change the options during a session, the session will be restarted.
</para>
<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>Settings</guimenu><guimenuitem>Configure &kwordquiz;...</guimenuitem></menuchoice> you can configure the appearance of the flashcards.
+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.
</para>
<screenshot>
@@ -885,25 +229,20 @@ If you are working with long expressions, the window can be resized to make more
</mediaobject>
</screenshot>
<para>
-Initially the front of the card is displayed. Use <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Check</guimenuitem></menuchoice> to see the other side.
+Initially the front of the card is displayed. Use the <guibutton>Check</guibutton> to see the other side.
</para>
<para>
-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.
+To move on to the next card, either select <guibutton>I Know</guibutton> to count the card as correct or <guibutton>I Don't Know</guibutton> to count the card as incorrect.
</para>
<para>
-Select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Repeat Errors</guimenuitem></menuchoice> to repeat the cards you have counted as incorrect.
+Select <guibutton>Repeat Errors</guibutton> to repeat the cards you have counted as incorrect.
</para>
<para>
-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.
+Select <guibutton>Try again</guibutton> to start the session from the beginning again. If you are using a random mode the cards will be reshuffled.
</para>
<para>
-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.
+The score section at the top of the screen shows the number of cards, the number of cards you have seen, the number of cards counted as correct, and the number counted as incorrect.
</para>
-
-<tip>
-<para>All items on the <guimenu>Quiz</guimenu> menu are available on the Quiz toolbar that is displayed on the right by default.</para>
-</tip>
-
</chapter>
<chapter id="multiple">
@@ -911,7 +250,7 @@ The score section at the bottom of the screen shows the number of cards, the num
<title>Multiple Choice Session</title>
<para>
-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.
+Select Multiple Choice in the welcome page to start a multiple choice quiz on the entries in the active vocabulary document. The mode selected in the <guimenu>Options</guimenu> menu will be used. If you change options during a session, the session will be restarted.
</para>
<para>
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.
@@ -932,24 +271,17 @@ In the example below the user gave an incorrect answer to the previous question.
</mediaobject>
</screenshot>
<para>
-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.
-</para>
-<para>
-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.
+Your choices are shown on the middle of the scren. Select the one you think is correct. Use <guibutton>Check</guibutton> to see if the answer is correct. If you have activated the automatic mode in <menuchoice><guimenu>Settings</guimenu></menuchoice> your selection is checked immediately.
</para>
<para>
-Select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Repeat Errors</guimenuitem></menuchoice> to repeat the questions you answered incorrectly.
+Select <guibutton>Repeat Errors</guibutton> to repeat the cards you have counted as incorrect.
</para>
<para>
-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.
+Select <guibutton>Try again</guibutton> to start the session from the beginning again. If you are using a random mode the cards will be reshuffled.
</para>
<para>
-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.
+The score section at the top of the screen shows the number of questions, the number of questions you have answered, the number of correct answers, and the number of incorrect answers.
</para>
-
-<tip>
-<para>All items on the <guimenu>Quiz</guimenu> menu are available on the Quiz toolbar that is displayed on the right by default.</para>
-</tip>
</chapter>
@@ -978,34 +310,27 @@ In the example below the user gave a correct answer to the previous question (to
</mediaobject>
</screenshot>
<para>
-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.
-</para>
-<para>
-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.
+Your question is shown on the center. Type your answer in the edit field. Use <guibutton>Check</guibutton> or &Enter; to see if the answer is correct.
</para>
<para>
-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.
+Select <guibutton>Hint</guibutton> to get the next correct letter of the answer. In <menuchoice><guimenu>Settings</guimenu></menuchoice> you may choose to count any questions where you use the hint function as incorrect.
</para>
<para>
-Select <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Repeat Errors</guimenuitem></menuchoice> to repeat the questions you answered incorrectly.
+Select <guibutton>Repeat Errors</guibutton> to repeat the cards you have counted as incorrect.
</para>
<para>
-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.
+Select <guibutton>Try again</guibutton> to start the session from the beginning again. If you are using a random mode the cards will be reshuffled.
</para>
<para>
-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.
+The score section at the top of the screen shows the number of questions, the number of questions you have answered, the number of correct answers, and the number of incorrect answers.
</para>
-
-<tip>
-<para>All items on the <guimenu>Quiz</guimenu> menu are available on the Quiz toolbar that is displayed on the right by default.</para>
-</tip>
</chapter>
<chapter id="fill-in-the-blank">
<title>Fill-in-the-blank</title>
<para>
-'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>.
+'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.
</para>
<para>
@@ -1067,15 +392,12 @@ In 4. there are two separate blanks. To specify that in the answer you have to w
<para>
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.
</para>
-<para>
-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.
-</para>
</chapter>
<chapter id="printing">
<title>Printing</title>
<para>
- &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 >></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.
+ &kwordquiz; provides the ability to print vocabulary documents in several different ways. The printing options are available in the &kwordquiz; editor. When selecting <guibutton>Print...</guibutton> you are presented with a menu where you can select to print the document as a vocabulary list (&ie; as displayed in the editor), a vocabulary exam, or as flashcards. Once the mode is selected, you will be presented with the standard &kde; print dialog.
</para>
<screenshot>
<screeninfo>Vocabulary Printing Options</screeninfo>
@@ -1138,131 +460,6 @@ The 'Fill-in-the-blank' features can be turned on and off in the Configuration d
</screenshot>
</chapter>
-<!--FIXME not ported to kf5
-<chapter id="tutor">
-<title>The Tutor Mode</title>
-
-<para>
- &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.
-</para>
-<screenshot>
- <screeninfo>Welcome message of the Tutor mode</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata fileref="kwq-tutor-welcome.png" format="PNG" />
- </imageobject>
- <textobject>
- <phrase>Welcome message of the Tutor mode</phrase>
- </textobject>
- </mediaobject>
-</screenshot>
-
-<para>
- 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).
-</para>
-
-<para>
- There are four items in this menu:
- <variablelist>
- <varlistentry>
- <term><guimenuitem>Start Exercise</guimenuitem></term>
- <listitem>
- <para>
- <action>Start</action> the Tutor exercise.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Open...</guimenuitem></term>
- <listitem>
- <para>
- <action>Open</action> an existing vocabulary document.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Configure &kwordquiz; Tutor...</guimenuitem></term>
- <listitem>
- <para>
- <action>Open</action> the Tutor configuration dialog.
- </para>
- <screenshot>
- <screeninfo>The Tutor Settings page</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata fileref="kwq-tutor-settings.png" format="PNG" />
- </imageobject>
- <textobject>
- <phrase>The Tutor Settings page</phrase>
- </textobject>
- </mediaobject>
- </screenshot>
- <para>
- 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>.
- </para>
- <para>
- In the current version, you can choose between <guilabel>Native</guilabel> and <guilabel>Minimalistic</guilabel> flashcard appearances.
- </para>
- <screenshot>
- <screeninfo>The Native flashcard appearance</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata fileref="kwq-tutor-popup-native.png" format="PNG" />
- </imageobject>
- <textobject>
- <phrase>The Native flashcard appearance</phrase>
- </textobject>
- <caption>
- <para>
- Use Native appearance for the fancy vocabularies with images.
- </para>
- </caption>
- </mediaobject>
- </screenshot>
- <screenshot>
- <screeninfo>The Minimalistic flashcard appearance</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata fileref="kwq-tutor-popup-minimalistic.png" format="PNG" />
- </imageobject>
- <textobject>
- <phrase>The Minimalistic flashcard appearance</phrase>
- </textobject>
- <caption>
- <para>
- Use Minimalistic appearance for the simple vocabularies.
- </para>
- </caption>
- </mediaobject>
- </screenshot>
- <screenshot>
- <screeninfo>The Shortcuts Settings page</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata fileref="kwq-tutor-shortcuts.png" format="PNG" />
- </imageobject>
- <textobject>
- <phrase>The Shortcuts Settings page</phrase>
- </textobject>
- </mediaobject>
- </screenshot>
- <para>
- 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.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><guimenuitem>Quit</guimenuitem></term>
- <listitem>
- <para>
- <action>Quit</action> &kwordquiz;.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-</para>
-</chapter>
--->
<chapter id="dialogs">
<title>Dialogs</title>
@@ -1273,7 +470,7 @@ The 'Fill-in-the-blank' features can be turned on and off in the Configuration d
<screeninfo>General Settings</screeninfo>
<mediaobject>
<imageobject>
- <imagedata fileref="kwq-dlg-configure-general.png" format="PNG" />
+ <imagedata fileref="kwq-dlg-config.png" format="PNG" />
</imageobject>
<textobject>
<phrase>General Settings</phrase>
@@ -1284,112 +481,18 @@ The 'Fill-in-the-blank' features can be turned on and off in the Configuration d
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.
</para>
<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.
-</para>
-</sect1>
-
-<sect1 id="dlg-config-editor">
-<title>Editor Settings</title>
-<screenshot>
- <screeninfo>Editor Settings</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata fileref="kwq-dlg-configure-editor.png" format="PNG" />
- </imageobject>
- <textobject>
- <phrase>Editor Settings</phrase>
- </textobject>
- </mediaobject>
-</screenshot>
-<para>
-You can configure the behavior of the &Enter; key when working in the editor.
-</para>
-<para>
-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.
-</para>
-<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.
-</para>
-</sect1>
-
-<sect1 id="dlg-config-quiz">
-<title>Quiz Settings</title>
-<screenshot>
- <screeninfo>Quiz Settings</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata fileref="kwq-dlg-configure-quiz.png" format="PNG" />
- </imageobject>
- <textobject>
- <phrase>Quiz Settings</phrase>
- </textobject>
- </mediaobject>
-</screenshot>
-<para>
-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.
-</para>
-<para>
-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.
-</para>
-<para>
-For question & answer sessions you can select if questions where you use <menuchoice><guimenu>Quiz</guimenu><guimenuitem>Hint</guimenuitem></menuchoice> should be counted as incorrect.
-</para>
-<para>
For all sessions you can select if the scores should be displayed as percentages instead of absolute numbers.
</para>
+<tip>
<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.
-</para>
-</sect1>
-
-<sect1 id="dlg-config-appearance">
-<title>Flashcard Appearance Settings</title>
-<screenshot>
- <screeninfo>Flashcard Appearance Settings</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata fileref="kwq-dlg-configure-appearance.png" format="PNG" />
- </imageobject>
- <textobject>
- <phrase>Flashcard Appearance Settings</phrase>
- </textobject>
- </mediaobject>
-</screenshot>
-<para>
-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.
-</para>
-<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.
-</para>
-</sect1>
-
-<sect1 id="dlg-config-characters">
-<title>Special Characters Settings</title>
-<screenshot>
- <screeninfo>Special Characters Settings</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata fileref="kwq-dlg-configure-characters.png" format="PNG" />
- </imageobject>
- <textobject>
- <phrase>Special Characters Settings</phrase>
- </textobject>
- </mediaobject>
-</screenshot>
-<para>
-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.
-</para>
-<para>
-Changing the keyboard shortcut associated with each action can be done by selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice>.
-</para>
-
-<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.
+Note that the settings are automatically applied.
</para>
+</tip>
</sect1>
<sect1 id="dlg-languages">
<title>Column Settings</title>
-<para>You can open this dialog from the menubar with <menuchoice><guimenu>Vocabulary</guimenu><guimenuitem>Column Settings...</guimenuitem></menuchoice></para>
+<para>You can open this dialog from the editor.</para>
<screenshot>
<screeninfo>Column Settings</screeninfo>
<mediaobject>
@@ -1402,30 +505,9 @@ Select <guibutton>Defaults</guibutton> to restore all settings to predefined def
</mediaobject>
</screenshot>
<para>
-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.
-</para>
-</sect1>
-
-<sect1 id="dlg-special-characters">
-<title>Special Characters</title>
-<para>Click the <guibutton>Character...</guibutton> button on the <guilabel>Special Characters</guilabel> page in &kwordquiz; settings dialog to open this window.</para>
-<screenshot>
- <screeninfo>Special Characters</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata fileref="kwq-dlg-characters.png" format="PNG" />
- </imageobject>
- <textobject>
- <phrase>Special Characters</phrase>
- </textobject>
- </mediaobject>
-</screenshot>
-<para>
-Use this dialog to select any special character you want to associate with the current special character <link linkend="dlg-config-characters">action</link>.
+Use this dialog to define the column titles and column languages. Click on a language to selected it or close the dialog to discard any changes.
</para>
-
</sect1>
-
</chapter>
<chapter id="credits">
@@ -1436,7 +518,7 @@ Use this dialog to select any special character you want to associate with the c
&kwordquiz;
</para>
<para>
-Program copyright 2003-2008 Peter B. Hedlund <email>peter.hedlund at kdemail.net</email>
+Program copyright 2003-2008 Peter B. Hedlund <email>peter.hedlund at kdemail.net</email> 2023 Carl Schwan <email>carl at carlchwan.eu</email>
</para>
<para>
diff --git a/doc/kwordquiz-icon.png b/doc/kwordquiz-icon.png
index a279daa0..adcf7f8f 100644
Binary files a/doc/kwordquiz-icon.png and b/doc/kwordquiz-icon.png differ
diff --git a/doc/kwq-dlg-config.png b/doc/kwq-dlg-config.png
new file mode 100644
index 00000000..354ba4e6
Binary files /dev/null and b/doc/kwq-dlg-config.png differ
diff --git a/doc/kwq-dlg-configure-appearance.png b/doc/kwq-dlg-configure-appearance.png
deleted file mode 100644
index 56a81274..00000000
Binary files a/doc/kwq-dlg-configure-appearance.png and /dev/null differ
diff --git a/doc/kwq-dlg-configure-characters.png b/doc/kwq-dlg-configure-characters.png
deleted file mode 100644
index 1c7833c1..00000000
Binary files a/doc/kwq-dlg-configure-characters.png and /dev/null differ
diff --git a/doc/kwq-dlg-configure-editor.png b/doc/kwq-dlg-configure-editor.png
deleted file mode 100644
index 2b917ef4..00000000
Binary files a/doc/kwq-dlg-configure-editor.png and /dev/null differ
diff --git a/doc/kwq-dlg-configure-general.png b/doc/kwq-dlg-configure-general.png
deleted file mode 100644
index a4f11374..00000000
Binary files a/doc/kwq-dlg-configure-general.png and /dev/null differ
diff --git a/doc/kwq-dlg-configure-quiz.png b/doc/kwq-dlg-configure-quiz.png
deleted file mode 100644
index 302761cf..00000000
Binary files a/doc/kwq-dlg-configure-quiz.png and /dev/null differ
diff --git a/doc/kwq-dlg-languages.png b/doc/kwq-dlg-languages.png
index 4799a8ba..fc34d212 100644
Binary files a/doc/kwq-dlg-languages.png and b/doc/kwq-dlg-languages.png differ
diff --git a/doc/kwq-dlg-print-type.png b/doc/kwq-dlg-print-type.png
index 4a2f074b..8b2200fd 100644
Binary files a/doc/kwq-dlg-print-type.png and b/doc/kwq-dlg-print-type.png differ
diff --git a/doc/kwq-editor.png b/doc/kwq-editor.png
index b2be7b24..44efe4e7 100644
Binary files a/doc/kwq-editor.png and b/doc/kwq-editor.png differ
diff --git a/doc/kwq-multiple.png b/doc/kwq-multiple.png
index 175fda43..8c481699 100644
Binary files a/doc/kwq-multiple.png and b/doc/kwq-multiple.png differ
diff --git a/doc/kwq-qanda.png b/doc/kwq-qanda.png
index ab31ec65..254dd26d 100644
Binary files a/doc/kwq-qanda.png and b/doc/kwq-qanda.png differ
diff --git a/doc/kwq-tutor-popup-minimalistic.png b/doc/kwq-tutor-popup-minimalistic.png
deleted file mode 100644
index 9920fd9c..00000000
Binary files a/doc/kwq-tutor-popup-minimalistic.png and /dev/null differ
diff --git a/doc/kwq-tutor-popup-native.png b/doc/kwq-tutor-popup-native.png
deleted file mode 100644
index 21f2e481..00000000
Binary files a/doc/kwq-tutor-popup-native.png and /dev/null differ
diff --git a/doc/kwq-tutor-settings.png b/doc/kwq-tutor-settings.png
deleted file mode 100644
index 73d88931..00000000
Binary files a/doc/kwq-tutor-settings.png and /dev/null differ
diff --git a/doc/kwq-tutor-shortcuts.png b/doc/kwq-tutor-shortcuts.png
deleted file mode 100644
index 951e5009..00000000
Binary files a/doc/kwq-tutor-shortcuts.png and /dev/null differ
diff --git a/doc/kwq-tutor-welcome.png b/doc/kwq-tutor-welcome.png
deleted file mode 100644
index fc2c99f5..00000000
Binary files a/doc/kwq-tutor-welcome.png and /dev/null differ
diff --git a/doc/kwq-welcome.png b/doc/kwq-welcome.png
new file mode 100644
index 00000000..afa16c9d
Binary files /dev/null and b/doc/kwq-welcome.png differ
More information about the kde-doc-english
mailing list