Changeset 23504 for documentation/trunk/tutorials
- Timestamp:
- 2010-12-16T23:05:44+13:00 (13 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
documentation/trunk/tutorials/xml-source/tutorial_en.xml
r23499 r23504 685 685 </Heading> 686 686 <NumberedItem> 687 <Text id="0381">Now we'll add a new browsing option based on the descriptions. In the <AutoText key="glidict::GUI.Design"/> panel, select <AutoText key="glidict::CDM.GUI.Classifiers"/> from the left-hand list. Set the menu item for <AutoText key="glidict::CDM.ClassifierManager.Classifier"/> to <AutoText text="List" /> ; then click <AutoText key="glidict::CDM.ClassifierManager.Add" type="button"/>. A dialog for configuring this plugin will apppear. In here, click the <AutoText text="partition_type_within_level"/> check box and choose <AutoText text="none"/> from the drop-down list and click <AutoText key="glidict::General.OK" type="button"/>.</Text>688 </NumberedItem> 689 <NumberedItem> 690 <Text id="0382">A window pops up to control the classifier's options. Set the <AutoText text="metadata"/> option to <AutoText key="metadata::dc.Description"/> and click <AutoText key="glidict::General.OK" type="button"/>.</Text>687 <Text id="0381">Now we'll add a new browsing option based on the descriptions. In the <AutoText key="glidict::GUI.Design"/> panel, select <AutoText key="glidict::CDM.GUI.Classifiers"/> from the left-hand list. Set the menu item for <AutoText key="glidict::CDM.ClassifierManager.Classifier"/> to <AutoText text="List" />, then click <AutoText key="glidict::CDM.ClassifierManager.Add" type="button"/>.</Text> 688 </NumberedItem> 689 <NumberedItem> 690 <Text id="0382">A window pops up to control the classifier's options. Set the <AutoText text="metadata"/> option to <AutoText key="metadata::dc.Description"/>. Next, click the <AutoText text="partition_type_within_level"/> check box and choose <AutoText text="none"/> from the drop-down list. Click <AutoText key="glidict::General.OK" type="button"/>.</Text> 691 691 </NumberedItem> 692 692 <NumberedItem> … … 871 871 <NumberedItem> 872 872 <Text id="fw-14">Next, we'll customize the format for the <AutoText key="coredm::_Global:labelCreator_" type="italics"/> list. Classifier bookshelves have only a few pieces of metadata to display: <Format>[ex.Title]</Format> and <Format>[numleafdocs]</Format>. Whatever metadata the classifier has been built on, the bookshelf label is always stored as <Format>[ex.Title]</Format>. This is why a Creator is printed out for each bookshelf even though <Format>[dc.Creator]</Format> is not specified in the format statement. <Format>[numleafdocs]</Format> is only defined for bookshelves, so this metadata can be used in an <Format>{If}</Format> statement to make bookshelves and documents display differently in the list.</Text> 873 <Text id="fw-15">Make each bookshelf in the Creator classifier show how many entries it contains. In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, select the <AutoText text="CL2 AZCompactList"/> classifier which is based on <AutoText key="metadata::dc.Creator"/> metadatafrom the <AutoText key="glidict::CDM.FormatManager.Feature"/> drop down list, and <AutoText text="VList"/> from the <AutoText key="glidict::CDM.FormatManager.Part"/> list. Click the <AutoText key="glidict::CDM.FormatManager.Add" type="button"/> button to add this format into the list of assigned formats. Note that it gets added as <AutoText text="CL2VList"/> in this list: it is the <AutoText text="VList"/> format for the second (<AutoText text="CL2"/>) classifier.</Text>873 <Text id="fw-15">Make each bookshelf in the Creator classifier show how many entries it contains. In the <AutoText key="glidict::CDM.GUI.Formats"/> section of the <AutoText key="glidict::GUI.Format"/> panel, select the <AutoText text="CL2 AZCompactList"/> classifier (which is based on <AutoText key="metadata::dc.Creator"/> metadata) from the <AutoText key="glidict::CDM.FormatManager.Feature"/> drop down list, and <AutoText text="VList"/> from the <AutoText key="glidict::CDM.FormatManager.Part"/> list. Click the <AutoText key="glidict::CDM.FormatManager.Add" type="button"/> button to add this format into the list of assigned formats. Note that it gets added as <AutoText text="CL2VList"/> in this list: it is the <AutoText text="VList"/> format for the second (<AutoText text="CL2"/>) classifier.</Text> 874 874 <Text id="fw15a">Append the following text to the bottom of the format statement:</Text> 875 875 <Format> … … 912 912 </Heading> 913 913 <NumberedItem> 914 <Text id="0321d-2">You may notice that the <AutoText text="AZCompactList"/> classifier has two options after the <AutoText text="metadata"/> option: <AutoText text="firstvalueonly"/> and <AutoText text="allvalues"/>. Manually added metadata can be used to replace or enhance automatically extracted metadata, and these options control exactly which pieces of metadata a document is classified by.</Text>914 <Text id="0321d-2">You may notice that the <AutoText text="AZCompactList"/> classifier's configuration dialog has two options after the <AutoText text="metadata"/> option: <AutoText text="firstvalueonly"/> and <AutoText text="allvalues"/>. Manually added metadata can be used to replace or enhance automatically extracted metadata, and these options control exactly which pieces of metadata a document is classified by.</Text> 915 915 <Text id="0321d-3">For example, say we have two documents. Document 1 has four Creators specified (dc.Creator = dcA, dc.Creator = dcB, ex.Creator = exA, ex.Creator = exB), while document 2 has three (ex.Creator = exA, ex.Creator = exB, ex.Creator = exC). The following table shows which metadata values each document is classified by, for the different classifier options:</Text> 916 916 <table> … … 1096 1096 </Heading> 1097 1097 <NumberedItem> 1098 <Text id="ew-8b">The Librarian Interface operates in three modes. Go to <Menu><AutoText key="glidict::Menu.File"/> → <AutoText key="glidict::Menu.File_Options"/> → <AutoText key="glidict::Preferences.Mode"/></Menu> and see the modes and what functionality they provide access to. <AutoText key="glidict::Preferences.Mode.Librarian"/> is the default mode. </Text>1098 <Text id="ew-8b">The Librarian Interface operates in three modes. Go to <Menu><AutoText key="glidict::Menu.File"/> → <AutoText key="glidict::Menu.File_Options"/> → <AutoText key="glidict::Preferences.Mode"/></Menu> and see the modes and what functionality they provide access to. <AutoText key="glidict::Preferences.Mode.Librarian"/> is the default mode. Check that this is indeed the currently active mode.</Text> 1099 1099 </NumberedItem> 1100 1100 <Heading> … … 1132 1132 </Format> 1133 1133 <Text id="ew-12">These header options define which styles should be considered as title, level 1, level 2 and level 3 styles. </Text> 1134 <Text id="ew-12a">Ensure that the <AutoText text="windows_scripting"/> option is checked, and set the options as follows(spaces in the Word styles are removed when converting to HTML styles, and these options must match the HTML styles):</Text>1135 <Format> 1136 level1_header: (ChapterTitle|AppendixTitle)<br/>1137 level2_header: SectionHeading<br/>1138 level3_header: SubsectionHeading<br/>1139 title_header : ManualTitle1134 <Text id="ew-12a">Ensure that the <AutoText text="windows_scripting"/> option is checked, and set the 4 header options to the values highlighted in the following (spaces in the Word styles are removed when converting to HTML styles, and these options must match the HTML styles):</Text> 1135 <Format> 1136 level1_header: <highlight>(ChapterTitle|AppendixTitle)</highlight><br/> 1137 level2_header: <highlight>SectionHeading</highlight><br/> 1138 level3_header: <highlight>SubsectionHeading</highlight><br/> 1139 title_header : <highlight>ManualTitle</highlight> 1140 1140 </Format> 1141 1141 <!-- … … 1175 1175 </NumberedItem> 1176 1176 <NumberedItem> 1177 <Text id="ew-28">In the <AutoText key="glidict::GUI.Design"/> panel, under <AutoText key="glidict::CDM.GUI.Plugins"/>, configure <AutoText text="WordPlugin"/> once again. Switch on the configuration option <AutoText text="metadata_fields"/>. Set the value to </Text>1178 <Format> 1179 Title,Author<Creator>,Subject,Keywords<Subject> 1177 <Text id="ew-28">In the <AutoText key="glidict::GUI.Design"/> panel, under <AutoText key="glidict::CDM.GUI.Plugins"/>, configure <AutoText text="WordPlugin"/> once again. Switch on the configuration option <AutoText text="metadata_fields"/>. Set the value to the following (but make sure not to enter any trailing spaces)</Text> 1178 <Format> 1179 Title,Author<Creator>,Subject,Keywords<Subject> 1180 1180 </Format> 1181 1181 <Text id="ew-29">This will make <AutoText text="WordPlugin"/> try to extract Title, Author, Subject and Keywords metadata. Title and Subject will be saved with the same name, while Author will be saved as Creator metadata, and Keywords as Subject metadata.</Text> … … 1242 1242 </Heading> 1243 1243 <NumberedItem> 1244 <Text id="0393">The browsing facilities in this collection (<AutoText key="coredm::_Global:labelTitle_" type="italics"/> and <AutoText key="coredm::_Global:labelSource_" type="italics"/>) are based entirely on extracted metadata. Returnto the <AutoText key="glidict::GUI.Enrich"/> panel in the Librarian Interface and examine the metadata that has been extracted for some of the files.</Text>1244 <Text id="0393">The browsing facilities in this collection (<AutoText key="coredm::_Global:labelTitle_" type="italics"/> and <AutoText key="coredm::_Global:labelSource_" type="italics"/>) are based entirely on extracted metadata. Switch to the <AutoText key="glidict::GUI.Enrich"/> panel in the Librarian Interface and examine the metadata that has been extracted for some of the files.</Text> 1245 1245 </NumberedItem> 1246 1246 <NumberedItem> … … 1696 1696 <td valign="top">[highlight]<br/> 1697 1697 {Or}{[dc.Title],[exp.Title],[ex.Title],Untitled}<br/> 1698 [/highlight]{If}{[ex.Source],<br><i>([ex.Source])</i>} 1698 [/highlight]{If}{[ex.Source],<br><i>([ex.Source])</i>}</td> 1699 1699 </Format> 1700 1700 <Text id="0533-11c">Since there is no <AutoText key="metadata::dc.Title"/> metadata and <AutoText key="metadata::exp.Title"/> comes before <AutoText key="metadata::ex.Title"/>, the exploded titles will be displayed.</Text> … … 2024 2024 <NumberedItem> 2025 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> 2026 <Text id="mf-68">You can type <Command>find /?</Command> to see a description of the program and its arguments.</Text>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> 2028 <Command>find 2029 <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> is 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>2028 <Command>findstr /s /m /C:"gsdlhead.gif" "C:\Program Files\Greenstone\macros\*.dm"</Command> 2029 <Text id="mf-70"><AutoText text="*.dm"/> means all files ending in <AutoText text=".dm"/> (while <AutoText text="/s"/> tells it to search within subfolders and <AutoText text="/m"/> lists the files that matched). 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> is 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> 2030 2030 <Text id="mf-71">Do the same thing for <i><AutoText text="chalk.gif" /></i>:</Text> 2031 <Command>find 2031 <Command>findstr /s /m /C:"chalk.gif" "C:\Program Files\Greenstone\macros\*.dm"</Command> 2032 2032 <Text id="mf-72"><Path>base.dm</Path> and <Path>style.dm</Path> are the only files that mention this image.</Text> 2033 2033 <Text id="mf-73">Close the command prompt.</Text> … … 2304 2304 </Bullet> 2305 2305 <Bullet> 2306 <Text id="0637"> Activate <AutoText text="removesuffix"/>and set it to:</Text>2306 <Text id="0637">Click the <AutoText key="glidict::CDM.ClassifierManager.Configure" type="button"/> button on it. Activate its <AutoText text="removesuffix"/> option and set it to:</Text> 2307 2307 <Format>(?i)(\\s+\\d+)|(\\s+[[:punct:]].*)</Format> 2308 2308 </Bullet>
Note:
See TracChangeset
for help on using the changeset viewer.