Welcome to the RLG EAD Report Card. This version of the 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 of the RLG EAD Report Card to comply with your own best practices for EAD. 


SERVER VERSION


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

To set up the server side implementation of the EAD checker:

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', including;
	--'index.html'; 
	--3 pages ('submit.html', 'report.html' and 'directions.html') are 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') that 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 bestpractice guides. 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 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 webserver.

The server will now check finding aids against the new guidelines.
