documentation/gettingStarted.html

<h1>Getting Started with Graphiti</h1>

<h2>Eclipse Installation</h2>
<p>As Eclipse base installation you can use any existing
installation you already have or start with a fresh one for Graphiti.
Eclipse downloads are available from <a
	href="http://eclipse.org/downloads/">here</a>, any package listed on
this page should do, but we recommend using the <i>Eclipse Classic</i>
or <i>Eclipse Modeling Tools</i> packages.</p>
<p><b>Note:</b> Graphiti 0.7.x runs against Eclipse 3.5 (Ganymede)
and Eclipse 3.6 (Helios), while Graphiti 0.8.x will run against Eclipse
3.6 (Helios) and Eclipse 3.7 (Indigo). So keep an eye on these version
ranges for your installations.</p>

<h2>First Steps</h2>
<p>To actually install Graphiti have a look onto our <a
	href="../download.php">download page</a>, all available versions and
the locations of the update sites are linked there. When you are using
an Eclipse Indigo installation (Eclipse 3.7), you don't need to add an
extra update site: Graphiti is already available from the preconfigured
Indigo update site.</p>
<p>To start, choose the <i>Graphiti SDK Plus</i> feature from the
list of available features. It contains the framework, the documentation
and the examples including the Graphiti tutorial described in the
documentation.</p>
<p>After finishing the installation and restarting Eclipse, choose
'Help' --> 'Help Contents' from the Eclipse main menu and browse for the
section on Graphiti ('Graphiti Developer Guide'). Read through the
Tutorial introduction and scenario description and start right off with
building the tutorial editor. The tutorial is also an excellent starting
point for writing your own graphical editor. Simply go through the steps
of the tutorial and replace the domain objects and the visualization in
the diagram with whatever your usecase requires.</p>
<p>In case of more detailed or further questions how to use the
Graphiti framework check-out our forum and/or Bugzilla component;
there's quite a bunch of already answered questions there, if yours is
not, feel free to open a new topic. See our <a
	href="../support/index.php">support page</a> for details on the forum
and Bugzilla component.</p>


<h2>Framework Developers</h2>
<p>If you want to change the Graphiti framework itself and start to
make contributions you should get familiar with the
general <a
	href="http://www.eclipse.org/projects/dev_process/development_process_2010.php">Eclipse
Development Process</a>.</p>
<p>More Graphiti specific information can be found on our <a
	href="../developers/index.php">developer resource pages</a>.</p>