Changeset 27118 for documentation

Show
Ignore:
Timestamp:
25.03.2013 11:44:21 (6 years ago)
Author:
jlwhisler
Message:

Changes to Building Multimedia through OAI tutorials. Added |3.05 to Version’s current attribute. Added Auto Text for GS3 to correspond with GS2’s coredm keys – so tutorials for GS3 can be generated properly from a Greenstone 3 installation. Modified GS3 format statements in the tutorials to work correctly with the default statements in the GLI, and to make sure the formatting changes produce the same result as the Greenstone 2 tutorials. Corrected the file path to Greenstone 3 collect folder.

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • documentation/trunk/tutorials/xml-source/tutorial_en.xml

    r27117 r27118  
    28292829<Prerequisite id="multimedia_collection_explore"/> 
    28302830<SampleFiles folder="beatles"/> 
    2831 <Version initial="2.60" current="2.85"/> 
     2831<Version initial="2.60" current="2.85|3.05"/> 
    28322832<Content> 
    28332833<Comment> 
     
    29572957    <Tab n="2"/>&lt;/gsf:when&gt;<br /> 
    29582958    <Tab n="2"/>&lt;gsf:when test='equals' test-value='Supplementary'&gt;<br /> 
    2959       <Tab n="3"/>&lt;gsf:link type=&quot;source&quot;&gt;&lt;gsf:metadata name=&quot;srcicon&quot;/&gt;&lt;/gsf:link&gt; &lt;gsf:link type=&quot;document&quot;&gt;&lt;gsf:icon type=&quot;document&quot;/&gt;&lt;/gsf:link&gt;<br /> 
     2959      <Tab n="3"/>&lt;gsf:link type=&quot;source&quot;&gt;&lt;gsf:metadata name=&quot;srcicon&quot;/&gt;&lt;/gsf:link&gt;<br /> 
     2960      <Tab n="3" />&lt;gsf:link type=&quot;document&quot;&gt;&lt;gsf:icon type=&quot;document&quot;/&gt;&lt;/gsf:link&gt;<br /> 
    29602961    <Tab n="2"/>&lt;/gsf:when&gt;<br /> 
    29612962    <Tab n="2"/>&lt;gsf:otherwise&gt;<br /> 
     
    30153016</Heading> 
    30163017<NumberedItem> 
    3017 <Text id="0597">There are sometimes several documents with the same title. For example, <AutoText text="All My Loving" type="italics"/> appears both as lyrics and tablature (under <AutoText text="ALL MY LOVING" type="italics"/>). The <AutoText key="coredm::_Global:labelTitle_"/> browser might be improved by grouping these together under a bookshelf icon. This is a job for an <AutoText text="AZCompactList"/>. In the previous tutorial we showed how to use the <AutoText text="bookshelf_type"/> option in <AutoText text="List"/> classifier to group documents with the same metadata value (<AutoText key="metadata::dc.Format"/> in that case) in one bookshelf. Here we use <AutoText text="AZCompactList"/> instead.</Text> 
     3018<Text id="0597">There are sometimes several documents with the same title. For example, <AutoText text="All My Loving" type="italics"/> appears both as lyrics and tablature (under <AutoText text="ALL MY LOVING" type="italics"/>). The <MajorVersion number="2"><AutoText key="coredm::_Global:labelTitle_"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Title.buttonname" /></MajorVersion> browser might be improved by grouping these together under a bookshelf icon. This is a job for an <AutoText text="AZCompactList"/>. In the previous tutorial we showed how to use the <AutoText text="bookshelf_type"/> option in <AutoText text="List"/> classifier to group documents with the same metadata value (<AutoText key="metadata::dc.Format"/> in that case) in one bookshelf. Here we use <AutoText text="AZCompactList"/> instead.</Text> 
    30183019<BulletList> 
    30193020<Bullet> 
     
    30563057</MajorVersion> 
    30573058<MajorVersion number="3"> 
    3058 <Text id="0606-3">Make the bookshelves show how many documents they contain by modifying the <AutoText text="VList classifierNode"/> template of the <AutoText text="browse"/> format feature in the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel. Remove the portion highlighted below:</Text>  
    3059 <Format> 
    3060       <Tab n="1"/>...<br /> 
    3061       <Tab n="1"/>&lt;xsl:call-template name=&quot;choose-title&quot;/&gt;<br /> 
    3062       <Tab n="1"/><highlight>&lt;gsf:switch&gt;<br /> 
    3063         <Tab n="2"/>&lt;gsf:metadata name=&quot;Source&quot;/&gt;<br /> 
    3064         <Tab n="2"/>&lt;gsf:when test=&quot;exists&quot;&gt;<br /> 
    3065           <Tab n="3"/>&lt;br/&gt;<br /> 
    3066           <Tab n="3"/>&lt;i&gt;(&lt;gsf:metadata name=&quot;Source&quot;/&gt;)&lt;/i&gt;<br /> 
    3067         <Tab n="2"/>&lt;/gsf:when&gt;<br /> 
    3068       <Tab n="1"/>&lt;/gsf:switch&gt;<br /> 
    3069     &lt;/td&gt;</highlight> 
    3070 </Format> 
    3071 And replace it with the statements highlighted here: 
    3072 <Format> 
    3073       <Tab n="1"/>...<br /> 
    3074       <Tab n="1"/>&lt;xsl:call-template name=&quot;choose-title&quot;/&gt;<br /> 
    3075     <highlight>&lt;/td&gt;<br /> 
    3076     &lt;td&gt;<br /> 
     3059<Text id="0606-3">Make the bookshelves show how many documents they contain by modifying the <AutoText text="VList classifierNode"/> template of the <AutoText text="browse"/> format feature in the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel. Insert the highlighted statements:</Text>  
     3060<Format> 
     3061      <Tab n="1"/>&lt;gsf:template match=&quot;classifierNode[@classifierStyle = 'VList']&quot;&gt;<br /> 
     3062      <Tab n="1"/>...<br /> 
     3063      <Tab n="1"/>&lt;gsf:metadata name=&quot;Title&quot;/&gt;<br /> 
     3064     &lt;/td&gt;<br /> 
     3065    <highlight>&lt;td&gt;<br /> 
    30773066       <Tab n="1"/>(&lt;gsf:metadata name=&quot;numleafdocs&quot;/&gt;)<br /> 
    30783067    &lt;/td&gt;</highlight> 
     3068    &lt;gsf:template<br /> 
    30793069</Format> 
    30803070<Text id="0606-3a">The complete format statement for the <AutoText text="VList classifierNode"/> template of the <AutoText text="browse"/> format feature can be copied from <Path>sample_files &rarr; beatles &rarr; format_tweaks &rarr; show_num_docs_3.txt</Path>.</Text> 
     
    30873077<NumberedItem> 
    30883078<Text id="0612">In the <AutoText key="glidict::CDM.GUI.Classifiers"/> section on the <AutoText key="glidict::GUI.Design"/> panel, add a <AutoText text="Phind"/> classifier. Leave the settings at their defaults: this generates a phrase browsing classifier that sources its phrases from <i>Title</i> and <i>text</i>.</Text> 
    3089 <Text id="0612b"><b>Build</b> the collection again and <b>preview</b> it. Select the new <AutoText key="coredm::_Global:labelPhrase_"/> option from the navigation bar. Enter a single word in the text box, such as <AutoText text="band" type="quotes"/>. The phrase browser will present you with phrases found in the collection containing the search term. This can provide a useful way of browsing a very large collection. Note that even though it is called a phrase browser, only single terms can be used as the starting point for browsing.</Text> 
     3079<Text id="0612b"><b>Build</b> the collection again and <b>preview</b> it. Select the new <MajorVersion number="2"><AutoText key="coredm::_Global:labelPhrase_"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::PhindPhraseBrowse::PhindApplet.name" /></MajorVersion> option from the navigation bar. Enter a single word in the text box, such as <AutoText text="band" type="quotes"/>. The phrase browser will present you with phrases found in the collection containing the search term. This can provide a useful way of browsing a very large collection. Note that even though it is called a phrase browser, only single terms can be used as the starting point for browsing.</Text> 
    30903080</NumberedItem> 
    30913081<Heading> 
     
    31313121</Heading> 
    31323122<Comment> 
    3133 <Text id="0618a">We now clean up the <AutoText key="coredm::_Global:labelTitle_"/> browser.</Text> 
     3123<Text id="0618a">We now clean up the <MajorVersion number="2"><AutoText key="coredm::_Global:labelTitle_"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Title.buttonname" /></MajorVersion> browser.</Text> 
    31343124</Comment> 
    31353125<NumberedItem> 
     
    31473137</NumberedItem> 
    31483138<Comment> 
    3149 <Text id="0640">One powerful use of regular expressions in the exercise was to clean up the <AutoText key="coredm::_Global:labelTitle_"/> browser. Perhaps the best way of doing this would be to have proper title metadata. The metadata extracted from HTML files is messy and inconsistent, and this was reflected in the original <AutoText key="coredm::_Global:labelTitle_" type="italics"/> browser. Defining proper title metadata would be simple but rather laborious. Instead, we have opted to use regular expressions in the <AutoText text="AZCompactList"/> classifier to clean up the title metadata. This is difficult to understand, and a bit fiddly to do, but if you can cope with its idiosyncrasies it provides a quick way to clean up the extracted metadata and avoid having to enter a large amount of metadata.</Text> 
     3139<Text id="0640">One powerful use of regular expressions in the exercise was to clean up the <MajorVersion number="2"><AutoText key="coredm::_Global:labelTitle_"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Title.buttonname" /></MajorVersion> browser. Perhaps the best way of doing this would be to have proper title metadata. The metadata extracted from HTML files is messy and inconsistent, and this was reflected in the original <MajorVersion number="2"><AutoText key="coredm::_Global:labelTitle_"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Title.buttonname" /></MajorVersion> browser. Defining proper title metadata would be simple but rather laborious. Instead, we have opted to use regular expressions in the <AutoText text="AZCompactList"/> classifier to clean up the title metadata. This is difficult to understand, and a bit fiddly to do, but if you can cope with its idiosyncrasies it provides a quick way to clean up the extracted metadata and avoid having to enter a large amount of metadata.</Text> 
    31503140</Comment> 
    31513141<Heading> 
     
    31653155<NumberedItem> 
    31663156<Text id="0645a">Open up another file browser, and locate the small beatles collection in your Greenstone installation:</Text> 
    3167 <Path>Greenstone &rarr; collect &rarr; smallbea</Path> 
     3157<Path>Greenstone<MajorVersion number="3">3 &rarr; web &rarr; sites &rarr; localsite </MajorVersion> &rarr; collect &rarr; smallbea</Path> 
    31683158<Text id="0645b"><AutoText text="smallbea"/> is the folder name generated by Greenstone for this collection. You can determine what the folder name is for a collection by looking at the title bar of the Librarian Interface: the folder name is displayed in brackets after the collection name.</Text> 
    31693159</NumberedItem> 
     
    31853175</MajorVersion> 
    31863176<NumberedItem> 
    3187 <Text id="0648">Re-edit <MajorVersion number="2"><AutoText text="VList" /> your format statement</MajorVersion><MajorVersion number="3">the previously edited portion of the <AutoText text="documentNode"/> format statement of the <AutoText text="browse"/> format feature</MajorVersion> (in <AutoText key="glidict::CDM.GUI.Formats"/> on the <AutoText key="glidict::GUI.Format"/> panel) to be the following. You can copy this text from the file <Path>sample_files &rarr; beatles &rarr; format_tweaks &rarr; multi_icons<MajorVersion number="3">_3</MajorVersion>.txt</Path>.</Text> 
     3177<Text id="0648">Re-edit <MajorVersion number="2"><AutoText text="VList" /> your format statement</MajorVersion><MajorVersion number="3">the previously edited portion of the <AutoText text="documentNode"/> format statement of the <AutoText text="browse"/> format feature</MajorVersion> (in <AutoText key="glidict::CDM.GUI.Formats"/> on the <AutoText key="glidict::GUI.Format"/> panel) to be the following. You can copy this text from the file <Path>sample_files &rarr; beatles &rarr; format_tweaks &rarr; multi_icons<MajorVersion number="3">_3</MajorVersion>.txt</Path>.<MajorVersion number="3">Change: </MajorVersion></Text> 
    31883178<Format> 
    31893179<MajorVersion number="2"> 
     
    32083198</MajorVersion> 
    32093199<MajorVersion number="3"> 
     3200&lt;td valign=&quot;top&quot;&gt;<br /> 
     3201  <Tab n="1"/><highlight>&lt;gsf:switch&gt;<br /> 
     3202    <Tab n="2"/>&lt;gsf:metadata name=&quot;dc.Format&quot;/&gt;<br /> 
     3203    <Tab n="2"/>&lt;gsf:when test='equals' test-value='Audio'&gt;<br /> 
     3204      <Tab n="3"/>&lt;gsf:link type=&quot;source&quot;&gt;&lt;gsf:metadata name=&quot;srcicon&quot;/&gt;&lt;/gsf:link&gt;<br /> 
     3205    <Tab n="2"/>&lt;/gsf:when&gt;<br /> 
     3206    <Tab n="2"/>&lt;gsf:when test='equals' test-value='Images'&gt;<br /> 
     3207      <Tab n="3"/>&lt;gsf:link type=&quot;source&quot;&gt;&lt;gsf:metadata name=&quot;thumbicon&quot;/&gt;&lt;/gsf:link&gt;<br /> 
     3208    <Tab n="2"/>&lt;/gsf:when&gt;<br /> 
     3209    <Tab n="2"/>&lt;gsf:when test='equals' test-value='Supplementary'&gt;<br /> 
     3210      <Tab n="3"/>&lt;gsf:link type=&quot;source&quot;&gt;&lt;gsf:metadata name=&quot;srcicon&quot;/&gt;&lt;/gsf:link&gt; &lt;gsf:link type=&quot;document&quot;&gt;&lt;gsf:icon type=&quot;document&quot;/&gt;&lt;/gsf:link&gt;<br /> 
     3211    <Tab n="2"/>&lt;/gsf:when&gt;<br /> 
     3212    <Tab n="2"/>&lt;gsf:otherwise&gt;<br /> 
     3213      <Tab n="3"/>&lt;gsf:link type=&quot;document&quot;&gt;&lt;gsf:icon type=&quot;document&quot;/&gt;&lt;/gsf:link&gt;<br /> 
     3214    <Tab n="2"/>&lt;/gsf:otherwise&gt;<br /> 
     3215  <Tab n="1"/>&lt;/gsf:switch&gt;</highlight><br /> 
     3216&lt;/td&gt; 
     3217</MajorVersion> 
     3218</Format> 
     3219<MajorVersion number="3"> 
     3220<Text id="0648a">to this:</Text> 
     3221<Format> 
    32103222  &lt;td valign=&quot;top&quot;&gt;<br /> 
    3211      <Tab n="1"/>&lt;gsf:switch&gt;<br /> 
     3223     <highlight><Tab n="1"/>&lt;gsf:switch&gt;<br /> 
    32123224        <Tab n="2"/>&lt;gsf:metadata name=&quot;dc.Format&quot;/&gt;<br /> 
    32133225    <Tab n="2"/>&lt;gsf:when test=&quot;equals&quot; test-value=&quot;Lyrics&quot;&gt;<br /> 
     
    32543266          <Tab n="3"/>&lt;/gsf:link&gt;<br /> 
    32553267        <Tab n="2"/>&lt;/gsf:when&gt;<br /> 
    3256       <Tab n="1"/>&lt;/gsf:switch&gt;<br /> 
     3268      <Tab n="1"/>&lt;/gsf:switch&gt;<br /></highlight> 
    32573269    &lt;/td&gt; 
    3258 </MajorVersion> 
    3259 </Format>  
     3270    </Format> 
     3271</MajorVersion>  
    32603272</NumberedItem> 
    32613273<NumberedItem> 
     
    33243336</Title> 
    33253337<SampleFiles folder="niupepa"/> 
    3326 <Version initial="2.60" current="2.85"/> 
     3338<Version initial="2.60" current="2.85|3.05"/> 
    33273339<Content> 
    33283340<Comment> 
     
    33423354</Comment> 
    33433355<NumberedItem> 
    3344 <Text id="0681">Go to the <AutoText key="glidict::GUI.Create"/> panel, <b>build</b> the collection and <b>preview</b> the result. Search for <AutoText text="waka" type="quoted"/> and view one of the titles listed (all three appear as <AutoText text="Te Whetu o Te Tau" type="italics"/>). Browse by <AutoText key="coredm::_Global:labelTitle_"/> and view one of the <AutoText text="Te Waka o Te Iwi" type="italics"/> newspapers. Note that only the <AutoText text="Te Whetu o Te Tau" type="italics"/> newspapers have text; <AutoText text="Te Waka o Te Iwi" type="italics"/> papers don't.</Text> 
     3356<Text id="0681">Go to the <AutoText key="glidict::GUI.Create"/> panel, <b>build</b> the collection and <b>preview</b> the result. Search for <AutoText text="waka" type="quoted"/> and view one of the titles listed (all three appear as <AutoText text="Te Whetu o Te Tau" type="italics"/>). Browse by <MajorVersion number="2"><AutoText key="coredm::_Global:labelTitle_"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Title.buttonname" /></MajorVersion> and view one of the <AutoText text="Te Waka o Te Iwi" type="italics"/> newspapers. Note that only the <AutoText text="Te Whetu o Te Tau" type="italics"/> newspapers have text; <AutoText text="Te Waka o Te Iwi" type="italics"/> papers don't.</Text> 
    33453357</NumberedItem> 
    33463358<Comment> 
     
    33513363</Heading> 
    33523364<Comment> 
    3353 <Text id="0684">Under <AutoText key="coredm::_Global:labelTitle_"/>, documents from the same series are repeated without any distinguishing features such as date, volume or number. It would be better to group them by series title and display other information within each group. This can be accomplished using the <AutoText text="-bookshelf_type"/> option to the <AutoText text="List"/> classifier, and tuning the classifier's format statement.</Text> 
     3365<Text id="0684">Under <MajorVersion number="2"><AutoText key="coredm::_Global:labelTitle_"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Title.buttonname" /></MajorVersion>, documents from the same series are repeated without any distinguishing features such as date, volume or number. It would be better to group them by series title and display other information within each group. This can be accomplished using the <AutoText text="-bookshelf_type"/> option to the <AutoText text="List"/> classifier, and tuning the classifier's format statement.</Text> 
    33543366</Comment> 
    33553367<NumberedItem> 
     
    33603372</NumberedItem> 
    33613373<NumberedItem> 
    3362 <Text id="0686a"><b>Build</b> the collection, and <b>preview</b> the <AutoText key="coredm::_Global:labelTitle_" type="italics"/> list.</Text> 
    3363 </NumberedItem> 
    3364 <NumberedItem> 
    3365 <Text id="0687">Now we change the format statement for <AutoText key="coredm::_Global:labelTitle_" type="italics"/> to display more information about the documents. In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, select the <AutoText text="dc.Title;ex.Title"/> classifier (CL1) in the <AutoText key="glidict::CDM.FormatManager.Feature"/> list<MajorVersion number="2">, and <AutoText text="VList"/> in the <AutoText key="glidict::CDM.FormatManager.Part"/> list.</MajorVersion> Click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/> to add this format statement to your collection.  
     3374<Text id="0686a"><b>Build</b> the collection, and <b>preview</b> the <MajorVersion number="2"><AutoText key="coredm::_Global:labelTitle_"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Title.buttonname" /></MajorVersion> list.</Text> 
     3375</NumberedItem> 
     3376<NumberedItem> 
     3377<Text id="0687">Now we change the format statement for <MajorVersion number="2"><AutoText key="coredm::_Global:labelTitle_"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Title.buttonname" /></MajorVersion> to display more information about the documents. In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, select the <AutoText text="dc.Title;ex.Title"/> classifier (CL1) in the <AutoText key="glidict::CDM.FormatManager.Feature"/> list.<MajorVersion number="2">, and <AutoText text="VList"/> in the <AutoText key="glidict::CDM.FormatManager.Part"/> list.</MajorVersion> Click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/> to add this format statement to your collection.  
    33663378<MajorVersion number="2">Delete the contents of the <AutoText key="glidict::CDM.FormatManager.Editor"/> box, and add the following text. (This format statement can be copied and pasted from the file <Path>sample_files &rarr; niupepa &rarr; formats &rarr; titles_tweak.txt</Path>.)</MajorVersion> 
    3367 <MajorVersion number="3">Edit the contents of the <AutoText text="browse"/> format statement by removing the following in the <AutoText text="documentNode"/> template:</MajorVersion> 
     3379<MajorVersion number="3">Edit the contents of the <AutoText text="dc.Title;ex.Title"/> classifier format statement by removing the following in the <AutoText text="documentNode"/> template:</MajorVersion> 
    33683380</Text> 
    33693381<MajorVersion number="2"> 
     
    34043416<Format> 
    34053417  &lt;td valign=&quot;top&quot;&gt;<br /> 
    3406     <Tab n="1"/>Volume:&lt;gsf:metadata name=&quot;Volume&quot;/&gt; Number:&lt;gsf:metadata name=&quot;Number&quot;/&gt; Date:&lt;gsf:metadata format=&quot;formatDate&quot; name=&quot;Date&quot;/&gt;<br /> 
     3418    <Tab n="1"/>Volume: &lt;gsf:metadata name=&quot;Volume&quot;/&gt; Number: &lt;gsf:metadata name=&quot;Number&quot;/&gt; Date: &lt;gsf:metadata format=&quot;formatDate&quot; name=&quot;Date&quot;/&gt;<br /> 
    34073419  &lt;/td&gt;<br /> 
    34083420</Format> 
     
    34163428</NumberedItem> 
    34173429<NumberedItem> 
    3418 <Text id="0690a">Refresh in the web browser to view the new <AutoText key="coredm::_Global:labelTitle_" type="italics"/> list.</Text> 
     3430<Text id="0690a">Refresh in the web browser to view the new <MajorVersion number="2"><AutoText key="coredm::_Global:labelTitle_"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Title.buttonname" /></MajorVersion> list.</Text> 
    34193431<Text id="0687c">As a consequence of using the <AutoText text="bookshelf_type"/> option of the <AutoText text="List"/> classifier, bookshelf icons appear when titles are browsed. This revised format statement has the effect of specifying in brackets how many items are contained within a bookshelf<MajorVersion number="3">, for classifier nodes</MajorVersion>. <MajorVersion number="2">It works by exploiting the fact that only bookshelf icons define <Format>[numleafdocs]</Format> metadata.</MajorVersion> For document nodes, Title is not displayed. Instead, Volume, Number and Date information are displayed.</Text> 
    34203432</NumberedItem> 
     
    34273439<MajorVersion number="3"> 
    34283440<NumberedItem> 
    3429 <Text id="0686b-3">In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, select <AutoText text="DateList" /> in the <AutoText key="glidict::CDM.FormatManager.Feature"/> list, and click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/> to add this format statement to your collection. Replace the final <Format>&lt;td&gt;</Format> table cell element of the new <AutoText text="DateList"/>'s <AutoText text="VList classifierNode"/> template with:</Text> 
    3430 <Format> 
     3441<Text id="0686b-3">In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, select <AutoText text="DateList" /> in the <AutoText key="glidict::CDM.FormatManager.Feature"/> list, and click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/> to add this format statement to your collection. In the <AutoText text="documentNode"/> template of the new <AutoText text="DateList"/> feature, replace:</Text> 
     3442<Format> 
     3443    &lt;gsf:switch&gt;<br /> 
     3444    <Tab n="1"/>&lt;gsf:metadata name=&quot;Source&quot;/&gt;<br /> 
     3445    <Tab n="1"/>&lt;gsf:when test=&quot;exists&quot;/&gt;<br /> 
     3446    <Tab n="2"/>&lt;br/&gt;<br /> 
     3447    <Tab n="2"/>&lt;i&gt;(&lt;gsf:metadata name=&quot;Source&quot;&gt;)&lt;/i&gt;<br /> 
     3448    <Tab n="1"/>&lt;/gsf:when&gt;<br /> 
     3449    &lt;/gsf:switch&gt; 
     3450</Format> 
     3451<Text id="0686b-31a">with this:</Text> 
     3452<Format> 
     3453  &lt;/td&gt;<br /> 
    34313454  &lt;td valign=&quot;top&quot;&gt;<br /> 
    34323455    <Tab n="1"/>&lt;xsl:call-template name=&quot;choose-date&quot;/&gt;<br /> 
    3433   &lt;/td&gt; 
    34343456</Format> 
    34353457</NumberedItem> 
     
    34503472</MajorVersion> 
    34513473<NumberedItem> 
    3452 <Text id="0686b"><b>Build</b> the collection, and <b>preview</b> the <AutoText key="coredm::_Global:labelDate_" type="italics"/> list.</Text> 
    3453 </NumberedItem> 
    3454 <NumberedItem> 
    3455 <Text id="0691">The <AutoText key="coredm::_Global:labelDate_" type="italics"/> list groups documents by date. Greenstone's internal date format is YYYYMMDD, for example 18580601, and this is crucial for the <AutoText text="DateList" /> classifier to correctly parse date metadata and generate an ordered date list. However, the date has been made to look nice by adding a <MajorVersion number="2"><AutoText text="[format:]"/> macro</MajorVersion><MajorVersion number="3">&quot;<AutoText text="format=formatDate"/>&quot; attribute</MajorVersion> to Date metadata in the format statement.</Text> 
     3474<Text id="0686b"><b>Build</b> the collection, and <b>preview</b> the <MajorVersion number="2"><AutoText key="coredm::_Global:labelDate_" type="italics"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Date.buttonname"/> 
     3475</MajorVersion> list.</Text> 
     3476</NumberedItem> 
     3477<NumberedItem> 
     3478<Text id="0691">The <MajorVersion number="2"><AutoText key="coredm::_Global:labelDate_" type="italics"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Date.buttonname"/> 
     3479</MajorVersion> list groups documents by date. Greenstone's internal date format is YYYYMMDD, for example 18580601, and this is crucial for the <AutoText text="DateList" /> classifier to correctly parse date metadata and generate an ordered date list. However, the date has been made to look nice by adding a <MajorVersion number="2"><AutoText text="[format:]"/> macro</MajorVersion><MajorVersion number="3">&quot;<AutoText text="format=formatDate"/>&quot; attribute</MajorVersion> to Date metadata in the format statement.</Text> 
    34563480</NumberedItem> 
    34573481<NumberedItem> 
     
    34793503</Format> 
    34803504</MajorVersion> 
    3481 <Text id="0691c">Refresh in the web browser to view the new <AutoText key="coredm::_Global:labelDate_" type="italics"/> list. The dates are now shown in internal format. </Text> 
     3505<Text id="0691c">Refresh in the web browser to view the new <MajorVersion number="2"><AutoText key="coredm::_Global:labelDate_" type="italics"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Date.buttonname"/> 
     3506</MajorVersion> list. The dates are now shown in internal format. </Text> 
    34823507</NumberedItem> 
    34833508<NumberedItem> 
     
    36513676<SampleFiles folder="niupepa"/> 
    36523677<Prerequisite id="scanned_image_collection"/> 
    3653 <Version initial="2.70" current="2.85"/> 
     3678<Version initial="2.70" current="2.85|3.05"/> 
    36543679<Content> 
    36553680<Comment> 
     
    369237171:images/12_3_6_1.gif:text/12_3_6_1.txt 
    36933718</Format> 
    3694 <Text id="sc16">Note that if there is no text file, you can leave that space blank. You need to add a line for each page in the document. Make sure you increment the page number as well as the image number for each line.</Text> 
    3695 </NumberedItem> 
    3696 <NumberedItem> 
    3697 <Text id="sc17">Save the file using <b>Filename</b> <AutoText text="12_3_6.item" type="italics"/>, and save as a plain text document. (If you are using Windows, make sure the file doesn't accidentally end up getting saved as <AutoText text="12_3_6.item.txt" type="italics"/>.) Back in the <AutoText key="glidict::GUI.Gather"/> panel of the Librarian Interface, locate the new file in the <b>Workspace</b> tree, and drag it into the collection, adding it to the <AutoText text="12"/> folder.</Text> 
     3719<Text id="sc16">Note that if there is no text file, you can leave that space blank. You need to add a line for each page in the document. Make sure you increment the page number as well as the image number for each line. (The full text for this file can be copied from <Path>sample_files &rarr; niupepa &rarr; formats &rarr; 12item_text.txt</Path>.)</Text> 
     3720</NumberedItem> 
     3721<NumberedItem> 
     3722<Text id="sc17">Save the file using <b>Filename </b> <AutoText text="12_3_6.item" type="italics"/>, and save as a plain text document. (If you are using Windows, make sure the file doesn't accidentally end up getting saved as <AutoText text="12_3_6.item.txt" type="italics"/>.) Back in the <AutoText key="glidict::GUI.Gather"/> panel of the Librarian Interface, locate the new file in the <b>Workspace</b> tree, and drag it into the collection, adding it to the <AutoText text="12"/> folder.</Text> 
    36983723</NumberedItem> 
    36993724<NumberedItem> 
     
    37093734</NumberedItem> 
    37103735<NumberedItem> 
    3711 <Text id="sc23">Open up the file <Path>xml &rarr; 23 &rarr; 23__2.item</Path> and have a look at the XML. This is <AutoText text="Number"/> <AutoText text="2" type="italics"/> of the newspaper titled <AutoText text="Matariki 1881" type="italics"/>. The contents of this document have been grouped into two sections: <AutoText text="Supplementary Material"/>, which contains an <AutoText text="Abstract"/>, and <AutoText text="Newspaper Pages"/>, which contains the page images (and OCR text). </Text> 
     3736<Text id="sc23">Open up the file <Path>xml &rarr; 23 &rarr; 23__2.item</Path> and have a look at the XML. This is <AutoText text="Number "/> <AutoText text="2" type="italics"/> of the newspaper titled <AutoText text="Matariki 1881" type="italics"/>. The contents of this document have been grouped into two sections: <AutoText text="Supplementary Material"/>, which contains an <AutoText text="Abstract"/>, and <AutoText text="Newspaper Pages"/>, which contains the page images (and OCR text). </Text> 
    37123737</NumberedItem> 
    37133738<NumberedItem> 
     
    37823807</Title> 
    37833808<SampleFiles folder="oai"/> 
    3784 <Version initial="2.60" current="2.85"/> 
     3809<Version initial="2.60" current="2.85|3.05"/> 
    37853810<Content> 
    37863811<Comment> 
     
    39713996</Title> 
    39723997<Prerequisite id="simple_image_collection"/> 
    3973 <Version initial="2.85" current="2.85"/> 
     3998<Version initial="2.85" current="2.85|3.05"/> 
    39743999<Content> 
    39754000<Comment> 
     
    41004125</Title> 
    41014126<Prerequisite id="GS_OAI_server"/> 
    4102 <Version initial="2.60" current="2.85"/> 
     4127<Version initial="2.60" current="2.85|3.05"/> 
    41034128<Content> 
    41044129<Comment> 
     
    42274252</NumberedItem> 
    42284253<NumberedItem> 
    4229 <Text id="0759">In your Windows file browser, locate the <Path>archives</Path> folder for the collection you are working with (in <Path>Greenstone &rarr; collect &rarr; &lt;collname&gt; &rarr; archives</Path>). For each document in the collection, Greenstone has generated two files: <Path>docmets.xml</Path>, the core METS description, and <Path>doctxt.xml</Path>, a supporting file. (Note: unless you are connected to the Internet you may be unable to view <Path>doctxt.xml</Path> in your web browser, because it refers to a remote resource.) Depending on the source documents there may be additional files, such as the images used within a web page. One of METS' many features is the ability to reference information in external XML files. Greenstone uses this to tie the content of the document, which is stored in the external XML file <Path>doctxt.xml</Path>, to its hierarchical structure, which is described in the core METS file <Path>docmets.xml</Path>.</Text> 
     4254<Text id="0759">In your Windows file browser, locate the <Path>archives</Path> folder for the collection you are working with (in <Path>Greenstone<MajorVersion number="3">3 &rarr; web &rarr; sites &rarr; localsite</MajorVersion> &rarr; collect &rarr; &lt;collname&gt; &rarr; archives</Path>). For each document in the collection, Greenstone has generated two files: <Path>docmets.xml</Path>, the core METS description, and <Path>doctxt.xml</Path>, a supporting file. (Note: unless you are connected to the Internet you may be unable to view <Path>doctxt.xml</Path> in your web browser, because it refers to a remote resource.) Depending on the source documents there may be additional files, such as the images used within a web page. One of METS' many features is the ability to reference information in external XML files. Greenstone uses this to tie the content of the document, which is stored in the external XML file <Path>doctxt.xml</Path>, to its hierarchical structure, which is described in the core METS file <Path>docmets.xml</Path>.</Text> 
    42304255</NumberedItem> 
    42314256</Content>