<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY kappname "&kalzium;"><!-- replace kapp here -->
 <!ENTITY package "kdeedu">
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % English "INCLUDE"><!-- change language only here -->
 ]>

 <book lang="&language;">

	 <bookinfo>
		 <title>The &kalzium; Handbook</title>
	
		 <authorgroup>
			 <author>
				 <firstname>Carsten</firstname>
				 <surname>Niehaus</surname>
				 <affiliation>
					 <address>&Carsten.Niehaus.mail;</address>
				 </affiliation>
			 </author>

			 <!-- TRANS:ROLES_OF_TRANSLATORS -->

		 </authorgroup>

		 <copyright>
			 <year>2001</year>
			 <year>2002</year>
			 <year>2004</year>
			 <year>2005</year>
			 <year>2006</year>
			 <year>2007</year>
			 <year>2008</year>
			 <holder>&Carsten.Niehaus;</holder>
		 </copyright>

		 <copyright>
			 <year>2005</year>
			 <holder>&Anne-Marie.Mahfouf;</holder>
		 </copyright>

		 <legalnotice>&FDLNotice;</legalnotice>

		 <date>2008-07-27</date>
		 <releaseinfo>2.0.80</releaseinfo>

		 <abstract>
			 <para>&kalzium; is a program which shows you the Periodic Table of
				 Elements. You can use &kalzium; to search for information about the elements or to learn facts about the
				 periodic table.</para>
		 </abstract>

		 <keywordset>
			 <keyword>KDE</keyword>
			 <keyword>education</keyword>
			 <keyword>elements</keyword>
			 <keyword>chemistry</keyword>
			 <keyword>education</keyword>
			 <keyword>kalzium</keyword>
		 </keywordset>

	 </bookinfo>

	 <chapter id="introduction">
		 <title>Introduction</title>

		 <para>&kalzium; provides you with all kinds of information about the
			 Periodic Table of the Elements. You can lookup
			 lots of information about the elements and also use visualizations to
			 show them. It is free and licensed
			 under the &GNU; Public License.
		 </para>

		 <para>
			 You can visualize the Periodic Table of the Elements by groups, blocks,
			 and families. You can
			 plot data for a range of elements for properties like the boilingpoint or the
			 atomic mass. You can go back in time and see what elements were known at a 
			 given date. You can also calculate the molecular mass of molecules.
		 </para>

	 </chapter>

	 <chapter id="quick-start">
		 <title>&kalzium; quick start guide</title>

		 <para>Here is &kalzium; the first time you run it, either by selecting <menuchoice><guimenu>Applications</guimenu> 
                 <guisubmenu>Edutainment</guisubmenu><guisubmenu>Science</guisubmenu><guimenuitem>&kalzium;</guimenuitem></menuchoice> from the &kmenu; 
                 or with <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> and entering <command>kalzium</command> into the field.</para>
		 <screenshot>
			 <screeninfo>&kalzium; main window</screeninfo>
			 <mediaobject>
				 <imageobject><imagedata fileref="quick-1.png" format="PNG" /></imageobject>
				 <textobject><phrase>&kalzium; main window</phrase></textobject>
			 </mediaobject>
		 </screenshot>

		 <para>
			 &kalzium; is divided in a navigation panel on the left (in red, 1) and the table view (in blue, 2) which shows the elements of the periodic table. The standard menubar allows you to choose what you want to display and the status bar reports facts. You can hide the navigation panel using the <menuchoice> <guimenu>View</guimenu> <guimenuitem>Show Sidebar</guimenuitem> </menuchoice> menu.
		 </para>

		 <para>
			 When you move the mouse cursor on an element of the table, an overview of the current element in the <guilabel>Overview</guilabel> tab of the navigation panel is displayed.
		 </para>

		 <para>
			 You can choose several views for the table: display the elements per families, per groups, per crystal structure, depending on their acidic behaviour, &etc;. You can change all that in the menubar in the <menuchoice> <guimenu>View</guimenu> <guimenuitem>Look</guimenuitem> </menuchoice> menu.
		 </para>
		 <para>
			 If you want to know facts about a precise element, click on it in the table and the information dialog will be displayed.
		 </para>

		 <screenshot>
			 <screeninfo>Information dialog</screeninfo>
			 <mediaobject>
				 <imageobject><imagedata fileref="quick-2.png" format="PNG" /></imageobject>
				 <textobject><phrase>Information dialog</phrase></textobject>
			 </mediaobject>
		 </screenshot>

		 <para>You can plot data using the <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Plot Data...</guimenuitem> </menuchoice> menu item. You choose what you want to plot on the y-axis and a range of elements to plot that for on the x-axis. The screenshot below shows the mass of the elements 1 to 10. </para>

		 <screenshot>
			 <screeninfo>The Plot Data dialog</screeninfo>
			 <mediaobject>
				 <imageobject><imagedata fileref="quick-3.png" format="PNG" /></imageobject>
				 <textobject><phrase>The Plot Data dialog</phrase></textobject>
			 </mediaobject>
		 </screenshot>

		 <para>The Glossary (<menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Glossary...</guimenuitem> </menuchoice>) explains the most important chemical words and shows you pictures of the most common tools along with an explanation.</para>

		 <screenshot>
			 <screeninfo>The Glossary</screeninfo>
			 <mediaobject>
				 <imageobject><imagedata fileref="quick-4.png" format="PNG" /></imageobject>
				 <textobject><phrase>The Glossary</phrase></textobject>
			 </mediaobject>
		 </screenshot>

	 </chapter>
	 <chapter id="using-kalzium">
		 <title>Using &kalzium;</title>

		 <sect1 id="foo"><title>Overview of Kalziums usage</title>
			 <para>Here are some screenshots of &kalzium; in action:</para>

			 <para>&kalzium; is very easy to use. It is specially designed for students of all ages to use as a small and quick database.</para>
			 <screenshot>
				 <screeninfo>&kalzium; main screen, immediately after the first start</screeninfo>
				 <mediaobject>
					 <imageobject>
						 <imagedata fileref="screenshot1.png" format="PNG"/>
					 </imageobject>
					 <textobject>
						 <phrase>&kalzium; main screen</phrase>
					 </textobject>
				 </mediaobject>
			 </screenshot>
		 </sect1>
		 <sect1 id="info-dlg">
			 <title>The information dialog</title>
			 <para>The information dialog is accessed by clicking with the &LMB; on
				 any element. This is the place to get information about an element. With the
				 buttons at the bottom of the dialog you can change the element which is displayed without closing the
				 dialog.</para>
			 <sect2 id="infodialog_overview">
				 <title>Overview</title>
				 <para>In the <guilabel>Overview</guilabel> you will find the most
					 important information about the element. In the middle you see the
					 symbol of the Element with it's elemental number in the bottom left.
					 The top-left corner displays the name of the element while the
					 bottom-right corner shows the elemental weight.</para>
				 <screenshot>
					 <screeninfo>&kalzium; information dialog</screeninfo>
					 <mediaobject>
						 <imageobject>
							 <imagedata fileref="infodialog_overview.png" format="PNG"/>
						 </imageobject>
						 <textobject>
							 <phrase>&kalzium; information dialog</phrase>
						 </textobject>
						 <caption><para></para></caption>
					 </mediaobject>
				 </screenshot>
			 </sect2>
			 <sect2 id="infodialog_orbits">
				 <title>Bohr Orbitals</title>
				 <para>The <guilabel>Atom Model</guilabel> tab displays the atomic
					 shells. Every orbit stands for a atomic shell and every yellow
					 circle represents an electron.</para>
				 <screenshot>
					 <screeninfo>&kalzium; information dialog</screeninfo>
					 <mediaobject>
						 <imageobject>
							 <imagedata fileref="infodialog_bohr.png" format="PNG"/>
						 </imageobject>
						 <textobject>
							 <phrase>&kalzium; information dialog</phrase>
						 </textobject>
						 <caption><para></para>
						 </caption>
					 </mediaobject>
				 </screenshot>
			 </sect2>
			 <sect2 id="infodialog_misc">
				 <title>Miscellaneous</title>
				 <para>The <guilabel>Miscellaneous</guilabel> tab tells you other information about the current element, 
				including when it was discovered and the origin of the name.</para>
				 <screenshot>
					 <screeninfo>&kalzium; information dialog</screeninfo>
					 <mediaobject>
						 <imageobject>
							 <imagedata fileref="infodialog_misc.png" format="PNG"/>
						 </imageobject>
						 <textobject>
							 <phrase>&kalzium; information dialog</phrase>
						 </textobject>
						 <caption><para></para>
						 </caption>
					 </mediaobject>
				 </screenshot>
			 </sect2>
			 <sect2 id="infodialog_isotopes">
				 <title>Isotopes</title>
				 <para>
					 The <guilabel>Isotopes</guilabel> tab presents information about the isotopes of an element.
					 <variablelist>

						 <varlistentry>
							 <term>Mass</term>
							 <listitem><para>
									 The mass of this isotope.
							 </para></listitem>
						 </varlistentry>

						 <varlistentry>
							 <term>Neutrons</term>
							 <listitem><para>
									 The number of neutrons this isotope has.
							 </para></listitem>
						 </varlistentry>

						 <varlistentry>
							 <term>Percentage</term>
							 <listitem><para>
									 The percentage of atoms occuring that are of this isotope type. Also called abundance.
							 </para></listitem>
						 </varlistentry>

						 <varlistentry>
							 <term>Half-life period</term>
							 <listitem><para>
									 Only unstable isotopes have a half-life period. It is defined as the time in which half the isotopes decay.
							 </para></listitem>
						 </varlistentry>

						 <varlistentry>
							 <term>Energy and Mode of Decay</term>
							 <listitem><para>

									Some isotopes are known to emit particle radiation under the process of radioactive decay.  Each decay transformation has a
									typical energy release, which is listed along with the mode of decay.

							 </para></listitem>
						 </varlistentry>

						 <varlistentry>
							 <term>Spin and Parity</term>
							 <listitem><para>
									 The spin of the nucleus and its parity.
							 </para></listitem>
						 </varlistentry>

						 <varlistentry>
							 <term>Magnetic Moment</term>
							 <listitem><para>
									 The magnetic dipolemoment of the nucleus. Measured in units of the nuclear magneton.
							 </para></listitem>
						 </varlistentry>

					 </variablelist>

				 </para>
				 <screenshot>
					 <screeninfo>&kalzium; information dialog</screeninfo>
					 <mediaobject>
						 <imageobject>
							 <imagedata fileref="infodialog_isotopes.png" format="PNG"/>
						 </imageobject>
						 <textobject>
							 <phrase>&kalzium; information dialog</phrase>
						 </textobject>
						 <caption><para></para>
						 </caption>
					 </mediaobject>
				 </screenshot>
			 </sect2>
			 <sect2 id="infodialog_dataoverview">
				 <title>Data Overview</title>
				 <para>The <guilabel>Data Overview</guilabel> tab tells you about different
					 facts related to the element.</para>
				 <para> Depending on the data available in &kalzium; you will see
					 different radii of the element. The covalent radius is the radius
					 of a non charged atom of the element in a molecule. The could for
					 example be the O-H-distance in Water. The atomic radius is the
					 radius of an elemental atom, &eg; not bound to anything. The van der
					 Waals-radius is defined as the distance of two atoms of the same
					 sort in two equal molecules, for example two carbon-atoms in
					 propane. The last possible radius is the ionic radius including its
					 charge.</para>
				 <para>The mass of an element is the avarage mass of all isotopes in
					 relation to their percentage.
				 </para>
				 <screenshot>
					 <screeninfo>&kalzium; information dialog</screeninfo>
					 <mediaobject>
						 <imageobject>
							 <imagedata fileref="infodialog_data_overview.png" format="PNG"/>
						 </imageobject>
						 <textobject>
							 <phrase>&kalzium; information dialog</phrase>
						 </textobject>
						 <caption><para></para>
						 </caption>
					 </mediaobject>
				 </screenshot>
			 </sect2>

<!-- Uncomment this when it has some content, since otherwise it -->
<!-- breaks checkXML -->
<!--   <sect2 id="infodialog_warnings">
				 <title>Warnings</title>
				 <para></para>
			 </sect2>
-->
			 <sect2 id="infodialog_spectrum">
				 <title>Spectrum</title>
				 <screenshot>
					 <screeninfo>&kalzium; information dialog</screeninfo>
					 <mediaobject>
						 <imageobject>
							 <imagedata fileref="infodialog_spectrum.png" format="PNG"/>
						 </imageobject>
						 <textobject>
							 <phrase>&kalzium; information dialog</phrase>
						 </textobject>
						 <caption><para></para>
						 </caption>
					 </mediaobject>
				 </screenshot>
			 </sect2>
		 </sect1>

		 <!-- Don't have empty chapters if possible - comment them out until -->
		 <sect1 id="numeration">
			 <title>Numeration</title>

			 <para>The numeration is the way  of numbering the 18 groups of the periodic table. You can change the numeration to
				 <guilabel>IUPAC</guilabel>, <guilabel>old IUPAC</guilabel> or
				 <guilabel>CAS</guilabel>, or you can switch it off entirely.</para>

			 <para>The following options in the <guimenu>View</guimenu> <guimenuitem>Numeration</guimenuitem> menu can be used to change the numeration shown:
				 <itemizedlist>
					 <listitem><para>
							 <guimenuitem>No Numeration</guimenuitem>: if this option is active, no period-numeration will be
							 in effect.</para></listitem>
					 <listitem><para>
							 <guimenuitem>IUPAC</guimenuitem> (default) is the <firstterm>International
								 Union of Pure and Applied Chemistry</firstterm>. This is an
							 organization which defines most of the standards for chemical
							 concerns. The new IUPAC system numbers each column with Arabic numbers from 1 (one) through 18 (eighteen).
					 </para></listitem>
					 <listitem><para>
							 <guimenuitem>CAS</guimenuitem> is the <firstterm>Chemical Abstracts
								 Service</firstterm>. In the CAS system the letters A and B were designated to main group elements (A) and transition elements (B). Though the <acronym>IUPAC</acronym> numeration
							 is the official, the <acronym>CAS</acronym> numeration is what is still
							 used in classrooms and laboratories.</para></listitem>
					 <listitem><para>
							 The <guimenuitem>Old IUPAC</guimenuitem> system labeled columns with Roman numerals followed by either the letter <quote>A</quote> or <quote>B</quote>. Columns were numbered such that columns one through seven were numbered <quote>IA</quote> through <quote>VIIA</quote>, columns 8 through 10 were labeled <quote>VIIIA</quote>, columns 11 through 17 were numbered <quote>IB</quote> through <quote>VIIB</quote> and column 18 was numbered <quote>VIII</quote>. Because of the confusion the old IUPAC and the CAS system created, the IUPAC adopted their new system.
					 </para></listitem>
				 </itemizedlist>
			 </para>

		 </sect1>

		 <sect1 id="colors">
			 <title>Color schemes</title>

			 <para>&kalzium; can show you which elements are where with regard to their Periodic <quote>block</quote> and <quote>group</quote>, their behavior with acid and which state of matter (&ie; solid/liquid/vapor) they are in at a given temperature.</para>

			 <para>Color schemes can be changed in the <menuchoice><guimenu>View</guimenu> <guimenuitem>Look</guimenuitem></menuchoice> menu. </para>
			 <itemizedlist>
				 <listitem><para>
						 <guimenuitem>One Color</guimenuitem>: all the elements have the same color. You can change the default color by choosing <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kalzium;...</guimenuitem>
						 </menuchoice> and going to the <guilabel>Colors</guilabel> tab.
				 </para></listitem>
				 <listitem><para>
						 <guimenuitem>Blocks</guimenuitem>: displays a color for each block.
				 </para></listitem>
				 <listitem><para>
						 <guimenuitem>Iconic</guimenuitem>: displays icons for each element.
				 </para></listitem>
				 <listitem><para>
						 <guimenuitem>Family</guimenuitem>: represents each of the nine families with a color.
				 </para></listitem>
				 <listitem><para>
						 <guimenuitem>Groups</guimenuitem>: displays a color for each group. A group is a vertical column in the periodic table of the elements. There are 18 groups in the standard periodic table. Elements in a group have similar configurations of their valence shell electrons, which gives them similar properties.
				 </para></listitem>
				 <listitem>
					 <para><guimenuitem>Gradient</guimenuitem></para>
					 <para>The gradient views displays the elements according to a property you can select below and with a gradient colored scheme. The elements for which the data is not available are displayed in grey.</para>
					 <screenshot>
						 <screeninfo>Gradient for Covalent Radius</screeninfo>
						 <mediaobject>
							 <imageobject>
								 <imagedata fileref="gradient.png" format="PNG"/>
							 </imageobject>
							 <textobject>
								 <phrase>Gradient for Covalent Radius</phrase>
							 </textobject>
						 </mediaobject>
					 </screenshot>
					 <itemizedlist>
						 <listitem><para><guimenuitem>Covalent Radius</guimenuitem>
						 </para></listitem>
						 <listitem><para><guimenuitem>van der Waals Radius</guimenuitem>
						 </para></listitem>
						 <listitem><para><guimenuitem>Atomic Mass</guimenuitem>
						 </para></listitem>
						 <listitem><para><guimenuitem>Boiling Point</guimenuitem>
						 </para></listitem>
						 <listitem><para><guimenuitem>Melting Point</guimenuitem>
						 </para></listitem>
						 <listitem><para><guimenuitem>Electronegativity (Pauling)</guimenuitem>
						 </para></listitem>
						 <listitem><para><guimenuitem>Electronaffinity</guimenuitem>
						 </para></listitem>
						 <listitem><para><guimenuitem>Discovery date</guimenuitem>
						 </para></listitem>
						 <listitem><para><guimenuitem>First Ionisation</guimenuitem>
						 </para></listitem>
					 </itemizedlist>
				 </listitem>
			 </itemizedlist>

		 </sect1>
		 <sect1 id="tools">
			 <title>Tools</title>
			 <sect2 id="nuclid_board">
				 <title>Isotope Table</title>
				 <para>
					 The <guimenuitem>Isotope Table...</guimenuitem> shows you the isotopes of the elements.
				 </para>
				 <para>
					 There are diffent kinds of isotopes, some are stable, some are not. The unstable isotopes can decay as alpha-rays are two diffent beta-rays. These differences are encoded by using diffenrent colors. 
				 </para>
				 <screenshot>
					 <mediaobject>
						 <imageobject>
							 <imagedata fileref="screenshotnuclidboard.png" format="PNG"/>
						 </imageobject>
						 <textobject>
							 <phrase>the <quote>Isotope Table</quote> window</phrase>
						 </textobject>
						 <caption><para>&kalzium; can display the isoptes of a range of elements</para>
						 </caption>
					 </mediaobject>
				 </screenshot>
			 </sect2>
			 
			 <sect2 id="rs_phrases">
				 <title>Risk/Security Phrases</title>
				 <para>The R/S Phrases, also known as Risk and Safety Statements, R/S statements, R/S numbers, and R/S sentences,
				 is a system of hazard codes and phrases for labeling dangerous chemicals and compounds.The R/S phrase of a compound
				consists of a risk part (R) and a safety part (S), each followed by a combination of numbers. Each number corresponds 
				to a phrase. The phrase corresponding to the letter/number combination has the same meaning in different languages.
				 </para>
			 </sect2>

			 <sect2 id="glossary">
				 <title>Glossary</title>
				 <para>The Glossary gives you definitions of the most used tools in chemistry as well as some knowledge data. On the left side of the windows you can see the tree of items. On top, there are chemical terms, below that there is a second tree of labaratory-tools. </para>
				 <para>On the top of the widget you can see a searchbar. If you type in the bar the trees will be adjusted immediately. The small button in the right end of the searchbar will clear it.
				 </para>
				 <screenshot>
					 <mediaobject>
						 <imageobject>
							 <imagedata fileref="screenshot7.png" format="PNG"/>
						 </imageobject>
						 <textobject>
							 <phrase>the <quote>Glossary</quote></phrase>
						 </textobject>
					 </mediaobject>
				 </screenshot>
			 </sect2>
			 <sect2 id="plot_data">
				 <title>Plot Data</title>
				 <para>
					 The <guimenuitem>Plot Data...</guimenuitem> dialog allows you to plot some information about elements. The X-axis represents a range of elements (from one number to a higher number). You set this range using the <guilabel>First Element</guilabel> and <guilabel>Last Element</guilabel> fields on the dialog.
				 </para>
				 <screenshot>
					 <mediaobject>
						 <imageobject>
							 <imagedata fileref="screenshot5.png" format="PNG"/>
						 </imageobject>
						 <textobject>
							 <phrase>the <quote>Plot Data</quote> Dialog</phrase>
						 </textobject>
						 <caption><para>&kalzium; can plot some data about a range of elements.</para>
						 </caption>
					 </mediaobject>
				 </screenshot>
			 </sect2>
			 <sect2 id="eq_solver">
				 <title>Equation Solver</title>
				 <para>
					 The <guimenuitem>Equation Solver</guimenuitem> enables the user to solve chemical equations. This is an example:
				 </para>
				 <blockquote><para>aH2O + bCO2 -> cH2CO3</para></blockquote>
				 <para>
					 The computed equation will be displayed on the right side of the window. As you can see in the first example you can also define the value of one or more coefficients. The other coefficients will be ajusted. Furthermore, it is possible to use brackets around elements or electronic charges as shown in the last two examples.</para>
				 <screenshot>
					 <mediaobject>
						 <imageobject>
							 <imagedata fileref="screenshoteqsolver.png" format="PNG"/>
						 </imageobject>
						 <textobject>
							 <phrase>the <quote>Equation Solver</quote> Dialog</phrase>
						 </textobject>
						 <caption><para>&kalzium; can solve chemical equations</para>
						 </caption>
					 </mediaobject>
				 </screenshot>
			 </sect2>

			 <sect2 id="sidebar">
				 <title>Sidebar</title>
				 <sect3 id="overview">
					 <title>Overview</title>
					 <screenshot>
						 <mediaobject>
							 <imageobject>
								 <imagedata fileref="sidebar1.png" format="PNG"/>
							 </imageobject>
							 <textobject>
								 <phrase>Overview</phrase>
							 </textobject>
						 </mediaobject>
					 </screenshot>
					 <para>The <guilabel>Overview</guilabel> tab is the first one and it shows you an overview of the element the mouse is over.</para>

				 </sect3>
				 <sect3 id="stateofmatter">
					 <title>State of Matter</title>

					 <para>The <guilabel>State of Matter</guilabel> tab is the second in the navigation panel.</para>
					 <para>You are first presented with the following icons and text:</para>
					 <screenshot>
						 <mediaobject>
							 <imageobject>
								 <imagedata fileref="screenshot2.png" format="PNG"/>
							 </imageobject>
							 <textobject>
								 <phrase>the <quote>State of Matter</quote> Dialog</phrase>
							 </textobject>
							 <caption><para>&kalzium; can show you which elements are
									 solid/liquid/vaporous at a given temperature.</para>
							 </caption>
						 </mediaobject>
					 </screenshot>
				 </sect3>
				 <sect3 id="timeline">
					 <title>Timeline</title>

					 <para>The <guilabel>Timeline</guilabel> feature allows you to explore the elements of the
						 set time period. This is great for getting a feel for how the PSE
						 evolved over time, as more and more elements were discovered. If you move the slider you will
						 notice that some elements disappear if you move it to the left and
						 reappear if you move it to the right. Furthermore the number will
						 change constantly.</para>

					 <para>
						 The number represents the date you are looking at. If you move the slider
						 to &eg; 1856 you will only see the elements which where known in the
						 year 1856. 
					 </para>

					 <para>
						 You will notice that some elements are not even shown in the current year.
						 This is because some of the elements have not been discovered yet but are
						 predicted to exist.
					 </para>

					 <screenshot>
						 <mediaobject>
							 <imageobject>
								 <imagedata fileref="screenshot6.png" format="PNG"/>
							 </imageobject>
							 <textobject>
								 <phrase>the <quote>Timeline</quote></phrase>
							 </textobject>
							 <caption><para>The PSE back in time (elements known in 1856)</para>
							 </caption>
						 </mediaobject>
					 </screenshot>
				 </sect3>

				 <sect3 id="calculate">
					 <title>Calculate</title>

					 <para>The <guilabel>Calculate</guilabel> tab is the last in the sidebar. It allows you to calculate molecules weights.</para>
					 <para>You are first presented with the following icons and text:</para>
					 <screenshot>
						 <mediaobject>
							 <imageobject>
								 <imagedata fileref="sidebar2.png" format="PNG"/>
							 </imageobject>
							 <textobject>
								 <phrase>Calculate</phrase>
							 </textobject>
							 <caption><para>Calculate</para>
							 </caption>
						 </mediaobject>
					 </screenshot>
				 </sect3>
				 <sect3 id="show_hide_legend">
					 <title>Show Legend</title>
					 <para>The Show Legend action allows you to display the legend for the scheme you are in (Groups, Family, Blocks). The legend is displayed by default but if you hide it, it will stay hidden until you choose to show it. &kalzium; will keep this setting in its configuration file, so that the next time you run it, the setting will be as you left it.
					 </para>
				 </sect3>

			 </sect2>
		 </sect1>
	 </chapter>

	 <chapter id="config">
		 <title>Configuring &kalzium;</title>

		 <para>
			 &kalzium; has many configuration options, which you can access by opening
			 the configuration dialog by selecting <menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Configure
					 &kalzium;...</guimenuitem> </menuchoice> from the menu.</para>

		 <screenshot>
			 <screeninfo>Configure &kalzium; Dialog</screeninfo>
			 <mediaobject>
				 <imageobject>
					 <imagedata fileref="settings1.png" format="PNG"/>
				 </imageobject>
				 <textobject>
					 <phrase>Colors</phrase>
				 </textobject>
			 </mediaobject>
		 </screenshot>
		 <para>In the <guilabel>Colors</guilabel> tab, you can change the different
			 colors for each scheme.
		 </para>
		 <screenshot>
			 <screeninfo>Configure &kalzium; Dialog</screeninfo>
			 <mediaobject>
				 <imageobject>
					 <imagedata fileref="settings2.png" format="PNG"/>
				 </imageobject>
				 <textobject>
					 <phrase>Units</phrase>
				 </textobject>
			 </mediaobject>
		 </screenshot>
		 <para>In the <guilabel>Units</guilabel> tab, you can
			 choose the units. You can select if you prefer kJ/mol by default or
			 you can choose eV. The Temperature is in Kelvin by default but you can 
			 change to degrees Celsius or degrees Fahrenheit.
		 </para>
		 <screenshot>
			 <screeninfo>Configure &kalzium; Dialog</screeninfo>
			 <mediaobject>
				 <imageobject>
					 <imagedata fileref="settings3.png" format="PNG"/>
				 </imageobject>
				 <textobject>
					 <phrase>Miscellaneous</phrase>
				 </textobject>
			 </mediaobject>
		 </screenshot>
		 <para>In the <guilabel>Miscellaneous</guilabel> tab, you can select to display the atomic mass or only the element numbers in the PSE.
		 </para>

	 </chapter>

	 <chapter id="commands">
		 <title>Command Reference</title>

		 <sect1 id="kalzium-mainwindow">
			 <title>Menus and shortcut keys</title>

			 <sect2>
				 <title>The <guimenu>File</guimenu> Menu</title>
				 <variablelist>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>File</guimenu>
								 <guimenuitem>Save As...</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Save</action> &kalzium;s table as image.</para></listitem>
					 </varlistentry>
				 </variablelist>
				 <variablelist>
					 <varlistentry>
						 <term><menuchoice>
								 <shortcut>
									 <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
								 </shortcut>
								 <guimenu>File</guimenu>
								 <guimenuitem>Quit</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Quits</action> &kalzium;.</para></listitem>
					 </varlistentry>
				 </variablelist>

			 </sect2>

			 <sect2>
				 <title>The <guimenu>View</guimenu> Menu</title>

				 <variablelist>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Numeration</guisubmenu>
								 <guimenuitem>No Numeration</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> no numeration scheme.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Numeration</guisubmenu>
								 <guimenuitem>IUPAC</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the IUPAC numeration.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Numeration</guisubmenu>
								 <guimenuitem>CAS</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the CAS numeration.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Numeration</guisubmenu>
								 <guimenuitem>Old IUPAC</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the Old IUPAC numeration.</para></listitem>
					 </varlistentry>

					 <!-- second entry -->
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Scheme: One Color</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> all elements with one background color.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Scheme: Blocks</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the four blocks of
								 elements.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Scheme: Iconic</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> icons for each element.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Scheme: Familiy</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the families of
								 elements.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Scheme: Groups</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the groups of elements.</para></listitem>
					 </varlistentry>

					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Gradient: Covalent Radius</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the elements covalent radius.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Gradient: van Der Waals</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the elements van der Waals radius.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Gradient: Atomic Mass</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the elements atomic mass.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Gradient: Boiling Point</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the elements boiling point.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Gradient: Melting Point</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the elements melting point.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Gradient: Electronegativity (Pauling)</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the elements electronegativity.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Gradient: Electronaffinity</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the elements electron affinity.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Gradient: Discovery date</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the discovery date of each element with different 
								background colors for each century.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Look</guisubmenu>
								 <guimenuitem>Gradient: First Ionisation</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the elements energy of first ionisation.</para></listitem>
					 </varlistentry>

					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Tables</guisubmenu>
								 <guimenuitem>Table: Classic Periodic Table</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the classic periodic table with all elements.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Tables</guisubmenu>
								 <guimenuitem>Table: Short Periodic Table</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> a periodic table without transition elements.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Tables</guisubmenu>
								 <guimenuitem>Table: Transition Elements</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> a periodic table only with transition elements.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Tables</guisubmenu>
								 <guimenuitem>Table: DZ Periodic Table</guimenuitem>
						 </menuchoice></term>
						 <listitem><para>This item represents the table the DZ <foreignphrase
							lang="de">Deutscher Zentralausschuss</foreignphrase> "German Central Comitee" suggests.</para></listitem>
					 </varlistentry>

					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guimenuitem>Show/Hide Legend</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Toggle</action> the legend view.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guimenuitem>Show/Hide Sidebar</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Toggle</action> the Sidebar.</para></listitem>
					 </varlistentry>

				 </variablelist>

			 </sect2>


			 <sect2>
				 <title>The <guimenu>Tools</guimenu> Menu</title>
				 <variablelist>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>Tools</guimenu>
								 <guimenuitem>Plot Data...</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Open</action> the Plot Data dialog.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>Tools</guimenu>
								 <guimenuitem>Isotope Table...</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Open</action> the Isotope Table window.</para></listitem>
					 </varlistentry>

					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>Tools</guimenu>
								 <guimenuitem>Glossary...</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Open</action> the Glossary.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>Tools</guimenu>
								 <guimenuitem>Equation Solver...</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Open</action> the Equationsolver dialog.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>Tools</guimenu>
								 <guimenuitem>Convert chemical files...</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Open</action> a dialog to import and export a wide range of chemical file formats and data types with the Open Babel library.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>Tools</guimenu>
								 <guimenuitem>R/S Phrases</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Open</action> the <guilabel>Risk/Security Phrases</guilabel> dialog.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>Tools</guimenu>
								 <guimenuitem>Tables...</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> a dialog with the <guilabel>Greek alphabet</guilabel> and 
						<guilabel>Numeric Prefixes and Roman Numerals</guilabel>.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>View</guimenu>
								 <guisubmenu>Tools</guisubmenu>
								 <guimenuitem>Molecular Editor...</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Open</action> the Molecular Editor dialog.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>Tools</guimenu>
								 <guimenuitem>Export Data...</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Opens</action> a dialog where you can select <guilabel>Elements</guilabel> 
						and their <guilabel>Properties</guilabel> to export them to a &HTML; file.</para></listitem>
					 </varlistentry>
				 </variablelist>

			 </sect2>

			 <sect2>
				 <title>The <guimenu>Settings</guimenu> Menu</title>

				 <variablelist>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>Settings</guimenu>
								 <guimenuitem>Show Toolbar</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Toggle</action> the Main Toolbar.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>Settings</guimenu>
								 <guimenuitem>Show Statusbar</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Toggle</action> the Statusbar.</para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>Settings</guimenu>
								 <guimenuitem>Configure Shortcuts...</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Configure</action> the keyboard keys you use to access the different actions.</para>
						 </listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>Settings</guimenu>
								 <guimenuitem>Configure Toolbars...</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Configure</action> the items you want to put in the toolbar.
						 </para></listitem>
					 </varlistentry>
					 <varlistentry>
						 <term><menuchoice>
								 <guimenu>Settings</guimenu>
								 <guimenuitem>Configure &kalzium;...</guimenuitem>
						 </menuchoice></term>
						 <listitem><para><action>Display</action> the &kalzium; settings dialog.
						 </para></listitem>
					 </varlistentry>

				 </variablelist>

			 </sect2>

			 <sect2>
				 <title>The <guimenu>Help</guimenu> Menu</title>
				 &help.menu.documentation;
			 </sect2>
		 </sect1>
	 </chapter>

	 <chapter id="faq">
		 <title>Questions and Answers</title>

		 <qandaset id="faqlist">
			 <qandaentry>
				 <question>
					 <para>Will I ever have to pay for &kalzium;?</para>
				 </question>
				 <answer>
					 <para>No, never. But the author always welcomes a nice mail or a
						 DVD as a <quote>Thank You</quote>. &kalzium; is licensed 
						 under the <ulink url="http://www.gnu.org/licenses/licenses.html#GPL">GPL</ulink>, so you will never have to pay for this program.</para>
				 </answer>
			 </qandaentry>
			 <qandaentry>

				 <question>
					 <para>Will there ever be a &Windows; version?</para>
				 </question>
				 <answer>
					 <para>No, at the moment not, but you can download the source and make
						 your own &Windows; version. It should not be a big problem, because it is
						 written with Trolltech &Qt; libs. But what do you need &Windows; for?
						 Get the latest &Linux;, and live on the edge.</para>

				 </answer>
			 </qandaentry>

		 </qandaset>
	 </chapter>

	 <chapter id="contribute">
		 <title>How can I contribute?</title>

		 <qandaset id="tasks">
			 <qandaentry>

				 <question>
					 <para>Support me with data.</para>
				 </question>

				 <answer>
					 <para>In the world of science, the progress is quite fast. If you
						 ever find an incorrect or missing value, please drop me
						 an email.</para>
				 </answer>
			 </qandaentry>

			 <qandaentry>
				 <question>
					 <para>Find some bugs or give some suggestions</para>
				 </question>
				 <answer>
					 <para>
						 If you find any bugs in the program, or have a few suggestions for
						 improvements, please let me know at &Carsten.Niehaus.mail;. 
					 </para>
				 </answer>

			 </qandaentry>
		 </qandaset>
	 </chapter>

	 <chapter id="credits">

		 <title>Credits and License</title>
		 <para>&kalzium;</para>
		 <para>
			 Program Copyright, 2001-2005 &Carsten.Niehaus;
			 &Carsten.Niehaus.mail;
		 </para>

		 <para> Contributors:</para>

		 <itemizedlist>
			 <listitem><para>
					 Pino Toscano <email>toscano.pino@tiscali.it</email>
			 </para></listitem>
		 </itemizedlist>

		 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->

		 &underFDL;           <!-- FDL: do not remove -->
		 &underGPL;        	 <!-- GPL License -->

	 </chapter>

	 <appendix id="installation">
		 <title>Installation</title>

		 <sect1 id="getting-kalzium">
			 <title>How to obtain &kalzium;</title>

			 &install.intro.documentation;

		 </sect1>

		 <sect1 id="requirements">
			 <title>Requirements</title>

			 <para>
				 &kalzium; itself can be found on <ulink
					 url="http://edu.kde.org/kalzium">The &kalzium; home page</ulink> and
				 is part of the &kde;-Edu project</para>

			 <para>You can find a list of changes in the file
				 <filename>ChangeLog</filename> in the distribution of
				 &kalzium;.</para>
		 </sect1>

		 <sect1 id="compilation">
			 <title>Compilation and Installation</title>

			 &install.compile.documentation;

		 </sect1>

	 </appendix>

	 &documentation.index;
 </book>
 <!--
 Local Variables:
 mode: sgml
 sgml-minimize-attributes:nil
 sgml-general-insert-case:lower
 sgml-indent-step:0
 sgml-indent-data:nil
 End:

 // vim:ts=2:sw=2:tw=78:noet:noai
 -->
