====== Pogamut & Maven & Eclipse ======

Working under Eclipse is extremely easy, at least from my point of view :-)

[[http://artemis.ms.mff.cuni.cz/pogamut_files/Pogamut_-_Eclipse_Tutorial.pdf|First-Steps tutorial for Eclipse (pdf with screenshots)]] //(we thank Liew Clement, clementliew@nus.edu.sg, National University of Singapore for creating it!)//

Steps
  - install Eclipse 3.6, or 3.7 (v3.7.2 is preferred)  or newer
    * Download [[http://www.eclipse.org/downloads/|Eclipse IDE for Java Development]]
    * Unpack it to some place, e.g. c:\eclipse
    * Turn off UAC (some plugins are having problems with UAC during installation)
  - install Subclipse plugin
    * see [[http://subclipse.tigris.org/|Subclipse]] Download&Install web page
    * copy to clipboard correct update site
      * e.g.: http://subclipse.tigris.org/update_1.8.xstartup
    * startup Eclipse, go to Menu - Help - Install New Software
    * click on "Add" button on the right-upper side of the dialog
    * add new update site (name it Subclipse and provide link from the clipboard from the Subclipse site)
    * list your new site from the combobox
    * install Subclipse plugins
  - install M2Eclipse plugin (this step is not required as of Eclipse 3.7.2 version that has M2E bundled, applies if you're using IDE for Java Developers version of Eclipse)
    * similar operation to installing Subclipse but different update site
    * see [[http://eclipse.org/m2e/|m2eclipse]] web page, particulary [[http://eclipse.org/m2e/download/|m2eclipse Download]] section 
      * pick their update site, e.g.: http://download.eclipse.org/technology/m2e/releases
    * install plugins from their update site
  - now it is advised to use [[http://tortoisesvn.net/|Tortoise SVN]] (or some other SVN client) to checkout desired Pogamut project from the SVN
    * Use [[svn://artemis.ms.mff.cuni.cz/pogamut/project|svn://artemis.ms.mff.cuni.cz/pogamut/project]] for all projects
  - in Eclipse, right-click empty space in Package explorer window (usually located on the left upper side of Eclipse), click Import, choose Existing Maven Project and browse for folder where you have checked out the Pogamut SVN
    * Eclipse should load all Maven projects into the list and you may select which one you want to import
  - alternatively, you may specify new remote catalog of archetypes via Eclipse-Window-Preferences-Maven-Archetypes
    * click Add Remote Catalog
    * fill in catalog URL: http://diana.ms.mff.cuni.cz:8081/artifactory/libs-release-local/archetype-catalog.xml 
    * name it as: Pogamut Archetypes
    * click OK
    * after that you may create new Maven project based on archetype from the catalog, note that we're regularly updating the catalog with each release of the Pogamut platform

In general it is good to read something about [[http://maven.apache.org/guides/getting-started/index.html|Maven]] as Pogamut build is fully Maven-based.

Comments & Questions are welcomed at: [[jakub.gemrot@gmail.com|jakub.gemrot@gmail.com]]