System requirements: 
Windows (XP) operating system 
Eclipse 2.1 framework 
Good CP and lots of RAM 


Installation: 
Copy the two plugins (ca.uvic.gild.mainview and ca.uvic.gild.servlet) to the 
plugins directory of eclipse. Start eclipse. From Windows->ShowView->Other->
GILD Main view. A view with an embedded Internet Explorer browser is 
displayed. 


Running the example: 
Copy the HelloWorld example in the workspace directory of eclipse and import 
it as an existing workspace project in your eclipse. Open the presentation 
directory and start navigating through the slides using the navigation view 
or the links in the document. 


Build your own presentations:

Writing a GILD presentation involves the following steps:
1. Using the wizard create a new java project. Specify the location of the
source code (usually a src directory). For a GILD project we might want to
be able to specify the location of the course material.
2. Create the java files for the class/course
3. Create the course material as html files. To edit these files you can use 
the default eclipse editor or an html editor of your choice. The Lomboz editor 
for example (shipped with the Lomboz plugin) offers html syntax highlighting.
It can be found at: 
http://www.mycgiserver.com/~objectlearn/products/lomboz.html#lomboz.


In order to use the features of the GILD authoring tool, several rules
need to be followed when editing the content of the presentation files:

IMG
===
The full path for the source of the images needs to be specified such as:
<IMG SRC="C:/eclipse/workspace/HelloWorld/icons/javaCoding.gif" WIDTH="465" 
HEIGHT="218 " ALIGN="BOTTOM" NATURALSIZEFLAG="3">
This is rather a limitation and I'm seeking a solution to this problem.

Links
=====
to other Web pages - no change
to local files - same as with the image sources, a complete path is required
to Gild project files - following format is required:
<a href='javascript:navigate("GildProject", "RelativePath/filename.html",\'>
Go to filename</a> where:
GildProject - a Gild Project
RelativePath - the path relative to the root of the GildProject. This path 
appears in the navigator view of the project
filename.html - the actual html file
Example:
<a href='javascript:navigate("HelloWorld", "tutorial/HelloWorld1.html")'>
Previous</a>
Note: Being portable, this last format is preferred over the full local path.

Links to Java code
==================
Format:
<a href='javascript:liveAction(
	"GildProject", 
	"RelativePath/File.java", "Container.Method(Parameters)")'> here</a>
Where:
GildProject - a Gild Project
RelativePath - the path relative to the root of the GildProject where the
source file is located. This path appears in the navigator view of the project
file.java - the source file
Container - the name of the class/interface.
Method(Parameters) - the signature of the method as it appears in the source
file.
Example:
<a href='javascript:liveAction(
	"HelloWorld", 
	"src/HelloWorld.java", "HelloWorld.foo()")'> here</a>
Notes: 
 Currently, the project needs to be open in order for this feature to
 work. This can be fixed if deemed important. 
 The Java editor opens and with the curasor positioned at the specified method. 
 If the method name is not specified or found in the file, the cursor is 
 positioned at the beginning of the file. 
 If the editor is invoked for the first time, it might take a while until it
 is loaded by the platform.

Embeded Java Code
=================
Format:
<javasource file="RelativePath\file.java" project="GildProject" 
method_sig="Container.Method(Parameters)">
Where:
GildProject - a Gild Project
RelativePath - the path relative to the root of the GildProject where the
source file is located. This path appears in the navigator view of the project
file.java - the source file
Container - the name of the class/interface.
Method(Parameters) - the signature of the method as it appears in the source
file.
Example:
<javasource file="src\HelloWorld.java" project="HelloWorld" 
method_sig="HelloWorld.foo()">
Notes:
Currently, the project needs to be open in order for this feature to
work. This can be fixed if deemed important. 
Only the specified method is presented
If a method is not specified or not found, the content of the whole file is
presented.
In order to synchronize the current course/presentation page with the content 
of a corresponding source files a refresh needs to be done (either by chosing
refresh option of the view context menu or by clicking on the file in the
navigator view or by following a link to the file). I'm not sure if an 
automatic update is feasible...

Known Bugs
Too many to list here. However, please free feel to contact me if you find more
or if you have any suggestions. 
Contact: Adrian Damian (adi_dam@yahoo.com)

Thanks and have fun! 


