Ignore:
Timestamp:
2006-03-13T14:06:39+13:00 (16 years ago)
Author:
kjdon
Message:

replace Comment2 with Comment, also moved a few tags to new lines

File:
1 edited

Legend:

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

    r11336 r11339  
    3535<NumberedItem>
    3636<Text id="0092">Click <b>&lt;next&gt; </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 <Comment2>
     37<Comment>
    3838<Text id="0093">Installation Wizard copies the required files from CD-ROM to disk</Text>
    39 </Comment2>
     39</Comment>
    4040</NumberedItem>
    4141<NumberedItem>
    4242<Text id="0094">Click <b>&lt;OK</b>&gt; to confirm completion of UNAIDS collection (twice).</Text>
    43 <Comment2>
     43<Comment>
    4444<Text id="0095">InstallShield quits</Text>
    4545<Text id="0096">--the UNAIDS Library is installed.</Text>
    46 </Comment2>
     46</Comment>
    4747</NumberedItem>
    4848<Comment>
     
    9191<NumberedItem>
    9292<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 <Comment2>
     93<Comment>
    9494<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 </Comment2>
     95</Comment>
    9696</NumberedItem>
    9797<NumberedItem>
     
    105105</NumberedItem>
    106106<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>&lt;Begin Search&gt;</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>&lt;Begin Search&gt;</b>.</Text>
     108<Comment>
    108109<Text id="0120">After a short pause, the web browser loads a fresh page showing the results of the search.</Text>
    109 </Comment2>
     110</Comment>
    110111</NumberedItem>
    111112<NumberedItem>
     
    115116<NumberedItem>
    116117<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 <Comment2>
     118<Comment>
    118119<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 </Comment2>
    120 <Comment2>
     120</Comment>
     121<Comment>
    121122<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 </Comment2>
     123</Comment>
    123124</NumberedItem>
    124125<Heading>
     
    371372<NumberedItem>
    372373<Text id="0198">From the IITE Digital Libraries in Education CD-ROM, or a Greenstone workshop CD-ROM</Text>
    373 <Comment2>
     374<Comment>
    374375<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 </Comment2>
     376</Comment>
    376377<Comment>
    377378<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>
     
    548549Start--&gt;All Programs--&gt;Greenstone Digital Library Software--&gt;Greenstone Librarian Interface
    549550</Menu>
    550 <Comment2>
     551<Comment>
    551552<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 </Comment2>
     553</Comment>
    553554</NumberedItem>
    554555<NumberedItem>
     
    574575<NumberedItem>
    575576<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 <Comment2>
     577<Comment>
    577578<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 </Comment2>
     579</Comment>
    579580</NumberedItem>
    580581<NumberedItem>
     
    731732</NumberedItem>
    732733<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>
    734736<Comment>
    735737<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>
     
    858860<Comment>
    859861<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>
    861864<NumberedItem>
    862865<Text id="0361">Next click <b>&lt;Replace Format&gt;</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>
     
    10171020</Indent>
    10181021<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 <Comment2>
     1022<Comment>
    10201023<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 </Comment2>
     1024</Comment>
    10221025</NumberedItem>
    10231026</Content>
     
    10531056<NumberedItem>
    10541057<Text id="0418">Now click &lt;<b>Download&gt;</b>. A progress bar appears in the lower half of the panel that reports on how the downloading process is doing.</Text>
    1055 <Comment2>
     1058<Comment>
    10561059<Text id="0419">More detailed information can be obtained by clicking &lt;<b>View Log&gt;</b>. The process can be paused and restarted as needed, or stopped altogether by clicking &lt;<b>Close&gt;</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 &lt;<b>Download&gt;</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 </Comment2>
     1060</Comment>
    10581061</NumberedItem>
    10591062<NumberedItem>
     
    12491252<Text id="0480">Title metadata--their title is the name of the metadata value associated with that bookshelf--they do not have </Text>
    12501253<Text id="0481">ex.Source metadata, so it comes out blank.</Text>
    1251 </Comment></NumberedItem>
     1254</Comment>
     1255</NumberedItem>
    12521256<NumberedItem>
    12531257<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>
     
    12981302</Format>
    12991303<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 <Comment2>
     1304<Comment>
    13011305<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>
    13031308<NumberedItem>
    13041309<Text id="0498">Go to the <b>Create </b>panel, click &lt;<b>Preview</b>&gt;, and examine the subject hierarchy again to see the effect of your changes. </Text>
     
    13801385<Comment>
    13811386<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>
    13831389<NumberedItem>
    13841390<Text id="0528"><b>Build</b> the collection and <b>preview</b> the result.</Text>
     
    14081414<NumberedItem>
    14091415<Text id="0536">From the <b>General</b> section of the <b>Design</b> panel, click the <b>&lt;Browse&gt;</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 &lt;<b>Open</b>&gt;.</Text>
    1410 <Comment2>
     1416<Comment>
    14111417<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 </Comment2>
     1418</Comment>
    14131419</NumberedItem>
    14141420<NumberedItem>
     
    19151921<Text id="0692">append</Text>
    19161922<Format>{If}{[numleafdocs],&lt;td&gt;([numleafdocs] items)&lt;/td&gt;}</Format>
    1917 <Comment2>
     1923<Comment>
    19181924<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 </Comment2>
     1925</Comment>
    19201926</NumberedItem>
    19211927<Heading>
     
    19291935<Format>&lt;center&gt;<br/>  &lt;table width=_pagewidth_&gt;<br/>  &lt;tr&gt;<br/>  &lt;td valign=top&gt;[srclink][screenicon][/srclink]&lt;/td&gt;<br/>  &lt;td&gt;[Text]&lt;/td&gt;<br/>  &lt;/tr&gt;<br/>  &lt;/table&gt;<br/> &lt;/center&gt;</Format>
    19301936<Text id="0697">(available as niupepa\doc_tweak.txt)</Text>
    1931 <Comment2>
     1937<Comment>
    19321938<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 </Comment2>
     1939</Comment>
    19341940</NumberedItem>
    19351941<NumberedItem>
     
    20122018</Format>
    20132019<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 &lt;<b>Replace Format</b>&gt; when finished</Text>
    2014 <Comment2>
     2020<Comment>
    20152021<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>
    20172024<NumberedItem>
    20182025<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>
    20192026<Format>&lt;h3&gt;[Subject]&lt;/h3&gt;</Format>
    2020 <Comment2>
     2027<Comment>
    20212028<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--&gt;</Text>
    20222029<Text id="0724">oai--&gt;</Text>
    20232030<Text id="0725"> JCDLPICS--&gt;</Text>
    20242031<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>
    20262034<NumberedItem>
    20272035<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>
     
    20872095<Text id="0745">Change directory into the folder containing the OAI Services Provider collection you built in the last exercise.</Text>
    20882096<Format>cd collect\oaiservi</Format>
    2089 <Comment2>
     2097<Comment>
    20902098<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>
    20922101<NumberedItem>
    20932102<Text id="0747">Run <i>perl -S importfrom.pl oaiservi</i></Text>
    20942103<Comment>
    20952104<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>
    20972107<NumberedItem>
    20982108<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.