<?xml version="1.0" standalone="no"?>
<!DOCTYPE book PUBLIC "-//OASIS/DTD DocBookXML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"[
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "0.8.0">
  <!ENTITY manrevision "0.8.0">
  <!ENTITY date "February 2007">
  <!ENTITY app "GChemTable">
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.GNOME.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Jan 30, 2002
-->
<!-- =============Document Header ============================= -->
<book id="index" lang="en">
  <title>&app; manual</title>
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <bookinfo> 
	 <title>&app; Manual V&manrevision;</title>
	 <copyright> 
       <year>2006</year>
       <holder>Jean Bréfort</holder>
     </copyright>

  <!-- translators: uncomment this and add lang=".." to the <book> tag:

  <copyright>
   <year>2002</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->

	&legal;

	<publisher role="maintainer">
		<publishername>GNOME Documentation Project</publishername>
	</publisher>

	 <authorgroup> 
		<author> 
		  <firstname>Jean</firstname>
		  <surname>Bréfort</surname>
		  <affiliation> 
			 <address> <email>jean.brefort@normalesup.org</email> </address>
		  </affiliation>
		</author> 
<!-- This is appropriate place for other contributors: translators,
      maintainers,  etc. Commented out by default.
       <othercredit role="translator">
	<firstname>Latin</firstname> 
	<surname>Translator 1</surname> 
	<affiliation> 
	  <orgname>Latin Translation Team</orgname> 
	  <address> <email>translator@gnome.org</email> </address> 
	</affiliation>
	<contrib>Latin translation</contrib>
      </othercredit>
-->
	 </authorgroup>

<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
	 <revhistory>
<!-- Remember to remove the &manrevision; entity from the revision entries other
   than the current revision. -->
   		<revision> 
		  <revnumber>&app; Manual V&manrevision;</revnumber>
		  <date>&date;</date> 
		  <revdescription> 
			 <para role="author">Jean Bréfort
				<email>jean.brefort@normalesup.org</email> </para>
			 <para role="publisher">GNOME Documentation Project</para>
		  </revdescription>
		</revision>
	 </revhistory>
	 <releaseinfo> This manual describes version &appversion; of &app;.
		</releaseinfo>
	 <legalnotice> 
		<title>Feedback</title>
		<para>To report a bug or make a suggestion regarding the &app; application or
		this manual, go to the
		<ulink url="http://savannah.nongnu.org/projects/gchemutils" type="html"><application>&app;</application> home page</ulink>. 
      </para>
<!-- Translators may also add here feedback address for translations -->
	 </legalnotice>
	<abstract role="description">
		<para>&app; is a chemistry elements periodic table application.</para>
	</abstract>
  </bookinfo>  

<!-- ============= Document Body ============================= -->

<!-- ============= Introduction ============================= -->
 <preface id="gchemtable-intro">
    <title>Introduction</title>
	<para>The <application>&app;</application> application is a chemical
	elements periodic table application.</para>
 </preface>

<!-- ============= Getting started ============================= -->
 <chapter id="gchemtable-getting-started">
    <title>Getting started</title>
	<sect1 id="gchemtable-to-start">
		<title>To Start <application>&app;</application></title>
		<para>You can start <application>&app;</application> in the following ways:</para>
		<variablelist>
    		<varlistentry>
    		<term><guimenu>Applications</guimenu> menu</term>
    		<listitem>
    		<para>Choose 
    		<menuchoice>
    		<guisubmenu>Education</guisubmenu>
    		<guimenuitem>Periodic table of the elements</guimenuitem>
    		</menuchoice>. </para>
    		</listitem>
    		</varlistentry>
    		<varlistentry>
    		<term>Command line</term>
    		<listitem>
    		<para>Type <command>gchemtable</command>, then press <keycap>Return</keycap>.
		</para>
    		</listitem>
    		</varlistentry>
    		</variablelist>
	</sect1>
	<sect1 id="gchemtable-when-you-start">
		<title>When You Start <application>&app;</application></title>
		<para>When you start <application>&app;</application>, the following window is displayed:</para>
 			<figure id="gchemtable-main-window"> 
			  <title>&app; window</title>
			  <screenshot> 
					<mediaobject>
						<imageobject>
							<objectinfo> <abstract><para>Screenshot of the <application>&app;</application>window.</para></abstract>
							</objectinfo> 
							<imagedata fileref="figures/start.png"/>
						</imageobject>
					</mediaobject>
				</screenshot>
			</figure>
	
		<para>The <application>&app;</application> window contains the following
		  elements: </para>
		<variablelist> 
		  <varlistentry> <term>Menubar</term> 
			 <listitem> 
				<para>The menus on the menubar contain all of the commands you need
				  to work with <application>&app;</application>.</para>
			 </listitem>
		  </varlistentry>
		  <varlistentry> <term>Periodic table</term> 
			 <listitem> 
				<para>A periodic table of the elements. The colors used for
				the buttons are conventional colors for the elements. Other
				color schemes are available as explained
				<link linkend="gchemtable-colors">there</link>.</para>
			 </listitem>
		  </varlistentry>
		</variablelist>
	</sect1>
</chapter>

<!-- ============= Usage ============================= -->
 <chapter id="gchemtable-usage">
    <title>Usage</title>
	<sect1 id="gchemtable-colors">
		<title>Color Schemes</title>
		<para>Several color schemes are available:</para>
		<variablelist> 
		  <varlistentry> <term>No colors</term> 
			 <listitem> 
				<para>All buttons are grey.</para>
			 </listitem>
		  </varlistentry>
		  <varlistentry> <term>Default</term> 
			 <listitem>
				<para>Conventional colors are used.</para>
			 </listitem>
		  </varlistentry>
		  <varlistentry> <term>Physical state</term> 
			 <listitem>
				<para>The color of the button depends on the
				physical state of the element at a given temperature.
				This temperature can be changed using the horizontal scale.</para>
				<figure id="gchemtable-state"> 
				  <title>Physical state color scheme</title>
				  <screenshot> 
						<mediaobject>
							<imageobject>
								<objectinfo> <abstract><para>Screenshot of the Main Page with Physical state color scheme.</para></abstract>
								</objectinfo> 
								<imagedata fileref="figures/state.png"/>
							</imageobject>
						</mediaobject>
					</screenshot>
				</figure>
				<para>Buttons with a black background indicate that the state is
				unknown at the given temperature.</para>
			 </listitem>
		  </varlistentry>
		  <varlistentry> <term>Family</term> 
			 <listitem>
				<para>The data used are the element family as given in the
				<ulink type="http" url="http://www.blueobelisk.org">Blue Obelisk</ulink> Data Repository.
				If no family is given in the database, the button will have a black background.</para>
				<figure id="gchemtable-family"> 
				  <title>Family color scheme</title>
				  <screenshot> 
						<mediaobject>
							<imageobject>
								<objectinfo> <abstract><para>Screenshot of the Main Page with Physical state color scheme.</para></abstract>
								</objectinfo> 
								<imagedata fileref="figures/family.png"/>
							</imageobject>
						</mediaobject>
					</screenshot>
				</figure>
			<para>If a family is selected in the combo box, only elements of this family
			will be displayed with their family color used as background, other elements
			are attributed a black background.</para>
			</listitem>
		  </varlistentry>
		</variablelist>
		
	</sect1>
	<sect1 id="gchemtable-eltdlg">
		<title>Element Window</title>
		<para>This window shows the data for an element. To display it,
		press the corresponding element button in the periodic table.
		It is possible to display several such windows at once.</para>
		<para>The data are spread over several pages, the following 
		screenshots show the various pages for the iron element:</para>
		<variablelist> 
		  <varlistentry> <term>Main Page</term> 
			 <listitem> 
				<figure id="gchemtable-main-page"> 
				  <title>Main Page</title>
				  <screenshot> 
						<mediaobject>
							<imageobject>
								<objectinfo> <abstract><para>Screenshot of the Main Page.</para></abstract>
								</objectinfo> 
								<imagedata fileref="figures/main.png"/>
							</imageobject>
						</mediaobject>
					</screenshot>
				</figure>
			 </listitem>
		  </varlistentry>
		  <varlistentry> <term>Electronic Properties</term> 
			 <listitem> 
				<figure id="gchemtable-electronic"> 
				  <title>Electronic Properties Page</title>
				  <screenshot> 
						<mediaobject>
							<imageobject>
								<objectinfo> <abstract><para>Screenshot of the Electronic Properties Page.</para></abstract>
								</objectinfo> 
								<imagedata fileref="figures/elec.png"/>
							</imageobject>
						</mediaobject>
					</screenshot>
				</figure>
			 </listitem>
		  </varlistentry>
		  <varlistentry> <term>Radii</term> 
			 <listitem> 
				<figure id="gchemtable-radii"> 
				  <title>Radii Page</title>
				  <screenshot> 
						<mediaobject>
							<imageobject>
								<objectinfo> <abstract><para>Screenshot of the Radii Page.</para></abstract>
								</objectinfo> 
								<imagedata fileref="figures/radii.png"/>
							</imageobject>
						</mediaobject>
					</screenshot>
				</figure>
			 </listitem>
		  </varlistentry>
		  <varlistentry> <term>Thermodynamic Properties</term> 
			 <listitem> 
				<figure id="gchemtable-thermodynamics"> 
				  <title>Thermodynamic Properties Page</title>
				  <screenshot> 
						<mediaobject>
							<imageobject>
								<objectinfo> <abstract><para>Screenshot of the Thermodynamic Properties Page.</para></abstract>
								</objectinfo> 
								<imagedata fileref="figures/thermo.png"/>
							</imageobject>
						</mediaobject>
					</screenshot>
				</figure>
			 </listitem>
		  </varlistentry>
		</variablelist>
		<para>When a <guibutton>Show curve</guibutton> appears on the same line
		than a data, it is possible to display a <link linkend="gchemtable-curvedlg">chart</link> of this data as a function
		of the element atomic number by clicking on the button.</para>
	</sect1>
	<sect1 id="gchemtable-curvedlg">
		<title>Curves</title>
		<para>Curves as displayed in <application>&app;</application> look like:</para>
		<figure id="gchemtable-curve"> 
		  <title>First ionization energy curve</title>
		  <screenshot> 
				<mediaobject>
					<imageobject>
						<objectinfo> <abstract><para>Screenshot of the first ionization energy curve.</para></abstract>
						</objectinfo> 
						<imagedata fileref="figures/curve.png"/>
					</imageobject>
				</mediaobject>
			</screenshot>
		</figure>
		<para>Consecutive points are joined by a segment. The absence of a segment
		means that at least one data is missing.</para>
		<para>The chart can be copied to other applications with the use of the <guibutton>Copy</guibutton>
		button.</para>
	</sect1>
</chapter>

<!-- ============= Application License ============================= -->

 <chapter id="license">
  <title>License</title>
  <para>
   This program is free software; you can redistribute it and/or
   modify it under the terms of the  <ulink type="help" url="ghelp:gpl">GNU
   General Public License</ulink> as
   published by the Free Software Foundation; 
   either version 2 of the License, or (at your option) any later
   version.
  </para>
  <para>
   This program is distributed in the hope that it will be useful, but
   WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   <citetitle>GNU General Public License</citetitle> for more details.
  </para>
  <para>
   A copy of the <citetitle>GNU General Public License</citetitle> is
   included as an appendix to the <citetitle>GNOME Users
   Guide</citetitle>.  You may also obtain a copy of the
   <citetitle>GNU General Public License</citetitle> from the Free
   Software Foundation by visiting <ulink type="http"
   url="http://www.fsf.org">their Web site</ulink> or by writing to
   <address>
    Free Software Foundation, Inc.
    <street>51 Franklin St</street> - Fifth Floor
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
    <country>USA</country>
   </address>
  </para>
 </chapter>

</book>
