BIRCH - Getting the Documentation onto the Web
 update July 20, 2026
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. This assumes a local webserver on a single machine.


 Directory
 URL
BIRCH Web site
 /home/birchBIRCH/public_html
 http://192.168.0.25
BIRCH Home Directory
 /home/birch/BIRCH/public_html http://192.168.0.25

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/BIRCH/public_html
 http://bhsc01.ucalgary.ca/~birch
BIRCH Home Directory
 /student/home/birch/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/birch/BIRCH/public_html

 http://brassica.plants.umanitoba.ca/~birch/birchhomedir
BIRCH Home Directory
actual directory
/home/birch/BIRCH
link on web server
 /www/data/faculties/afs/plant_science/birch http://brassica.plants.umanitoba.ca/~birch




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