Release Notes for Current DLXS Release

From DLXS Documentation

(Difference between revisions)
Jump to: navigation, search
(IdResolver)
(FindaidClass)
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 &lt;bioghist&gt; &lt;head&gt; 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 &lt;relatedmaterial&gt; &lt;separatedmaterial&gt; 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 &lt;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 &lt;xsl:value-of select="."/> with <xsl:apply-templates
 
-
                select="*|text()"/> If value-of select gets highlighted
 
-
                text in the context node: "text&lt;HIGHLIGHT>text</HIGHLIGHT>text
 
-
                text" it will ignore the &lt;HIGHLIGHT> elemnts and just
 
-
                render all the text. On the other hand the apply-templates
 
-
                "*" will match the &lt;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 &lt;head> text.
 
-
                Key is to limit the apply templates after we already
 
-
                processed the head not to process the head again:
 
-
                &lt;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 &lt;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 &lt;head> tags for bioghist instead of bentley logic
 
===XClass===
===XClass===

Revision as of 10:38, 19 October 2010

Main Page > Release Notes for Current DLXS Release

Contents

General Information

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.

Release 15 is comprised of:

Known Problems

  • None

Database Installation Notes

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.

New and Changed Functionality

XPAT

  • No changes.

Lib

TextClass

web/t/text

  • some file name
    • message

ImageClass

CGI/Middleware

Known Problems

  • None known so far.

Enhancements


Data Preparation

Enhancements

BibClass

cgi/b/bib

Oai

IdResolver

cgi/i/idresolver/

broker20

  • No changes.

Collmgr

  • Supports version 7.0 database for DLXS release14.
  • default browse page for Text and Findaid Class now set from first item in Browsefields list

FindaidClass

Findaid Class Summary

XClass

  • No changes.

METS Pageturner and Collection Builder

  • Continuing development work in Pageturner. New application: Collection Builder allows users to add items to a personal collection via widgets in Pageturner. These applications are not part of DLXS. They use a different code base mainly under DLXSROOT/{web,bin,cgi}/m/mdp and DLXSROOT/lib/App. Stub routines are required in Pageturner to abstract the database connections and an installation of Solr/Lucene is required to support the collection search in Collection Builder. The user interface makes extensive use of Yahoo User Interfacen toolkit (YUI) functionality.

SRU

  • Added fielded searching to query -- not yet Level 1 or 2, though

Top

Personal tools