Changeset 13135
- Timestamp:
- 2006-10-19T17:09:36+13:00 (18 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/gsdl-documentation/tutorials/xml-source/tutorial_en.xml
r13119 r13135 875 875 </NumberedItem> 876 876 <NumberedItem> 877 <Text id="0310b">Modify the <AutoText key="metadata::ex.Title"/> index to include <AutoText key="metadata::dc.Title"/> by selecting the index in the <AutoText key="glidict::CDM.IndexManager.Indexes"/> box and clicking <AutoText key="glidict::CDM.IndexManager.Edit_Index" type="button"/>. Select <AutoText key="metadata::dc.Title"/> from the list of metadata, and click <AutoText key="glidict::CDM.IndexManager. MGPP.Replace_Index" type="button"/>. Searching this index will search both dc.Title and ex.Title metadata. If you want to restrict searching to just the manually added dc.Title metadata, edit the index again and deselect <AutoText key="metadata::ex.Title"/> from the list of metadata.</Text>877 <Text id="0310b">Modify the <AutoText key="metadata::ex.Title"/> index to include <AutoText key="metadata::dc.Title"/> by selecting the index in the <AutoText key="glidict::CDM.IndexManager.Indexes"/> box and clicking <AutoText key="glidict::CDM.IndexManager.Edit_Index" type="button"/>. Select <AutoText key="metadata::dc.Title"/> from the list of metadata, and click <AutoText key="glidict::CDM.IndexManager.Replace_Index" type="button"/>. Searching this index will search both dc.Title and ex.Title metadata. If you want to restrict searching to just the manually added dc.Title metadata, edit the index again and deselect <AutoText key="metadata::ex.Title"/> from the list of metadata.</Text> 878 878 </NumberedItem> 879 879 <NumberedItem> … … 907 907 </Heading> 908 908 <NumberedItem> 909 <Text id=" ">The default display text for the indexes in the drop-down list on the search page contains the content of the index. Now we will change this display text to make it nicer. Go to the <AutoText key="glidict::GUI.Format"/> panel by clicking its tab. This panel is split into several sections, each controlling some aspect of collection presentation.</Text>910 </NumberedItem> 911 <NumberedItem> 912 <Text id=" ">Select <AutoText key="glidict::CDM.GUI.SearchMetadata"/> in the left hand list. This pane allows you to modify what text is displayed for the drop-down lists in the search form (indexes, subcollections, levels etc). Set the <AutoText key="glidict::CDM.SearchMetadataManager.Component_Name"/> for the <AutoText text="dc.Title,Title"/> index to be "titles", and that for the <AutoText text="dc.Creator"/> index to be "creators". Preview the collection by clicking the <AutoText key="glidict::CreatePane.Preview_Collection"/>. The search form should display the new text.</Text>909 <Text id="0321-2">The default display text for the indexes in the drop-down list on the search page contains the content of the index. Now we will change this display text to make it nicer. Go to the <AutoText key="glidict::GUI.Format"/> panel by clicking its tab. This panel is split into several sections, each controlling some aspect of collection presentation.</Text> 910 </NumberedItem> 911 <NumberedItem> 912 <Text id="0321-3">Select <AutoText key="glidict::CDM.GUI.SearchMetadata"/> in the left hand list. This pane allows you to modify what text is displayed for the drop-down lists in the search form (indexes, subcollections, levels etc). Set the <AutoText key="glidict::CDM.SearchMetadataManager.Component_Name"/> for the <AutoText text="dc.Title,Title"/> index to be "titles", and that for the <AutoText text="dc.Creator"/> index to be "creators". Preview the collection by clicking the <AutoText key="glidict::CreatePane.Preview_Collection"/>. The search form should display the new text.</Text> 913 913 </NumberedItem> 914 914 <Heading> … … 1377 1377 </Content> 1378 1378 </Tutorial> 1379 <!-- ** here -->1380 1379 <Tutorial id="enhanced_html_collection"> 1381 1380 <Title> … … 1383 1382 </Title> 1384 1383 <Prerequisite id="large_html_collection"/> 1385 <Version initial="2.60" current="2.7 0w"/>1384 <Version initial="2.60" current="2.71"/> 1386 1385 <Content> 1387 1386 <Comment> … … 1450 1449 </NumberedItem> 1451 1450 <NumberedItem> 1452 <Text id="0451">Having defined the subcollection s, we partition the index into corresponding parts. Click the <AutoText key="glidict::CDM.SubcollectionManager.Subindex_Controls"/> tab. Select the first subcollection and give it the name <b>citizens</b>; click <AutoText key="glidict::CDM.SubcollectionIndexManager.Add_Subindex" type="button"/>. Repeat for the other three subcollections, naming their partitions <b>monarchs</b>, <b>others</b> and <b>relatives</b>.</Text>1453 <Text id="0451a">The order they appear in the <AutoText key="glidict::CDM.SubcollectionIndexManager.Subindexes"/> list os the order they will appear in the drop down menu on the search page. You can change the order by using the <AutoText key="glidict::CDM.Move.Move_Up" type="button"/> and <AutoText key="glidict::CDM.Move.Move_Down" type="button"/> buttons.</Text>1451 <Text id="0451">Having defined the subcollection filters, we partition the index into corresponding parts. Click the <AutoText key="glidict::CDM.SubcollectionManager.Subindex_Controls"/> tab. Select the citizens subcollection and click <AutoText key="glidict::CDM.SubcollectionIndexManager.Add_Subindex" type="button"/>. Next select monarchs, and click <AutoText key="glidict::CDM.SubcollectionIndexManager.Add_Subindex" type="button"/>. Repeat for the other two subcollections, so that you end up with four partitions, one based on each subcollection filter.</Text> 1452 <Text id="0451a">The order they appear in the <AutoText key="glidict::CDM.SubcollectionIndexManager.Subindexes"/> list is the order they will appear in the drop down menu on the search page. You can change the order by using the <AutoText key="glidict::CDM.Move.Move_Up" type="button"/> and <AutoText key="glidict::CDM.Move.Move_Down" type="button"/> buttons.</Text> 1454 1453 </NumberedItem> 1455 1454 <NumberedItem> … … 1460 1459 </NumberedItem> 1461 1460 <NumberedItem> 1462 <Text id="0453">To allow users to search the collection as a whole as well as each subcollection individually, return to the <AutoText key="glidict::CDM.GUI.Subcollections"/> section of the <AutoText key="glidict::GUI.Design"/> panel and select the <AutoText key="glidict::CDM.SubcollectionManager.Subindex_Controls"/> tab. Type <b>all</b> into the <AutoText key="glidict::CDM.SubcollectionIndexManager.PartitionName"/> and select all four subcollections by checking their boxes. Click <AutoText key="glidict::CDM.SubcollectionIndexManager.Add_Subindex" type="button"/>.</Text>1461 <Text id="0453">To allow users to search the collection as a whole as well as each subcollection individually, return to the <AutoText key="glidict::CDM.GUI.Subcollections"/> section of the <AutoText key="glidict::GUI.Design"/> panel and select the <AutoText key="glidict::CDM.SubcollectionManager.Subindex_Controls"/> tab. Select all four subcollections by checking their boxes and click <AutoText key="glidict::CDM.SubcollectionIndexManager.Add_Subindex" type="button"/>.</Text> 1463 1462 </NumberedItem> 1464 1463 <NumberedItem> … … 1469 1468 </NumberedItem> 1470 1469 <NumberedItem> 1470 <Text id="0455a">The text in the drop down box on the search page is based on the filters each partition was built on. To change the text that is displayed, go to the <AutoText key="glidict::CDM.GUI.SearchMetadata"/> section of the <AutoText key="glidict::GUI.Format"/> panel. The single filter partitions have sensible default text, but the combined partition does not. Set the <AutoText key="glidict::CDM.SearchMetadataManager.Component_Name"/> for the combined partition to "all". <b>Preview</b> the collection.</Text> 1471 </NumberedItem> 1472 <NumberedItem> 1471 1473 <Text id="0456">Return to <AutoText key="glidict::Preferences.Mode.Librarian"/> mode, using <AutoText key="glidict::Menu.File_Options"/> (on the <AutoText key="glidict::Menu.File"/> menu).</Text> 1472 1474 </NumberedItem> … … 1481 1483 </NumberedItem> 1482 1484 <NumberedItem> 1483 <Text id="0464">Preview the newly rebuilt collection's <AutoText key="coredm::_Global:labelTitle_"/> 1484 page. Previously this listed more than a dozen pages per letter of the alphabet, but now there are just three—the first three files encountered by the building process.</Text> 1485 <Text id="0464">Preview the newly rebuilt collection's <AutoText key="coredm::_Global:labelTitle_"/> page. Previously this listed more than a dozen pages per letter of the alphabet, but now there are just three—the first three files encountered by the building process.</Text> 1485 1486 </NumberedItem> 1486 1487 <NumberedItem> … … 1494 1495 </Title> 1495 1496 <Prerequisite id="large_html_collection"/> 1496 <Version initial="2.60" current="2.7 0w"/>1497 <Version initial="2.60" current="2.71"/> 1497 1498 <Content> 1498 1499 <NumberedItem> 1499 <Text id="0468">Open up your <b>tudor</b> collection, go to the <AutoText key="glidict::GUI. Design"/> panel (by clicking on its tab) and select <AutoText key="glidict::CDM.GUI.Formats"/> from the left-hand list. Leave the editing controls at their default value, so that <AutoText key="glidict::CDM.FormatManager.Feature"/> remains blankand <AutoText text="VList"/> is selected as the <AutoText key="glidict::CDM.FormatManager.Part"/>. The text in the <AutoText key="glidict::CDM.FormatManager.Editor"/> box reads as follows:</Text>1500 <Text id="0468">Open up your <b>tudor</b> collection, go to the <AutoText key="glidict::GUI.Format"/> panel (by clicking on its tab) and select <AutoText key="glidict::CDM.GUI.Formats"/> from the left-hand list. Leave the editing controls at their default value, so that <AutoText key="glidict::CDM.FormatManager.Feature"/> displays <AutoText key="glidict::CDM.FormatManager.AllFeatures" type="italics"/> and <AutoText text="VList"/> is selected as the <AutoText key="glidict::CDM.FormatManager.Part"/>. The text in the <AutoText key="glidict::CDM.FormatManager.Editor"/> box reads as follows:</Text> 1500 1501 <Format> 1501 1502 <td valign=top>[link][icon][/link]</td><br/> … … 1510 1511 </Indent> 1511 1512 <Text id="0472">for a particular document whose <i>Title</i> metadata is <AutoText text="A discussion of question five from Tudor Quiz: Henry VIII"/> and whose <i>Source</i> metadata is <AutoText text="quizstuff.html"/>.</Text> 1512 <Text id="0473">This format appears in the search results list, in the <AutoText key="coredm::_Global:labelTitle_"/> list, and also when you get down to individual documents in the <AutoText key="coredm::_Global:label Title_"/> hierarchy. This is Greenstone's default format statement.</Text>1513 </NumberedItem> 1514 <Comment> 1515 <Text id="0474">Greenstone's default format statement is complex —even baroque—because it is designed to produce something reasonable under almost any conditions, and also because for practical reasons it needs to be backwards compatible with legacy collections.</Text>1513 <Text id="0473">This format appears in the search results list, in the <AutoText key="coredm::_Global:labelTitle_"/> list, and also when you get down to individual documents in the <AutoText key="coredm::_Global:labelSubject_"/> hierarchy. This is Greenstone's default format statement.</Text> 1514 </NumberedItem> 1515 <Comment> 1516 <Text id="0474">Greenstone's default format statement is complex because it is designed to produce something reasonable under almost any conditions, and also because for practical reasons it needs to be backwards compatible with legacy collections.</Text> 1516 1517 </Comment> 1517 1518 <NumberedItem> … … 1523 1524 </td> 1524 1525 </Format> 1525 <Text id="0475a">Remember to click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text>1526 1526 <Text id="0476"><b>Preview</b> the result (you don't need to build the collection, because changes to format statements take effect immediately). Look at some search results and at the <AutoText key="coredm::_Global:labelTitle_"/> list. They are just the same as before! Under most circumstances this far simpler format statement is entirely equivalent to Greenstone's more complex default. </Text> 1527 1527 <Comment> … … 1530 1530 </NumberedItem> 1531 1531 <NumberedItem> 1532 <Text id="0482">In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI. Design"/> panel, the <AutoText key="glidict::CDM.FormatManager.Feature"/> menu (just above <AutoText key="glidict::CDM.FormatManager.Part"/> 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 <AutoText key="glidict::CDM.FormatManager.Feature"/> menu can be used to restrict a format statement to a specific one of these lists; when it's blank, the <AutoText text="VList" /> specification applies throughout. We will override this format statement for the hierarchical <i>subject</i> classifier. In the <AutoText key="glidict::CDM.FormatManager.Feature"/> menu, scroll down to the item that says</Text>1532 <Text id="0482">In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, the <AutoText key="glidict::CDM.FormatManager.Feature"/> menu (just above <AutoText key="glidict::CDM.FormatManager.Part"/> menu) displays <AutoText key="glidict::CDM.FormatManager.AllFeatures" type="italics"/>. 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 <AutoText key="glidict::CDM.FormatManager.Feature"/> menu can be used to restrict a format statement to a specific one of these lists. We will override this format statement for the hierarchical <i>subject</i> classifier. In the <AutoText key="glidict::CDM.FormatManager.Feature"/> menu, scroll down to the item that says</Text> 1533 1533 <Indent> 1534 1534 CL2: Hierarchy -metadata dc.Subject and Keywords 1535 1535 </Indent> 1536 1536 <Text id="0483">and select it. This is the format statement that affects the second classifier (i.e., "CL2"), which is a <AutoText text="Hierarchy"/> classifier based on <b>dc.Subject and Keywords</b> metadata.</Text> 1537 <Text id="0483a">Click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/> to add this format statement to the collection.</Text> 1537 1538 <Text id="0484">Edit the <AutoText key="glidict::CDM.FormatManager.Editor"/> box below to read</Text> 1538 1539 <Format> … … 1540 1541 <td>[ex.Title]</td> 1541 1542 </Format> 1542 <Text id="0485">and click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/>.</Text> 1543 </NumberedItem> 1544 <NumberedItem> 1545 <Text id="0486">Now go to the <AutoText key="glidict::GUI.Create"/> panel and click <AutoText key="glidict::CreatePane.Preview_Collection" type="button"/>. First, the offending "()" has disappeared from the bookshelves. Second, when you get down to a list of documents in the subject hierarchy, the filename does not appear beside the title, because <AutoText key="metadata::ex.Source"/> is not specified in the format statement and this format statement applies to all nodes in the <i>subject</i> classifier. Note that the search results and titles lists have not changed: they still display the filename underneath the title.</Text> 1546 </NumberedItem> 1547 <NumberedItem> 1548 <Text id="0487">Let's change the search results format so that <i>dc.Subject and Keywords</i> metadata is displayed here instead of the filename. In the <AutoText key="glidict::CDM.FormatManager.Feature"/> menu (under <AutoText key="glidict::CDM.GUI.Formats"/> on the <AutoText key="glidict::GUI.Design"/> panel), scroll down to the item <AutoText text="Search"/> and select it. Change the <AutoText key="glidict::CDM.FormatManager.Editor"/> box below to read</Text> 1543 </NumberedItem> 1544 <NumberedItem> 1545 <Text id="0486"><b>Preview</b> the <AutoText key="coredm::_Global:labelSubject_"/> list in the collection. First, the offending "()" has disappeared from the bookshelves. Second, when you get down to a list of documents in the subject hierarchy, the filename does not appear beside the title, because <AutoText key="metadata::ex.Source"/> is not specified in the format statement and this format statement applies to all nodes in the <i>subject</i> classifier. Note that the search results and titles lists have not changed: they still display the filename underneath the title.</Text> 1546 </NumberedItem> 1547 <NumberedItem> 1548 <Text id="0487">Let's change the search results format so that <AutoText key="metadata::dc.Subject"/> metadata is displayed here instead of the filename. In the <AutoText key="glidict::CDM.FormatManager.Feature"/> menu (under <AutoText key="glidict::CDM.GUI.Formats"/> on the <AutoText key="glidict::GUI.Format"/> panel), scroll down to the item <AutoText text="Search"/> and select it. Click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/> to add this format statement to the collection. Change the <AutoText key="glidict::CDM.FormatManager.Editor"/> box below to read</Text> 1549 1549 <Format> 1550 1550 <td>[link][icon][/link]</td><br/> … … 1553 1553 </td><br/> 1554 1554 </Format> 1555 <Text id="0488">and click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/>.</Text> 1556 </NumberedItem> 1557 <NumberedItem> 1558 <Text id="0489">To insert the <b>[dc.Subject]</b>, position the cursor at the appropriate point and either type it in, or use the <AutoText key="glidict::CDM.FormatManager.Variable"/> drop down menu—the one that says <AutoText text="[Text]"/>. Make it say <b>[dc.Subject]</b> and click <AutoText key="glidict::CDM.FormatManager.Insert" type="button"/> to insert this into the <AutoText key="glidict::CDM.FormatManager.Editor"/>. This menu shows many of the things that you can put in square brackets in the format statement.</Text> 1559 </NumberedItem> 1560 <NumberedItem> 1561 <Text id="0490">Now go to the <AutoText key="glidict::GUI.Create"/> panel and click <AutoText key="glidict::CreatePane.Preview_Collection" type="button"/>. Documents in the search results list will be displayed like this:</Text> 1555 </NumberedItem> 1556 <NumberedItem> 1557 <Text id="0489">To insert the <AutoText text="[dc.Subject]"/>, position the cursor at the appropriate point and either type it in, or select it from the <AutoText key="glidict::CDM.FormatManager.Insert_Variable"/> drop down menu. This menu shows many of the things that you can put in square brackets in the format statement.</Text> 1558 </NumberedItem> 1559 <NumberedItem> 1560 <Text id="0490"><b>Preview</b> the collection. Documents in the search results list will be displayed like this:</Text> 1562 1561 <table><tr><td><img width='15' height='20' src="../tutorial_files/itext.gif" /></td><td width='408' valign='top'>A discussion of question five from Tudor Quiz: Henry VIII <br/> 1563 1562 Tudor period|Others</td></tr></table> 1564 <Text id="0493">(The vertical bar appears because this < i>dc.Subject and Keywords</i> metadata is hierarchical metadata. Unfortunately there is no way to get at individual components of the hierarchy. For most metadata, such as title and author, this isn't a problem.)</Text>1565 </NumberedItem> 1566 <NumberedItem> 1567 <Text id="0494">Finally, let's return to the < i>subjects</i> hierarchy and learn how to do different things to the bookshelves and to the documents themselves. In the <AutoText key="glidict::CDM.FormatManager.Feature"/> menu, re-select the item</Text>1563 <Text id="0493">(The vertical bar appears because this <AutoText key="metadata::dc.Subject"/> metadata is hierarchical metadata. Unfortunately there is no way to get at individual components of the hierarchy. For most metadata, such as title and author, this isn't a problem.)</Text> 1564 </NumberedItem> 1565 <NumberedItem> 1566 <Text id="0494">Finally, let's return to the <AutoText key="coredm::_Global:labelSubject_" type="italics"/> hierarchy and learn how to do different things to the bookshelves and to the documents themselves. In the <AutoText key="glidict::CDM.FormatManager.Feature"/> menu, re-select the item</Text> 1568 1567 <Indent> 1569 CL2: Hierarchy -metadata dc.Subject and Keywords1568 CL2: Hierarchy -metadata <AutoText key="metadata::dc.Subject" type="plain"/> 1570 1569 </Indent> 1571 1570 <Text id="0495">Edit the <AutoText key="glidict::CDM.FormatManager.Editor"/> box below to read</Text> … … 1576 1575 </td> 1577 1576 </Format> 1578 <Text id="0496"> and click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>. Again, you can insert the items in square brackets by selecting them from the <AutoText key="glidict::CDM.FormatManager.Variable"/> drop down box (don't forget to click <AutoText key="glidict::CDM.FormatManager.Insert" type="button"/>).</Text>1577 <Text id="0496">Again, you can insert the items in square brackets by selecting them from the <AutoText key="glidict::CDM.FormatManager.Insert_Variable"/> drop down box.</Text> 1579 1578 <Comment> 1580 1579 <Text id="0497">The <AutoText text="If"/> statement tests the value of the variable <AutoText text="numleafdocs"/>. 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 <AutoText text="If"/> is special—otherwise the word <AutoText text="If" type="quoted"/> itself would be output.</Text> … … 1582 1581 </NumberedItem> 1583 1582 <NumberedItem> 1584 <Text id="0498"> Go to the <AutoText key="glidict::GUI.Create"/> panel, click <AutoText key="glidict::CreatePane.Preview_Collection" type="button"/>, and examine the subject hierarchy again to see the effect of your changes. Bookshelves should say <AutoText text="Bookshelf title:"/> and then the title, while documents willdisplay <AutoText text="Title:"/> and the title. Note that the number of documents in the bookshelf is not displayed: we are using <Format>[numleafdocs]</Format> to test what kind of item in the list we are at, but we are not displaying it.</Text>1583 <Text id="0498"><b>Preview</b> the collection and examine the subject hierarchy again to see the effect of your changes. Bookshelves should say <AutoText text="Bookshelf title:"/> and then the title, while documents will display <AutoText text="Title:"/> and the title. Note that the number of documents in the bookshelf is not displayed: we are using <Format>[numleafdocs]</Format> to test what kind of item in the list we are at, but we are not displaying it.</Text> 1585 1584 </NumberedItem> 1586 1585 </Content> … … 1636 1635 <NumberedItem> 1637 1636 <Text id="st-7">Open the Greenstone demo collection in the Librarian Interface. In the <AutoText key="glidict::CDM.GUI.Plugins"/> section of the <AutoText key="glidict::GUI.Design"/> panel, note that <AutoText text="HTMLPlug"/> has the <AutoText text="description_tags"/> option set. This option is needed when Section tags are used in the source documents.</Text> 1638 <Text id="st-8">The <AutoText text="metadata_fields"/> option is not valid when <AutoText text="description_tags"/> is set—all metadata is expected to be in the Section tags if they are being used.</Text>1639 1637 </NumberedItem> 1640 1638 <NumberedItem> … … 1647 1645 <Text id="0411">Downloading files from the web</Text> 1648 1646 </Title> 1649 <Version initial="2.60" current="2.7 0w"/>1647 <Version initial="2.60" current="2.71"/> 1650 1648 <Content> 1651 1649 <Comment> … … 1661 1659 </NumberedItem> 1662 1660 <NumberedItem> 1663 <Text id="0415a">In the <AutoText key="glidict::GUI.Download"/> panel, enter this URL</Text> 1661 <Text id="0415a">Go to the <AutoText key="glidict::GUI.Download"/> panel by clicking its tab. There are four download types listed on the left hand side. For this exercise, we only use the <AutoText key="glidict::DOWNLOAD.MODE.WebDownload"/> type. Make sure this is selected in the list.</Text> 1662 <Text id="0415b">Enter this URL</Text> 1664 1663 <Link>http://englishhistory.net/tudor/citizens/</Link> 1665 <Text id="0417">into the <AutoText key="glidict::Mirroring.Source_URL"/> box. There are several options that govern how the download process proceeds. To copy just the <i>citizens</i> section of the website, select <AutoText key="glidict::Mirroring.Higher_Directories"/>. If you don't do this (or if you miss out the terminating "/"), the downloading process will follow links to other areas of the <i>englishhistory.net</i> website and grab those as well. Set <AutoText key="glidict::Mirroring.Download_Depth"/> to <AutoText key="glidict::Mirroring.Download_Depth.Unlimited"/>—we want to follow as many links as necessary to download all the pages.</Text>1666 </NumberedItem> 1667 <NumberedItem> 1668 <Text id="0417a">If your computer is behind a firewall or proxy server, you will need to edit the proxy settings in the Librarian Interface. Open the <AutoText key="glidict::Preferences.Connection"/> tab in <Menu><AutoText key="glidict::Menu.File"/> → <AutoText key="glidict::Menu.File_Options"/></Menu> and switch on the <AutoText key="glidict::Preferences.Connection.Use_Proxy"/> checkbox. Enter the proxy server address and port number in the <AutoText key="glidict::Preferences.Connection.Proxy_Host"/> and <AutoText key="glidict::Preferences.Connection.Proxy_Port"/> boxes. Click <AutoText key="glidict::General.OK" type="button"/>.</Text>1669 </NumberedItem> 1670 <NumberedItem> 1671 <Text id="0418">Now click <AutoText key="glidict::Mirroring.Download" type="button"/>. If you have set proxy information in <AutoText key="glidict::Menu.File_Options"/>, a popup will ask for you user name and password. Once the download has started, a progress bar appears in the lower half of the panel that reports on how the downloading process is doing.</Text>1672 <Comment> 1673 <Text id="0419">More detailed information can be obtained by clicking <AutoText key="glidict::Mirroring.DownloadJob.Log" type="button"/>. The process can be paused and restarted as needed, or stopped altogether by clicking <AutoText key="glidict::Mirroring.DownloadJob.Close" type="button"/>. 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 <AutoText key="glidict::Mirroring.Source_URL"/> box and <AutoText key="glidict::Mirroring.Download" type="button"/> 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>1664 <Text id="0417">into the <AutoText text="url"/> box. There are several other options that govern how the download process proceeds. To see a description of the option, hover the mouse over the option and a tooltip will appear. To copy just the <i>citizens</i> section of the website, switch on the <AutoText text="below"/> option by checking its box. If you don't do this (or if you miss out the terminating "/" in the URL), the downloading process will follow links to other areas of the <i>englishhistory.net</i> website and grab those as well.</Text> 1665 </NumberedItem> 1666 <NumberedItem> 1667 <Text id="0417a">If your computer is behind a firewall or proxy server, you will need to edit the proxy settings in the Librarian Interface. Click the <AutoText key="glidict::Mirroring.Preferences" type="button"/> button. Switch on the <AutoText key="glidict::Preferences.Connection.Use_Proxy"/> checkbox. Enter the proxy server address and port number in the <AutoText key="glidict::Preferences.Connection.Proxy_Host"/> and <AutoText key="glidict::Preferences.Connection.Proxy_Port"/> boxes. Click <AutoText key="glidict::General.OK" type="button"/>.</Text> 1668 </NumberedItem> 1669 <NumberedItem> 1670 <Text id="0418">Now click <AutoText key="glidict::Mirroring.Download" type="button"/>. If you have set proxy information in <AutoText key="glidict::Menu.File_Options"/>, a popup will ask for your user name and password. Once the download has started, a progress bar appears in the lower half of the panel that reports on how the downloading process is doing.</Text> 1671 <Comment> 1672 <Text id="0419">More detailed information can be obtained by clicking <AutoText key="glidict::Mirroring.DownloadJob.Log" type="button"/>. The process can be paused and restarted as needed, or stopped altogether by clicking <AutoText key="glidict::Mirroring.DownloadJob.Close" type="button"/>. 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 <AutoText text="url"/> box and <AutoText key="glidict::Mirroring.Download" type="button"/> 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> 1674 1673 </Comment> 1675 1674 </NumberedItem> … … 1688 1687 </Title> 1689 1688 <Prerequisite id="downloading_from_internet"/> 1690 <Version initial="2.60" current="2.7 0w"/>1689 <Version initial="2.60" current="2.71"/> 1691 1690 <Content> 1692 1691 <NumberedItem> … … 1707 1706 </NumberedItem> 1708 1707 <NumberedItem> 1709 <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. Design"/> panel, select the <AutoText key="glidict::CDM.GUI.Formats"/> section and edit the <AutoText text="VList" /> format statement by replacing</Text>1708 <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 <AutoText text="VList" /> format statement by replacing</Text> 1710 1709 <Format>[link][icon][/link]</Format> 1711 1710 <Text id="0431">with</Text> 1712 1711 <Format>[weblink][webicon][/weblink]</Format> 1713 <Text id="0432">Click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/> to commit the change.</Text>1714 1712 </NumberedItem> 1715 1713 <NumberedItem> … … 1723 1721 </Title> 1724 1722 <SampleFiles folder="marc"/> 1725 <Version initial="2.60" current="2.7 0w"/>1723 <Version initial="2.60" current="2.71"/> 1726 1724 <Content> 1727 1725 <Comment> 1728 <Text id="0520a">This exercise looks at adding fielded searching to a collection. Fielded searching is best used for metadata rich collections. Here we use bibliographic data in MARC format. We also "explode" the database, enabling editing of the metadata with the Librarian Interface.</Text> 1729 </Comment> 1730 <NumberedItem> 1731 <Text id="0521">Start a new collection called <b>Beatles Bibliography</b> which will contain a collection of MARC records on the Beatles, from the US Library of Congress. Enter the requested information and base it on <AutoText key="glidict::NewCollectionPrompt.NewCollection"/>. There is no need to include any metadata sets because the metadata extracted from the MARC records will appear as extracted metadata. Deselect the <b>Dublin Core</b> metadata set, and click <AutoText key="glidict::General.OK" type="button"/>.</Text> 1732 <Text id="0521a">A <AutoText key="glidict::NoMetadataSetsSelected.Title"/> warning message will pop-up, alerting you to the fact that you won't be able to manually assign metadata to the collection. In this collection, all the metadata will come from the MARC file; click <AutoText key="glidict::General.OK" type="button"/> to continue. (If you don't want to see this popup again, tick the <AutoText key="glidict::WarningDialog.Dont_Show_Again"/> checkbox.)</Text> 1726 <Text id="0520a">This exercise looks at using fielded searching in a collection. Fielded searching is best used for metadata rich collections. Here we use bibliographic data in MARC format. We also "explode" the database, enabling editing of the metadata with the Librarian Interface.</Text> 1727 </Comment> 1728 <NumberedItem> 1729 <Text id="0521">Start a new collection called <b>Beatles Bibliography</b> which will contain a collection of MARC records on the Beatles, from the US Library of Congress. Enter the requested information and base it on <AutoText key="glidict::NewCollectionPrompt.NewCollection"/>.</Text> 1733 1730 </NumberedItem> 1734 1731 <NumberedItem> … … 1756 1753 </NumberedItem> 1757 1754 <Heading> 1758 <Text id="0531">Adding fielded searching</Text> 1759 </Heading> 1760 <NumberedItem> 1761 <Text id="0532">In the <AutoText key="glidict::GUI.Design"/> panel select <AutoText key="glidict::CDM.GUI.SearchTypes"/> from the left-hand list and activate the <AutoText key="glidict::CDM.SearchTypeManager.Enable"/> option.</Text> 1762 </NumberedItem> 1763 <NumberedItem> 1764 <Text id="0532a">Add form searching to the collection by selecting <AutoText text="form"/> in the <AutoText key="glidict::CDM.SearchTypeManager.SearchType_Selection"/> menu and clicking <AutoText key="glidict::CDM.SearchTypeManager.Add" type="button"/>. Remove plain searching by selecting <AutoText text="plain"/> in the <AutoText key="glidict::CDM.SearchTypeManager.Assigned"/> list, and clicking <AutoText key="glidict::CDM.SearchTypeManager.Remove" type="button"/>.</Text> 1765 </NumberedItem> 1766 <NumberedItem> 1767 <Text id="0533"><b>Build</b> the collection once again, and <b>preview</b> the results. Notice that the collection's home page no longer includes a query box. (This is because the search form is too big to fit here nicely.) To search, you have to click <AutoText key="coredm::_Global:labelSearch_"/> in the navigation bar. Note that the <AutoText key="coredm::_Global:linktextPREFERENCES_" type="italics"/> page has changed to control the advanced searching options.</Text> 1755 <Text id="0531">Using fielded searching</Text> 1756 </Heading> 1757 <NumberedItem> 1758 <Text id="0531a">Collections built with MGPP (the default indexer) provide the option of fielded searching. In the browser, go to the <AutoText key="coredm::_Global:linktextPREFERENCES_" type="italics"/> page. You will notice that there is a <AutoText key="coredm::_preferences:textsearchtype_" /> option which enables you to switch between "normal" and "fielded" search. Change to fielded search now and click on the <AutoText key="coredm::_Global:labelSearch_"/>. The search form has changed to a fielded form.</Text> 1759 </NumberedItem> 1760 <NumberedItem> 1761 <Text id="0531b">You can specify which search form types are available for a particular collection, and which one is the default using the <AutoText text="SearchTypes"/> format statement. In the <AutoText key="glidict::GUI.Format"/> panel select <AutoText key="glidict::CDM.GUI.Formats"/> from the left-hand list. Select the <AutoText text="SearchTypes"/> format statement from the list of assigned formats, and set the contents to <AutoText text="form"/>. This will make only fielded searching available for this collection.</Text> 1762 <Comment> 1763 <Text id="0531c">Search type options include <AutoText text="form"/> and <AutoText text="plain"/>. You can specify one or both separated by a comma. If both are specified, the first one is used as the default: this is the one that the user will see when they first enter the collection.</Text> 1764 </Comment> 1765 </NumberedItem> 1766 <NumberedItem> 1767 <Text id="0533"><b>Preview</b> the collection again. Notice that the collection's home page no longer includes a query box. (This is because the search form is too big to fit here nicely.) To search, you have to click <AutoText key="coredm::_Global:labelSearch_"/> in the navigation bar. Note that the <AutoText key="coredm::_Global:linktextPREFERENCES_" type="italics"/> page has changed so that the "normal" query style is no longer offered.</Text> 1768 1768 </NumberedItem> 1769 1769 <NumberedItem> … … 1771 1771 </NumberedItem> 1772 1772 <NumberedItem> 1773 <Text id="0533c">In the <AutoText key="glidict::GUI.Design"/> panel, go to the <AutoText key="glidict::CDM.GUI.Indexes"/> section. Add an index on <b>subjects</b> by selecting <AutoText key="metadata::ex.Subject"/> from the <AutoText key="glidict::CDM.IndexManager.Source"/> list (and deselecting anything already selected), and giving it a name in the <AutoText key="glidict::CDM.IndexManager.Index_Name"/> box, e.g. "Subject". Click <AutoText key="glidict::CDM.IndexManager.Add_Index" type="button"/>.</Text> 1774 </NumberedItem> 1775 <NumberedItem> 1776 <Text id="0533d"><b>Rebuild</b> the collection and <b>preview</b> the results. Notice the extra fields in the <AutoText key="coredm::_query:textinfield_"/> drop-down menus in the search form. You can do quite complicated queries by searching for words in different fields at the same time.</Text> 1773 <Text id="0533c">In the <AutoText key="glidict::GUI.Design"/> panel, go to the <AutoText key="glidict::CDM.GUI.Indexes"/> section. Add a new index based on <AutoText key="metadata::ex.Subject"/> by clicking <AutoText key="glidict::CDM.IndexManager.New_Index" type="button"/>, selecting <AutoText key="metadata::ex.Subject"/> in the list of metadata, and clicking <AutoText key="glidict::CDM.IndexManager.Add_Index" type="button"/>.</Text> 1774 </NumberedItem> 1775 <NumberedItem> 1776 <Text id="0533d"><b>Rebuild</b> the collection and <b>preview</b> the results. Notice the extra field in the <AutoText key="coredm::_query:textinfield_"/> drop-down menus in the search form. You can do quite complicated queries by searching for words in different fields at the same time.</Text> 1777 </NumberedItem> 1778 <NumberedItem> 1779 <Text id="0533e">To change the text that is displayed in the drop-down menus of the search form, go to the <AutoText key="glidict::CDM.GUI.SearchMetadata"/> section of the <AutoText key="glidict::GUI.Format"/> panel. Here you can change the display text for the indexes.</Text> 1777 1780 </NumberedItem> 1778 1781 <Heading> … … 1782 1785 <Text id="0533-3">Go to the <AutoText key="glidict::GUI.Enrich"/> panel and try to see the metadata. It doesn't appear! This is because the metadata is associated with records inside the file, not the file itself.</Text> 1783 1786 <Text id="0533-4">Metadata file types, such as MARC, CDS/ISIS, BibTex etc. can be imported into Greenstone but their metadata cannot be viewed in the Librarian Interface. To edit any metadata you need to go back to the program that created the file.</Text> 1784 <Text id="0533-5">Greenstone provides a newway of <i>exploding</i> a metadata database so that each record appears as an individual document, with viewable and editable metadata. This process is irreversible: once this step has been done, the database is deleted and can no longer be used in its original program.</Text>1787 <Text id="0533-5">Greenstone provides a way of <i>exploding</i> a metadata database so that each record appears as an individual document, with viewable and editable metadata. This process is irreversible: once this step has been done, the database is deleted and can no longer be used in its original program.</Text> 1785 1788 </NumberedItem> 1786 1789 <NumberedItem> … … 1807 1810 <Text id="0533-12b">We need to modify the collection design to take note of these changes.</Text> 1808 1811 <NumberedItem> 1809 <Text id="0533-13">In the <AutoText key="glidict::CDM.GUI.Indexes"/> section, change the Title index to use <AutoText key="metadata::exp.Title"/>: select the Title index in the <AutoText key="glidict::CDM.IndexManager.Indexes"/> list . Deselect <AutoText key="metadata::ex.Title"/> in the <AutoText key="glidict::CDM.IndexManager.Source"/> list, and select <AutoText key="metadata::exp.Title"/>. Click <AutoText key="glidict::CDM.IndexManager.MGPP.Replace_Index" type="button"/>.</Text>1810 </NumberedItem> 1811 <NumberedItem> 1812 <Text id="0533-13a">Remove the <AutoText key="metadata::ex.Subject"/> index by selecting it in the <AutoText key="glidict::CDM.IndexManager.Indexes"/> list and clicking <AutoText key="glidict::CDM.IndexManager.Remove_Index" type="button"/>. Add an index on <AutoText key="metadata::exp.Subject"/>: type "Subject" in the <AutoText key="glidict::CDM.IndexManager.Index_Name"/> field, select <AutoText key="metadata::exp.Subject"/> in the <AutoText key="glidict::CDM.IndexManager.Source"/> list (making sure nothing else is selected), and click <AutoText key="glidict::CDM.IndexManager.Add_Index" type="button"/>.</Text>1812 <Text id="0533-13">In the <AutoText key="glidict::CDM.GUI.Indexes"/> section, change the Title index to use <AutoText key="metadata::exp.Title"/>: select the Title index in the <AutoText key="glidict::CDM.IndexManager.Indexes"/> list and click <AutoText key="glidict::CDM.IndexManager.Edit_Index" type="button"/>. Deselect <AutoText key="metadata::ex.Title"/> in the list of metadata, and select <AutoText key="metadata::exp.Title"/>. Click <AutoText key="glidict::CDM.IndexManager.Replace_Index" type="button"/>.</Text> 1813 </NumberedItem> 1814 <NumberedItem> 1815 <Text id="0533-13a">Remove the <AutoText key="metadata::ex.Subject"/> index by selecting it in the <AutoText key="glidict::CDM.IndexManager.Indexes"/> list and clicking <AutoText key="glidict::CDM.IndexManager.Remove_Index" type="button"/>. Add an index on <AutoText key="metadata::exp.Subject"/>: click <AutoText key="glidict::CDM.IndexManager.New_Index" type="button"/>, select <AutoText key="metadata::exp.Subject"/> in the metadata list, and click <AutoText key="glidict::CDM.IndexManager.Add_Index" type="button"/>.</Text> 1813 1816 </NumberedItem> 1814 1817 <NumberedItem> … … 1816 1819 </NumberedItem> 1817 1820 <NumberedItem> 1818 <Text id="0533-14a">To enable combined searching across all indexes at once, tick the <AutoText key="glidict::CDM.IndexManager.Allfields_Index"/> checkbox, enter an appropriate name in the <AutoText key="glidict::CDM.IndexManager.Index_Name"/> field (e.g. "All Fields", thenclick <AutoText key="glidict::CDM.IndexManager.Add_Index" type="button"/>. Move this to the top of the list using the <AutoText key="glidict::CDM.Move.Move_Up" type="button"/> and <AutoText key="glidict::CDM.Move.Move_Down" type="button"/> buttons, so that it appears first in the drop down list. Click <AutoText key="glidict::CDM.IndexManager.Set_Default" type="button"/> so that it becomes the default field for searching.</Text>1819 </NumberedItem> 1820 <NumberedItem> 1821 <Text id="0533-15">In the <AutoText key="glidict::CDM.GUI.Classifiers"/> section, change the Title <AutoText text="AZList"/> to use <AutoText key="metadata::exp.Title"/> metadata. Double click the 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"/> .</Text>1822 </NumberedItem> 1823 <NumberedItem> 1824 <Text id="0533-16">In the <AutoText key="glidict::CDM.GUI.Formats"/> section , select <AutoText text="VList"/> in the list of assigned format statements.</Text>1821 <Text id="0533-14a">To enable combined searching across all indexes at once, click <AutoText key="glidict::CDM.IndexManager.New_Index" type="button"/>, tick the <AutoText key="glidict::CDM.IndexManager.Allfields_Index"/> checkbox, and click <AutoText key="glidict::CDM.IndexManager.Add_Index" type="button"/>. Move this to the top of the list using the <AutoText key="glidict::CDM.Move.Move_Up" type="button"/> and <AutoText key="glidict::CDM.Move.Move_Down" type="button"/> buttons, so that it appears first in the drop down list. Click <AutoText key="glidict::CDM.IndexManager.Set_Default" type="button"/> so that it becomes the default field for searching.</Text> 1822 </NumberedItem> 1823 <NumberedItem> 1824 <Text id="0533-15">In the <AutoText key="glidict::CDM.GUI.Classifiers"/> section, change the Title <AutoText text="AZList"/> to use <AutoText key="metadata::exp.Title"/> metadata. Double click the 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::ex.Subject"/> to <AutoText key="metadata::exp.Subject"/>.</Text> 1825 </NumberedItem> 1826 <NumberedItem> 1827 <Text id="0533-16">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.</Text> 1825 1828 <BulletList> 1826 1829 <Bullet> 1827 <Text id="0533-16a">There is no dls or dc Title, so replace <Format>{Or}{[dls.Title],[dc.Title],[ex.Title],Untitled}</Format> with <Format>{Or}{[exp.Title],[ex.Title],Untitled}</Format>.</Text>1830 <Text id="0533-16a">There is no dls or dc metadata for this collection, so replace <Format>{Or}{[dls.Title],[dc.Title],[ex.Title],Untitled}</Format> with <Format>{Or}{[exp.Title],[ex.Title],Untitled}</Format>.</Text> 1828 1831 </Bullet> 1829 1832 <Bullet> … … 1841 1844 [/highlight]</td> 1842 1845 </Format> 1843 <Text id="0533-18">Click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text> 1844 </NumberedItem> 1845 <NumberedItem> 1846 <Text id="0533-19">Clear the <AutoText text="DocumentHeading"/> format statement by selecting it in the list of assigned format statements, deleting the contents in the <AutoText key="glidict::CDM.FormatManager.Editor"/>, and clicking <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>. The record Title will be displayed as part of the <AutoText text="DocumentText"/> format, so we don't need it here. </Text> 1846 </NumberedItem> 1847 <NumberedItem> 1848 <Text id="0533-19">Clear the <AutoText text="DocumentHeading"/> format statement by selecting it in the list of assigned format statements and deleting the contents in the <AutoText key="glidict::CDM.FormatManager.Editor"/>. The record Title will be displayed as part of the <AutoText text="DocumentText"/> format, so we don't need it here. </Text> 1847 1849 </NumberedItem> 1848 1850 <NumberedItem> … … 1855 1857 </table> 1856 1858 </Format> 1857 <Text id="0533-21">Remember to click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text> 1858 </NumberedItem> 1859 <NumberedItem> 1860 <Text id="0533-22">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, make it empty, and click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text> 1859 </NumberedItem> 1860 <NumberedItem> 1861 <Text id="0533-22">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.</Text> 1861 1862 </NumberedItem> 1862 1863 <NumberedItem> … … 1875 1876 </Comment> 1876 1877 <NumberedItem> 1877 <Text id="is-3">Start a new collection called <b>ISIS Collection</b> , fill out appropriate fields for it, and choose <b>Dublin Core</b> as the metadata set.</Text>1878 </NumberedItem> 1879 <NumberedItem> 1880 <Text id="is-4">Drag the files from <Path>sample_files → isis</Path> into the collection. </Text>1878 <Text id="is-3">Start a new collection called <b>ISIS Collection</b>.</Text> 1879 </NumberedItem> 1880 <NumberedItem> 1881 <Text id="is-4">Drag the files from <Path>sample_files → isis</Path> (excluding the <Path>format_tweaks</Path> folder) into the collection. </Text> 1881 1882 </NumberedItem> 1882 1883 <NumberedItem> … … 1884 1885 </NumberedItem> 1885 1886 <NumberedItem> 1886 <Text id="is-6">In the <AutoText key="glidict::GUI.Design"/> panel select <AutoText key="glidict::CDM.GUI.SearchTypes"/> from the left-hand list and activate the <AutoText key="glidict::CDM.SearchTypeManager.Enable"/> option.</Text> 1887 </NumberedItem> 1888 <NumberedItem> 1889 <Text id="is-7">Add form searching to the collection by selecting <AutoText text="form"/> in the <AutoText key="glidict::CDM.SearchTypeManager.SearchType_Selection"/> menu and clicking <AutoText key="glidict::CDM.SearchTypeManager.Add" type="button"/>. Remove plain searching by selecting <AutoText text="plain"/> in the <AutoText key="glidict::CDM.SearchTypeManager.Assigned"/> list, and clicking <AutoText key="glidict::CDM.SearchTypeManager.Remove" type="button"/>.</Text> 1890 </NumberedItem> 1891 <NumberedItem> 1892 <Text id="is-8">In the <AutoText key="glidict::CDM.GUI.Indexes"/> section, remove the useless Source and Title indexes, and add new indexes for Photographer^all, Country^all and Notes^all metadata.</Text> 1887 <Text id="is-8">In the <AutoText key="glidict::CDM.GUI.Indexes"/> section of the <AutoText key="glidict::GUI.Design"/> panel, remove the useless Source and Title indexes, and add new indexes for Photographer^all, Country^all and Notes^all metadata.</Text> 1893 1888 <Text id="is-9">CDS/ISIS metadata has subfields, and these are represented using ^.</Text> 1894 1889 </NumberedItem> … … 1897 1892 </NumberedItem> 1898 1893 <NumberedItem> 1899 <Text id="is-11">In the <AutoText key="glidict::CDM.GUI.Formats"/> section, change the <AutoText text="VList"/> format statement to display <AutoText text="Photographer"/> and <AutoText text="Notes"/> metadata. Change it to look like:</Text> 1894 <Text id="is-12"><b>Rebuild</b> and <b>preview</b> the collection. </Text> 1895 </NumberedItem> 1896 <NumberedItem> 1897 <Text id="is-11">In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, change the <AutoText text="VList"/> format statement to display <AutoText text="Photographer"/> and <AutoText text="Notes"/> metadata. Change it to look like:</Text> 1900 1898 <Format> 1901 1899 <td valign=top>[link][icon][/link]</td><br/> 1902 1900 <td valign=top><b>[ex.Photographer^all]</b><br/>[ex.Notes^all]</td> 1903 1901 </Format> 1904 <Text id="is-11a">Click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text> 1905 </NumberedItem> 1906 <NumberedItem> 1907 <Text id="is-12"><b>Rebuild</b> and <b>preview</b> the collection. </Text> 1902 </NumberedItem> 1903 <NumberedItem> 1904 <Text id="is-11a">Make fielded searching the default by changing the <AutoText text="SearchTypes"/> format statement to <AutoText text="form,plain"/> (instead of <AutoText text="plain,form"/>).</Text> 1908 1905 </NumberedItem> 1909 1906 <Text id="is-13"><AutoText text="ISISPlug"/> stores a nicely formatted version of the record as the document text, and this is what is displayed when we view a record. Lets tidy it up a little more.</Text> 1910 1907 <NumberedItem> 1911 <Text id="is-14"> In the <AutoText key="glidict::CDM.GUI.Formats"/> section, remove the <AutoText key="coredm::_document:textDETACH_" type="italics"/> and <AutoText key="coredm::_document:textNOHIGHLIGHT_" type="italics"/> buttons by setting the <AutoText text="DocumentButtons"/> format statement to empty, and clicking <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text>1912 </NumberedItem> 1913 <NumberedItem> 1914 <Text id="is-15">Remove the <AutoText text="Untitled" type="quoted"/> at the top of the document by setting the <AutoText text="DocumentHeading"/> format statement to empty and clicking <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text>1915 </NumberedItem> 1916 <NumberedItem> 1917 <Text id="is-16">Finally, lets link to the raw record, which is stored as <AutoText text="ISISRawRecord"/> metadata. Edit the <AutoText text="DocumentText"/> format statement to look like :</Text>1908 <Text id="is-14">Remove the <AutoText key="coredm::_document:textDETACH_" type="italics"/> and <AutoText key="coredm::_document:textNOHIGHLIGHT_" type="italics"/> buttons by setting the <AutoText text="DocumentButtons"/> format statement to empty.</Text> 1909 </NumberedItem> 1910 <NumberedItem> 1911 <Text id="is-15">Remove the <AutoText text="Untitled" type="quoted"/> at the top of the document by setting the <AutoText text="DocumentHeading"/> format statement to empty.</Text> 1912 </NumberedItem> 1913 <NumberedItem> 1914 <Text id="is-16">Finally, lets link to the raw record, which is stored as <AutoText text="ISISRawRecord"/> metadata. 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>.)</Text> 1918 1915 <Format> 1919 1916 <p>[Text]</p><br/> 1920 1917 {If}{_cgiargshowrecord_, <br/> 1921 < b>CDS Record:</b><br/><tt>[ISISRawRecord]</tt><p/><br/>1918 <p><b>CDS Record:</b><br/><tt>[ISISRawRecord]</tt></p><br/> 1922 1919 <center><a href=\'_gwcgi_?e=_cgiarge_&a=d&d=_cgiargd_\'>Hide CDS Record</a></center>, <br/> 1923 1920 <center><a href=\'_gwcgi_?e=_cgiarge_&a=d&d=_cgiargd_&showrecord=1\'>Show CDS Record</a></center><br/> 1924 1921 } 1925 1922 </Format> 1926 <Text id="is-16a">Don't forget to click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text>1927 1928 1923 </NumberedItem> 1929 1924 <NumberedItem> … … 1937 1932 </Title> 1938 1933 <SampleFiles folder="custom"/> 1939 <Version initial="2.70" current="2.7 0w"/>1934 <Version initial="2.70" current="2.71"/> 1940 1935 <Content> 1941 1936 <Text id="mf-2">The appearance of all pages produced by Greenstone is governed by macro files, which reside in the folder <Path>Greenstone → macros</Path>, images, and CSS stylesheets, both of which reside in <Path>Greenstone → images</Path>. </Text> … … 1943 1938 <Text id="mf-4">Macros are grouped into packages, and different packages control the appearance of different pages. For example, the <AutoText text="home"/>, <AutoText text="help"/>, <AutoText text="preferences"/>, <AutoText text="query"/>, <AutoText text="document"/> packages control the home, help, preferences, query, and document pages, respectively. Some macro files contain macros for just one package, for example, <Path>home.dm</Path>, <Path>query.dm</Path>, <Path>document.dm</Path>, while others contain macros for many packages. <Path>base.dm</Path> contains macros used globally, <Path>style.dm</Path> controls the common style of each page, <Path>english.dm</Path>, <Path>french.dm</Path> and other language files contain the text fragments for the entire interface, in that specific language. </Text> 1944 1939 <Text id="mf-5">The output of the library program is a page of HTML which is viewed in a web browser. CSS (Cascading Style Sheets) are often used alongside HTML pages to control the formatting, such as layout, colour, font etc. The default Greenstone stylesheet is <Path>Greenstone → images → style.css</Path>.</Text> 1945 <Text id="mf-6">In this exercise, we customize the macros, images and stylesheets to change the appearance of our library. You will not need the Librarian Interface for this exercise.</Text>1940 <Text id="mf-6">In this exercise, we customize the macros, images and stylesheets to change the appearance of our library.</Text> 1946 1941 <Heading> 1947 1942 <Text id="mf-7">Changing the background and header images</Text> … … 1951 1946 </NumberedItem> 1952 1947 <NumberedItem> 1953 <Text id="mf-9">Open the file <Path>Greenstone → macros → home.dm</Path> in a text editor, e.g. WordPad. Find each occurrence of <Format>gsdlhead.gif</Format> in this file (there are two) and replace each onewith <Format>gsdlhead-blue.gif</Format>. (If you are using WordPad, you can use <Menu>Edit → Find</Menu> to search for the text.)</Text>1948 <Text id="mf-9">Open the file <Path>Greenstone → macros → home.dm</Path> in a text editor, e.g. WordPad. Find each occurrence of <Format>gsdlhead.gif</Format> in this file (there are two) and replace with <Format>gsdlhead-blue.gif</Format>. (If you are using WordPad, you can use <Menu>Edit → Find</Menu> to search for the text.)</Text> 1954 1949 <Text id="mf-10">Save <Path>home.dm</Path> and close the file.</Text> 1955 1950 </NumberedItem> … … 2089 2084 document.dm browse.dm status.dm authen.dm users.dm html.dm \<br/> 2090 2085 extlink.dm gsdl.dm extra.dm home.dm collect.dm docs.dm \<br/> 2091 bsummary.dm gti.dm gli.dm nav_css.dm \<br/> 2092 english.dm english2.dm french.dm french2.dm spanish.dm \<br/> 2093 spanish2.dm russian.dm russian2.dm usability.dm<br/> 2086 bsummary.dm gti.dm gli.dm nav_css.dm usability.dm \<br/> 2087 ...<br/> 2094 2088 </Format> 2095 2089 <Text id="mf-46">Change the text <Format>home.dm</Format> to <Format>yourhome.dm</Format>. Save and close the file.</Text> … … 2101 2095 <Text id="mf-48">Reverse this last change by changing <Format>yourhome.dm</Format> back to <Format>home.dm</Format> in the file <Path>Greenstone → etc → main.cfg</Path>. You may also like to reverse the other changes you have made.</Text> 2102 2096 </NumberedItem> 2103 2104 2097 <Heading> 2105 2098 <Text id="mf-49">Collection specific customisation</Text> 2106 2099 </Heading> 2107 <Text id="mf-50">Macros can also be used to customize single collections. They should be added to a file called <Path>extra.dm</Path> in the <Path>macros</Path> directory of a collection. </Text>2108 <Text id="mf-51">We use the Word and PDF collection (from exercise <TutorialRef id="word_pdf_collection"/>) as the example for this exercise, but it can be done with any collection. </Text>2109 <NumberedItem> 2110 <Text id="mf-5 2">Create a new macros folder for the collection: <Path>Greenstone → collect → reports → macros</Path>. Copy the file <Path>Greenstone → macros → extra.dm</Path> into the new folder.</Text>2111 </NumberedItem> 2112 <NumberedItem> 2113 <Text id="mf-53">First, we change the title of the <AutoText key="coredm::_about:textabcol_"/> section of the about page. Add the following text to the <Path>extra.dm</Path> file:</Text>2100 <Text id="mf-50">Macros can also be used to customize single collections. They should be added to a file called <Path>extra.dm</Path> in the <Path>macros</Path> directory of a collection. This part of the exercise can be done using the Librarian Interface.</Text> 2101 <Text id="mf-51">We use the Word and PDF collection (from exercise <TutorialRef id="word_pdf_collection"/>) as the example for this exercise, but it can be done with any collection. Open up this collection (reports) in the Librarian Interface.</Text> 2102 <NumberedItem> 2103 <Text id="mf-51a">Go to the <AutoText key="glidict::GUI.Format"/> panel, and select <AutoText key="glidict::CDM.GUI.Macros"/> from the left hand list. This section allows you to edit the collection's extra.dm macro file.</Text> 2104 </NumberedItem> 2105 <NumberedItem> 2106 <Text id="mf-53">First, we change the title of the <AutoText key="coredm::_about:textabcol_"/> section of the about page. Add the following text in the edit box:</Text> 2114 2107 <Format> 2115 2108 package about<br/> … … 2122 2115 } 2123 2116 </Format> 2124 <Text id="mf-54">Save the file.</Text>2125 2117 <Text id="mf-55">Preview the collection. (On Windows, restart the Greenstone library server.) The about page will have a new title underneath the search form.</Text> 2126 2118 </NumberedItem> 2127 2119 <NumberedItem> 2128 <Text id="mf-56">Next we'll do some style customisations for this collection. Add the following text to <Path>extra.dm</Path>:</Text>2120 <Text id="mf-56">Next we'll do some style customisations for this collection. Add the following text:</Text> 2129 2121 <Format> 2130 2122 package Style<br/> … … 2155 2147 } 2156 2148 </Format> 2157 <Text id="mf-60"> Copy the file <Path>sample_files → custom → style-blue.css</Path> into the collection's <Path>images</Path> folder: <Path>Greenstone → collect → reports → images</Path> (you may need to create this folder).</Text>2149 <Text id="mf-60">Outside of the Librarian Interface, locate the collection folder <Path>Greenstone → collect → reports →</Path>. Create an <Path>images</Path> folder inside this, and copy the file <Path>sample_files → custom → style-blue.css</Path> into this folder.</Text> 2158 2150 <Text id="mf-61">Preview the collection; it should look radically different.</Text> 2159 2151 </NumberedItem> … … 2173 2165 <Text id="mf-67">Once you have identified the names of the images to be replaced, you need to find out where they occur in the macro files. To do this, search the macro files for the image names using the <AutoText text="find"/> program, which is run in a command prompt. Open a command prompt using <Menu>Start → Programs → Accessories → Command Prompt</Menu>, or <Menu>Start → Run</Menu> and enter <Command>cmd</Command> as the name of the program to run.</Text> 2174 2166 <Text id="mf-68">You can type <Command>find/?</Command> to see a description of the program and its arguments.</Text> 2175 2176 2167 <Text id="mf-69">To search the macro files for <AutoText text="gsdlhead.gif" type="quoted"/> type</Text> 2177 2168 <Command>find "gsdlhead.gif" "C:\Program Files\Greenstone\macros\*.dm"</Command> 2178 2169 <Text id="mf-70"><AutoText text="*.dm"/> means all files ending in <AutoText text=".dm"/>. A list of all macro files will be displayed, along with any matches. You will see that <Path>home.dm</Path> and <Path>exported_home.dm</Path> both contain <AutoText text="gsdlhead.gif"/>. <Path>home.dm</Path> in the one you want to edit—<Path>exported_home.dm</Path> is used for the home page when you export a collection to CD-ROM.</Text> 2179 2180 2170 <Text id="mf-71">Do the same thing for <AutoText text="chalk.gif" type="quoted"/>:</Text> 2181 2171 <Command>find "chalk.gif" "C:\Program Files\Greenstone\macros\*.dm"</Command> 2182 2183 2172 <Text id="mf-72"><Path>base.dm</Path> is the only file that mentions this image.</Text> 2184 2185 2173 <Text id="mf-73">Close the command prompt.</Text> 2186 2174 </NumberedItem> … … 2192 2180 </Title> 2193 2181 <SampleFiles folder="beatles"/> 2194 <Version initial="2.60" current="2.7 0w"/>2182 <Version initial="2.60" current="2.71"/> 2195 2183 <Content> 2196 2184 <NumberedItem> … … 2228 2216 <Prerequisite id="multimedia_collection_explore"/> 2229 2217 <SampleFiles folder="beatles"/> 2230 <Version initial="2.60" current="2.7 0w"/>2218 <Version initial="2.60" current="2.71"/> 2231 2219 <Content> 2232 2220 <Comment> … … 2234 2222 </Comment> 2235 2223 <NumberedItem> 2236 <Text id="0552">Start a new collection (<Menu><AutoText key="glidict::Menu.File"/> → <AutoText key="glidict::Menu.File_New"/></Menu>) called <b>small beatles</b>, basing it on the default "New Collection." (Basing it on the existing Advanced Beatles collection would make your life far easier, but we want you to learn how to build it from scratch!) Fill out the fields with appropriate information. Use the Dublin Core metadata set (set by default).</Text>2224 <Text id="0552">Start a new collection (<Menu><AutoText key="glidict::Menu.File"/> → <AutoText key="glidict::Menu.File_New"/></Menu>) called <b>small beatles</b>, basing it on the default <AutoText key="glidict::NewCollectionPrompt.NewCollection"/>. (Basing it on the existing Advanced Beatles collection would make your life far easier, but we want you to learn how to build it from scratch!) Fill out the fields with appropriate information.</Text> 2237 2225 </NumberedItem> 2238 2226 <NumberedItem> … … 2296 2284 </Bullet> 2297 2285 <Bullet> 2298 <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 s pecify "Title" in the adjacent text box: this will make the classifier display documents in alphabetical order of title.</Text>2286 <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> 2299 2287 </Bullet> 2300 2288 </BulletList> … … 2302 2290 </NumberedItem> 2303 2291 <Comment> 2304 <Text id="0575a">Note how we assigned dc.Formatmetadata to all documents in the collection with a minimum of labour. We did this by capitalizing on the folder structure of the original information. Even though we complained earlier about how messy this folder structure is, you can still take advantage of it when assigning metadata.</Text>2292 <Text id="0575a">Note how we assigned <AutoText key="metadata::dc.Format"/> metadata to all documents in the collection with a minimum of labour. We did this by capitalizing on the folder structure of the original information. Even though we complained earlier about how messy this folder structure is, you can still take advantage of it when assigning metadata.</Text> 2305 2293 </Comment> 2306 2294 <Heading> … … 2311 2299 <BulletList> 2312 2300 <Bullet> 2313 <Text id="0581">Change to the <AutoText key="glidict::GUI. Design"/> panel and select the <AutoText key="glidict::CDM.GUI.Formats"/> section.</Text>2301 <Text id="0581">Change to the <AutoText key="glidict::GUI.Format"/> panel and select the <AutoText key="glidict::CDM.GUI.Formats"/> section.</Text> 2314 2302 </Bullet> 2315 2303 <Bullet> … … 2336 2324 </Format> 2337 2325 </Bullet> 2338 <Bullet>2339 <Text id="0584">Then click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text>2340 </Bullet>2341 2326 </BulletList> 2342 2327 <Text id="0585">To make this easier for you we have prepared a plain text file that contains the new text. In WordPad open the following file:</Text> 2343 2328 <Path>sample_files → beatles → format_tweaks → audio_tweak.txt</Path> 2344 <Text id="0586">(Be sure to use WordPad rather than Notepad, because Notepad does not display the line breaks correctly.) Place it in the copy buffer by highlighting the text in WordPad and selecting <Menu>Edit → Copy</Menu>. Now move back to the Librarian Interface, highlight all the text that makes up the current <AutoText text="VList"/> format statement, and use <Menu><AutoText key="glidict::Menu.Edit"/> → <AutoText key="glidict::Menu.Edit_Paste"/></Menu> to transform the old statement to the new one. Remember to press <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/> when finished.</Text>2329 <Text id="0586">(Be sure to use WordPad rather than Notepad, because Notepad does not display the line breaks correctly.) Place it in the copy buffer by highlighting the text in WordPad and selecting <Menu>Edit → Copy</Menu>. Now move back to the Librarian Interface, highlight all the text that makes up the current <AutoText text="VList"/> format statement, and use <Menu><AutoText key="glidict::Menu.Edit"/> → <AutoText key="glidict::Menu.Edit_Paste"/></Menu> to transform the old statement to the new one.</Text> 2345 2330 <Text id="0589"><b>Preview</b> the result. You may need to click the browser's <<b>Reload</b>> button to force it to re-load the page.</Text> 2346 2331 </NumberedItem> … … 2362 2347 </Bullet> 2363 2348 </BulletList> 2364 <Text id="0595"> Don't forget to click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/> after all this work!<b>Preview</b> the result (you don't need to rebuild the collection.)</Text>2349 <Text id="0595"><b>Preview</b> the result (you don't need to rebuild the collection.)</Text> 2365 2350 </NumberedItem> 2366 2351 <Heading> … … 2392 2377 </Heading> 2393 2378 <NumberedItem> 2394 <Text id="0606">Make the bookshelves show how many documents they contain by inserting a line in the <AutoText text="VList"/> format statement in the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI. Design"/> panel. The added line is shown highlighted below. The complete format statement can be copied from <Path>sample_files → beatles → format_tweaks → show_num_docs.txt</Path>.</Text>2379 <Text id="0606">Make the bookshelves show how many documents they contain by inserting a line in the <AutoText text="VList"/> format statement in the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel. The added line is shown highlighted below. The complete format statement can be copied from <Path>sample_files → beatles → format_tweaks → show_num_docs.txt</Path>.</Text> 2395 2380 <Format> 2396 2381 <td valign=top><br/> … … 2404 2389 {Or}{[dls.Title],[dc.Title],[Title],Untitled}<br/> 2405 2390 [/highlight]</td></Format> 2406 <Text id="0607">Don't forget to click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text>2407 2391 <Text id="0609"><b>Preview</b> the result (you don't need to build the collection.) Bookshelves in the titles and browse classifiers should show how many documents they contain.</Text> 2408 2392 </NumberedItem> … … 2412 2396 <NumberedItem> 2413 2397 <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> 2414 <Text id="0612b"><b>Build</b> the collection again and <b>preview</b> it. Select the new "phrases"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>2398 <Text id="0612b"><b>Build</b> the collection again and <b>preview</b> it. Select the new <AutoText key="coredm::_Global:labelPhrases_"/> 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> 2415 2399 </NumberedItem> 2416 2400 <Heading> … … 2418 2402 </Heading> 2419 2403 <NumberedItem> 2420 <Text id="0613">To complete the collection, lets give it a new image for the top left corner of the page. Go to the <AutoText key="glidict::CDM.GUI.General"/> section of the <AutoText key="glidict::GUI. Design"/> panel. Use the browse button of <AutoText key="glidict::CDM.General.Icon_Collection"/> to select the following image:</Text>2404 <Text id="0613">To complete the collection, lets give it a new image for the top left corner of the page. Go to the <AutoText key="glidict::CDM.GUI.General"/> section of the <AutoText key="glidict::GUI.Format"/> panel. Use the browse button of <AutoText key="glidict::CDM.General.Icon_Collection"/> to select the following image:</Text> 2421 2405 <Path>sample_files → beatles → advbeat_large → images → beatlesmm.png</Path> 2422 <Text id="0613a"> Previewthe collection, and make sure the new image appears.</Text>2406 <Text id="0613a"><b>Preview</b> the collection, and make sure the new image appears.</Text> 2423 2407 </NumberedItem> 2424 2408 <Heading> … … 2493 2477 </Comment> 2494 2478 <NumberedItem> 2479 <Text id="0644a">Close the collection in the Librarian Interface (<Menu><AutoText key="glidict::Menu.File"/> → <AutoText key="glidict::Menu.File_Close"/></Menu>).</Text> 2480 </NumberedItem> 2481 <NumberedItem> 2495 2482 <Text id="0645">Using your Windows file browser outside Greenstone, locate the folder</Text> 2496 2483 <Path>sample_files → beatles → advbeat_large</Path> … … 2498 2485 <NumberedItem> 2499 2486 <Text id="0645a">Open up another file browser, and locate the small beatles collection in your Greenstone installation:</Text> 2500 <Path> greenstone → collect → smallbea</Path>2487 <Path>Greenstone → collect → smallbea</Path> 2501 2488 <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> 2502 2489 </NumberedItem> 2503 2490 <NumberedItem> 2504 <Text id="0646">Using the file browser, copy the <Path>images</Path> and <Path>macros</Path> folders from the <Path>advbeat_large</Path> folder into the <Path>smallbea</Path> folder. (It's OK to overwrite the existing <Path>images</Path> folder: the image in it is included in the folder being copied.) The <Path>images</Path> folder includes some useful icons, and the <Path>macros</Path> folder defines some macro names that use these images. To see the macro definitions, take a look by using a text editor to open the file <Path>extra.dm</Path> in the <Path>macros</Path> folder.</Text> 2491 <Text id="0646">Using the file browser, copy the <Path>images</Path> and <Path>macros</Path> folders from the <Path>advbeat_large</Path> folder into the <Path>smallbea</Path> folder. (It's OK to overwrite the existing <Path>images</Path> folder: the image in it is included in the folder being copied.) The <Path>images</Path> folder includes some useful icons, and the <Path>macros</Path> folder defines some macro names that use these images.</Text> 2492 <Text id="0646a">To see the macro definitions, open the collection in the LIbrarian Interface (<Menu><AutoText key="glidict::Menu.File"/> → <AutoText key="glidict::Menu.File_Open"/></Menu>) and view the <AutoText key="glidict::CDM.GUI.Macros"/> section in the <AutoText key="glidict::GUI.Format"/> panel.</Text> 2505 2493 </NumberedItem> 2506 2494 <Heading> … … 2508 2496 </Heading> 2509 2497 <NumberedItem> 2510 <Text id="0648">Re- Edit your <AutoText text="VList" /> format statement to be the following (in <AutoText key="glidict::CDM.GUI.Formats"/> on the <AutoText key="glidict::GUI.Design"/> panel)</Text>2498 <Text id="0648">Re-edit your <AutoText text="VList" /> format statement to be the following (in <AutoText key="glidict::CDM.GUI.Formats"/> on the <AutoText key="glidict::GUI.Format"/> panel). You can copy this text from the file <Path>sample_files → beatles → format_tweaks → multi_icons.txt</Path>.</Text> 2511 2499 <Format><highlight><td valign=top></highlight><br/> 2512 2500 <highlight>{If}{[numleafdocs],[link][icon][/link]}</highlight><br/> … … 2529 2517 </NumberedItem> 2530 2518 <NumberedItem> 2531 <Text id="0649">The complete statement is in the file <Path>format_tweaks → multi_icons.txt</Path>.</Text>2532 </NumberedItem>2533 <NumberedItem>2534 2519 <Text id="0651"><b>Preview</b> your collection as before. Now different icons are used for discography, lyrics, tablature, and MARC metadata. Even MP3 and MIDI audio file types are distinguished. If you let the mouse hover over one of these images a "tool tip" appears explaining what file type the icon represents in the current interface language (note: <Path>extra.dm</Path> only defines English and French).</Text> 2535 2520 </NumberedItem> … … 2538 2523 </Heading> 2539 2524 <NumberedItem> 2540 <Text id="0653 ">Open your collection's <Path>macros</Path> folder and locate the <Path>extra.dm</Path> file within it. <b>Open</b> it in a text editor, e.g. WordPad.</Text>2541 </NumberedItem> 2542 <NumberedItem> 2543 <Text id="0654">The file content is fairly brief, specifying only what needs to be overridden from the default behaviour for this collection. Near the top of the fileyou should see:</Text>2525 <Text id="0653a">Go to the <AutoText key="glidict::CDM.GUI.Macros"/> section in the <AutoText key="glidict::GUI.Format"/> panel.</Text> 2526 </NumberedItem> 2527 <NumberedItem> 2528 <Text id="0654">The content is fairly brief, specifying only what needs to be overridden from the default behaviour for this collection. Near the top you should see:</Text> 2544 2529 <Format> 2545 2530 _collectionspecificstyle_ {<br/> … … 2550 2535 } 2551 2536 </Format> 2552 <Text id="0655">Replace the text <AutoText text="beat_margin.gif" type="quotes"/> with <AutoText text="tile.jpg" type="quotes"/>. Save the file.</Text>2537 <Text id="0655">Replace the text <AutoText text="beat_margin.gif" type="quotes"/> with <AutoText text="tile.jpg" type="quotes"/>.</Text> 2553 2538 <Text id="0656">This line relates to the background image used. The new image <Path>tile.jpg</Path> was in the <Path>images</Path> folder that was copied across previously.</Text> 2554 2539 </NumberedItem> 2555 2540 <NumberedItem> 2556 2541 <Text id="0658"><b>Preview</b> the collection's home page. The page background is now the new graphic.</Text> 2557 <Text id="0659">Other features can be altered by editing the macro files—for example, the headers and footers used on each page, and the highlighting style used for search terms (specify a different colour, use bold etc.).</Text>2542 <Text id="0659">Other features can be altered by editing the macros—for example, the headers and footers used on each page, and the highlighting style used for search terms (specify a different colour, use bold etc.).</Text> 2558 2543 </NumberedItem> 2559 2544 <Heading> … … 2576 2561 </Bullet> 2577 2562 <Bullet> 2578 <Text id="0670"><b>Build</b> the collection and <b>preview</b> the result. (If you want the collection to have an icon, you will have to add it from the <AutoText key="glidict::GUI. Design"/> panel.)</Text>2563 <Text id="0670"><b>Build</b> the collection and <b>preview</b> the result. (If you want the collection to have an icon, you will have to add it from the <AutoText key="glidict::GUI.Format"/> panel.)</Text> 2579 2564 </Bullet> 2580 2565 </BulletList> … … 2596 2581 </Title> 2597 2582 <SampleFiles folder="niupepa"/> 2598 <Version initial="2.60" current="2.7 0w"/>2583 <Version initial="2.60" current="2.71"/> 2599 2584 <Content> 2600 2585 <Comment> … … 2605 2590 </Comment> 2606 2591 <NumberedItem> 2607 <Text id="0677">Start a new collection called <b>Paged Images</b> and fill out the fields with appropriate information: it is a collection sourced from an excerpt of Niupepa documents ; the only metadata used is document title and date, and these are extracted from the <AutoText text="item" type="quoted"/> files included in the source documents so no metadata set need be stipulated.</Text>2592 <Text id="0677">Start a new collection called <b>Paged Images</b> and fill out the fields with appropriate information: it is a collection sourced from an excerpt of Niupepa documents.</Text> 2608 2593 </NumberedItem> 2609 2594 <NumberedItem> … … 2635 2620 </NumberedItem> 2636 2621 <NumberedItem> 2637 <Text id="0687">In the <AutoText key="glidict::CDM.GUI.Formats"/> section , select the <AutoText key="metadata::ex.Title"/> classifier in the <AutoText key="glidict::CDM.FormatManager.Feature"/> list, and <AutoText text="VList"/> in the <AutoText key="glidict::CDM.FormatManager.Part"/> list. 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 → niupepa → formats → titles_tweak.txt</Path>.)</Text>2622 <Text id="0687">In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, select the <AutoText key="metadata::ex.Title"/> classifier in the <AutoText key="glidict::CDM.FormatManager.Feature"/> list, and <AutoText text="VList"/> in the <AutoText key="glidict::CDM.FormatManager.Part"/> list. Click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/> to add this format statment to your collection. 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 → niupepa → formats → titles_tweak.txt</Path>.)</Text> 2638 2623 <Format> 2639 2624 <td valign="top">[link][icon][/link]</td><br/> … … 2645 2630 </td> 2646 2631 </Format> 2647 <Text id="0687a">Click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/>.</Text>2648 2632 </NumberedItem> 2649 2633 <NumberedItem> 2650 2634 <Text id="0690a"><b>Build</b> the collection, and <b>preview</b> the new <AutoText key="coredm::_Global:labelTitle_" type="italics"/> list.</Text> 2651 <Text id="0687c">As a consequence of using the <AutoText text="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 <Format>[numleafdocs]</Format> metadata. For document nodes, Title is not displayed. instead, Volume, Number and Date information are displayed if present.</Text>2635 <Text id="0687c">As a consequence of using the <AutoText text="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 <Format>[numleafdocs]</Format> metadata. For document nodes, Title is not displayed. Instead, Volume, Number and Date information are displayed if present.</Text> 2652 2636 </NumberedItem> 2653 2637 <Heading> … … 2658 2642 </Comment> 2659 2643 <NumberedItem> 2660 <Text id="0696">In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI. Design"/> panel, select the <AutoText text="DocumentText"/> format statement. The default format string displays the document's plain text, which, if there is none, is set to <AutoText key="perlmodules::BasPlug.dummy_text" type="quoted"/>. Change this to the following text. (This format statement can be copied and pasted from the file <Path>sample_files → niupepa → formats → doc_tweak.txt</Path>)</Text>2644 <Text id="0696">In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, select the <AutoText text="DocumentText"/> format statement. The default format string displays the document's plain text, which, if there is none, is set to <AutoText key="perlmodules::BasPlug.dummy_text" type="quoted"/>. Change this to the following text. (This format statement can be copied and pasted from the file <Path>sample_files → niupepa → formats → doc_tweak.txt</Path>)</Text> 2661 2645 <Format> 2662 2646 <table><tr><br/> … … 2665 2649 </tr></table> 2666 2650 </Format> 2667 <Text id="0696a">and click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text>2668 2651 <Comment> 2669 2652 <Text id="0698">Including <Format>[screenicon]</Format> has the effect of embedding the screen-sized image generated by switching the <AutoText text="screenview"/> option on in <AutoText text="PagedImgPlug"/>. It is hyperlinked to the original image by the construct <Format>[srclink]...[/srclink]</Format>.</Text> … … 2677 2660 {If}{[Text] ne "<AutoText key="perlmodules::BasPlug.dummy_text" type="plain"/> ",<td valign=top>[Text]</td>} 2678 2661 </Format> 2679 <Text id="0698d">and click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text>2680 2662 </NumberedItem> 2681 2663 <NumberedItem> … … 2689 2671 </NumberedItem> 2690 2672 <NumberedItem> 2691 <Text id="0690d">Go to the <AutoText key="glidict::CDM.GUI.Indexes"/> section of the <AutoText key="glidict::GUI.Design"/> panel. Remove the <AutoText key="metadata::ex.Source"/> index. Select the <AutoText text="document:text"/> index in the <AutoText key="glidict::CDM.IndexManager.Indexes"/> box, and change the <AutoText key="glidict::CDM.IndexManager.Index_Name"/> to "whole newspapers". Click <AutoText key="glidict::CDM.IndexManager.MGPP.Replace_Index" type="button"/>. Create a new index: set the <AutoText key="glidict::CDM.IndexManager.Index_Name"/> to "newspaper pages", keep <AutoText text="text"/> selected in <AutoText key="glidict::CDM.IndexManager.Source"/>, and change <AutoText key="glidict::CDM.IndexManager.Level"/> to <AutoText text="section"/>. Click <AutoText key="glidict::CDM.IndexManager.Add_Index" type="button"/>. Click <AutoText key="glidict::CDM.IndexManager.Set_Default" type="button"/> on the right hand side to make the "newspaper pages" index the default.</Text> 2692 </NumberedItem> 2693 <NumberedItem> 2694 <Text id="0690e"><b>Build</b> and <b>preview</b> the collection. Compare searching in the "whole newspapers" index compared to the "newspaper pages" index. A useful search term for this collection is <AutoText text="aroha" type="quoted"/>.</Text> 2695 </NumberedItem> 2696 <NumberedItem> 2697 <Text id="0690f">You will notice that when searching for individual pages, the newspaper image is displayed in the search results. As these images are very large, this is not very useful. Go to <AutoText key="glidict::CDM.GUI.Formats"/> in the Librarian Interface and select the <AutoText text="VList"/> format statement from the list of assigned format statements. Remove the second line from the <AutoText key="glidict::CDM.FormatManager.Editor"/>:</Text> 2673 <Text id="0690d">Go to the <AutoText key="glidict::CDM.GUI.Indexes"/> section of the <AutoText key="glidict::GUI.Design"/> panel. Remove the <AutoText key="metadata::ex.Source"/> index. Check the <AutoText key="glidict::CDM.LevelManager.Section"/> checkbox to build the indexes on section level as well as document level. Make section level the default by selecting its <AutoText key="glidict::CDM.LevelManager.Default"/> radio button.</Text> 2674 </NumberedItem> 2675 <NumberedItem> 2676 <Text id="0690d-1">Set the display text used for the level drop-down menu by going to the <AutoText key="glidict::CDM.GUI.SearchMetadata"/> section on the <AutoText key="glidict::GUI.Format"/> panel. Set the document level text to "newspaper", and the section level text to "page".</Text> 2677 </NumberedItem> 2678 <NumberedItem> 2679 <Text id="0690e"><b>Build</b> and <b>preview</b> the collection. Compare searching at "newspaper" level compared to "page" level. A useful search term for this collection is <AutoText text="aroha" type="quoted"/>.</Text> 2680 </NumberedItem> 2681 <NumberedItem> 2682 <Text id="0690f">You will notice that when searching for individual pages, the newspaper image is displayed in the search results. As these images are very large, this is not very useful. Go to <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel in the Librarian Interface and select the <AutoText text="VList"/> format statement from the list of assigned format statements. Remove the second line from the <AutoText key="glidict::CDM.FormatManager.Editor"/>:</Text> 2698 2683 <Format> 2699 2684 <td valign="top">[ex.srclink]{Or}{[ex.thumbicon],[ex.srcicon]}[ex./srclink]</td> … … 2703 2688 {If}{[ex.Source],<br><i>([ex.Source])</i>} 2704 2689 </Format> 2705 <Text id="0690f-2">Click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text>2706 2690 <Text id="0690g"><b>Preview</b> the collection—the search results should be back to normal. </Text> 2707 2691 </NumberedItem> 2708 2692 <NumberedItem> 2709 2693 <Text id="0690h">Now you will notice that page level search results only show the Title of the page (the page number), and not the Title of the newspaper. We'll modify the format statement to show the newspaper title as well as the page number. Also, lets add in Volume and Number information too. </Text> 2710 <Text id="0690h-1">In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Design"/> panel, select <AutoText text="Search"/> in <AutoText key="glidict::CDM.FormatManager.Feature"/>, and <AutoText text="VList"/> in <AutoText key="glidict::CDM.FormatManager.Part"/>. The previous changes modified <AutoText text="VList"/>, so they will apply to all <AutoText text="VList"/>s that don't have specific format statements. These next changes are made to <AutoText text="SearchVList"/> so will only apply to search results.</Text>2694 <Text id="0690h-1">In the <AutoText key="glidict::CDM.GUI.Formats"/> section, select <AutoText text="Search"/> in <AutoText key="glidict::CDM.FormatManager.Feature"/>, and <AutoText text="VList"/> in <AutoText key="glidict::CDM.FormatManager.Part"/>. Click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/> to add this format to the collection. The previous changes modified <AutoText text="VList"/>, so they will apply to all <AutoText text="VList"/>s that don't have specific format statements. These next changes are made to <AutoText text="SearchVList"/> so will only apply to search results. </Text> 2711 2695 <Text id="0690i">The extracted Title for the current section is specified as <Format>[ex.Title]</Format> while the Title for the parent section is <Format>[parent:ex.Title]</Format>. Since the same <AutoText text="SearchVList"/> format statement is used when searching both whole newspapers and newspaper pages, we need to make sure it works in both cases.</Text> 2712 2696 <Text id="0690j">Set the format statement to the following text (it can be copied and pasted from the file <Path>sample_files → niupepa → formats → search_tweak.txt</Path>.)</Text> … … 2722 2706 </td> 2723 2707 </Format> 2724 <Text id="1690j-1">Click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/>.</Text>2725 2708 <Text id="0690l"><b>Preview</b> the search results. Items display newspaper title, Volume, Number and Date if available, and pages also display the page number.</Text> 2726 2709 </NumberedItem> … … 2736 2719 <SampleFiles folder="niupepa"/> 2737 2720 <Prerequisite id="scanned_image_collection"/> 2738 <Version initial="2.70" current="2.7 0w"/>2721 <Version initial="2.70" current="2.71"/> 2739 2722 <Content> 2740 2723 <Comment> … … 2806 2789 </NumberedItem> 2807 2790 <NumberedItem> 2808 <Text id="sc2 6"><b>Close</b> the collection in the Librarian Interface (<Menu><AutoText key="glidict::Menu.File"/> → <AutoText key="glidict::Menu.File_Close"/></Menu>). It will not let you add two of the same plugin (apart from <AutoText text="UnknownPlug"/>), so the second <AutoText text="PagedImgPlug"/> must be added to the collect.cfg file manually.</Text>2809 </NumberedItem> 2810 <NumberedItem> 2811 <Text id="sc2 7">Open the file <Path>greenstone → collect → pagedima → etc → collect.cfg</Path> in a text editor. Copy the <AutoText text="plugin PagedImgPlug"/> line and paste it above the existing one. Edit the two <AutoText text="plugin PagedImgPlug"/> lines so that they look like:</Text>2812 < Format>2813 plugin PagedImgPlug -screenview -documenttype hierarchy -process_exp xml.*.item$<br/>2814 plugin PagedImgPlug -screenview -documenttype paged 2815 </ Format>2816 < Text id="sc27a">Save and close the file.</Text>2791 <Text id="sc25b">Change the mode in the Librarian Interface to <AutoText key="glidict::Preferences.Mode.Systems"/> (or <AutoText key="glidict::Preferences.Mode.Expert"/>) mode (using <Menu><AutoText key="glidict::Menu.File"/> → <AutoText key="glidict::Menu.File_Options"/></Menu>), because you will need to change the order of plugins, and use regular expressions in the plugin options.</Text> 2792 </NumberedItem> 2793 <NumberedItem> 2794 <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="PagedImgPlug"/> plugin. Enable the <AutoText text="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> 2795 </NumberedItem> 2796 <NumberedItem> 2797 <Text id="sc25d">Move this <AutoText text="PagedImgPlug"/> plugin above the original one in the <AutoText key="glidict::CDM.PlugInManager.Assigned"/> list.</Text> 2798 </NumberedItem> 2799 <NumberedItem> 2817 2800 <Text id="sc28">The XML based newspapers have been grouped into a folder called <Path>xml</Path>. This enables us to process these files differently, by utilizing the <AutoText text="process_exp"/> option which all plugins support. The first <AutoText text="PagedImgPlug"/> in the list looks for item files underneath the <Path>xml</Path> folder. These documents will be processed as 'hierarchical' documents. Item files that don't match the process expression (i.e. aren't underneath the <Path>xml</Path> folder) will be passed onto the second <AutoText text="PagedImgPlug"/>, and these are treated as 'paged' documents.</Text> 2818 <Text id="sc28a">Open the collection in the Librarian Interface (<Menu><AutoText key="glidict::Menu.File"/> → <AutoText key="glidict::Menu.File_Open"/></Menu>). Check the <AutoText key="glidict::CDM.GUI.Plugins"/> section of the <AutoText key="glidict::GUI.Design"/> panel to make sure that the two <AutoText text="PagedImgPlug"/> plugins appear.</Text>2819 2801 <Text id="sc29"><b>Rebuild</b> and <b>preview</b> the collection. Compare the document display for a paged document e.g. <AutoText text="Te Waka o Te Iwi, Vol. 1, No. 1"/> with a hierarchical document, e.g. <AutoText text="Matariki 1881, No. 1"/>.</Text> 2820 2802 </NumberedItem> … … 2824 2806 <Text id="sc31">We can modify the document display to switch between the text version and the screenview and full size versions. We do this using a combination of format statements and macro files.</Text> 2825 2807 <NumberedItem> 2826 <Text id="sc32">First of all we will add a macro file to the collection. In a file browser outside of Greenstone, locate the Paged Image collection in your Greenstone installation: <Path>Greenstone → collect → pagedima</Path>. Create a new folder called <Path>macros</Path> in the <Path>pagedima</Path> folder.</Text>2827 <Text id="sc32a">Also in a file browser, locate the file <Path>sample_files → niupepa → macros → extra.dm</Path>. Copy this file and paste it into the new <Path>macros</Path> folder you just created.</Text>2828 </NumberedItem> 2829 <NumberedItem> 2830 <Text id="sc33a">Back in the Librarian Interface, go to the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Design"/> panel.</Text>2831 </NumberedItem> 2832 <NumberedItem> 2833 <Text id="sc33b">Select <AutoText text="AllowExtendedOptions"/> in the <AutoText key="glidict::CDM.FormatManager.Feature"/> list, and tick <AutoText key="glidict::CDM.FormatManager.Enabled"/>. Click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/>. This gives us more control over the layout of the page—in this case, we want to replace the standard <AutoText key="coredm::_document:textDETACH_" type="italics"/> and <AutoText key="coredm::_document:textNOHIGHLIGHT_" type="italics"/> buttons with buttons that switch between images and text.</Text>2808 <Text id="sc32">First of all we will add a macro file to the collection. Close the collection in the Librarian Interface. In a file browser outside of Greenstone, locate the Paged Image collection in your Greenstone installation: <Path>Greenstone → collect → pagedima</Path>.</Text> 2809 <Text id="sc32a">Also in a file browser, locate the file <Path>sample_files → niupepa → macros → extra.dm</Path>. Copy this file and paste it into the <Path>macros</Path> folder inside the pagedima collection.</Text> 2810 </NumberedItem> 2811 <NumberedItem> 2812 <Text id="sc33a">Back in the Librarian Interface, open up the collection again, and go to the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel.</Text> 2813 </NumberedItem> 2814 <NumberedItem> 2815 <Text id="sc33b">Select <AutoText text="AllowExtendedOptions"/> in the <AutoText key="glidict::CDM.FormatManager.Feature"/> list, and click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/>. Tick the <AutoText key="glidict::CDM.FormatManager.Enabled"/> checkbox. This gives us more control over the layout of the page—in this case, we want to replace the standard <AutoText key="coredm::_document:textDETACH_" type="italics"/> and <AutoText key="coredm::_document:textNOHIGHLIGHT_" type="italics"/> buttons with buttons that switch between images and text.</Text> 2834 2816 </NumberedItem> 2835 2817 <NumberedItem> … … 2844 2826 <div class="toc">[DocTOC]</div><br/> 2845 2827 </Format> 2846 <Text id="sc33c-1">Click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text>2847 2828 <Text id="sc33e"><Format>{Or}{[parent(Top):ex.Title],[ex.Title]}</Format> outputs the newspaper Title metadata. This is only stored at the top level of the document, so if we are at a subsection, we need to get it from the top (<Format>[parent(Top):ex.Title]</Format>). Note that we can't just use <Format>[parent:ex.Title]</Format> as this retrieves the Title from the immediate parent node, which may not be the top node of the document.</Text> 2848 <Text id="sc33g"><Format>_document:viewpreview_, _document:viewfullsize_, _document:viewtext_</Format> are macros defined in <Path>extra.dm</Path> which output buttons for preview, fullsize and text versions, respectively. We choose which buttons to display based on what metadata and text the document has. </Text>2829 <Text id="sc33g"><Format>_document:viewpreview_, _document:viewfullsize_, _document:viewtext_</Format> are macros defined in <Path>extra.dm</Path> which output buttons for preview, fullsize and text versions, respectively. We choose which buttons to display based on what metadata and text the document has. Note you can view the macros by going to the <AutoText key="glidict::CDM.GUI.Macros"/> section of the <AutoText key="glidict::GUI.Format"/> panel.</Text> 2849 2830 <Text id="sc33h"><Format>[DocTOC]</Format> is the document table of contents or "go to page" navigation element. Since we are using extended options, we need to explicitly specify this for it to appear in the page.</Text> 2850 2831 <Text id="sc33i">The different pieces are surrounded by <Format><div></Format> elements, so that the appropriate styling information can be used.</Text> … … 2857 2838 {If}{[Text] ne \'This document has no text. \',[Text],[screenicon]}}} 2858 2839 </Format> 2859 <Text id="sc34a-1">Remember to click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text>2860 2840 <Text id="sc34b">This format statement changes the display based on the <AutoText text="p" type="quoted"/> argument (<Format>_cgiargp_</Format>). This is not used normally for document display, so we can use it here to switch between full size image (<Format>[srcicon]</Format>), preview size image (<Format>[screenicon]</Format>) and text (<Format>[Text]</Format>) versions of each page.</Text> 2861 2841 </NumberedItem> … … 2870 2850 </Title> 2871 2851 <SampleFiles folder="oai"/> 2872 <Version initial="2.60" current="2.7 0w"/>2852 <Version initial="2.60" current="2.71"/> 2873 2853 <Content> 2874 2854 <Comment> … … 2879 2859 </Comment> 2880 2860 <NumberedItem> 2881 <Text id="0705">Start a new collection called <b>OAI Service Provider</b>. Fill out the fields with appropriate information. You can leave the default metadata set as Dublin Core, although we do not make use of it.</Text>2861 <Text id="0705">Start a new collection called <b>OAI Service Provider</b>. Fill out the fields with appropriate information.</Text> 2882 2862 </NumberedItem> 2883 2863 <NumberedItem> … … 2895 2875 </Comment> 2896 2876 <NumberedItem> 2897 <Text id="0710">You need to configure the image plug-in. In the <AutoText key="glidict::GUI.Design"/> panel, select the <AutoText key="glidict::CDM.GUI.Plugins"/> section, then select the <AutoText text=" pluginImagePlug"/> line and click <AutoText key="glidict::CDM.PlugInManager.Configure" type="button"/>. In the resulting popup window locate the <AutoText text="screenviewsize"/> option, switch it on, and type the number <AutoText text="300"/> in the box beside it to create a screen-view image of 300 pixels. Click <AutoText key="glidict::General.OK" type="button"/>.</Text>2877 <Text id="0710">You need to configure the image plug-in. In the <AutoText key="glidict::GUI.Design"/> panel, select the <AutoText key="glidict::CDM.GUI.Plugins"/> section, then select the <AutoText text="ImagePlug"/> line and click <AutoText key="glidict::CDM.PlugInManager.Configure" type="button"/>. In the resulting popup window locate the <AutoText text="screenviewsize"/> option, switch it on, and type the number <AutoText text="300"/> in the box beside it to create a screen-view image of 300 pixels. Click <AutoText key="glidict::General.OK" type="button"/>.</Text> 2898 2878 </NumberedItem> 2899 2879 <NumberedItem> … … 2914 2894 </NumberedItem> 2915 2895 <NumberedItem> 2916 <Text id="0716">In the <AutoText key="glidict::CDM.GUI.Indexes"/> section of the <AutoText key="glidict::GUI.Design"/> panel, delete all indexes and add a new one called "captions"based on <AutoText key="metadata::ex.Description"/> metadata.</Text>2896 <Text id="0716">In the <AutoText key="glidict::CDM.GUI.Indexes"/> section of the <AutoText key="glidict::GUI.Design"/> panel, delete all indexes and add a new one based on <AutoText key="metadata::ex.Description"/> metadata.</Text> 2917 2897 </NumberedItem> 2918 2898 <NumberedItem> … … 2923 2903 </Heading> 2924 2904 <NumberedItem> 2925 <Text id="0719">In the <AutoText key="glidict::GUI. Design"/> panel, select <AutoText key="glidict::CDM.GUI.Formats"/>. First replace the <AutoText text="VList" /> format statement with this:</Text>2905 <Text id="0719">In the <AutoText key="glidict::GUI.Format"/> panel, select <AutoText key="glidict::CDM.GUI.Formats"/>. First replace the <AutoText text="VList" /> format statement with the following (which can be copied from the file <Path>vlist_tweak.txt</Path> in the <Path>sample_files → oai →format_tweaks</Path> folder).</Text> 2926 2906 <Format> 2927 2907 <td><br/> … … 2932 2912 </td> 2933 2913 </Format> 2934 <Text id="0720">You will find this text in the file <Path>vlist_tweak.txt</Path> in the <Path>sample_files → oai →format_tweaks</Path> folder. Remember to click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/> when finished</Text>2935 2914 <Comment> 2936 2915 <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 <Format>[Description]</Format> is the same as <Format>[ex.Description]</Format>.</Text> … … 2940 2919 <Text id="0722">Next, select <AutoText text="DocumentHeading"/> from the <AutoText key="glidict::CDM.FormatManager.Feature"/> pull-down list and change its format statement to: </Text> 2941 2920 <Format><h3>[Subject]</h3></Format> 2942 <Text id="0722a">Click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text>2943 2921 <Comment> 2944 2922 <Text id="0723">The document heading appears above the <AutoText key="coredm::_document:textDETACH_" type="italics"/> and <AutoText key="coredm::_document:textNOHIGHLIGHT_" type="italics"/> buttons when you get to a document in the collection. By default <AutoText text="DocumentHeading"/> displays the document's <AutoText key="metadata::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 <AutoText key="glidict::GUI.Enrich"/> panel if you select an image in <Path>oai → JCDLPICS → srcdocs</Path> and check its <AutoText key="metadata::ex.Source"/> and <AutoText key="metadata::ex.Title"/> metadata. The above format statement displays <AutoText key="metadata::ex.Subject"/> metadata instead.</Text> … … 2957 2935 <tr><td>Rights:<td> [Rights]</td></tr><br/> 2958 2936 </table></center></Format> 2959 <Text id="0727a">Click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text>2960 2937 <Text id="0730">This format statement alters how the document view is presented. It includes a screen-sized version of the image that hyperlinks back to the original larger version available on the web. Factual information extracted from the image, such as width, height and type, is also displayed.</Text> 2961 2938 </NumberedItem> 2962 2939 <NumberedItem> 2963 <Text id="0731">Format statements are processed by the runtime system, so the collection does not need to be rebuilt for these changes to take effect. Switch to the <AutoText key="glidict::GUI.Design"/> panel and press<AutoText key="glidict::CreatePane.Preview_Collection" type="button"/> to see the changes.</Text>2940 <Text id="0731">Format statements are processed by the runtime system, so the collection does not need to be rebuilt for these changes to take effect. Click <AutoText key="glidict::CreatePane.Preview_Collection" type="button"/> to see the changes.</Text> 2964 2941 </NumberedItem> 2965 2942 <Comment> … … 2968 2945 </Content> 2969 2946 </Tutorial> 2947 <!-- ** here --> 2970 2948 <Tutorial id="OAI_downloading"> 2971 2949 <Title> … … 2973 2951 </Title> 2974 2952 <Prerequisite id="OAI_collection"/> 2975 <Version initial="2.60" current="2.7 0w"/>2953 <Version initial="2.60" current="2.71"/> 2976 2954 <Content> 2977 2955 <Comment> … … 3024 3002 <Text id="0750">Use METS as Greenstone's Internal Representation</Text> 3025 3003 </Title> 3026 <Version initial="2.60" current="2.7 0w"/>3004 <Version initial="2.60" current="2.71"/> 3027 3005 <Content> 3028 3006 <NumberedItem> … … 3045 3023 </NumberedItem> 3046 3024 <NumberedItem> 3047 <Text id="0759">In your Windows file browser, locate the <Path>archives</Path> folder for the collection you are working with . 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 will 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>3025 <Text id="0759">In your Windows file browser, locate the <Path>archives</Path> folder for the collection you are working with (in <Path>Greenstone → collect → <collname> → 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 will 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> 3048 3026 </NumberedItem> 3049 3027 </Content> … … 3054 3032 </Title> 3055 3033 <SampleFiles folder="dspace"/> 3056 <Version initial="2.60" current="2.7 0w"/>3034 <Version initial="2.60" current="2.71"/> 3057 3035 <Content> 3058 3036 <NumberedItem> … … 3106 3084 </NumberedItem> 3107 3085 <NumberedItem> 3108 <Text id="0780">Now select the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI. Design"/> panel, and select the <AutoText text="VList" /> format statement in the list of assigned format statements. Add the following text before the final <Format></td></Format>:</Text>3086 <Text id="0780">Now select the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, and select the <AutoText text="VList" /> format statement in the list of assigned format statements. Add the following text before the final <Format></td></Format>:</Text> 3109 3087 <Format> 3110 3088 {If}{[ex.equivlink],<br>Also available as:[ex.equivlink]} 3111 3089 </Format> 3112 <Text id="0781">Click <AutoText key="glidict::CDM.FormatManager.Replace" type="button"/>.</Text> 3113 </NumberedItem> 3114 <NumberedItem> 3115 <Text id="0782">Also, let's add a format statement for the classifier based on <AutoText key="metadata::dc.Contributor"/> metadata. In the <AutoText key="glidict::CDM.FormatManager.Feature"/> menu (under <AutoText key="glidict::CDM.GUI.Formats"/> on the <AutoText key="glidict::GUI.Design"/> panel), select the item that says:</Text> 3090 </NumberedItem> 3091 <NumberedItem> 3092 <Text id="0782">Also, let's add a format statement for the classifier based on <AutoText key="metadata::dc.Contributor"/> metadata. In the <AutoText key="glidict::CDM.FormatManager.Feature"/> menu (under <AutoText key="glidict::CDM.GUI.Formats"/> on the <AutoText key="glidict::GUI.Format"/> panel), select the item that says:</Text> 3116 3093 <Indent> 3117 3094 CL2: AZCompactList -metadata <AutoText key="metadata::dc.Contributor"/> … … 3119 3096 </NumberedItem> 3120 3097 <NumberedItem> 3121 <Text id="0783">Leave <AutoText text="VList" /> as the <AutoText key="glidict::CDM.FormatManager.Part"/> and edit the text in the <AutoText key="glidict::CDM.FormatManager.Editor"/> box. Replace</Text>3098 <Text id="0783">Leave <AutoText text="VList" /> as the <AutoText key="glidict::CDM.FormatManager.Part"/> and click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/>. Edit the text in the <AutoText key="glidict::CDM.FormatManager.Editor"/> box. Replace</Text> 3122 3099 <Format> 3123 3100 {Or}{[dls.Title],[dc.Title],[ex.Title],Untitled} … … 3127 3104 {If}{[numleafdocs],([numleafdocs]) [ex.Title],[dc.Title]} 3128 3105 </Format> 3129 <Text id="0784"> and click <AutoText key="glidict::CDM.FormatManager.Add" type="button"/>.This will display the number of documents for each bookshelf in the <AutoText key="coredm::_Global:labelContributor_" type="italics"/> classifier.</Text>3106 <Text id="0784">This will display the number of documents for each bookshelf in the <AutoText key="coredm::_Global:labelContributor_" type="italics"/> classifier.</Text> 3130 3107 </NumberedItem> 3131 3108 <NumberedItem> … … 3142 3119 </Title> 3143 3120 <Prerequisite id="dspace_to_greenstone"/> 3144 <Version initial="2.60" current="2.7 0w"/>3121 <Version initial="2.60" current="2.71"/> 3145 3122 <Content> 3146 3123 <Comment> … … 3187 3164 <Version initial="2.70w" current="2.71"/> 3188 3165 <Content> 3189 <Text id="gems-2">GEMS (Greenstone Editor for Metadata Sets) can be used to modify existing metadata sets or create new ones. </Text>3166 <Text id="gems-2">GEMS (Greenstone Editor for Metadata Sets) can be used to modify existing metadata sets or create new ones. GEMS is launched from the Librarian Interface when you want to create a new metadata set, or edit an existing one. In this exercise, we run GEMS outside of the Librarian Interface.</Text> 3190 3167 <Heading> 3191 3168 <Text id="gems-3">Running GEMS</Text> … … 3196 3173 </NumberedItem> 3197 3174 <NumberedItem> 3198 <Text id="gems-6"> A list of all the available metadata sets is shown on the left hand side. Explore these metadata sets, and see what elements belong to each set. Double click on a folder icon to open the set. A list of elements will be displayed.</Text>3175 <Text id="gems-6">GEMS starts up with no metadata set loaded. You can start a new set, or open an existing one, from the <Menu><AutoText key="glidict::Menu.File"/></Menu> menu.</Text> 3199 3176 </NumberedItem> 3200 3177 <Heading> … … 3202 3179 </Heading> 3203 3180 <NumberedItem> 3204 <Text id="gems-8">In this exercise, we will create a new metadata set. In order to save time, we will base it on an existing one: Development Library Subset. From the <AutoText key="glidict::Menu.File"/> menu, select <AutoText key="glidict::Menu.File_New"/> (<AutoText key="glidict::Menu.File"/> → <AutoText key="glidict::Menu.File_New"/>). A popup window appears: <AutoText key="glidict::GEMS. Add_Set"/>. Fill in the fields. Use <AutoText text="My Metadata Set" type="quoted"/> for the <AutoText key="glidict::GEMS.Name"/>, <AutoText text="my" type="quoted"/> for the <AutoText key="glidict::GEMS.Namespace"/>, and select "Development Library Subset Example Metadata" from the <AutoText key="glidict::GEMS.inheritMetadataSet"/> drop down list. Click <AutoText key="glidict::General.OK" type="button"/>.</Text>3205 </NumberedItem> 3206 <NumberedItem> 3207 <Text id="gems-9"> A folder for <AutoText text="My Metadata Set"/> will appear in the metadata set list on the left. Double click the folder icon to see what elements it has. Since it was based on the Development Library Subset metadata set, itcontains all the elements from that set.</Text>3181 <Text id="gems-8">In this exercise, we will create a new metadata set. In order to save time, we will base it on an existing one: Development Library Subset. From the <AutoText key="glidict::Menu.File"/> menu, select <AutoText key="glidict::Menu.File_New"/> (<AutoText key="glidict::Menu.File"/> → <AutoText key="glidict::Menu.File_New"/>). A popup window appears: <AutoText key="glidict::GEMS.NewMetadataSetPrompt.Title"/>. Fill in the fields. Use <AutoText text="My Metadata Set" type="quoted"/> for the <AutoText key="glidict::GEMS.NewMetadataSetPrompt.Metadata_Title"/>, <AutoText text="my" type="quoted"/> for the <AutoText key="glidict::GEMS.NewMetadataSetPrompt.Metadata_Namespace"/>, and select "Development Library Subset Example Metadata" from the <AutoText key="glidict::GEMS.NewMetadataSetPrompt.Base_MetadataSet"/> drop down list. Click <AutoText key="glidict::General.OK" type="button"/>.</Text> 3182 </NumberedItem> 3183 <NumberedItem> 3184 <Text id="gems-9">The new metadata set will be displayed. The left hand side list the elements (and sub-elements, if any) for the set, and the right hand side displays the set or element attributes. Since the new set was based on the Development Library Subset metadata set, it already contains all the elements from that set.</Text> 3208 3185 </NumberedItem> 3209 3186 <Heading> … … 3211 3188 </Heading> 3212 3189 <NumberedItem> 3213 <Text id="gems-11">Right click on the <AutoText text="My Metadata Set (my)"/> item in the list of metadata sets, and choose <AutoText key="glidict::GEMS.Add_Element"/> from the menu that appears. In the popup window, type <AutoText text="Category" type="quoted"/> for the <AutoText key="glidict::GEMS.Name"/>, and click <AutoText key="glidict::General.OK" type="button"/>. The new element will appear in the list.</Text>3214 </NumberedItem> 3215 <NumberedItem> 3216 <Text id="gems-12"> Right click on the <AutoText text="my.Category"/> element and select <AutoText key="glidict::GEMS.Add_Attribute"/> from the menu. Select <AutoText text="definition"/> from the <AutoText key="glidict::GEMS.Name"/> drop down list, and enter <AutoText text="The category this resource belongs to" type="quoted"/> in the <AutoText key="glidict::GEMS.Values"/> box. The GLI uses the element definitions when displaying information about a metadata set.</Text>3190 <Text id="gems-11">Right click on <AutoText text="My Metadata Set"/> in the left hand tree (or in the blank space in the left hand side) and choose <AutoText key="glidict::GEMS.Popup.AddElement"/> from the menu that appears. In the popup window, type <AutoText text="Category" type="quoted"/> for the new element name, and click <AutoText key="glidict::General.OK" type="button"/>. The new element will appear in the list.</Text> 3191 </NumberedItem> 3192 <NumberedItem> 3193 <Text id="gems-12">In the right hand side, the default attributes will appear for the new element. "Label" and "definition" are used in the Librarian Interface when displaying metadata elements and their descriptions. These attributes can be set in multiple languages.</Text> 3217 3194 </NumberedItem> 3218 3195 <NumberedItem>
Note:
See TracChangeset
for help on using the changeset viewer.
