Changeset 27117 for documentation/trunk/tutorials
- Timestamp:
- 2013-03-25T09:30:38+13:00 (11 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
documentation/trunk/tutorials/xml-source/tutorial_en.xml
r27116 r27117 2130 2130 </Title> 2131 2131 <Prerequisite id="downloading_from_internet"/> 2132 <Version initial="2.60" current="2.85 "/>2132 <Version initial="2.60" current="2.85|3.05"/> 2133 2133 <Content> 2134 2134 <NumberedItem> … … 2149 2149 </NumberedItem> 2150 2150 <NumberedItem> 2151 <Text id="0430">To make use of the new URL metadata, the icon link must be changed to serve up the original URL rather than the copy stored in the digital library. Go to the <AutoText key="glidict::GUI.Format"/> panel, select the <AutoText key="glidict::CDM.GUI.Formats"/> section and edit the <MajorVersion number="2"><AutoText text="VList" /></MajorVersion><MajorVersion number="3"><AutoText text="documentNode"/> template of the <AutoText key="coredm::_Global:labelBrowse_"/></MajorVersion> format statement by replacing</Text>2151 <Text id="0430">To make use of the new URL metadata, the icon link must be changed to serve up the original URL rather than the copy stored in the digital library. Go to the <AutoText key="glidict::GUI.Format"/> panel, select the <AutoText key="glidict::CDM.GUI.Formats"/> section and edit the <MajorVersion number="2"><AutoText text="VList" /></MajorVersion><MajorVersion number="3"><AutoText text="documentNode"/> template of the <AutoText text="Browse" /></MajorVersion> format statement by replacing</Text> 2152 2152 <MajorVersion number="2"> 2153 2153 <Format>[link][icon][/link]</Format> … … 2179 2179 </Title> 2180 2180 <SampleFiles folder="marc"/> 2181 <Version initial="2.60" current="2.85 "/>2181 <Version initial="2.60" current="2.85|3.05"/> 2182 2182 <Content> 2183 2183 <Comment> … … 2197 2197 </NumberedItem> 2198 2198 <NumberedItem> 2199 <Text id="0525">Switch to the <AutoText key="glidict::GUI.Create"/> panel, <b>build</b> the collection, and <b>preview</b> it. Browse through the < AutoText key="coredm::_Global:labelTitle_" type="italics"/> and view a record or two. Try searching—for example, find items that include <AutoText text="graphics"/>.</Text>2199 <Text id="0525">Switch to the <AutoText key="glidict::GUI.Create"/> panel, <b>build</b> the collection, and <b>preview</b> it. Browse through the <MajorVersion number="2"><AutoText key="coredm::_Global:labelTitle_" type="italics"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Title.buttonname" type="italics"/></MajorVersion> and view a record or two. Try searching—for example, find items that include <AutoText text="graphics"/>.</Text> 2200 2200 </NumberedItem> 2201 2201 <NumberedItem> … … 2263 2263 </NumberedItem> 2264 2264 <NumberedItem> 2265 <MajorVersion number="2"> 2265 2266 <Text id="0533-11"><b>Rebuild</b> and <b>preview</b> the collection. You will notice that the <AutoText key="coredm::_Global:labelSubject_" type="italics"/> classifier is empty, searching no longer returns any results, and the document display is useless.</Text> 2266 <Text id="0533-11b">Although the <AutoText key="coredm::_Global:labelTitle_" type="italics"/> classifier was built on <AutoText key="metadata::ex.Title"/>, it still displays the correct titles, but in the <AutoText key="glidict::GUI.Enrich"/> panel you can see the <AutoText key="metadata::ex.Title"/> metadata are actually the filenames rather than titles of the MARC records. This is because the default <MajorVersion number="2"><AutoText text="VList"/></MajorVersion><MajorVersion number="3"><AutoText text="browse"/></MajorVersion> format uses the <AutoText key="metadata::exp.Title"/> metadata. In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, select <MajorVersion number="2"><AutoText text="VList"/></MajorVersion><MajorVersion number="3"><AutoText text="global"/></MajorVersion> in the list of assigned format statements. The format statement looks like:</Text> 2267 <Text id="0533-11b">Although the <AutoText key="coredm::_Global:labelTitle_" type="italics"/> classifier was built on <AutoText key="metadata::ex.Title"/>, it still displays the correct titles, but in the <AutoText key="glidict::GUI.Enrich"/> panel you can see the <AutoText key="metadata::ex.Title"/> metadata are actually the filenames rather than titles of the MARC records. This is because the default <AutoText text="VList"/> format uses the <AutoText key="metadata::exp.Title"/> metadata. In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, select <AutoText text="VList"/> in the list of assigned format statements. The format statement looks like:</Text> 2268 </MajorVersion> 2269 <MajorVersion number="3"> 2270 <Text id="0533-11-1"><b>Rebuild</b> and <b>preview</b> the collection. You will notice that the <AutoText key="gs3::metadata_names::Subjects.buttonname" type="italics"/> classifier is empty, searching no longer returns any results, and the document display is useless.</Text> 2271 <Text id="0533-11b-1">Although the <AutoText key="gs3::metadata_names::Title.buttonname" type="italics"/> classifier was built on <AutoText key="metadata::ex.Title"/>, it still displays the correct titles, but in the <AutoText key="glidict::GUI.Enrich"/> panel you can see the <AutoText key="metadata::ex.Title"/> metadata are actually the filenames rather than titles of the MARC records. This is because the default <AutoText text="browse"/> format uses the <AutoText key="metadata::exp.Title"/> metadata. In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, select <AutoText text="global"/> in the list of assigned format statements. The format statement looks like:</Text> 2272 </MajorVersion> 2267 2273 <MajorVersion number="2"> 2268 2274 <Format> … … 2293 2299 <Text id="0533-11a">Reformatting the collection to use the exploded metadata</Text> 2294 2300 </Heading> 2295 <Text id="0533-12">The collection previously used extracted (ex.) metadata, but now it uses exploded (exp.) metadata. The < AutoText key="coredm::_Global:labelSubject_" type="italics"/> classifier and search indexes were built on ex metadata, which is why they no longer work properly.</Text>2301 <Text id="0533-12">The collection previously used extracted (ex.) metadata, but now it uses exploded (exp.) metadata. The <MajorVersion number="2"><AutoText key="coredm::_Global:labelSubject_" type="italics"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Subjects.buttonname" type="italics"/></MajorVersion> classifier and search indexes were built on ex metadata, which is why they no longer work properly.</Text> 2296 2302 <Text id="0533-12a">There is also no longer any text in the documents. Previously, <AutoText text="MARCPlugin"/> stored the raw record as the "text" of each record. Now that the metadata is in the Librarian Interface, there is no longer the concept of raw record, and so there is no text.</Text> 2297 2303 <Text id="0533-12b">We need to modify the collection design to take note of these changes.</Text> … … 2397 2403 </MajorVersion> 2398 2404 <MajorVersion number="3"> 2399 <Text id="0533-19-3"> The record Title will be displayed as part of the default <AutoText text="documentContent"/> format, so we override the <AutoText text="documentHeading"/> format statement (which displays the Title) with one that does not do anything. Go to the <AutoText text="display"/> format feature in the <AutoText key="glidict::CDM.FormatManager.Editor"/> and add the following just after the<Format><gsf:option name="TOC" value="true"/></Format>:</Text>2405 <Text id="0533-19-3">In the <AutoText key="gs3::metadata_names::Title.buttonname" type="italics"/> list, click on one of the documents. This will take you to the document's display page. Exploding the database has left this document display useless. Only the record Title (in this case, the generated filename) is displayed. We will make two changes to improve the document display. First, we will remove the record Title, since it is not useful in this instance. To remove the record Title, we need to override the default <AutoText text="documentHeading"/> format statement with one that does not do anything. Go to the <AutoText text="display"/> format feature in the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel and add the following just after <Format><gsf:option name="TOC" value="true"/></Format>:</Text> 2400 2406 <Format><gsf:template name="documentHeading"/></Format> 2401 2407 </MajorVersion> … … 2436 2442 <NumberedItem> 2437 2443 <Text id="0533-22"><MajorVersion number="2">The <AutoText key="coredm::_document:textDETACH_" type="italics"/> and <AutoText key="coredm::_document:textNOHIGHLIGHT_" type="italics"/> buttons are not very useful for this collection, so lets get rid of them. Edit the <AutoText text="DocumentButtons"/> format statement to make it empty. </MajorVersion> 2438 Press the <AutoText key="glidict::CreatePane.Preview_Collection" type="button"/> button to preview the collection .</Text>2444 Press the <AutoText key="glidict::CreatePane.Preview_Collection" type="button"/> button to preview the collection and see how the document display has improved.</Text> 2439 2445 </NumberedItem> 2440 2446 </Content> … … 2445 2451 </Title> 2446 2452 <SampleFiles folder="isis"/> 2447 <Version initial="2.70w" current="2.85 "/>2453 <Version initial="2.70w" current="2.85|3.05"/> 2448 2454 <Content> 2449 2455 <Comment> … … 2457 2463 </NumberedItem> 2458 2464 <NumberedItem> 2459 <Text id="is-5"><b>Build</b> and <b>preview</b> the collection. The default indexes, classifiers and formats are not very useful for this data. There is no metadata searching, and the < AutoText key="coredm::_Global:labelTitle_" type="italics"/> classifier is completely empty. The filenames classifier is useless because all records come from the same file.</Text>2465 <Text id="is-5"><b>Build</b> and <b>preview</b> the collection. The default indexes, classifiers and formats are not very useful for this data. There is no metadata searching, and the <MajorVersion number="2"><AutoText key="coredm::_Global:labelTitle_" type="italics"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Title.buttonname" type="italics"/></MajorVersion> classifier is completely empty. The filenames classifier is useless because all records come from the same file.</Text> 2460 2466 </NumberedItem> 2461 2467 <NumberedItem> … … 2512 2518 </MajorVersion> 2513 2519 <NumberedItem> 2514 <Text id="is-16">Finally, let s link to the raw record, which is stored as <AutoText text="ISISRawRecord"/> metadata.2520 <Text id="is-16">Finally, let's link to the raw record, which is stored as <AutoText text="ISISRawRecord"/> metadata. 2515 2521 <MajorVersion number="2">Edit the <AutoText text="DocumentText"/> format statement to look like the following. (This format can be copied from <Path>sample_files → isis → format_tweaks → document_text.txt</Path>.)</MajorVersion> 2516 2522 <MajorVersion number="3">Add the following to the <AutoText text="display"/> format statement (which can be copied from <Path>sample_files → isis → format_tweaks → document_content.txt</Path>), to adjust the <AutoText text="documentContent"/>. This now makes use of a predefined Greenstone javascript function to toggle between displaying and hiding the raw record.</MajorVersion> … … 2558 2564 </Content> 2559 2565 </Tutorial> 2560 < Tutorial id="using_macro_files">2566 <MajorVersion number="2"><Tutorial id="using_macro_files"> 2561 2567 <Title> 2562 2568 <Text id="mf-1">Customization: macro files and stylesheets</Text> … … 2768 2774 </NumberedItem> 2769 2775 </Content> 2770 </Tutorial> 2776 </Tutorial></MajorVersion> 2771 2777 <Tutorial id="multimedia_collection_explore"> 2772 2778 <Title> … … 2774 2780 </Title> 2775 2781 <SampleFiles folder="beatles"/> 2776 <Version initial="2.60" current="2.85 "/>2782 <Version initial="2.60" current="2.85|3.05"/> 2777 2783 <Content> 2778 2784 <NumberedItem> … … 2780 2786 <Path>sample_files → beatles → advbeat_large</Path> 2781 2787 <Text id="0542">(with all its contents) into your Greenstone <Path>collect</Path> folder. If you have installed Greenstone in the usual place, this is</Text> 2788 <MajorVersion number="2"> 2782 2789 <Path> 2783 <Text id="0542a"><Path>My Computer → Local Disk (C:) → Users → <Username> → collect</Path></Text>2790 <Text id="0542a"><Path>My Computer → Local Disk (C:) → Users → <Username> → Greenstone → collect</Path></Text> 2784 2791 </Path> 2785 <Text id="0542b">where <Username> is the username under with Greenstone is installed.</Text> 2792 </MajorVersion> 2793 <MajorVersion number="3"> 2794 <Text id="0542c"><Path>My Computer → Local Disk (C:) → Users → <Username> → Greenstone3 → web → sites → localsite → collect</Path></Text> 2795 </MajorVersion> 2796 <Text id="0542b">where <Username> is the username under which Greenstone is installed.</Text> 2786 2797 <Text id="0543">Put <Path>advbeat_large</Path> in there.<MajorVersion number="3"> Then go into the <Path>advbeat_large</Path> folder and delete its <Path>index</Path> subfolder.</MajorVersion></Text> 2787 2798 </NumberedItem> … … 2797 2808 </MajorVersion> 2798 2809 <NumberedItem> 2799 <Text id="0545">Explore the Beatles collection. Note how the <AutoText key="coredm::_Global:labelBrowse_" type="italics"/>button divides the material into seven different types. Within each category, the documents have appropriate icons. Some documents have an audio icon: when you click these you hear the music (assuming your computer is set up with appropriate player software). Others have an image thumbnail: when you click these you see the images.</Text>2800 </NumberedItem> 2801 <NumberedItem> 2802 <Text id="0546">Look at the < AutoText key="coredm::_Global:labelTitle_" type="italics"/> browser. Each title has a bookshelf that may include several related items. For example, <i>Hey Jude</i> has a MIDI file, lyrics, and a discography item.</Text>2803 </NumberedItem> 2804 <NumberedItem> 2805 <Text id="0547">Observe the low quality of the metadata. For example, the five 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—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>2810 <Text id="0545">Explore the Beatles collection. Note how the <AutoText text="Browse" /> button divides the material into seven different types. Within each category, the documents have appropriate icons. Some documents have an audio icon: when you click these you hear the music (assuming your computer is set up with appropriate player software). Others have an image thumbnail: when you click these you see the images.</Text> 2811 </NumberedItem> 2812 <NumberedItem> 2813 <Text id="0546">Look at the <MajorVersion number="2"><AutoText key="coredm::_Global:labelTitle_" type="italics"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Title.buttonname" type="italics"/></MajorVersion> browser. Each title has a bookshelf that may include several related items. For example, <i>Hey Jude</i> has a MIDI file, lyrics, and a discography item.</Text> 2814 </NumberedItem> 2815 <NumberedItem> 2816 <Text id="0547">Observe the low quality of the metadata. For example, the five items under <AutoText text="A Hard Day's Night"/> (under <AutoText text="H" type="quoted"/> in the <MajorVersion number="2"><AutoText key="coredm::_Global:labelTitle_" type="italics"/></MajorVersion><MajorVersion number="3"><AutoText key="gs3::metadata_names::Title.buttonname" type="italics"/></MajorVersion> 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—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> 2806 2817 </NumberedItem> 2807 2818 <NumberedItem>
Note:
See TracChangeset
for help on using the changeset viewer.