# /programs/ourwork/past/ead/server-readme.htm

originally: http://www.oclc.org/programs/ourwork/past/ead/server-readme.htm

# EAD Report Card Server Version—Readme

This version of the RLG EAD Report Card is meant to run on a Web server; there is also a version you can run on your Windows desktop. You can adapt either version to comply with your own best practices for EAD.

## Server application

All the necessary files required for the server version of the Report Card are in the directories "cgi-bindir" and "webpages".

1. Make sure you have Perl, XML::LibXML, and XML::LibXSLT (see comments in "cgi-bindir/rlgead.pl")
2. Modify paths in rlgead.pl to reflect the local implementation. You can find "rlgead.pl" in the the "cgi-bindir" directory.

   > $bpgxsl = "/usr0/web/cgi-bin/bpg.xsl";
   > $idxsl = "/usr0/web/cgi-bin/verbid.xsl";

   There are two XSLT scripts - "verbid.xsl" and "bpg.xsl". Both are in the "cgi-bindir" directory.
3. Modify form action to location of rlgead.pl script in the file "submit.html"

The Web pages for the server-side implementation can be found in the directory "webpages":

- "index.html";
- 3 pages ("submit.html", "report.html" and "directions.html"): the default pages for the frames defined in the index page;
- a copy of the XML encoding the best practice guidelines ("bpgrules.xml");
- the rules DTD (against which "bpgrules.xml" validates);
- a stylesheet ("rulestransform.xsl"), which transforms "bpgrules.xml" on the fly to HTML in a browser.

## Updating and adapting the guidelines and stylesheets

Note: This process must be run on a Windows machine.

1. Go to the "sources" directory.
2. Modify "bpgrules.xml" with changes to the best practice guidelines. To understand how to encode the rules, point your browser to "sources/rulesdefinition.xml". (Use IE or a browser that can transform documents with XSL stylesheets.)
   If you have problems reading xml files such as "sources/rulesdefinition.xml" with your browser, try this:
   - Download Microsoft XML Core Services 4.0 Service Pack 2 from http://msdn.microsoft.com/XML/XMLDownloads/default.aspx
   - Start > Run regsvr32 msxml4
3. Once you have made changes to "bpgrules.xml", click on "generatestyles.bat". It will automatically rerun the generator and place the new stylesheets in the stylesheets directory.
4. Copy the stylesheet "bpg.xsl" from the "stylesheets" directory to your Web server. The server will now check finding aids against the new guidelines.