Dialogs

Document properties dialog
This dialog also consists of several pages the determine properties that belong only to the current document. They are stored with the vocabulary.

General properties
General document properties screenshot
General document properties
Title 	Here you enter the title of the document which is displayed in the window's title bar.
Authors 	Usually you will enter your name in this field. If there are more than one author you might use a line for each person.
License 	If you want to restrict (or better allow) the use of you vocabulary you should enter the according permission or license here.
I recommend something like the Free Document License
Remark 	This field should contain things that do not fall in one of the other categories.

Lesson descriptions
Lesson descriptions dialog screenshot
Lesson descriptions
Here you add, modify or delete descriptions of your lessons.
The buttons should be pretty selfexplanatory except Clean up. This one will remove all lesson descriptions that are unused in the current document.

Type descriptions
Similar to the previous section about lessons, you can edit your own expression types on this page.
Since the dialog page looks the same as the one before there is no picture.

Tenses
On the next page you may add the tenses you need.

Usage labels
The last page provides the possibilty to enter your own usage labels.
If you think an important item is missing (from the above tense, type or usage label section) you should tell me, so I can include them in the application as standard item.
This way all the other users can benefit.

Document options
Document options dialog screenshot
Document Options
allow sorting 	If you have created your vocabulary with a certain order, you can use this checkbox to turn sorting off for this document. A click in the header button will then no longer sort the row.
Version 0.7 of additionally offered the choice to either use 8Bit or Unicode to store the vocabulary files. This is no more supported. The files are always stored in Unicode to prevent wrong rendering of characters.
Unfortunately there is no backwards compatibility to versions below 0.6 any more but I think the benefit is worth it.
If you have important files that are rendered wrong in the new version you may contact me since it might be worth the effort to create some conversion tool.

Language properties dialog
Language Properties dialog screenshot
Language Elements
The following pages of this dialog determine for each language of this dictionary several elements that are used in the according queries.
Article 	For every gender you enter here the definite and the indefinite article. If there is none for this language, you leave the field empty.
Conjugation 	In the similar manner you input the descriptor for the first, second and third person each in plural and singular.
Because many languages do not distinguish in the third person plural, there is a checkbox to determine this.
Leave the uneccessary fields empty.
Version 0.7 of also offered the choice for a special charset. In version 3 there is no need for this any more.
If you have important files that are rendered wrong in the new version you may contact me since it might be worth the effort to create some conversion tool.

Options dialog
The settings of this dialog are global and affect all vocabularies equally.

General options
General options dialog screenshot
General Options Dialog
Automatic backup interval 	 will automatically save the document if it was modified after the period you enter here when the option is checked.
As a side effect it also does not ask for confirmation to save when quiting with modified data but saves the vocabulary without asking.
An interval of 0 also stops this behaviour.
Smart appending 	If this feature is activated, you will repeatedly be prompted with the entry dialog. After entering the first original you have to enter the corresponding translations. Afterwards you proceed with the next original and its translations until you stop by pressing the ESC key.
When you are in this mode and modify the lesson in the dialog it has the same meaning as selecting the lesson in the toolbar. This way it is preselected when the next entry dialag appears.
The required lessons will have to be created in advance in the document settings.
Save options automatically 	When checked, all options are save upon termination of . Otherwise you have to select the appropriate menu item.
Column resizing 	When you resize your main window it is convenient, if the columns resize automatically, too.
This is possible in two manners:
Automatic 	 makes each columns the same width except the leftmost with the lesson names which has half the size of the others. The second column which contains the picture that describes the state of the row has a fixed width.
Percent 	 The widths of the columns are altered with the same factor the main window grew or shrunk.
If the last button labeled fixed is set, no resizing of the columns is done.

Available languages
Language options dialog screenshot
Language options dialog
Language code 	Each column can be assigned a language. This is internally done with the usual international language codes ⪚ en, de, it. These codes are also stored with the document.
You should always use the correct codes to be able to share vocabularies with others. Merging vocabularies also relies on the correct language codes.
Alternative code 	Sometimes it may be useful to have a second language code because some languages have the usual short code and one or two longer codes. For German for example it is common to use de but either deu or ger is also possible according to ISO639-2.
Language name 	Here you can give the language code a descriptive name in your own language which is shown in the header buttons in the main view.
Picture 	Additionally you can add a nice icon to your language which is shown in the table header button.
2 stores those pixmaps under $KDEDIR/share/locale/l10n/language -code.
Delete 	Deletes the currently selected language code in the list.
Add 	After entering a new language code in the field to its left, you use this button to append it to your list. After that you need to fill in the fields for the long name and the picture for the header button.
Add language from KDE database 	Pressing this button opens a menu that contains all the countries that are known in your installation. Ordered by country you can add your desired language properties to your personal list.
Maybe you want to change the language name or the according picture but I strongly recommend you keep at least the 2-byte language code and its 3-byte alternative if you don't have a special reason. This is to achieve compatible document files that can be shared among all users.
Add language from ISO639-1 	Pressing this button opens a menu that contains all the language codes that are covered by ISO639-1.
Basically the previous two button provide the same data. The former contains the language codes known in sorted by country whereas the second contains all ISO639-1 codes sorted alphabetically.

Table View
[view options dialog]
Table Font 	Lets you choose a font to display the vocabulary in the main view.
IPA Font 	Lets you choose a font to display the characters from the international phonetic alphabet. This is used to show the pronounciation of the expression on the bottom in the statusbar.
Probably you don't have an IPA enabled font since those characters are seldom used. You may download a free font from http://bibliofile.mc.duke.edu/gww/fonts/Unicode.html or http://www.hclrss.demon.co.uk/unicode/fonts.html . Install these fonts for example with kfontinst.
If you have StarOffice installed you probably have the font Lucida Sans Unicode which also contains most of the needed characters (but be sure to select the font which ends with Unicode).
I also found a Reference and Introduction to Phonetic Symbols that explains a bit about the background. There is also The International Phonetic Association where you can find even more information.
Grade colors 	Every grade can be assigned an individual color. For example I prefer green for best grade and red for worst.
If you don't want any colors but just black on white, uncheck the according check box.

Clipboard
Clipboard options dialog screenshot
Clipboard options dialog
Separator 	This is a sequence of one ore more characters which divide the parts of an expression when transfering data from or to an other application over the clipboard.
The most common item is TAB which uses the tabulator character. Another possibility is to use the semicolon, if you want to export data to a database file in CSV format.This character is also used to read such files correctly.
Order 	When pasting via the clipboard does not know which languages the different fields belong to and just would insert them from left to right.
To facilitate correct behaviour, if you arranged your vocabulary in an other way, you can determine your desired order with this area.
The buttons right to the list box move the current language up or down. Skip will insert a hole which means that the later calculated field from the clipboard is skipped.
Use current document 	When checked, the items in the clipboard are assumend to be in the same language order as the current document.

Query options dialog

Option groups
Option groups dialog screenshot
Option groups
Depending on the dictionary or the time you have to learn the vocabulary different settings may be optimal.
For that reason all the settings of the pages of this dialog can be summarized under an arbitrarily chosen name. You can store the settings and recall them whenever you want.
Retain 	Retains the settings of the other pages under the current name.
Saving to disk is done as with all the other settings using the according menu item of the options menu. Some properties are stored with the document. For example the lessons to include since this depends on the document in use.
Recall 	Recalls the settings from the group in the listbox.
New 	Creates a new group with the current settings.
Delete 	Removes the current group.

General query options
General query options dialog screenshot
General query options
Time per query 	Here you can influence the behaviour of when you don't know the answer in time.
You may set a time limit grants you to remember the correct answer.
Additionally you can tell what to do when this limit is reached. Besides of waiting unlimited time you may select to be shown the solution or to continue immediately with the next question.
Furthermore you can activate a little progess bar to show the remaining time for the current answer.
If you exceed the time limit several times in series in continuous mode will assume that there is currently no person in front of the screen and stop the query.
Swap direction randomly 	Usually a query is only in one direction, depending on the column you used to start the query. With this checkbox you can determine, that the directions are altered randomly.

Query threshholds
Query threshholds dialog screenshot
Query threshholds
With this dialog you determine which entries are included in the next selection for random query.
If you have activated the blocking mechanism on the next dialog page, the threshholds from Grade, Query count, Bad count and Last query are disabled and not taken into account.
Lesson 	Designate which lessons to include or leave out. An arbitrary number of lessons can be selected for the calculation.
For convenience there are two additional buttons to selected all entries or none.
Starting with version 0.7.0 this part is stored with the document instead of storing globally.
Word type 	Select the word type. does not pay any attention to subtypes.
Grade 	The same for the grade.
Query count 	Choose how often the selection must be queried.
Bad count 	The same for the amount of times the entry was not known.
Last query 	Include queries before or within the given time span.
Entries which have not been queried yet are always included if you choose before.
Entries are only included if all conditions are fulfilled. If you want a property to be ignored, choose Dont care for it.

Blocking and expiring
Query blocking dialog screenshot
Query blocking
On this page you select the time, an known entry is excluded from queries resp. when it must be queried at the latest.
There are two conditions which must be fullfilled, otherwise you will be shown an according warning:
The time must increase from level to level
The time for blocking must be less than for expiring in the same level.
If at least one of blocking or expiring is active, the threshholds from Grade, Query count, Bad count and Last query on the previous dialog page are not taken into account.

Entry dialog

General properties
Here you enter a new expression into a table cell or modify existing entries and their properties.
Entry dialog screenshot
Entry dialog
Expression 	Contains your words.
Lesson 	Selects the desired lesson.
The button on the right also invokes the document properties page where you can enter a new lesson.
Pronunciation 	In this field you can describe how the word is pronunciated.
This is possible either by using simple ascii charaters and maybe an fancy and very personal phonetic description or better by using the international phonetic alphabet. The button on the right invokes a dialog where you can select all the characters that belong to this alphabet.
Type 	Lets you choose one of the predefined types for your expression. If you change the type for an entry, all the other entries in that row will be assigned the new type.
See the table for all available types.
Subtype 	Some types also include subtypes. If there is no subtype available this field is disabled.
Every entry in a row can have a different subtype. This is useful for nouns as the gender of a noun may be different in different languages.
The button to the right of this field invokes the according page from the document properties dialog so you can enter a new type immediately.
Usage label 	One or more usage labels can be selected to describe the usual usage of the expression, ⪚ medicine or chemistry.
The button on the right also invokes the according page from the document properties dialog to enter a new usage label.

Selecting from the international phonetic alphabet
If you have an IPA-enabled font installed your dialog should look like this:
IPA dialog screenshot
International phonetic alphabet dialog
If you don't have such a font you can find a link to a free one in the section about the view options.

Additional properties
Less important properties that did not find place on the previous page are located here.
For most of these fields there are special queries, too.
Additional entry dialog screenshot
Additional entry dialog
Synonym 	Here you may enter words that have the same meaning as the expression. There is also a query type for this expression.
Antonym 	This is for words that have the opposite meaning. This field can also be queried.
Example 	Additionally you may enter here an example sentence for the expression. There is a simple query type which prompts you with the content of this field but with dots instead of the word in question.
Remark 	This is an optional field to store additional information.
Paraphrase 	Here you may enter a description in different words. There is also a query type for this expression.

Suggestions for a multiple choice query
Multiple choice dialog screenshot
Multiple choice dialog
If you want to create an efficient multiple choice query it is good to offer expressions that are similar to the solution to make it more difficult. If you don't offer them, has only the possibility to create such queries with randomly chosen expresions which are rather easy to guess. You can enter up to five expressions for this purpose.

Additional properties for verbs
This page is only accessible when you selected verb as word type.
Verb entry dialog screenshot
Verb entry dialog
For every tense knows you can enter the conjugations of the verb for the different persons. The tense can be selected from the list. After doing this the entry fields are updated accordingly.
Because some languages don't distinguish in the 3rd person of the plural you may use the according checkbox.
Next searches for the next tense with already entered conjugations.

Additional properties for adjectives
This page is only accessible when you selected adjective as word type.
Comparison entry dialog screenshot
Comparison entry dialog
Here you enter the the comparison forms of the adjective.

Properties from or to the original
For some properties it is possible to set up values from the original or to the original. For example you can have a grade when querying the translation (=> from the original). The opposite is the grade when querying the original when one of the translations is given (=> to the original).
From/to entry dialog screenshot
From/to entry dialog
Grade 	Contains the current grade of this expression.
False friend 	Sometimes there is a word in a foreign language that looks like a word in your native language so you think it must have the same meaning. But in fact, it is not.
Enter such words in this field.
Last query date 	This is the date when this entry was last queried. If it was never queried yet you only see --.
For convinience reasons there are two buttons to set the current date or reset to never queried.
Due to internal reasons, it is not possible to store dates before August 12 1999 with every version of . Versions 0.8 and later are no more affected.
altogether 	Designates how often this entry was queried.
wrong 	Shows the amount of times you did not know the right answer.

Docking to the main window
If you have to enter or change a lot of words you may want to place the main window next to the entry dialog and occupy the whole screen. You may do this manually or use one of the two buttons in the bottom left corner. The left one resizes the windows to an optimal height and places them one upon the other. The second places them accordingly side by side.
After closing the entry dialog the main window returns to its previous position and size.

Query dialogs

Normal random query
After selecting Create random query the main window disappers.
Then all entries that match your current threshholds are put into a list and shown in random order with the following dialog box.
Random query dialog screenshot
Random query dialog
In the dialog area with the original expression there are some properties you can enable to give you some hints. You have to enter the solution in the according text field.
Show all 	Shows the complete solution in the Translation field.
Show more 	Each click on this button will show one more character of the solution to give you a little help.
Verify 	Compares your answer with the correct solution. Currently your solution must match exactly to be accepted. If the answer was correct the color of the translation changes to green, otherwise to red
Don`t know 	Tells that you did not know the answer and that the according grade must be lowered.
Know it 	Click this button to tell that you knew the answer correctly. This entry is then removed from the currentbad list.
Edit 	If you find a mistake with a query you can invoke the edit dialog immediately and correct it.
Stop query 	Stop query mode and show vocabulary again.
In the right bottom corner you see two progressbars that indicate the remaining time and the amount of queries to come.
The query of the current lesson is repeated until all its expressions are known. The amount of retries of the current lesson is shown below the progress indicator. Once the current lesson is finished continues with the next (provided that you have set up the query options accordingly).
I regret to admit, but usually I don`t know the solution. For this reason the Return key has special behaviour, which I found convenient:
First pressing Return shows the complete solution (at the beginning the button Show more is the default button) and makes Don`t know the default button.
Pressing Return the second time will leave this dialog and tell that you did not know the answer.
At the moment you must decide for yourself, if you knew the answer or failed. Later versions may provide a more or less smart algorithm to make this decision from the answer you entered.
If you knew the corrent answer, the grade is increased by one step. If you did not know it, the grade is reset to level 1 which is worst.

Random query with multiple choice
Multiple choice query dialog screenshot
Multiple choice query dialog
This type of query works similar to the previous one. The solution is shown together with random other expressions and you have to choose one answer from the five provided.
This query works most efficiently if you provide similar solutions on the according entry dialog pages. Additionally a false friend is added if available.

Query of conjugations
Conjugation query dialog
Conjugation query dialog
This dialog appears after starting the query of the verbs.
All tenses are queried that have definitions for conjugations. Of course you must know all of them for a successful result.

Query of articles
Article query dialog screenshot
Article query dialog
In this dialog the article of the noun is queried.
It is important to having selected the correct subtype in the entry dialog.

Query of comparison forms
Comparison query dialog screenshot
Comparison query dialog
All expressions that contain also comparison forms are shown. One word is chosen randomly and you must complete the remaining two.

Query of synonyms, antonyms, paraphrases and example sentences.
Synonym query dialog screenshot
Synonym query dialog
The queries for the above mentioned additional properties of your expression look basically the same for all types.
You are prompted the expression and have to enter the according property. Querying by example is a bit different since takes the expression and replaces it by some dots so this is mainly useful when your expression is a single word.

Document statistics dialog

General
General document statistics screenshot
General document statistics
On this page you find the most important general information about your document:
The filename
The title
The name of the author
and the number of entries and lessons.

All languages in the dictionary
Per language statistics screenshot
Per language statistics
Depending on the amount of translations your document contains, you will have none, one or more additional pages. Each page contains two pictures for each lesson describing the amount of entries per grade in each lesson.
A click with the right mouse button on one of the pixmaps will popup a menu which shows the exact numbers.