EAD Report Card Desktop Version—Readme
This version of the RLG EAD Report Card is meant to run on the Windows desktop; there is also a version you can run on a web server. You can adapt either version of the EAD Report Card to comply with your own best practices for EAD.
- Windows OS: XP, Windows 2000, Windows NT
- Browser: Internet Explorer 5.0 (or more recent), recent versions of Mozilla Firefox.
How can I tell what my system is running? This page ( http://www.java.com/en/download/help/testvm.xml) will tell you:
- where your Java came from (Sun, Microsoft, Apple, etc.).
- what version of Java you have installed.
- your operating system.
- what version of your operating system you are running.
In the directory "local", there are two desktop implementations: dynamic and static.
This version generates a report on the fly. It does not save as a file.
- Point your browser to local/index.html.
- Follow the directions that appear in the middle window.
This version produces a report that is automatically saved in a subfolder of the folder where the chosen EAD document resides.
If you wish to use the static version of the EAD Report Card, be sure to install the program so that the path name contains no spaces (in other words, not in a directory structure that looks like "C:/Documents and Settings/My Documents/EAD report card/", but one that looks like "C:/programs/eadreportcard/".)
Read the README.html in the "local/desktop" folder to get started.
- Create a desktop shortcut for "createreport.bat".
- If you'd like the batch file to be run minimized or invisibly, right-click on the "createreport.bat" shortcut and select Properties. Now change the Run properties to Minimized.
- Make sure that the DOCTYPE in your EAD file points to the DTD on your local system; if not, comment out the DOCTYPE.
- Use the Windows Explorer to find your EAD document. Drag it to the desktop icon. A subfolder will be created in the folder where your document is. It will correspond to the name of the document. Inside that folder, open "index.html" with your browser. The report will be displayed in the top window.
Updating and adapting the guidelines and stylesheets
Note: this process must be run on a Windows machine.
- Go to "sources" directory.
- 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
- 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.
- Move the stylesheet "desktopbpg.xsl" to local/desktop.
- Move the stylesheet "bpg.xsl" to local/. You can now check finding aids against the new guidelines.