The Digital Librarian's Digital Library
DOCIS Documents in Computing and Information Science
The installation is based in the home of the user adocis at
/home/adocis. This is hardwired in the code. To get the
code running, you need to place the directory docis
into /home/adocis.
Thus, the directory /home/adocis/docis is the
home of the installation. When refering to files here, we refer
to them in subdirectories of /home/adocis/docis/,
unless the file names start with a /.
You need to have your rclis data in rclis. Softlinks to
the rclis data should work, but we have not tried.
The scripts assume that a temporary file space is in /tmp.
All scripts are written in Perl. You should have Perl at
/usr/bin/perl. That seems to be pretty much the norm
these days.
Apache logs are presumed to be in /var/log/apache.
The logging script perl/wlog makes a range
of assumptions about external programs. Refer to that script
for details.
<!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html><head><title>
</title></head><body>
etc/docis_script.xml provided that there are links to downloadable contents.
etc/docis_stylesheet_link.xml. It provides for the link to the style sheet.
etc/docis_header.xml. It provides the
main header box.
etc/docis_breadcrumbs_top.xml. It provides the top of the breadcrumbs.
etc/docis_breadcrumbs_bottom.xml. This
provides the gold bar below the breadcrumbs.
etc/docis_breadcrumbs_bottom.xml. This
provides the gold bar below the framed part of the page.
etc/docis_footer.xml. This provides the
footer.
</body></html>.
For the general pages, i.e., those that represent rclis data, the model is implemented by the xslt templates.
For special pages the page model is implemented by
perl/install_etc_pages.
Such special pages are generated from XML files in
found in etc/. XML files that are in this
directory and that don't have a name starting in
docis_ represent pages. For
example, perl/install_etc_pages transforms
etc/internal_documentation.xml into
html/internal_documentation.html, to
form the page that you are currently reading.
The script makes calls to the perl/make_page
script for each page. make_page, in turn, calls
the Docis::Page::docis_page subroutine, with
special arguments. Note that the routine changes
the date of the last update of the HTML file
to the date of last change of the
underlying xml file.
After etc/docis_footer.xml is read by
perl/install_etc_pages, it replaces
the date that it contains with the date of the XML file.
adocis. Here are the
changes from the defaults as shipped with version 6.05
config.h
Word_Min_Size to 3WordThreshold_Default to 50000User_Default[] to adocisGroup_Default[] to adocisTempDirectory_Default[] to /var/tmpconfig/config.mk
MOD_LIST to html onlyCHARSET_LIST to utf8 onlyPERL to /usr/bin/perlI_ROOT to /home/adocisI_OWNER to -o adocisI_GROUP to -g adocisdocis/etc/crontab has the
crontab. It performs the following jobs
docis/perl/swish++_up_check. That script checks of we can connect
to the socket. If that check fails, the script assumes the swish
search daemon has died, and fires up the script
swish++_index.
docis/perl/wlog, with some
appropriate file name on where log files are
to be found. The log files are then searched for requests
that start with "/docis", and the result is merged into
daily files held in docis/log.
DoCIS runs on an Apache 1.3 installation. Here are parts of the Apache configuration required for DoCIS.
![[SWISH++]](/docis/swish-powered.gif){kind=small}
