From ce599e4f9f94b4eb00c1b5edb85bce5431ab3df2 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeedu@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/kbruch/Makefile.am | 4 + doc/kbruch/checked.png | Bin 0 -> 30829 bytes doc/kbruch/compare.png | Bin 0 -> 28709 bytes doc/kbruch/convert.png | Bin 0 -> 29991 bytes doc/kbruch/factorize.png | Bin 0 -> 32061 bytes doc/kbruch/gui_main.png | Bin 0 -> 28853 bytes doc/kbruch/index.docbook | 553 ++++++++++++++++++++++++++++++++++++++++ doc/kbruch/man-kbruch.1.docbook | 56 ++++ doc/kbruch/reduced.png | Bin 0 -> 12004 bytes doc/kbruch/settings.png | Bin 0 -> 51072 bytes 10 files changed, 613 insertions(+) create mode 100644 doc/kbruch/Makefile.am create mode 100644 doc/kbruch/checked.png create mode 100644 doc/kbruch/compare.png create mode 100644 doc/kbruch/convert.png create mode 100644 doc/kbruch/factorize.png create mode 100644 doc/kbruch/gui_main.png create mode 100644 doc/kbruch/index.docbook create mode 100644 doc/kbruch/man-kbruch.1.docbook create mode 100644 doc/kbruch/reduced.png create mode 100644 doc/kbruch/settings.png (limited to 'doc/kbruch') diff --git a/doc/kbruch/Makefile.am b/doc/kbruch/Makefile.am new file mode 100644 index 00000000..da8216ae --- /dev/null +++ b/doc/kbruch/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO +KDE_MANS = AUTO diff --git a/doc/kbruch/checked.png b/doc/kbruch/checked.png new file mode 100644 index 00000000..c3940127 Binary files /dev/null and b/doc/kbruch/checked.png differ diff --git a/doc/kbruch/compare.png b/doc/kbruch/compare.png new file mode 100644 index 00000000..e94daa54 Binary files /dev/null and b/doc/kbruch/compare.png differ diff --git a/doc/kbruch/convert.png b/doc/kbruch/convert.png new file mode 100644 index 00000000..4977385f Binary files /dev/null and b/doc/kbruch/convert.png differ diff --git a/doc/kbruch/factorize.png b/doc/kbruch/factorize.png new file mode 100644 index 00000000..edca9117 Binary files /dev/null and b/doc/kbruch/factorize.png differ diff --git a/doc/kbruch/gui_main.png b/doc/kbruch/gui_main.png new file mode 100644 index 00000000..6c1d0c07 Binary files /dev/null and b/doc/kbruch/gui_main.png differ diff --git a/doc/kbruch/index.docbook b/doc/kbruch/index.docbook new file mode 100644 index 00000000..dd7343b2 --- /dev/null +++ b/doc/kbruch/index.docbook @@ -0,0 +1,553 @@ + +KBruch"> + + + + +]> + + + + +The &kbruch; Handbook + + + +Sebastian +Stein + +
seb.kde@hpfsc.de
+ + + + + + + + +2001-2005 +Sebastian Stein + + +&FDLNotice; + +2004-07-09 +3.4 + + +&kbruch; is a small program to practice calculating with fractions. +Different exercises are provided for this purpose. The program checks user's +input and gives feedback. + + + + + +KDE +education +fraction +mathematics +denominator +kbruch + + + + + +Introduction + + +&kbruch; is a small program to practice calculating with fractions. Therefore +4 different exercises are offered. + + + + + Fraction Task - in this exercise you have to solve a given fraction task. +You have to enter numerator and denominator. This is the main exercise. + + + Comparison - in this exercise you have to compare the size of 2 given +fractions. + + + Conversion - in this exercise you have to convert a given number into a +fraction. + + + Factorization - in this exercise you have to factorize a given number into its prime factors. + + + + +In all different exercises &kbruch; will generate a task and the user has to +solve it. The program checks the input and gives a feedback about it. + + + +&kbruch; counts how many tasks were solved at all and how many tasks were +solved correctly. The statistics are shown to the user, but this part of the +main window can be hidden. The user can reset the statistics at any point. + + + +&kbruch; is very compact and focuses on the core idea of a task generator. An +online help system provides context-sensitive help for the different +situations. + + +&kbruch; is free and licensed under the &GNU; Public License. + + + + + +Using &kbruch; + + +Main screen + +Here is a screenshot of &kbruch;'s main screen: + + + &kbruch; main screen, directly after the start + + + + + + &kbruch; main screen + + + + + +All action takes place in this screen. This ensures that &kbruch; is +easy to use even for young users! The main screen is separated into 5 +parts: + + + + the menubar with the 3 menus Task, +Settings and Help + + + the toolbar, where you can set the difficulty for the tasks given in the + Fraction Task exercise + + + the exercise chooser, where you can switch between the different exercises + + + the task part, where you have to enter the result of the given task + + + the statistical part, where you can see how many tasks have been solved + correctly or attempted + + + + +First you have to choose an exercise in the exercise chooser on the left side +of the window. The task part will change according to the chosen task. The +settings in the toolbar will be enabled, if you have chosen the exercise +Fraction Task. + + +You will find an icon to generate a new task in the toolbar as well. This +action is also available in the menu +TaskNew +Task. This action is always enabled. If you have not +solved the currently given task, a new task is generated and the given task is +counted as not correctly solved. + + +You can hide the statistic part by dragging the vertical separator to the +right. + + +If you terminate &kbruch; the currently chosen exercise will be saved and +restored on next startup. + + + + +Statistical Part + +In this part of the main screen you can see: + + + how many tasks have been solved + + + how many tasks have been solved correctly + + + how many tasks have been solved incorrectly + + + + +You can reset the statistics by clicking on the Reset button +under the figures. + + +The statistics will be saved on &kbruch;'s termination and restored on next +startup. + + + + +Settings Window + +In this part of the main screen you can adjust some general settings for +task display. To open this dialog use +SettingsConfigure +&kbruch;. + + + + &kbruch; settings dialog + + + + + + &kbruch; settings dialog + + + + + +In the top part of the dialog you can choose a font for displaying. In the +lower part you can choose colors for the different parts of a mathematical +expression. You can set wether to show the mixed number notation in the result. +This notation is not known everywhere and can be disabled therefore. + + +The settings will be saved on &kbruch;'s termination and restored on the next +startup. + + + + + + +Exercises + + +Exercise Fraction Task + +In this exercise you have to solve a given task. Therefor you have to +enter numerator and denominator. The difficulty of the generated task can be +adjusted by the task parameters described below. + + + +Task Parameters + +There are 3 parameters which influence the difficulty of the generated +tasks: + + + +Terms +The number of terms (separate fractions) given in each +task. From 2 to 5, inclusive. + + + +Max. main denominator +The highest number &kbruch; will use as the main denominator in the +tasks it sets. From a minimum of 10 to a maximum of 50. + + + +Operations +Operations which should be used in the +task: Addition/Subtraction, +Multiplication/Division or All Operations Mixed. + + + + +After you have changed the parameters you have to click on the New +Task button in the toolbar to generate a task which uses the new +parameters. You can also call this action from the menubar with +TaskNew +Task. + + + +Your selection of the maximum main denominator will be reset to a default +value every time you change the number of terms. So you should change the +number of terms first and then select the maximum main denominator. + + + +If you have not solved the current task and call the New +Task action, the task will be counted as not solved correctly. To +prevent this you have to change the parameters after you solved the task but +before generating a new one. + + +The chosen parameters will be saved on &kbruch;'s termination and restored +on next startup. + + + + +Solving Tasks + +After you have solved a given task, you need to enter the result into the two +input boxes. In the upper box you enter the numerator and in the lower +box the denominator. + + +If the result is negative, you can enter a minus sign in front of the numerator +or denominator. If the result is 0, just type a 0 in the numerator input field. +If the result has a denominator of 1, you can leave the lower box empty. + + +After you have entered the result you should click the Check +Task button below the input boxes. &kbruch; will check your input +and present the correct result. Therefore the screen changes a little, as +you can see in the screenshot: + + +Checked Task + + + + + + Checked Task + + + + +This task was solved correctly. The correct value is shown in 2 different +forms. The second form just in front of the word CORRECT +is only used in some countries and must be read as 2 + 1/5 in the given case. + + + +You always have to enter the result reduced, because most teachers only +give all points to reduced results. &kbruch; will show you a short message +like the one in the screenshot below, if you enter the correct result +unreduced. + + + +Unreduced Result + + + + + + Unreduced Result + + + + + +To continue with the next task, click on the Next Task +button. If you want to change the parameters for the next task please do this +before clicking on the Next Task button. + + + + + +Exercise Comparison + +In this exercise you have to compare 2 given fractions. You have to choose +the bigger fraction of both by selecting the correct comparison sign. + + + +Exercise Comparison + + + + + + Exercise Comparison + + + + +First choose the correct comparison sign. To toggle the comparison sign, +you have to click on the button showing the comparison sign. After you have +chosen the comparison sign click on the Check Task button. +&kbruch; will check your input and present the correct result. After this step +you will get to the next task by clicking on the Next Task +button. + + + + +Exercise Conversion + +In this exercise you have to convert a given number into a fraction. You +have to enter numerator and denominator. + + + +Exercise Conversion + + + + + + Exercise Conversion + + + + +On the left side of the equal sign in the screenshot above you can see a +recurring decimal. This means, that the fraction shown as a decimal has a +repeating part. The repeating part is marked with the small bar above the +numbers. Those numbers repeat ad infinitum. + + +After you have entered the numerator and denominator click on the +Check Task button. &kbruch; will check your input and +present the correct result. After this step you will get to the next task by +clicking on the Next Task button. + + + + +Do not forget to enter the result reduced. Unreduced results will be counted as +solved not correctly. + + + + + +Exercise Factorization + +In this exercise you have to factorize a given number into its prime +factors. You have to enter all prime factors of the number. + + + +Exercise Factorization + + + + + + Exercise Factorization + + + + +You can enter a factor by clicking on the prime factor +buttons. The currently entered prime factors will be shown in the +field next to the number to be factorized. You can remove the last entered +prime factor by clicking on the Remove Last Factor button. + + +After you have entered all prime factors click on the +Check Task button. &kbruch; will check your input and +present the correct result. After this step you will get to the next task by +clicking on the Next Task button. + + +In the screenshot at the top of this page you can see a * +between the prime factors. This is the multiplication sign. The product of all +prime factors must be the number you try to factorize. + + + + +You have to enter all prime factors even when a prime factor repeats several +times. Example: As prime factors of number 18 you have to enter 2, 3 and 3. + + + + + + + + +Credits and License +&kbruch; + +Program and documentation Copyright, 2001-2004 Sebastian Stein + seb.kde@hpfsc.de + + +Thank you goes to: + + + &Anne-Marie.Mahfouf; for managing the &kde;-edu project + Klas Kalass for helping design the interface + Eva Brucherseifer for writing KMath (&kbruch;'s &GUI; is based on this work) + Dominique Devriese for bug fixing + Stefan Schumacher for testing a very early version + Sven Guckes for testing the text interface (which has been removed) + &David.Faure; for helping with &kde; CVS and &kde; Bugzilla + &Robert.Gogolok; for helping with &kde; CVS + John Kesson for proof reading the handbook + + + + +&underFDL; +&underGPL; + + + + +Installation + + +How to obtain &kbruch; + +&install.intro.documentation; + + + + +Requirements + + +In order to successfully use &kbruch;, you need &kde; > 3.1 . + + + +&kbruch; itself can be found +on the &kbruch; home page +and it is part of the &kde;-edu project + +You can find a list of changes in the CVS commit +messages. + + + + +Compilation and Installation + +&install.compile.documentation; + + + + + +&documentation.index; + + diff --git a/doc/kbruch/man-kbruch.1.docbook b/doc/kbruch/man-kbruch.1.docbook new file mode 100644 index 00000000..0b642e9b --- /dev/null +++ b/doc/kbruch/man-kbruch.1.docbook @@ -0,0 +1,56 @@ + + +]> + + + +KDE User's Manual +&Lauri.Watts;&Lauri.Watts.mail; +May 25, 2005 +K Desktop Environment + + + +kbruch +1 + + + +kbruch +Learn calculating with fractions + + + + +kbruch +KDE Generic Options +Qt Generic Options + + + + +Description +&kbruch; is a small program to practice calculating with fractions. +Different exercises are provided for this purpose. The program checks user's +input and gives feedback. + + + +See Also +More detailed user documentation is available from help:/kbruch +(either enter this URL into &konqueror;, or run +khelpcenter +help:/kbruch). +There is also further information available at the kde-edu website + + + +Authors +&kbruch; was written by +SebastianStein seb.kde@hpfsc.de + + + diff --git a/doc/kbruch/reduced.png b/doc/kbruch/reduced.png new file mode 100644 index 00000000..edaea85e Binary files /dev/null and b/doc/kbruch/reduced.png differ diff --git a/doc/kbruch/settings.png b/doc/kbruch/settings.png new file mode 100644 index 00000000..74c5efb9 Binary files /dev/null and b/doc/kbruch/settings.png differ -- cgit v1.2.1