Quick start developing for the MONK workbench using the Eclipse IDE.

1. Download and install XAMPP
   • go to http://www.apachefriends.org/en/xampp.html and download the appropriate package for your platform (scroll down the page to see the download links)
   • install XAMPP
   • start Apache only, since there's no need to start the other services
   • verify your web server by browsing to http://localhost/
   • take note of where documents are served since this is where you'll check out code from the MONK repository. For Windows see http://www.apachefriends.org/en/faq-xampp-windows.html#startpage In OS X you should be able to use ~/Sites/ as a document root
2. Download and install Eclipse
   • go to http://www.eclipse.org/downloads/
   • download "Eclipse IDE for Java Developers"
   • install Eclipse
3. Install the Subclipse plug-in for Eclipse
   • start Eclipse
   • install Subclipse using the instructions here http://subclipse.tigris.org/install.html
   • after the plug-in has been installed you will be prompted to re-start Eclipse; you need to re-start to enable the plug-in
4. Install the Aptana plug-in for Eclipse (Aptana will help write JavaScript, but is optional)
   • Follow the instructions here to install the plug-in
5. Check-out a working copy of the MONK workbench code as an Eclipse project (note for this step to work you need to have a user name and password to access the Subversion repository in which the source code is stored. Ask Amit about getting a valid user name and password.)
   • Once Eclipse has re-started, set your workbench location to the same path as your web server document root
   • Create a new project using the following steps:
     • Click the "File" menu, select "New" then "Other..."
     • Expand the "SVN" branch and select "Checkout projects from SVN"; click "Next"
     • Select "Create a new repository location"; click "Next"
     • Enter svn://nora.lis.uiuc.edu/monkWorkbench/trunk for the new location
     • You will be prompted to enter your username and password
     • When the server responds to your request you will see a listing of the repository's contents. Select the root element (the one labeled svn://nora.lis.uiuc.edu/monkWorkbench/trunk); click "Finish"
     • Expand the "General" element and select "Project"; click "Next"
     • Name your project something useful like "MONK"; click "Finish"; depending on your connection speed the checkout time could take a while, so go make a tea or something while this is finishing...
6. Configure local MONK proxy server
   • From Eclipse (or your favourite text editor) open (from the root of where you checked out the MONK source code) resources/js/proxy.js
   • Change the line Monk.data.PROXY_URL = "http://monk.lis.uiuc.edu:8888/monkmiddleware/"; to Monk.data.PROXY_URL = "http://localhost/PATH/TO/WORKBENCH/resources/proxy/"; and save the file
7. Configure Apache to use the proxy
   • Make sure the Apache rewrite module is enabled: open httpd.conf (found in YOUR_APACHE_INSTALL/conf) and uncomment the line
     LoadModule rewrite_module modules/mod_rewrite.so
   • Open resources/proxy/.htaccess and change the RewriteBase to the location of this proxy folder, in relation to Apache's DocumentRoot (also found in httpd.conf). E.g. if your DocumentRoot is /workspace/Monk, the RewriteBase will be /resources/proxy

Recommended additional reading:

https://apps.lis.uiuc.edu/wiki/display/MONK/Component+Creation+Guide https://apps.lis.uiuc.edu/wiki/display/MONK/MONK+Workbench+Events