Changeset 24559 for documentation/trunk/tutorials
- Timestamp:
- 2011-09-05T16:04:17+12:00 (13 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
documentation/trunk/tutorials/xml-source/tutorial_en.xml
r24535 r24559 1677 1677 <NumberedItem> 1678 1678 <Text id="0533-6">In the <AutoText key="glidict::GUI.Gather"/> panel, you may notice that the MARC database has a different coloured icon to other files. A metadata database that can be exploded will be displayed with this green icon. Right-click on the file and choose <AutoText key="glidict::ExplodeMetadataPrompt.Title"/> from the menu. A new window opens, containing options for the exploding process. A description of each option can be obtained by hovering the mouse over the option.</Text> 1679 <Text id="0533-7">Turn on the <AutoText text="metadata_set"/> option by checking its box. This option indicates which metadata set to explode the metadata into. The default set is the "Exploded Metadata Set"—a metadata set which initially has no elements in it, but will receive a new element for each metadata field retrieved from the database.</Text>1679 If it's not already on, <Text id="0533-7">turn on the <AutoText text="metadata_set"/> option by checking its box. This option indicates which metadata set to explode the metadata into. The default set is the "Exploded Metadata Set"—a metadata set which initially has no elements in it, but will receive a new element for each metadata field retrieved from the database.</Text> 1680 1680 </NumberedItem> 1681 1681 <NumberedItem> … … 1783 1783 </NumberedItem> 1784 1784 <NumberedItem> 1785 <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 <AutoText text="ex.Photographer^all"/>, <AutoText text="ex.Country^all"/> and <AutoText text="ex.Notes^all"/> metadata. </Text>1785 <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 <AutoText text="ex.Photographer^all"/>, <AutoText text="ex.Country^all"/> and <AutoText text="ex.Notes^all"/> metadata. In the <AutoText key="glidict::CDM.GUI.SearchMetadata"/> section of the <AutoText key="glidict::GUI.Format"/> panel, you can set the display text for these indexes to "photographer", "country" and "notes".</Text> 1786 1786 <Text id="is-9">CDS/ISIS metadata has subfields, and these are represented using ^.</Text> 1787 1787 </NumberedItem> … … 2023 2023 </NumberedItem> 2024 2024 <NumberedItem> 2025 <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 on Windows, you would 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>2025 <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 on Windows, you would search the macro files for the image names using the <AutoText text="findstr"/> 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> 2026 2026 <Text id="mf-68">You can type <Command>findstr/?</Command> to see a description of the program and its arguments.</Text> 2027 2027 <Text id="mf-69">To search the macro files for <i><AutoText text="gsdlhead.gif" /></i> type</Text> … … 2108 2108 </NumberedItem> 2109 2109 <NumberedItem> 2110 <Text id="0562">Instead, add <AutoText key="metadata::dc.Title"/> metadata for these two files: "Magical Mystery Tour." Change tothe <AutoText key="glidict::GUI.Enrich"/> panel, open the discography folder and drill down to the individual files. Set the <AutoText key="metadata::dc.Title"/> value for the two offending items.</Text>2110 <Text id="0562">Instead, add <AutoText key="metadata::dc.Title"/> metadata for these two files: "Magical Mystery Tour." In the <AutoText key="glidict::GUI.Enrich"/> panel, open the discography folder and drill down to the individual files. Set the <AutoText key="metadata::dc.Title"/> value for the two offending items.</Text> 2111 2111 </NumberedItem> 2112 2112 <NumberedItem> … … 2401 2401 </Bullet> 2402 2402 <Bullet> 2403 <Text id="0666">Copy the content of <Path>sample_files → beatles → advbeat_large → import</Path> into this newly formed collection. Since there are considerably more files in this set of documents the copy will take longer. </Text>2403 <Text id="0666">Copy the content of <Path>sample_files → beatles → advbeat_large → import</Path> into this newly formed collection. Since there are considerably more files in this set of documents the copy will take longer. You may also want to use the file browser to copy the <Path>images</Path> and <Path>macros</Path> folders from the <Path>smallbea</Path> folder into the <Path>largebea</Path> folder, replacing anything already there.</Text> 2404 2404 </Bullet> 2405 2405 <Bullet> … … 2570 2570 </NumberedItem> 2571 2571 <Comment> 2572 <Text id="0690h">You might notice that newspaper level search results only display the newspaper Title, and not any volume information, while 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 Volume and Number information, and for page results, the newspaper title as well as the page number.</Text>2572 <Text id="0690h">You might notice that newspaper level search results only display a large scan of the newspaper page, the newspaper Title, and not any volume information, while 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 Volume and Number information, and for page results, the newspaper title as well as the page number.</Text> 2573 2573 </Comment> 2574 2574 <NumberedItem> … … 2785 2785 </Comment> 2786 2786 <NumberedItem> 2787 <Text id="oai-plugin-option">You need to specif iy which document the OAI metadata values should be attached to. In the <AutoText key="glidict::GUI.Design"/> panel, select the <AutoText key="glidict::CDM.GUI.Plugins"/> section, then select the <AutoText text="OAIPlugin"/> and click <AutoText key="glidict::CDM.PlugInManager.Configure" type="button"/>. Locate the <AutoText text="document_field"/> option in the popup window and select <AutoText text="dc.Resource Identifier"/> from the drop-down list. Click <AutoText key="glidict::General.OK" type="button"/>.</Text>2787 <Text id="oai-plugin-option">You need to specify which document the OAI metadata values should be attached to. In the <AutoText key="glidict::GUI.Design"/> panel, select the <AutoText key="glidict::CDM.GUI.Plugins"/> section, then select the <AutoText text="OAIPlugin"/> and click <AutoText key="glidict::CDM.PlugInManager.Configure" type="button"/>. Locate the <AutoText text="document_field"/> option in the popup window and select <AutoText text="dc.Resource Identifier"/> from the drop-down list. Click <AutoText key="glidict::General.OK" type="button"/>. Move the <AutoText text="OAIPlugin"/> above the <AutoText text="EmbeddedMetadataPlugin"/>.</Text> 2788 2788 </NumberedItem> 2789 2789 <NumberedItem> … … 2801 2801 </NumberedItem> 2802 2802 <NumberedItem> 2803 <Text id="0714">Add an <AutoText text="AZCompactList" /> classifier based on <AutoText key="metadata:: dc.Subject"/> metadata.</Text>2804 </NumberedItem> 2805 <NumberedItem> 2806 <Text id="0715">Now add an <AutoText text="AZCompactList" /> classifier based on <AutoText key="metadata:: dc.Description"/> metadata. In its configuration panel set <AutoText text="mingroup"/> to <AutoText text="2"/>, <AutoText text="mincompact"/> to <AutoText text="1"/>, <AutoText text="maxcompact"/> to <AutoText text="10"/> and <AutoText text="buttonname"/> to <AutoText text="Captions"/>.</Text>2803 <Text id="0714">Add an <AutoText text="AZCompactList" /> classifier based on <AutoText key="metadata::ex.dc.Subject"/> metadata. Configure it with "subjects" as the <AutoText text="buttonname"/>.</Text> 2804 </NumberedItem> 2805 <NumberedItem> 2806 <Text id="0715">Now add an <AutoText text="AZCompactList" /> classifier based on <AutoText key="metadata::ex.dc.Description"/> metadata. In its configuration panel set <AutoText text="mingroup"/> to <AutoText text="2"/>, <AutoText text="mincompact"/> to <AutoText text="1"/>, <AutoText text="maxcompact"/> to <AutoText text="10"/> and <AutoText text="buttonname"/> to <AutoText text="Captions"/>.</Text> 2807 2807 <Text id="0715a">Setting <AutoText text="mingroup"/> to 2 will mean that two or more documents with the same description will be grouped into a bookshelf; the default <AutoText text="mingroup"/> of 1 means that every document will get a bookshelf. <AutoText text="mincompact"/> and <AutoText text="maxcompact"/> control how many documents are grouped into each section of the horizontal A-Z list. In this case, each group can have as few as one document, and no more than ten.</Text> 2808 2808 </NumberedItem> 2809 2809 <NumberedItem> 2810 <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:: dc.Description"/> metadata.</Text>2810 <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.dc.Description"/> metadata. Set the <AutoText text="Display text"/> for the <AutoText key="metadata::ex.dc.Description"/> index by going to the <AutoText key="glidict::CDM.GUI.SearchMetadata"/> section in the <AutoText key="glidict::GUI.Format"/> panel and changing its label to "_labelDescription_".</Text> 2811 2811 </NumberedItem> 2812 2812 <NumberedItem> … … 2832 2832 <NumberedItem> 2833 2833 <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> 2834 <Format><h3>[ dc.Subject]</h3></Format>2835 <Comment> 2836 <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:: dc.Subject"/> metadata instead.</Text>2834 <Format><h3>[ex.dc.Subject]</h3></Format> 2835 <Comment> 2836 <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.dc.Subject"/> metadata instead.</Text> 2837 2837 </Comment> 2838 2838 </NumberedItem> … … 2841 2841 <Format><center><table width=_pagewidth_ border=1><br/> 2842 2842 <tr><td colspan=2 align=center><br/> 2843 <a href=[ dc.OrigURL]>[screenicon]</a></td></tr><br/>2844 <tr><td>Caption:</td><td> <i>[ dc.Description]</i> <br><br/>2845 (<a href=[ dc.OrigURL]>original [ImageWidth]x[ImageHeight] [ImageType] available</a>)<br/>2843 <a href=[ex.dc.OrigURL]>[screenicon]</a></td></tr><br/> 2844 <tr><td>Caption:</td><td> <i>[ex.dc.Description]</i> <br><br/> 2845 (<a href=[ex.dc.OrigURL]>original [ImageWidth]x[ImageHeight] [ImageType] available</a>)<br/> 2846 2846 </td></tr><br/> 2847 <tr><td>Subject:</td><td> [ dc.Subject]</td></tr><br/>2848 <tr><td>Publisher:</td><td> [ dc.Publisher]</td></tr><br/>2849 <tr><td>Rights:<td> [ dc.Rights]</td></tr><br/>2847 <tr><td>Subject:</td><td> [ex.dc.Subject]</td></tr><br/> 2848 <tr><td>Publisher:</td><td> [ex.dc.Publisher]</td></tr><br/> 2849 <tr><td>Rights:<td> [ex.dc.Rights]</td></tr><br/> 2850 2850 </table></center></Format> 2851 2851 <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> … … 2956 2956 </NumberedItem> 2957 2957 <NumberedItem> 2958 <Text id="0756">Switch to the <AutoText key="glidict::GUI.Design"/> panel and select <AutoText key="glidict::CDM.GUI.Plugins"/>. Remove <AutoText text="GreenstoneXMLPlugin"/> from the list of plug-ins and add <AutoText text="GreenstoneMETSPlugin" />, with the default configuration options. </Text>2958 <Text id="0756">Switch to the <AutoText key="glidict::GUI.Design"/> panel and select <AutoText key="glidict::CDM.GUI.Plugins"/>. Remove <AutoText text="GreenstoneXMLPlugin"/> from the list of plug-ins and add <AutoText text="GreenstoneMETSPlugin" />, with the default configuration options. Move this plugin to where <AutoText text="GreenstoneXMLPlugin"/> was (just below <AutoText text="ZipPlugin"/>).</Text> 2959 2959 </NumberedItem> 2960 2960 <NumberedItem> … … 2986 2986 </NumberedItem> 2987 2987 <NumberedItem> 2988 <Text id="0768">In the <AutoText key="glidict::GUI.Gather"/> panel, locate the folder <Path>sample_files → dspace</Path>. It contains five example items exported from a DSpace institutional repository. Copy them into your collection by dragging them over to the right-hand side of the panel. </Text>2988 <Text id="0768">In the <AutoText key="glidict::GUI.Gather"/> panel, locate the folder <Path>sample_files → dspace</Path>. It contains five example items exported from a DSpace institutional repository. Copy them into your collection by dragging them over to the right-hand side of the panel. Cancel out of any dialog offering to add plugins.</Text> 2989 2989 </NumberedItem> 2990 2990 <NumberedItem> … … 3014 3014 <Text id="0776">The DSpace exported files contain Dublin Core metadata for title and author (amongst other things).</Text> 3015 3015 <NumberedItem> 3016 <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:: dc.Contributor"/>. Rename the <AutoText key="metadata::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>3017 </NumberedItem> 3018 <NumberedItem> 3019 <Text id="0779">Go back to the <AutoText key="glidict::GUI.Design"/> panel, select <AutoText key="glidict::CDM.GUI.Classifiers"/>. Select the <AutoText key="metadata::ex.Source"/> <AutoText text="List" /> classifier and click <AutoText key="glidict::CDM.ClassifierManager.Configure" type="button"/>. Change the <AutoText text="metadata"/> option to <AutoText key="metadata:: dc.Contributor"/>. Activate the <AutoText text="bookshelf_type"/> option and set its value to <AutoText text="always"/>. Activate the <AutoText text="partition_type_within_level"/> option and set it to <AutoText text="none"/>. Click <AutoText key="glidict::General.OK" type="button"/> to close the dialog.</Text>3016 <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> 3017 </NumberedItem> 3018 <NumberedItem> 3019 <Text id="0779">Go back to the <AutoText key="glidict::GUI.Design"/> panel, select <AutoText key="glidict::CDM.GUI.Classifiers"/>. Select the <AutoText key="metadata::ex.Source"/> <AutoText text="List" /> classifier and click <AutoText key="glidict::CDM.ClassifierManager.Configure" type="button"/>. Change the <AutoText text="metadata"/> option to <AutoText key="metadata::ex.dc.Contributor"/>. Activate the <AutoText text="bookshelf_type"/> option and set its value to <AutoText text="always"/>. If not already active, activate the <AutoText text="partition_type_within_level"/> option. Then set it to <AutoText text="none"/>. Finally, activate <AutoText text="buttonname"/> and set this to "contributors". Click <AutoText key="glidict::General.OK" type="button"/> to close the dialog.</Text> 3020 3020 </NumberedItem> 3021 3021 <NumberedItem> … … 3026 3026 </NumberedItem> 3027 3027 <NumberedItem> 3028 <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 starts with:</Text>3028 <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> 3029 3029 <Indent> 3030 CL2: List -metadata <AutoText key="metadata:: dc.Contributor" type="plain"/>3030 CL2: List -metadata <AutoText key="metadata::ex.dc.Contributor" type="plain"/> 3031 3031 </Indent> 3032 3032 </NumberedItem> … … 3038 3038 <Text id="0783a">with</Text> 3039 3039 <Format> 3040 {If}{[numleafdocs],([numleafdocs]) [ex.Title],[ dc.Title]}3040 {If}{[numleafdocs],([numleafdocs]) [ex.Title],[ex.dc.Title]} 3041 3041 </Format> 3042 3042 <Text id="0784">This will display the number of documents for each bookshelf in the <AutoText key="coredm::_Global:labelContributor_" type="italics"/> classifier.</Text> … … 3271 3271 <Text id="depositor-7">Enabling <AutoText key="coredm::_depositor:textdepositor_"/></Text> 3272 3272 </Heading> 3273 <Text id="depositor-8">For Windows users, first make sure that you are using a Web Server (e.g. Apache) instead of the Local Library Server. The binary installation of Greenstone will install Apache, but by default the Local Library Server will be used. To switch to using Apache, rename the <Path>GSDLHOME → server.exe</Path> file to something else.</Text>3273 <Text id="depositor-8">For Windows users, first make sure that you are using a Web Server (e.g. Apache) instead of the Local Library Server. The binary installation of Greenstone will install Apache, but by default the Local Library Server will be used. To switch to using Apache, <AutoText text="rename"/> the <Path>GSDLHOME → server.exe</Path> file to something else. Then re-run the Greenstone Server, from the <Path>Start → Greenstone Server</Path> menu.</Text> 3274 3274 <Text id="depositor-access">Note: You might need to set permissions for the <Path>GSDLHOME → tmp</Path> and <Path>GSDLHOME → collect</Path> or <Path>GSDLHOME → collect → your_accessible_collection</Path> directory.</Text> 3275 3275 <Text id="depositor-enable">In Greenstone, <AutoText key="coredm::_depositor:textdepositor_"/> is disabled by default. To enable it, edit the file <Path>GSDLHOME → etc → main.cfg</Path>. Look for the "depositor" line, and change <i>disabled</i> to <i>enabled</i>.</Text> … … 3289 3289 </NumberedItem> 3290 3290 <NumberedItem> 3291 <Text id="depositor-user5">At the end of each user entry there are two links: <AutoText key="auxdm::_userslistusers:textedituser_"/> and <AutoText key="auxdm::_userslistusers:textdeleteuser_"/>. Click <AutoText key="auxdm::_userslistusers:textedituser_"/> on the <AutoText text="demo"/> user account, and you will be shown more detailed information about the demo user. Add <AutoText text="demoluce-collection-editor"/> at the end of the <AutoText key="auxdm::_userslistusers:textgroups_"/> line, using a comma to separate group entries. (Note, if your collection shortname is not demoluce, then replace demoluce with the appropriate name in ***-collection-editor.</Text> 3291 <Text id="depositor-user5">At the end of each user entry there are two links: <AutoText key="auxdm::_userslistusers:textedituser_"/> and <AutoText key="auxdm::_userslistusers:textdeleteuser_"/>. Click <AutoText key="auxdm::_userslistusers:textedituser_"/> on the <AutoText text="demo"/> user account, and you will be shown more detailed information about the demo user. Add <AutoText text="demoluce-collection-editor"/> at the end of the <AutoText key="auxdm::_userslistusers:textgroups_"/> line, using a comma to separate group entries, so that the <AutoText key="auxdm::_userslistusers:textgroups_"/> field now contains: 3292 <Format>demo, demoluce-collection-editor.</Format> (Note, if your collection shortname is not demoluce, then replace demoluce with the appropriate name in ***-collection-editor.)</Text> 3292 3293 </NumberedItem> 3293 3294 <NumberedItem> … … 3318 3319 </NumberedItem> 3319 3320 <NumberedItem> 3320 <Text id="depositor-13">Click the <AutoText key="auxdm::_depositor:textintro_"/> button. Click the <b>Choose File</b> button and select <Path>sample_files → demo → new → r9006e.htm</Path>, click the <AutoText key="auxdm::_depositor:textconfirm_"/> button and check the document has been uploaded successfully.</Text>3321 <Text id="depositor-13">Click the <AutoText key="auxdm::_depositor:textintro_"/> button. Click the <b>Choose File</b> button and select <Path>sample_files → demo_NewFiles → new → r9006e.htm</Path>, click the <AutoText key="auxdm::_depositor:textconfirm_"/> button and check the document has been uploaded successfully.</Text> 3321 3322 </NumberedItem> 3322 3323 <NumberedItem>
Note:
See TracChangeset
for help on using the changeset viewer.