|
|
Line 117: |
Line 117: |
| | | |
| ====Findaid Class Summary==== | | ====Findaid Class Summary==== |
- | <ul>
| |
- | <li>Browse by subject added</li>
| |
- | <li>Default browse page now set in collmgr</li>
| |
- | <li>Sample code and documentation included for accomodating non-Bentley encoding practices</li>
| |
- | <ul>
| |
- | <li>Code to use <bioghist> <head> tag for labels in TOC and in Finding Aid:
| |
- | [[Mounting_a_Finding_Aids_Collection#Changing_the_Bioghist_labels_to_use_the_appropriate_.3Chead.3E_elements|Changing the Bioghist labels to use the appropriate head elements]]
| |
- | </li>
| |
- | <li>Code to add <relatedmaterial> <separatedmaterial> to TOC: [[Mounting_a_Finding_Aids_Collection#Adding_sections_to_the_table_of_contents|Adding sections to the table of contents]]</li>
| |
- | </ul>
| |
- | <li>Data prep scripts reorganized and renamed</li>
| |
- | <li>New functionality for Makefile and preparedocs.pl</li>
| |
- | <li>New script to set up new collections [[setup_newcoll]]</li>
| |
- | <li>Bug fixes</li>
| |
- | </ul>
| |
- |
| |
- | <h4>Prep scripts</h4>
| |
- | Data prep scripts have been reorganized and renamed.
| |
- | *New functionality for Makefile and preparedocs.pl
| |
- | *New script to setup new collections
| |
- |
| |
- | '''New prep script: setup_newcoll'''
| |
- |
| |
- | $DLXSROOT/bin/f/findaid/setup_newcoll can be used to set up directories for new collections. For example, to set up the workshopfa collection based on samplefa (Assuming your $DLXSROOT variable is set)run this command:
| |
- |
| |
- | $DLXSROOT/bin/f/findaid/setup_newcoll -c workshopfa -s $DLXSROOT/prep/s/samplefa/data
| |
- |
| |
- | More information on the setup_newcoll script can be found by clicking [[setup_newcoll_manpage|here]] or invoking the man page:
| |
- |
| |
- | $DLXSROOT/bin/f/findaid/setup_newcoll --man
| |
- |
| |
- | '''New options for preparedocs.pl'''
| |
- | <p>The $DLXSROOT/bin/s/samplefa/preparedocs.pl script now takes several new arguments.</p>
| |
- | ./preparedocs.pl --man will give details
| |
- | of particular interest is the preparedocs.pl -i inputfilelist option which allows you to specify a file containing the full paths to the finding aids you wish to index. This option can be used instead of the previous default behavior which was to recursively search the data directory and index all files in that directory.
| |
- |
| |
- | '''Changes to Makefile'''
| |
- | <p>Addition of these new targets:</p>
| |
- |
| |
- | ;prepdocslist
| |
- | :Same as prepdocs but uses the -i inputfilelist to preparedocs.pl and by default reads a file $DLXSROOT/prep/c/collection/list_of_eads.
| |
- | ;allbutprep
| |
- | :convenience target for use in conjunction with prepdocslist that does all the make steps except for the make prepdocs
| |
- | ;index
| |
- | :convenience method that runs all 3 indexing steps
| |
- |
| |
- | '''Changes to prep scripts'''
| |
- |
| |
- | ;$DLXSROOT/bin/s/samplefa
| |
- | :Moved generic bin files to f/findaid
| |
- | :Makefile modified
| |
- | :preparedocs.pl has new options
| |
- |
| |
- | ;$DLXSROOT/prep/s/samplefa
| |
- | :Renamed files
| |
- | <pre> samplefa.text.inp to samplefa.ead2002.dcl
| |
- | samplefa.xml.inp to samplefa.concat.ead.dcl
| |
- | </pre>
| |
- |
| |
- | :Removed:
| |
- | <pre> samplefa.inp
| |
- | </pre>
| |
- | :Added:
| |
- | <pre> list_of_eads
| |
- | </pre>
| |
- |
| |
- | ;$DLXSROOT/bin/f/findaid
| |
- | :Removed:
| |
- | <pre> catsourcefiles.pl
| |
- | isolat128bit.pl
| |
- | validate.pl
| |
- | </pre>
| |
- | :Added/moved from bin/s/samplefa
| |
- | <pre> fixdoctype.pl
| |
- | stripdoctype.pl
| |
- | validateeach.sh
| |
- | setup_newcoll
| |
- | </pre>
| |
- |
| |
- | <H4>web/f/findaid</H4>
| |
- |
| |
- | <UL>
| |
- | <LI> bookbagitemsstring_debug.xsl
| |
- | <UL>
| |
- | <LI>For debugging in oxygen since the Oxygen
| |
- | debugger uses Saxon and Saxon doesn't understand the
| |
- | extensions</LI>
| |
- | </UL>
| |
- | </LI>
| |
- | </UL>
| |
- |
| |
- | <ul>
| |
- | <li>browse.xsl</li>
| |
- | <ul>
| |
- | <li>Added code for subject browse</li>
| |
- | </ul>
| |
- |
| |
- | </ul>
| |
- |
| |
- | <UL>
| |
- | <LI> browseheader.xsl
| |
- | <UL>
| |
- |
| |
- | <LI>bulk dates labelled</LI></UL></LI>
| |
- | </UL>
| |
- | <UL>
| |
- | <LI> htmlhead.xsl
| |
- | <UL>
| |
- | <LI>emit full path to main XML template
| |
- | for <TemplateName> element</LI>
| |
- | <LI>changed TemplateName to TemplatePath</LI></UL></LI>
| |
- | </UL>
| |
- | <UL>
| |
- |
| |
- | <LI> text.components.xsl
| |
- | <UL>
| |
- | <LI>Modified template for processing c0x's
| |
- | so that if there are two containers within a //c0x/did/
| |
- | such as box/folder they will both show up in the proper
| |
- | column.</LI>
| |
- | <LI>Highlighting fix. Replaced about 36
| |
- | instances of <xsl:value-of select="."/> with <xsl:apply-templates
| |
- | select="*|text()"/> If value-of select gets highlighted
| |
- | text in the context node: "text<HIGHLIGHT>text</HIGHLIGHT>text
| |
- | text" it will ignore the <HIGHLIGHT> elemnts and just
| |
- | render all the text. On the other hand the apply-templates
| |
- | "*" will match the <HIGHLIGHT> element and trigger
| |
- | the appropriate highlighting template and the text()
| |
- | nodes will get passed to the template that just outputs
| |
- | the text</LI>
| |
- | <LI>Fixed code in template match=unittitle
| |
- | mode=SimpleUnittitle because foreach was messing with
| |
- | context Also change code for handling notes/scopeconent
| |
- | in match=C01|c02... because it was an xsl:choose,
| |
- | but notes and scopecontent are not mutually exclusive</LI>
| |
- | <LI>Changed code for handling notes/scopeconent
| |
- | in match=C01|c02... now both did/note and note and
| |
- | did/scopecontent and scopecontent will be rendered</LI>
| |
- | <LI>fixed bug in template match="list"
| |
- | where there was a foreach and then value-of select
| |
- | *|text() that needed to be value-of select="."</LI>
| |
- | <LI>space before unitdate value</LI>
| |
- | <LI>title styling</LI>
| |
- | <LI>optional labels for additional descriptive
| |
- | material</LI>
| |
- |
| |
- | <LI>hide sorting title</LI>
| |
- | <LI>sponsor</LI>
| |
- | <LI>Restored ADD to full-text view</LI>
| |
- | <LI>abstracts in dids</LI>
| |
- | <LI>Change template for index mode= add
| |
- | so it doesn't produce 2 copies of any <head> text.
| |
- | Key is to limit the apply templates after we already
| |
- | processed the head not to process the head again:
| |
- | <xsl:apply-templates select="*[not(self::head)]"/></LI></UL></LI>
| |
- |
| |
- | </UL>
| |
- |
| |
- | <H4>bin/f/findaid</H4>
| |
- |
| |
- | *catsourcefiles.pl
| |
- | **No longer used for samplefa (replaced by preparedocs.pl) Also it contains bhl specific code. For bhl use the copy in $DLXSROOT/bin/b/bhlead which is in cvs.
| |
- | *fixdoctype.pl
| |
- | **Moved here from bin/s/samplefa No collection-specific customization These should work on any EAD that conforms to the ead2002.dtd
| |
- | *isolat128bit.pl
| |
- | **No longer used for findaids, since all findaids should be utf8 encoded
| |
- | *setup_newcoll
| |
- | **New script to set up directories ./setup_newcoll --man for details
| |
- | *stripdoctype.pl
| |
- | **This library file is now used by preparedocs.pl and validateeach.sh (through $DLXSROOT/bin/s/samplefa/fixdoctype.pl)to correctly remove multiple line DOCTYPE declarations and any entity references contained within them. It is a replacement for the one-line perl program previously used by those two programs.
| |
- | *validate.pl
| |
- | **Removed outdated file that worked on sgml files. FindaidClass now exclusively xml
| |
- | *validateeach.sh
| |
- | **Moved here from bin/s/samplefa No collection-specific customization Thise should work on any EAD that conforms to the ead2002.dtd
| |
- |
| |
- | <H4>cgi/f/findaid</H4>
| |
- |
| |
- | <UL>
| |
- | <LI> FindaidApp.pm
| |
- | <UL>
| |
- | <LI>remove FormatGuideFrame() obsolete
| |
- | since the change to XML/XSL</LI></UL></LI>
| |
- | </UL>
| |
- | <UL>
| |
- | <LI> FindaidAppXsltPIFiller.pm
| |
- | <UL>
| |
- | <LI>Removed FormatOutlineResult_XML and
| |
- | FormatOutlineFrame_XML as they are not called by any
| |
- | code (or bound to any PIs).</LI></UL></LI>
| |
- |
| |
- | </UL>
| |
- | <UL>
| |
- | <LI> FindaidClass.pm
| |
- | <UL>
| |
- | <LI>highlight hits in layer 1 result items</LI>
| |
- | <LI>Added highlighting to BuildItemTitle_XML
| |
- | so highlighting will show up in title</LI>
| |
- | <LI>Fixed bug in FilterAllDaos_XML that
| |
- | would not properly process daos with real hrefs and
| |
- | would result in illegal xml being output when id resolver
| |
- | is turned on.</LI></UL></LI>
| |
- | </UL>
| |
- | <UL>
| |
- | <LI> FindaidClass/ClementsmssFC.pm
| |
- |
| |
- | <UL>
| |
- | <LI>removes "viewtextnote" speedbump</LI></UL></LI>
| |
- | </UL>
| |
- |
| |
- | *FindaidClass/DemofaFC.pm
| |
- | **Demo of subclassing
| |
- | **add relatedmaterial and separated material TOC heads
| |
- | **use <head> tags for bioghist instead of bentley logic for TOC heads
| |
- | **change labels for several TOC heads
| |
- |
| |
- | *FindaidClass/BioghistfaFC.pm
| |
- | **Demo of subclassing to use <head> tags for bioghist instead of bentley logic
| |
| | | |
| ===XClass=== | | ===XClass=== |
TextClass is substantially
identical to release 14 except for enhancements and bug fixes as noted below. ImageClass
provides new image viewing functionality. FindaidClass improves handling of the EAD DTD and includes subject browsing. BibClass is unchanged and is being de-emphasized.
MySQL is the supported database type. In order to run DLXS you will need to have a MySQL server installed. Sample data is delivered in the form of a MySQL dump file which can be directly imported into a MySQL database. The database upgrade script (upgrade_6_7) operates only on a MySQL database. These issues are documented in detail in the installation instructions and the upgrade instructions.