creator		greenstone@cs.waikato.ac.nz
maintainer	greenstone@cs.waikato.ac.nz
public		true

indexes		section:text
defaultindex	section:text

plugin		GreenstoneXMLPlugin
# We want the two types of paged documents to be treated differently: paged 
# and hierarchical. So include two PagedImagePlugin plugins and modify the 
# process_exp.
plugin		PagedImagePlugin -create_screenview true -minimumsize 100 -documenttype hierarchy -process_exp xml.*\.item$
plugin		PagedImagePlugin -create_screenview true -minimumsize 100 -documenttype paged 
plugin		MetadataXMLPlugin
plugin		ArchivesInfPlugin
plugin		DirectoryPlugin

classify	AZCompactList -metadata Series -sort Date 
classify	DateList 

# Format statements to display Series, Volume, Number and Date information

format DocumentVList "<td valign=top>[link][icon][/link]</td>
<td valign=top>{If}{[Series],[Series] {If}{[Volume],Vol. [Volume]} {If}{[Number],No. [Number]},[highlight]{Or}{[Title],[PageNum]}[/highlight]}</td>"

format CL1VList "<td valign=top>[link][icon][/link]</td>
<td valign=top>{If}{[numleafdocs],[Title],{If}{[Volume],Vol. [Volume]} {If}{[Number],No. [Number]} ([format:Date])}</td>"

format SearchVList "<td valign=top>[link][icon][/link]</td>
<td valign=top>[parent(Top):Series] {If}{[parent(Top):Volume],Vol. [parent(Top):Volume]} {If}{[parent(Top):Number],No. [parent(Top):Number]} Page [Title]</td>"

format DateList "<td valign=top>[link][icon][/link]</td>
<td valign=top>[Series] {If}{[Volume],Vol. [Volume]} {If}{[Number],No. [Number]}</td>"

format HList "[link][highlight][ex.Title][/highlight][/link]"

# We customise the document display, so use the extended options
format AllowExtendedOptions  true

# We want to add in fullsize/preview/text buttons to switch between the
# different versions of each page

format DocumentHeading "<center><table width=_pagewidth_>
<tr valign=top><td>{Or}{[parent(Top):Series],[Series]}</td></tr>
<tr valign=top><td><table><tr><td>
[DocumentButtonDetach][DocumentButtonHighlight]
{If}{_cgiargp_ eq 'fullsize',{If}{[screenicon],_document:viewpreview_}
{If}{[NoText] eq \'1\',,_document:viewtext_},
{If}{_cgiargp_ eq 'preview',{If}{[srcicon],_document:viewfullsize_}
{If}{[NoText] eq \'1\',,_document:viewtext_},
{If}{[srcicon],_document:viewfullsize_}
{If}{[screenicon],_document:viewpreview_}}}
</td></tr></table></td>
<td>[DocTOC]</td></tr></table></center>"

# Document text display changes based on the p argument - this is not used 
#normally for document display, so we can use it here to switch between 
#fullsize/preview/text versions.
format DocumentText "<center><table width=_pagewidth_><tr><td>
{If}{_cgiargp_ eq \'fullsize\',[srcicon],
{If}{_cgiargp_ eq \'preview\',[screenicon],{If}{[NoText] eq \'1\',,[Text]}}}
</td></tr></table></center>"


# -- English strings --------------------
collectionmeta	collectionname [l=en] "Paged Image example"
collectionmeta  .section:text [l=en] "newspaper pages"

# -- English text -----------------------

collectionmeta	collectionextra [l=en] "This collection contains a few newspapers from the 
<a href='http://www.nzdl.org/cgi-bin/library?a=p&amp;p=about&amp;c=niupepa'>
Niupepa</a> collection of Maori newspapers. 

<h3>How the collection works</h3>
<p>Each newspaper issue consists of a set of images, one per page, and a set 
of text files for the OCR'd text. An item file links the set of pages into a 
single newspaper document. PagedImagePlugin is used to process the item files. 
<p>There are two styles of item files, and this collection demonstrates both. 
The first uses a text based format, and consists of a list of metadata for the 
document, and a list of pages. Here are some examples: 
<a href='_httpcollection_/import/09/09\_1\_1.item'>Te Waka o Te Iwi, Vol. 1, No. 1</a>, 
<a href='_httpcollection_/import/10/10\_1\_3.item'>Te Whetu o Te Tau, Vol. 1, No. 3</a>. 
This format allows specification of document level metadata, and a single list of pages.
<p>The second style is an extended format, and uses XML. It allows a hierarchy 
of pages, and metadata specification at the page level as well as at the 
document level. An example is <a href='_httpcollection_/import/xml/23/23\_\_2.item'>Matariki 1881, No. 2</a>. 
This newspaper also has an abstract associated with it. The contents have been 
grouped into two sections: Supplementary Material, which contains the Abstract,
 and Newspaper Pages, which contains the page images.
<p>Paged documents can be presented with a hierarchical table of contents 
(e.g. <a href='?a=d&amp;c=_cgiargc_&amp;d=HASHecd552ed3c2d5f1f6a620f.2.2&p=text'>this one</a>), 
or with next and previous page arrows, and a goto page box 
(e.g. <a href='?a=d&amp;c=_cgiargc_&amp;d=HASH01f4f2a92e501cdfa5d243bb.2&p=preview'>this one</a>). 
This is specified by the <tt>-documenttype (hierarchy|paged)</tt> option to PagedImagePlugin. 
The next and previous arrows suit the linear sequence documents, while the table of contents 
suits the hierarchically organised document. Ordinarily, a Greenstone collection
 would have one plugin per document type, and all documents of that type get 
the same processing. In this case, we want to treat the XML-based item files 
differently from the text-based item files. We can achieve this by adding two 
PagedImagePlugin plugins to the collection, and configuring them differently. 
<p><tt>plugin PagedImagePlugin -screenview -minimumsize 100 -documenttype hierarchy -process_exp xml.*\.item$<br/>
plugin	PagedImagePlugin -screenview -minimumsize 100 -documenttype paged </tt>

<p>XML based newpapers have been grouped into a folder called <tt>xml</tt>. 
This enables us to process these files differently, by utilising the 
<tt>process_exp</tt> option which all plugins support. The first PagedImagePlugin 
in the list looks for item files underneath the xml folder. These documents 
will be processed as hierarchical documents. Item files that don't match the 
process expression (i.e. aren't underneath the xml folder) will be passed onto 
the second PagedImagePlugin, and these are treated as paged documents.

<p><b>Formatting</b>
<p>We have modified the document formatting to display fullsized images, 
preview images or text, with buttons to switch between them. This involves 
modifications to the DocumentHeading and DocumentText format statements in the 
<a href='_httpcollection_/etc/collect.cfg' target=\'collect.cfg\'>collection configuration file</a>, 
and some macro definitions in the <a href='_httpcollection_/macros/extra.dm' target=\'extra.dm\'>extra.dm macro file</a>.
The extra.dm macro file provides definitions for the buttons (\_viewfullsize\_,
 \_viewpreview\_, \_viewtext\_) which are used by the format statement in the 
collect.cfg file. The format statement switches the document display and sets 
the buttons to be displayed based on the p argument, which is also set by the 
format statement.
"