Changeset 19676 for documentation/trunk

Show
Ignore:
Timestamp:
29.05.2009 16:03:48 (10 years ago)
Author:
anna
Message:

updated tutorial exercises.

Files:
1 modified

Legend:

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

    r19652 r19676  
    18531853</NumberedItem> 
    18541854<NumberedItem> 
    1855 <Text id="0533-15">To explicitly use the <AutoText key="metadata::exp.Title"/> metadata, in the <AutoText key="glidict::CDM.GUI.Classifiers"/> section, change the <AutoText text="dc.Title;Title"/> <AutoText text="List"/> to use <AutoText key="metadata::exp.Title"/> metadata. Double click the <AutoText key="metadata::ex.Title"/> <AutoText text="AZList"/> in the <AutoText key="glidict::CDM.ClassifierManager.Assigned"/> list, and change the <AutoText text="metadata"/> option to use <AutoText key="metadata::exp.Title"/>. Click <AutoText key="glidict::General.OK" type="button"/>. Do the same thing for the Subject <AutoText text="AZCompactList"/>, changing <AutoText key="metadata::dc.Subject"/> to <AutoText key="metadata::exp.Subject"/>.</Text> 
     1855<Text id="0533-15">To explicitly use the <AutoText key="metadata::exp.Title"/> metadata, in the <AutoText key="glidict::CDM.GUI.Classifiers"/> section, change the <AutoText text="dc.Title;Title"/> <AutoText text="List"/> to use <AutoText key="metadata::exp.Title"/> metadata. Double click the <AutoText text="dc.Title;Title"/> <AutoText text="List"/> in the <AutoText key="glidict::CDM.ClassifierManager.Assigned"/> list, and change the <AutoText text="metadata"/> option to use <AutoText key="metadata::exp.Title"/>. Click <AutoText key="glidict::General.OK" type="button"/>. Do the same thing for the Subject <AutoText text="AZCompactList"/>, changing <AutoText key="metadata::dc.Subject"/> to <AutoText key="metadata::exp.Subject"/>.</Text> 
    18561856</NumberedItem> 
    18571857<NumberedItem> 
     
    21712171</Title> 
    21722172<SampleFiles folder="beatles"/> 
    2173 <Version initial="2.60" current="2.81"/> 
     2173<Version initial="2.60" current="2.82"/> 
    21742174<Content> 
    21752175<NumberedItem> 
     
    21872187</NumberedItem> 
    21882188<NumberedItem> 
    2189 <Text id="0544">On Windows, if the Greenstone Digital Library Local Library Server is already running, re-start it by clicking the CD icon on the task bar and then pressing <i>Restart Library</i>. If not, start it up by selecting <i>Greenstone Digital Library</i> from the <i>Start</i> menu. On Linux and Mac, just do a forced reload/refresh of the web browser.</Text> 
     2189<Text id="0544">On Windows, if the Greenstone Digital Library Local Library Server is already running, re-start it by clicking the world icon on the task bar and then pressing <i>Restart Library</i>. On Linux and Mac, just do a forced reload/refresh of the web browser. On Linux and Mac, just do a forced reload/refresh of the web browser (eg. by pressing Ctrl and the refresh button in Firefox to do a forced reload). If the Local Library Server hasn't been started yet, start it up by selecting <i>Greenstone Digital Library</i> from the <i>Start</i> menu on Windows, or run <Path>./gs-server.sh</Path> on Linux and Mac.</Text> 
    21902190</NumberedItem> 
    21912191<NumberedItem> 
     
    21962196</NumberedItem> 
    21972197<NumberedItem> 
    2198 <Text id="0547">Observe the low quality of the metadata. For example, the four items under <AutoText text="A Hard Day's Night"/> (under <AutoText text="H" type="quoted"/> in the <AutoText key="coredm::_Global:labelTitle_" type="italics"/> browser) have different variants as their titles. The collection would have been easier to organize had the metadata been cleaned up manually first, but that would be a big job. Only a tiny amount of metadata was added by hand&mdash;fewer than ten items. The original metadata was left untouched and Greenstone facilities used to clean it up automatically. (You will find in <TutorialRef id="multimedia_collection_build"/> that this is possible but tricky.)</Text> 
     2198<Text id="0547">Observe the low quality of the metadata. For example, the four items under <AutoText text="A Hard Day's Night"/> (under <AutoText text="H" type="quoted"/> in the <AutoText key="coredm::_Global:labelTitle_" type="italics"/> browser) have different variants as their titles. The collection would have been easier to organize had the metadata been cleaned up manually first, but that would be a big job. Only a tiny amount of metadata was added by hand&mdash;fewer than ten items. The original metadata was left untouched and Greenstone facilities were used to clean it up automatically. (You will find in <TutorialRef id="multimedia_collection_build"/> that this is possible but tricky.)</Text> 
    21992199</NumberedItem> 
    22002200<NumberedItem> 
     
    22442244</NumberedItem> 
    22452245<Comment> 
    2246 <Text id="0563">Now there's a twist. The <AutoText key="metadata::dc.Title"/> metadata won't appear in <AutoText key="coredm::_Global:labelTitle_" type="italics"/> because the classifier has been instructed to use <AutoText key="metadata::ex.Title"/>. But changing the classifier to use <AutoText key="metadata::dc.Title"/> would miss out all the extracted titles! Fortunately, there's a way of dealing with this by specifying a list of metadata names in the classifier.</Text> 
     2246<Text id="0563a">For versions before 2.82, the default <AutoText key="coredm::_Global:labelTitle_" type="italics"/> classifier only uses <AutoText key="metadata::ex.Title"/> metadata. This has been changed since 2.82 version, and the <AutoText key="coredm::_Global:labelTitle_" type="italics"/> classifier now uses both <AutoText key="metadata::dc.Title"/> and <AutoText key="metadata::ex.Title"/>. So the next step only applies to versions before 2.82.</Text> 
     2247<Text id="0563">For pre-2.82 versions, now there's a twist. The <AutoText key="metadata::dc.Title"/> metadata won't appear in <AutoText key="coredm::_Global:labelTitle_" type="italics"/> because the classifier has been instructed to use <AutoText key="metadata::ex.Title"/>. But changing the classifier to use <AutoText key="metadata::dc.Title"/> would miss out all the extracted titles! Fortunately, there's a way of dealing with this by specifying a list of metadata names in the classifier.</Text> 
    22472248</Comment> 
    22482249<NumberedItem> 
     
    22572258</Bullet> 
    22582259</BulletList> 
     2260</NumberedItem> 
     2261<NumberedItem> 
    22592262<Text id="0566"><b>Build</b> the collection again, and <b>preview</b> it.</Text> 
    22602263<Text id="0567">Extracted metadata is unreliable. But it is very cheap! On the other hand, manually assigned metadata is reliable, but expensive. The previous section of this exercise has shown how to aim for the best of both worlds by using extracted metadata but correcting it when it is wrong.</Text> 
     
    22792282</Bullet> 
    22802283<Bullet> 
    2281 <Text id="0574">Add an <AutoText text="AZCompactList" /> classifier. Select <AutoText key="metadata::dc.Format"/> as the <AutoText text="metadata"/> field and specify "browse" as the <AutoText text="buttonname"/>. Click the <AutoText text="sort"/> checkbox, and select <AutoText key="metadata::ex.Title"/> in the drop-down list: this will make the classifier display documents in alphabetical order of title.</Text> 
     2284<Text id="0574">Add an <AutoText text="AZCompactList" /> classifier. Select <AutoText key="metadata::dc.Format"/> as the <AutoText text="metadata"/> field and specify "browse" as the <AutoText text="buttonname"/>. Click the <AutoText text="sort_leaf_nodes_using"/> checkbox, and select <AutoText key="metadata::ex.Title"/> in the drop-down list: this will make the classifier display documents in alphabetical order of title.</Text> 
    22822285</Bullet> 
    22832286</BulletList> 
     
    24402443</Comment> 
    24412444<Comment> 
    2442 <Text id="0621">To do this we must put the Librarian Interface into a different mode. The interface supports four levels of user: <AutoText key="glidict::Preferences.Mode.Assistant"/>, who can add documents and metadata to collections, and create new ones whose structure mirrors that of existing collections; <AutoText key="glidict::Preferences.Mode.Librarian"/>, who can, in addition, design new collections, but cannot use specialist IT features (e.g. regular expressions); <AutoText text="Library Systems Specialist"/>, who can use all design features, but cannot perform troubleshooting tasks (e.g. interpreting debugging output from Perl programs); and <AutoText key="glidict::Preferences.Mode.Expert"/>, who can perform all functions.</Text> 
    2443 </Comment> 
    2444 <Comment> 
    2445 <Text id="0622">So far you have mostly been operating in <AutoText key="glidict::Preferences.Mode.Librarian"/> mode. We switch to <AutoText text="Library Systems Specialist"/> mode for the next exercise.</Text> 
     2445<Text id="0621">We are going to use the <AutoText text="removesuffix"/> option of a classifier, and to do this we must put the Librarian Interface into a different mode in versions before 2.82. Since Greenstone 2.82, the interface supports three levels of user: <AutoText key="glidict::Preferences.Mode.Assistant"/>, who can add documents and metadata to collections, and create new ones whose structure mirrors that of existing collections; <AutoText key="glidict::Preferences.Mode.Librarian"/>, who can, in addition, design new collections, but cannot use specialist IT features (e.g. regular expressions); and <AutoText key="glidict::Preferences.Mode.Expert"/>, who can perform all functions. For Greenstone versions before 2.82, there is another user type between <AutoText key="glidict::Preferences.Mode.Librarian"/> and <AutoText key="glidict::Preferences.Mode.Expert"/>&mdash;<AutoText text="Library Systems Specialist"/>, who can use all design features, but cannot perform troubleshooting tasks (e.g. interpreting debugging output from Perl programs).</Text> 
     2446</Comment> 
     2447<Comment> 
     2448<Text id="0622a">For Greenstone 2.82, skip the next step.</Text> 
     2449<Text id="0622">Now we switch to <AutoText text="Library Systems Specialist"/> mode.</Text> 
    24462450</Comment> 
    24472451<NumberedItem> 
     
    24622466</NumberedItem> 
    24632467<Comment> 
    2464 <Text id="0639">The previous exercise was done in <AutoText text="Library Systems Specialist"/> mode because it requires the use of regular expressions, something librarians are not normally trained in.</Text> 
     2468<Text id="0639">The previous exercise was done in <AutoText text="Library Systems Specialist"/> mode (for versions before 2.82) because it requires the use of regular expressions, and now the <AutoText text="Library Systems Specialist"/> mode doesn't exist anymore and regular expressions can be edited in <AutoText key="glidict::Preferences.Mode.Librarian"/> mode.</Text> 
    24652469</Comment> 
    24662470<Comment> 
     
    28402844</NumberedItem> 
    28412845<NumberedItem> 
    2842 <Text id="sc25c">Go to the <AutoText key="glidict::CDM.GUI.Plugins"/> section of the <AutoText key="glidict::GUI.Design"/> panel, and add a new <AutoText text="PagedImagePlugin"/> plugin. Enable the <AutoText text="create_screenview"/> option, set the <AutoText text="documenttype"/> option to <AutoText text="hierarchy"/> and set the <AutoText text="process_exp"/> option to <AutoText text="xml.*.item$"/>.</Text> 
     2846<Text id="sc25c">Go to the <AutoText key="glidict::CDM.GUI.Plugins"/> section of the <AutoText key="glidict::GUI.Design"/> panel, and add a new <AutoText text="PagedImagePlugin"/> plugin. Enable the <AutoText text="create_screenview"/> option, set the <AutoText text="documenttype"/> option to <AutoText text="hierarchy"/> and set the <AutoText text="process_exp"/> option to <AutoText text="xml.*\.item$"/>.</Text> 
    28432847</NumberedItem> 
    28442848<NumberedItem> 
     
    28982902</Title> 
    28992903<SampleFiles folder="oai"/> 
    2900 <Version initial="2.60" current="2.81"/> 
     2904<Version initial="2.60" current="2.82"/> 
    29012905<Content> 
    29022906<Comment> 
     
    29362940</Comment> 
    29372941<NumberedItem> 
    2938 <Text id="0713">In the <AutoText key="glidict::CDM.GUI.Classifiers"/> section of the <AutoText key="glidict::GUI.Design"/> panel, delete the two <AutoText text="AZList" /> classifiers (<AutoText key="metadata::ex.Title"/> and <AutoText key="metadata::ex.Source"/>).</Text> 
     2942<Text id="0713">In the <AutoText key="glidict::CDM.GUI.Classifiers"/> section of the <AutoText key="glidict::GUI.Design"/> panel, delete the two <AutoText text="List" /> classifiers (<AutoText key="metadata::dc.Title"/> and <AutoText key="metadata::ex.Source"/>).</Text> 
    29392943</NumberedItem> 
    29402944<NumberedItem> 
     
    30023006</Title> 
    30033007<Prerequisite id="OAI_collection"/> 
    3004 <Version initial="2.60" current="2.81"/> 
     3008<Version initial="2.60" current="2.82"/> 
    30053009<Content> 
    30063010<Comment> 
     
    30823086<Text id="0750">Use METS as Greenstone's Internal Representation</Text> 
    30833087</Title> 
    3084 <Version initial="2.60" current="2.81"/> 
     3088<Version initial="2.60" current="2.82"/> 
    30853089<Content> 
    30863090<NumberedItem> 
     
    31123116</Title> 
    31133117<SampleFiles folder="dspace"/> 
    3114 <Version initial="2.60" current="2.81"/> 
     3118<Version initial="2.60" current="2.82"/> 
    31153119<Content> 
    31163120<NumberedItem> 
     
    31553159<Text id="0776">The DSpace exported files contain Dublin Core metadata for title and author (amongst other things).</Text> 
    31563160<NumberedItem> 
    3157 <Text id="0778">In the <AutoText key="glidict::GUI.Design"/> panel, select <AutoText key="glidict::CDM.GUI.Indexes"/>. Delete the <AutoText key="metadata::ex.Title"/> and <AutoText key="metadata::ex.Source"/> indexes, and add one for <AutoText key="metadata::dc.Title"/> called "titles" and another for <AutoText key="metadata::dc.Contributor"/> called "authors".</Text> 
     3161<Text id="0778">In the <AutoText key="glidict::GUI.Design"/> panel, select <AutoText key="glidict::CDM.GUI.Indexes"/>. Delete the <AutoText key="metadata::ex.Title"/> and <AutoText key="metadata::ex.Source"/> indexes, and add one for <AutoText key="metadata::dc.Title"/> and another for <AutoText key="metadata::dc.Contributor"/>. Rename the <AutoText key="metadata::dc.Contributor"/> index by going to the <AutoText key="glidict::CDM.GUI.SearchMetadata"/> section in the <AutoText key="glidict::GUI.Format"/> panel, select this index and change its value to "authors". Greenstone 2.82 automatically detects index names, so <AutoText key="metadata::dc.Title"/> index will be named as <AutoText key="coredm::_Global:labelTitle_"/></Text> 
    31583162</NumberedItem> 
    31593163<NumberedItem>