Changeset 11339
- Timestamp:
- 2006-03-13T14:06:39+13:00 (18 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/gsdl-documentation/tutorials/xml-source/tutorial_en.xml
r11336 r11339 35 35 <NumberedItem> 36 36 <Text id="0092">Click <b><next> </b>again to install the UNAIDS collection in the default folder, which is <b>C:\Program Files\UNAIDS Library 2.0 [CD-ROM]</b>.</Text> 37 <Comment 2>37 <Comment> 38 38 <Text id="0093">Installation Wizard copies the required files from CD-ROM to disk</Text> 39 </Comment 2>39 </Comment> 40 40 </NumberedItem> 41 41 <NumberedItem> 42 42 <Text id="0094">Click <b><OK</b>> to confirm completion of UNAIDS collection (twice).</Text> 43 <Comment 2>43 <Comment> 44 44 <Text id="0095">InstallShield quits</Text> 45 45 <Text id="0096">--the UNAIDS Library is installed.</Text> 46 </Comment 2>46 </Comment> 47 47 </NumberedItem> 48 48 <Comment> … … 91 91 <NumberedItem> 92 92 <Text id="0114">You can return to the currently selected page of document titles by clicking the <b>book icon </b>next to the title of the book at the top of the table of contents (this signifies closing the book). You also get to the document titles using <b>titles a-z</b> in the navigation bar, in this case to the titles beginning with A-D.</Text> 93 <Comment 2>93 <Comment> 94 94 <Text id="0115">If the table of contents is open at the top level--showing all the chapters--then clicking <b>Expand Document or Chapter</b> expands the full document. For long documents, which take some time to load in, Greenstone seeks confirmation for this action: clicking 'continue' loads the full document.</Text> 95 </Comment 2>95 </Comment> 96 96 </NumberedItem> 97 97 <NumberedItem> … … 105 105 </NumberedItem> 106 106 <NumberedItem> 107 <Text id="0119">In the query box under <b>Search for chapters in any language which contain some of the words</b>,<b> </b>enter the term <b>gender</b> then click <b><Begin Search></b>.</Text><Comment2> 107 <Text id="0119">In the query box under <b>Search for chapters in any language which contain some of the words</b>,<b> </b>enter the term <b>gender</b> then click <b><Begin Search></b>.</Text> 108 <Comment> 108 109 <Text id="0120">After a short pause, the web browser loads a fresh page showing the results of the search.</Text> 109 </Comment 2>110 </Comment> 110 111 </NumberedItem> 111 112 <NumberedItem> … … 115 116 <NumberedItem> 116 117 <Text id="0123">Experiment further with searching, and with the interface in general. For example, there is a detailed <b>Help</b> page. It contains a <b>Preferences</b> section through which you can control some search settings.</Text> 117 <Comment 2>118 <Comment> 118 119 <Text id="0124">The Preferences options in the UNAIDS collection are intentionally minimalist. Most collections have a separate Preferences button that offers more features.</Text> 119 </Comment 2>120 <Comment 2>120 </Comment> 121 <Comment> 121 122 <Text id="0125">The home page of the UNAIDS library collection cycles through a sequence of front cover images, updated every 5 seconds or so. Clicking a particular image takes you directly to that document.</Text> 122 </Comment 2>123 </Comment> 123 124 </NumberedItem> 124 125 <Heading> … … 371 372 <NumberedItem> 372 373 <Text id="0198">From the IITE Digital Libraries in Education CD-ROM, or a Greenstone workshop CD-ROM</Text> 373 <Comment 2>374 <Comment> 374 375 <Text id="0199">In addition to all the above software, these CD-ROMs contain the <b>Greenstone Language Pack</b>, which gives reader's interfaces in many languages (currently about 40). This has its own installer which you have to invoke separately, after you have installed Greenstone. They also contain a set of <b>sample files</b> to be used for exercises.</Text> 375 </Comment 2>376 </Comment> 376 377 <Comment> 377 378 <Text id="0200">All these CD-ROMs contain the full Greenstone software, which allows you to view collections and build new ones. They are not the same as CD-ROMs that contain a pre-packaged Greenstone collection, which only allow you to view that collection.</Text> … … 548 549 Start-->All Programs-->Greenstone Digital Library Software-->Greenstone Librarian Interface 549 550 </Menu> 550 <Comment 2>551 <Comment> 551 552 <Text id="0256">After a short pause a startup screen appears, and then after a slightly longer pause the main Greenstone Librarian Interface appears.</Text> 552 </Comment 2>553 </Comment> 553 554 </NumberedItem> 554 555 <NumberedItem> … … 574 575 <NumberedItem> 575 576 <Text id="0265">Now drag the <i>hobbits</i> folder from the left-hand side and drop it on the right. The progress bar at the bottom shows some activity. Gradually, duplicates of all the files will appear in the right-hand panel.</Text> 576 <Comment 2>577 <Comment> 577 578 <Text id="0266">You can inspect the files that have been copied by double-clicking on the folder in the right-hand side.</Text> 578 </Comment 2>579 </Comment> 579 580 </NumberedItem> 580 581 <NumberedItem> … … 731 732 </NumberedItem> 732 733 <NumberedItem> 733 <Text id="0321">Check that all the facilities work properly. There should be three full-text indexes, called <i>text</i>, <i>Document Title</i>, and <i>Authors</i>. In the <i>titles a-z</i> list should appear all the documents to which you have assigned <i>dc.Title</i> metadata (and only those documents). In the <i>authors aÂ-z</i> list should appear one bookshelf for each author you have assigned as <i>dc.Creator</i>, and clicking on that bookshelf should take you to all the documents they authored.</Text></NumberedItem> 734 <Text id="0321">Check that all the facilities work properly. There should be three full-text indexes, called <i>text</i>, <i>Document Title</i>, and <i>Authors</i>. In the <i>titles a-z</i> list should appear all the documents to which you have assigned <i>dc.Title</i> metadata (and only those documents). In the <i>authors aÂ-z</i> list should appear one bookshelf for each author you have assigned as <i>dc.Creator</i>, and clicking on that bookshelf should take you to all the documents they authored.</Text> 735 </NumberedItem> 734 736 <Comment> 735 737 <Text id="0322">At this point you might like to publish the collection on CD-ROM, See below under "Exporting a collection to CD-ROM" for how to do this.</Text> … … 858 860 <Comment> 859 861 <Text id="0360">Metadata names are case-sensitive in Greenstone: it is important that you capitalize "Title" (and don't capitalize "dc").</Text> 860 </Comment></NumberedItem> 862 </Comment> 863 </NumberedItem> 861 864 <NumberedItem> 862 865 <Text id="0361">Next click <b><Replace Format></b>. The first of the above changes alters the fragment of text that appears to the right of the thumbnail image, the second alters the item of metadata that follows it.</Text> … … 1017 1020 </Indent> 1018 1021 <Text id="0409">You need to use your own computer's software to write these on to CD-ROM. On WindowsXP this ability is built into the operating system: assuming you have a CD-ROM or DVD writer insert a blank disk into the drive and drag the contents of <i>exported_Tudorcollection</i> into the folder that represents the disk.</Text> 1019 <Comment 2>1022 <Comment> 1020 1023 <Text id="0410">The result will be a self-installing Greenstone CD-ROM, which starts the installation process as soon as it is placed in the drive.</Text> 1021 </Comment 2>1024 </Comment> 1022 1025 </NumberedItem> 1023 1026 </Content> … … 1053 1056 <NumberedItem> 1054 1057 <Text id="0418">Now click <<b>Download></b>. A progress bar appears in the lower half of the panel that reports on how the downloading process is doing.</Text> 1055 <Comment 2>1058 <Comment> 1056 1059 <Text id="0419">More detailed information can be obtained by clicking <<b>View Log></b>. The process can be paused and restarted as needed, or stopped altogether by clicking <<b>Close></b>. Downloading can be a lengthy process involving multiple sites, and so Greenstone allows additional downloads to be queued up. When new URLs are pasted into the Source URL box and <<b>Download></b> clicked, a new progress bar is appended to those already present in the lower half of the panel. When the currently active download item completes, the next is started automatically.</Text> 1057 </Comment 2>1060 </Comment> 1058 1061 </NumberedItem> 1059 1062 <NumberedItem> … … 1249 1252 <Text id="0480">Title metadata--their title is the name of the metadata value associated with that bookshelf--they do not have </Text> 1250 1253 <Text id="0481">ex.Source metadata, so it comes out blank.</Text> 1251 </Comment></NumberedItem> 1254 </Comment> 1255 </NumberedItem> 1252 1256 <NumberedItem> 1253 1257 <Text id="0482">In the <b>Format Features</b> section of the <b>Design</b> panel, the <b>Choose Feature</b> menu (just above <b>Affected Component</b> menu) is blank. That implies that the same format is used for the search results, titles, and all nodes in the subject hierarchy--including internal nodes (that is, bookshelves). The <b>Choose Feature</b> menu can be used to restrict a format statement to a specific one of these lists; when it's blank, the <b>VList</b> specification applies throughout. We will override this format statement for the hierarchical <i>subject</i> classifier. In the <b>Choose Feature</b> menu, scroll down to the item that says</Text> … … 1298 1302 </Format> 1299 1303 <Text id="0496">and click <b>Replace Format</b>. Again, you can insert the items in square brackets by selecting them from the <b>Variables</b> dropdown box (don't forget to click <b>Insert</b>).</Text> 1300 <Comment 2>1304 <Comment> 1301 1305 <Text id="0497">The <b>if </b>statement tests the value of the variable <b>numleafdocs</b>. This variable is only set for internal nodes of the hierarchy, i.e. bookshelves, and gives the number of documents below that node. If it is set we take the first branch, otherwise we take the second. Commas are used to separate the branches. The curly brackets serve to indicate that the <b>if</b> is special--otherwise the word "if" itself would be output.</Text> 1302 </Comment2></NumberedItem> 1306 </Comment> 1307 </NumberedItem> 1303 1308 <NumberedItem> 1304 1309 <Text id="0498">Go to the <b>Create </b>panel, click <<b>Preview</b>>, and examine the subject hierarchy again to see the effect of your changes. </Text> … … 1380 1385 <Comment> 1381 1386 <Text id="0527"><b>AZCompactList</b> is like <b>AZList,</b> except that terms that appear multiple times in the hierarchy are automatically grouped together and a new node, shown as a bookshelf icon, is formed. Setting <b>mingroup</b> to 1 means that the bookshelf appears even when there is just one item, and is done here to provide a more uniform display.</Text> 1382 </Comment></NumberedItem> 1387 </Comment> 1388 </NumberedItem> 1383 1389 <NumberedItem> 1384 1390 <Text id="0528"><b>Build</b> the collection and <b>preview</b> the result.</Text> … … 1408 1414 <NumberedItem> 1409 1415 <Text id="0536">From the <b>General</b> section of the <b>Design</b> panel, click the <b><Browse></b> button next to the label <b>URL to âabout page' icon</b> and use the resulting popup file browser to access the folder <i>sample_files\marc</i>. Select <i>beatles_logo.jpg</i> and click <<b>Open</b>>.</Text> 1410 <Comment 2>1416 <Comment> 1411 1417 <Text id="0537">Greenstone copies the image into your collection area, so the collection will still work when the CD-ROM is removed from the drive.</Text> 1412 </Comment 2>1418 </Comment> 1413 1419 </NumberedItem> 1414 1420 <NumberedItem> … … 1915 1921 <Text id="0692">append</Text> 1916 1922 <Format>{If}{[numleafdocs],<td>([numleafdocs] items)</td>}</Format> 1917 <Comment 2>1923 <Comment> 1918 1924 <Text id="0693">As a consequence of using the AZCompactList 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. It works by exploiting the fact that only bookshelf icons define [numleafdocs] metadata.</Text> 1919 </Comment 2>1925 </Comment> 1920 1926 </NumberedItem> 1921 1927 <Heading> … … 1929 1935 <Format><center><br/> <table width=_pagewidth_><br/> <tr><br/> <td valign=top>[srclink][screenicon][/srclink]</td><br/> <td>[Text]</td><br/> </tr><br/> </table><br/> </center></Format> 1930 1936 <Text id="0697">(available as niupepa\doc_tweak.txt)</Text> 1931 <Comment 2>1937 <Comment> 1932 1938 <Text id="0698">Including [screenicon] has the effect of embedding the screen-sized image generated by switching the screenview option on in PagedImgPlug. It is hyperlinked to the original image by the construct [srclink]âŠ[/srclink].</Text> 1933 </Comment 2>1939 </Comment> 1934 1940 </NumberedItem> 1935 1941 <NumberedItem> … … 2012 2018 </Format> 2013 2019 <Text id="0720">You will find this text in the file <i>vlist_tweak.txt </i>in the <i>oai/format_tweaks</i> folder of <i>sample_files. </i>Remember to press <<b>Replace Format</b>> when finished</Text> 2014 <Comment 2>2020 <Comment> 2015 2021 <Text id="0721">This format statement customizes the appearance of vertical lists such as the search results and captions lists to show a thumbnail icon followed by Description metadata. Greenstone's default is to use extracted metadata, so [Description] is the same as [ex.Description].</Text> 2016 </Comment2></NumberedItem> 2022 </Comment> 2023 </NumberedItem> 2017 2024 <NumberedItem> 2018 2025 <Text id="0722">Next, select <b>DocumentHeading</b> from the <b>Choose Feature</b> pull-down list and make its format statement (which is currently blank) read</Text> 2019 2026 <Format><h3>[Subject]</h3></Format> 2020 <Comment 2>2027 <Comment> 2021 2028 <Text id="0723">The document heading appears above the detach and no highlighting buttons when you get to a document in the collection. By default DocumentHeading displays the document's ex.Title metadata. In this particular set of OAI exported records, titles are filenames of JPEG images, and the filenames are particularly uninformative (for example, 01dla14). You can see them in the <b>Enrich</b> panel if you select an image in sample_small--></Text> 2022 2029 <Text id="0724">oai--></Text> 2023 2030 <Text id="0725"> JCDLPICS--></Text> 2024 2031 <Text id="0726">srcdocs and check its filename and ex.Title metadata. The above format statement displays ex.Subject metadata instead.</Text> 2025 </Comment2></NumberedItem> 2032 </Comment> 2033 </NumberedItem> 2026 2034 <NumberedItem> 2027 2035 <Text id="0727">Finally, you will have noticed that where the document itself should appear, you see only <i>This document has no text</i>. To rectify this, select <b>DocumentText</b> in the <b>Choose Feature</b> pull-down list and use the following as its format statement (which is currently blank) (this text is in </Text> … … 2087 2095 <Text id="0745">Change directory into the folder containing the OAI Services Provider collection you built in the last exercise.</Text> 2088 2096 <Format>cd collect\oaiservi</Format> 2089 <Comment 2>2097 <Comment> 2090 2098 <Text id="0746">Even though the collection name used capital letters the directory generated by the Librarian Interface is all lowercase.</Text> 2091 </Comment2></NumberedItem> 2099 </Comment> 2100 </NumberedItem> 2092 2101 <NumberedItem> 2093 2102 <Text id="0747">Run <i>perl -S importfrom.pl oaiservi</i></Text> 2094 2103 <Comment> 2095 2104 <Text id="0748">Greenstone will immediately set to work and generate a stream of diagnostic output. The importfrom.pl program connects to the OAI data provider specified in collection configuration file (it does this for each "acquire" line in the file) and exports all the records on that site.</Text> 2096 </Comment></NumberedItem> 2105 </Comment> 2106 </NumberedItem> 2097 2107 <NumberedItem> 2098 2108 <Text id="0749">The downloaded files are saved in the collection's import folder. Once the command is finished, everything is in place and the collection is ready to be built. Confirm you have successfully acquired the OAI records by rebuilding the collection.</Text>
Note:
See TracChangeset
for help on using the changeset viewer.
