Development Directories

File Creation & Editing

The following are the iWander development directories where all the project file creation and editing took palce:


(Home Laptop) /bruce/gradcenter/html/ - file creation & editing
(Linux Server) carson-city.marlboro.edu: /home/kid     - staging and source control
(MSIE Server) bob.marlboro.edu/html: /home/bluhrs/ - staging

 kid@carson-city.marlboro.edu: /home/kid   
       (username: kid, password: XxxxXxxxy
                  root           XxxxXxxxxn)

capstone
     |------------,          (http://bob.marlboro.edu/~bluhrs/capstone)
   project     index.html    (Project 'Intro page')
  ____|_________________________________ _ _ _ 
 |      |      |       |        |      |      |
data   doc    logs   scripts   src    test   project.html
  |_______________________________           (Project 'overview page')
     |         |        |        |
    help    regions   views    waypts

doc - project documentation, requirements, project plan, design specs, field-guide
src - web-application code
data - iWander data: images and html files
- help - iWander User and Administrator help information and other help .html files
- regions - region-level, .jpg & .html files
- waypts - waypoint files
- views - view-level files
scripts - data table creation & populate scripts (.sql), as well as other utility scripts
test - region, waypoint and view level test data (.jpg & .html files)
logs - session log and other development logs and notes

Refer to the Implementation Overview for more information.

Backup and Source Control

Laptop Backup: Copies of important source files, documents and data were placed on 1.4M floppies (or 100M zip disks) on a regular basis in order to have backup copies of these files in the event of a system or disk crash, or just plain file corruption. (File corruption could be as a result of a bad command or bad night of editing).

Source Control on Linux (carson-city): important Source files (*.html, *.cgi, ...) as well as test scripts (*.sql, ..) were kept under revision control on my Linux server using CVS.

Web-Application Directories

The following directories, located on my student Linux server box (carson-city.marlboro.edu) contain the CGI scripts, HTML web page files as well as the .JPG and .HTML data files used by the iWander web application.

     /(root)         carson-city.marlboro.edu
     |	      (i386 Red Hat Linux 2.2.14-5?)
  /usr/local    	     (Dell XPS R400)
_____|_____________________________________________________________
|                         |               |          |             |
/apache (1.3.12)   /mysql 1-3.23.30    /cvsrepos  (perl 5.6.0) (ssh 2.3 build 135)
   |
   |   
 htdocs    carson-city.marlboro.edu         bob.marlboro.edu
   |     (/usr/local/apache/htdocs) OR    (/home/bluhrs/capstone/)
                                
     _________|______
    |                |       
   scripts     iwander.html   (iWander 'home page')
    |          (.jpgs,.gifs)
    |__________________________________________________
    |                 |            |        |          |  
iwander.cgi         help         waypts   views      regions                            
adminmenu.cgi         |            |         |          |     
starttrip.cgi    mainhelp.html    (.... .html, .jpgs .....) 
waypoint.cgi     adminhelp.html 
showlog.cgi       (.htmls, .jpgs..)
  iwander.conf
(.jpgs,.gifs)

The entry-point and iWander Home Page is iwander.html. or

In the top-level deployment area, /usr/local/apache/htdocs/ on carson-city and /home/bluhrs/capstone on bob.marlboro.edu, the iWander related files are iwander.html, and the images it sources: compass.gif, iwanderlogo.jpg, and yellowpaper.gif.

In the scripts subdirectory, the web-site program files are: adminmenu.cgi, iwander.cgi, starttrip.cgi, waypoint.cgi and showlog.cgi. iwander.conf is the iWander configuration file. Settings in this file determine if debug messages will be output (more flags & settings may be added to this file in the future). The images they source as icons are: admin.gif, yellowpaper.gif, bluepaper.gif, info.gif, lifebuoy_help.gif and iwanderlogosm.jpg; as well as iwander.conf that's used

The "data" .jpg and .html files are in the help, waypts, views and regions subdirectories.