Changeset 26030 for documentation/trunk/tutorials
- Timestamp:
- 2012-07-26T19:57:23+12:00 (12 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
documentation/trunk/tutorials/xml-source/tutorial_en.xml
r26012 r26030 647 647 <MajorVersion number="3"><Text id="0359d">Click on the <b>browse</b> Format Feature. Find the section under <b>documentNode</b> where it says</Text> 648 648 <Format> 649 <td valign="top"> 650 <highlight><gsf:displayText name="ImageName"/>:<gsf:metadata name="Image"/><br/></highlight>651 <gsf:displayText name="Width"/>:<gsf:metadata name="ImageWidth"/><br/> 652 <gsf:displayText name="Height"/>:<gsf:metadata name="ImageHeight"/><br/> 653 <gsf:displayText name="Size"/>:<gsf:metadata name="ImageSize"/> 649 <td valign="top"><br /> 650 <Tab n="1"/><highlight><gsf:displayText name="ImageName"/>:<gsf:metadata name="Image"/><br/></highlight><br /> 651 <Tab n="1"/><gsf:displayText name="Width"/>:<gsf:metadata name="ImageWidth"/><br/><br /> 652 <Tab n="1"/><gsf:displayText name="Height"/>:<gsf:metadata name="ImageHeight"/><br/><br /> 653 <Tab n="1"/><gsf:displayText name="Size"/>:<gsf:metadata name="ImageSize"/><br /> 654 654 </td></Format> 655 655 <Text id="0395d">Edit the text as follows:</Text></MajorVersion> … … 1471 1471 </NumberedItem> 1472 1472 <NumberedItem> 1473 <Text id="assoc-files-5">Copy the files pdf03.pdf and word03.doc provided in sample_files → Word_and_PDF → Documents i mages into your new collection. Do this by dragging these files across from the filesystem view on the left of the <AutoText key="glidict::GUI.Gather"/> panel into the collection view on the right.</Text>1473 <Text id="assoc-files-5">Copy the files pdf03.pdf and word03.doc provided in sample_files → Word_and_PDF → Documents into your new collection. Do this by dragging these files across from the filesystem view on the left of the <AutoText key="glidict::GUI.Gather"/> panel into the collection view on the right.</Text> 1474 1474 </NumberedItem> 1475 1475 <NumberedItem> … … 3310 3310 <MajorVersion number="3"> 3311 3311 <NumberedItem> 3312 <Text id="gs-oai-3-3">For this exercise, we will be visiting the <b>Open Archives Validator</b>, for which your OAIserver needs to provide a valid email address. In a text editor, open up your Greenstone installation's <AutoText text="web/WEB-INF/classes/OAIConfig.xml" type="italics"/> file again and set the value of the <Format>adminEmail</Format> element to your email address to which you would like to get the validation resultssent. If testing the behaviour of the <Format>resumptionToken</Format>, set the <Format>resumeAfter</Format> element to a low value like 5.</Text>3313 </NumberedItem> 3314 <NumberedItem> 3315 <Text id="gs-oai-3-4">Restart the Greenstone 3 server if it was running. Otherwise, go to <Menu>Start → Greenstone → Greenstone3 Server</Menu> to start up the server. When the library home page opens in your browser, change the library suffix in the URL to oaiserver to visit the OAIServer page. Copy this URL.</Text>3312 <Text id="gs-oai-3-3">For this exercise, we will be visiting the <b>Open Archives Validator</b>, for which your OAIserver needs to provide a valid email address. In a text editor, open up your Greenstone installation's <AutoText text="web/WEB-INF/classes/OAIConfig.xml" type="italics"/> file again and set the value of the <Format>adminEmail</Format> element to the email address where the validation results are to be sent. If testing the behaviour of the <Format>resumptionToken</Format>, set the <Format>resumeAfter</Format> element to a low value like 5.</Text> 3313 </NumberedItem> 3314 <NumberedItem> 3315 <Text id="gs-oai-3-4">Restart the Greenstone 3 server if it was running. Otherwise, go to <Menu>Start → Greenstone → Greenstone3 Server</Menu> to start up the server. When the library home page opens in your browser, change the library suffix in the URL to <Format>oaiserver</Format>, which is the baseURL of your OAI Server. Copy this URL and visit <Link>http://www.openarchives.org/Register/ValidateSite</Link>.</Text> 3316 3316 </NumberedItem> 3317 3317 </MajorVersion> 3318 3318 <NumberedItem> 3319 <Text id="gs-oai-16">The Open Archives Validator page will request the URL to your Greenstone OAI server. Paste the URL you have in your copy buffer into the field provided for this, and press the <b>Validate baseURL</b> button to start running the tests. You will be told to check your email to continue the remaining tests and get the validation report.</Text>3320 <Text id="gs-oai-17">If the validator does not recognise the URL, make sure you have given the full domain of your host machine rather than just the host name. If th e URL is still not accepted, visit the <AutoText text="oaiserver.cgi?verb=Identify" type="italics"/> page again and check that works. If it doesn't, maybe your machine is not set up to be accessible to outside networks. Check your proxy settings, make sure you've set up port forwarding and that your firewall is not interfering.</Text>3319 <Text id="gs-oai-16">The Open Archives Validator page will request the URL to your Greenstone OAI server. Paste the URL you have in your copy buffer into the field provided for this, and press the <b>Validate baseURL</b> button to start running the tests. You will be told to check your email to continue the remaining tests and to get the validation report.</Text> 3320 <Text id="gs-oai-17">If the validator does not recognise the URL, make sure you have given the full domain of your host machine rather than just the host name. If that URL is still not accepted, visit the <AutoText text="oaiserver.cgi?verb=Identify" type="italics"/> page again and check this works. If it doesn't, it may be your machine is not set up to be accessible to outside networks. Check your proxy settings, make sure you've set up port forwarding and that your firewall is not interfering.</Text> 3321 3321 </NumberedItem> 3322 3322 </Content> … … 3491 3491 <Text id="0776">The DSpace exported files contain Dublin Core metadata for title and author (amongst other things).</Text> 3492 3492 <NumberedItem> 3493 <Text id="0778">In the <AutoText key="glidict::GUI.Design"/> panel, select <AutoText key="glidict::CDM.GUI.Indexes"/>. Delete the <AutoText key="metadata::ex.Source"/> index, and add one for <AutoText key="metadata::ex.dc.Contributor"/>. Rename the <AutoText key="metadata::ex.dc.Contributor"/> index by going to the <AutoText key="glidict::CDM.GUI.SearchMetadata"/> section in the <AutoText key="glidict::GUI.Format"/> panel, select this index and change its value to "_labelAuthor_". Using a macro for an index name means that it will display in the correct language (assuming that the macro has been translated). You can check <Path>Greenstone → macros → english.dm</Path> to see which macros are available.</Text> 3493 <Text id="0778">In the <AutoText key="glidict::GUI.Design"/> panel, select <AutoText key="glidict::CDM.GUI.Indexes"/>. Delete the <AutoText key="metadata::ex.Source"/> index, and add one for <AutoText key="metadata::ex.dc.Contributor"/>. Rename the <AutoText key="metadata::ex.dc.Contributor"/> index by going to the <AutoText key="glidict::CDM.GUI.SearchMetadata"/> section in the <AutoText key="glidict::GUI.Format"/> panel. Select this index and change its value to "_labelAuthor_". Using a macro for an index name means that it will display in the correct language (assuming that the macro has been translated). <MajorVersion number="2">You can check <Path>Greenstone → macros → english.dm</Path> to see which macros are available.</MajorVersion> 3494 <MajorVersion number="3"><AutoText text="authors" type="italics"/></MajorVersion>.</Text> 3494 3495 </NumberedItem> 3495 3496 <NumberedItem> … … 3497 3498 </NumberedItem> 3498 3499 <NumberedItem> 3499 <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> 3500 <Format> 3501 {If}{[ex.equivlink],<br>Also available as:[ex.equivlink]} 3502 </Format> 3503 </NumberedItem> 3504 <NumberedItem> 3505 <Text id="0782">Also, let's add a format statement for the classifier based on <AutoText key="metadata::ex.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 starts with:</Text> 3500 <Text id="0780">Now select the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, and select the <MajorVersion number="2"><AutoText text="VList" /></MajorVersion><MajorVersion number="3"><AutoText text="browse"/></MajorVersion> format statement in the list of assigned format statements. Add the following text before the final <Format></td></Format><MajorVersion number="3"> of the <AutoText text="documentNode"/> template</MajorVersion>:</Text> 3501 <Format> 3502 <MajorVersion number="2">{If}{[ex.equivlink],<br>Also available as:[ex.equivlink]}</MajorVersion> 3503 <MajorVersion number="3"> 3504 <gsf:switch><br /> 3505 <Tab n="1"/><gsf:metadata name="equivDocLink"/><br /> 3506 <Tab n="1"/><gsf:when test="exists"><br /> 3507 <Tab n="2"/><br/>Also available as:<gsf:equivlinkgs3/><br /> 3508 <Tab n="1"/></gsf:when><br /> 3509 </gsf:switch> 3510 </MajorVersion> 3511 </Format> 3512 </NumberedItem> 3513 <NumberedItem> 3514 <Text id="0782">Also, let's add a format statement for the classifier based on <AutoText key="metadata::ex.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 starts with:</Text> 3506 3515 <Indent> 3507 3516 CL2: List -metadata <AutoText key="metadata::ex.dc.Contributor" type="plain"/> … … 3509 3518 </NumberedItem> 3510 3519 <NumberedItem> 3511 <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> 3512 <Format> 3513 {Or}{[dc.Title],[exp.Title],[ex.Title],Untitled} 3520 <Text id="0783"><MajorVersion number="2">Leave <AutoText text="VList" /> as the <AutoText key="glidict::CDM.FormatManager.Part"/> and click</MajorVersion><MajorVersion number="3">Click</MajorVersion> <AutoText key="glidict::CDM.FormatManager.Add" type="button"/>. Edit the text in the <AutoText key="glidict::CDM.FormatManager.Editor"/> box. <MajorVersion number="3">Adjust the <AutoText text="documentNode"/> template of this format statement to make reference to <Format><gsf:equivlinkgs3/></Format> too, exactly as in the previous step. Then replace</MajorVersion><MajorVersion number="2">Replace</MajorVersion></Text> 3521 <Format> 3522 <MajorVersion number="2">{Or}{[dc.Title],[exp.Title],[ex.Title],Untitled}</MajorVersion> 3523 <MajorVersion number="3"> 3524 <gsf:choose-metadata><br /> 3525 <Tab n="1"/><gsf:metadata name="dc.Title"/><br /> 3526 <Tab n="1"/><gsf:metadata name="exp.Title"/><br /> 3527 <Tab n="1"/><gsf:metadata name="ex.dc.Title"/><br /> 3528 <Tab n="1"/><gsf:metadata name="Title"/><br /> 3529 <Tab n="1"/><gsf:default>Untitled</gsf:default><br /> 3530 </gsf:choose-metadata> 3531 </MajorVersion> 3514 3532 </Format> 3515 3533 <Text id="0783a">with</Text> 3516 3534 <Format> 3517 {If}{[numleafdocs],([numleafdocs]) [ex.Title],[ex.dc.Title]} 3518 </Format> 3519 <Text id="0784">This will display the number of documents for each bookshelf in the <AutoText key="coredm::_Global:labelContributor_" type="italics"/> classifier.</Text> 3535 <MajorVersion number="2">{If}{[numleafdocs],([numleafdocs]) [ex.Title],[ex.dc.Title]</MajorVersion> 3536 <MajorVersion number="3"> 3537 <gsf:metadata name="ex.dc.Title"/> 3538 </MajorVersion> 3539 </Format> 3540 <MajorVersion number="3"> 3541 <Text id="0783b">Then scroll down to the <AutoText text="classifierNode"/> template for <AutoText text="VList" />s. Here too, locate the same <Format><gsf:choose-metadata> ... </gsf:choose-metadata></Format> format statement as before, but this time replace it with the following:</Text> 3542 <Format> 3543 <gsf:metadata name="Title"/>(<gsf:metadata name="numleafdocs"/>) 3544 </Format> 3545 </MajorVersion> 3546 <Text id="0784">This will display the number of documents for each bookshelf in the <AutoText key="coredm::_Global:labelContributor_" type="italics"/> classifier. 3547 <MajorVersion number="3">And for individual documents within each bookshelf, it will display the <AutoText text="ex.dc.Title"/>.</MajorVersion></Text> 3520 3548 </NumberedItem> 3521 3549 <NumberedItem>
Note:
See TracChangeset
for help on using the changeset viewer.
