BIRCH - Getting the Documentation onto the Web
Examples


1) Default - no web server, BIRCH web site is not Internet accessible


Directory
URL
BIRCH Web site
/home/birch/public_html
file:///home/birch/public_html
BIRCH Home Directory
/home/birch file:///home/birch



2) Web server runs on the same host as BIRCH, symbolic links allowed.

a) This example takes advantage of the fact that, within public_html, there are symbolic links named doc, dat etc. that point to directories in the parent directory (ie. doc --> ../doc, dat --> ../dat etc). Put another way, for the purpose of reading documentation and data files, the public_html directory can also be used as the "HOME" directory.


Directory
URL
BIRCH Web site
/home/birch/public_html
http://cbr-rbc.nrc-cnrc.gc.ca/birch/
BIRCH Home Directory
/home/birch/public_html http://cbr-rbc.nrc-cnrc.gc.ca/birch/

b) This example uses a single symbolic link to point to all directories in the parent directory (ie. birchhomedir --> .. ). This one is probably less likely to get broken by future changes in BIRCH


Directory
URL
BIRCH Web site
/student/home/birch/public_html
http://bhsc01.ucalgary.ca/~birch
BIRCH Home Directory
/student/home/birch/public_html/birchhomedir http://bhsc01.ucalgary.ca/~birch/birchhomedir



3) BIRCH directories are remotely-mounted to Web server


Directory
URL
BIRCH Web site

/home/psgendb/BIRCHDEV/public_html

http://home.cc.umanitoba.ca/~psgendb/birchhomedir/BIRCHDEV/public_html
BIRCH Home Directory
actual directory


/home/psgendb/BIRCHDEV


link on web server
/www/data/faculties/afs/plant_science/psgendb http://home.cc.umanitoba.ca/~psgendb/birchhomedir/BIRCHDEV





Please send suggestions of comments regarding this page to psgendb@cc.umanitoba.ca