Edit your ivy files easily in eclipse with the Ivy Eclipse UI Plugin editor.
Ivy Eclipse UI brings creation wizard, html preview and completion for Ivy xml tag, attributes but also for attributes' values!
Choose an organisation and browse thru its projects and revisions.

Plugin installation

You can either use :
- the auto update site : http://www.jayasoft.fr/org/updatesite
- download the binaries and unzip it in your eclipse root folder

Wizard

Eclipse Ivy UI comes with a wizard that allow you to create an ivy file for your projet.
To open the wizard choose Fle->New->Other in the eclipse menu (Ctrl+N by default)
The Ivy wizard is accesible in the category Other. Select it then click Next


The wizard contains only one page, and is very simple.

Wizard fields:
1. Container : you have to select the targeted project.(This is already set if you access the wizard thanks right click menu on your project root folder)
2. File name : the ivy file name.(ivy.xml by default and its better to keep it in most of case)
3. Organisation : the component owner name.(your company name or the company that provides the component if you are writing ivy file for 3rd party jars). Note this value can be set in the ivy preference page
4. Module name : the component name.
5. Status : the status of the project. (integration by default since we have just created its ivy file :-). Please refer to ivy documentation for more details )

When the form is correctly filled you can press Finish button. Eclipse will automatically open the ivy editor.

Ivy Editor

Xml Editor

The Ivy's eclipse editor provides xml syntaxic coloration, tag completion, tag's attribute names completion, and for dependency and configuration tag value completion.
Completion comes with contextual help. The completion popup is displayed when hitting simultaneously the CTRL and the SPACE keys.

Available completions:
• Xml structure : allow you quickly inserts the good tag at its right place. If the tag can have nested childs both notations, simple tag and open tag, are proposed
  
  
• Tag attributes : when your cursor is placed in a tag brackets the completion show available attributes for the enclosing tag.
  
  
• Attributes values : when your cursor is placed in the quote of an attribute value the completion shows available values for the matching attribute.
  
  Available value completion
  • info : organisation (pref based), module (eclipse project name),
  • info/ivyauthor : name(pref based), url (pref based)
  • info/description : homepage (pref based)
  • info/license : name
  • info/repository : name (the other attributes depend on it), url, ivys, pattern, artifacts
  • configurations/conf : visibility, deprecated, extends
  • publications/artifact : type, conf, ext
  • dependencies/dependency : org, name, rev are resolved thanks ivy using the ivyconf set in the ivy preference page. If not set ivy uses its defaults resolvers configuration (ie ivyrep + ibiblio). conf values are computed from current ivy file and the dependency ivy file if any.
    
    

Html rendering

Ivy editor is a multi tabs editor. Located on the bottom of the editor you will found a tab named preview that allows to view the ivy file as an html file.
Note : for the moment, as we let the browser do the XSLT processing on a remote file this feature only work with IE. Mozilla browser will display a blank page due its security policy. (If you know a workaround please put it on the forum)

Preference Page

Preference fields:
1. Ivyconf file : specify here the path to your ivyconf file. Leave it blank to use ivy default resolvers
2. Organisation: your company name for ivy editor completion
3. Organisation Url: your company web site url for ivy editor completion