source: trunk/gli/help/7-7.htm@ 4459

Last change on this file since 4459 was 4293, checked in by jmt12, 21 years ago

Initial revision
  • Property svn:keywords set to Author Date Id Revision
File size: 8.5 KB
Line 
1<html>
2<head>
3<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
4<title>The Gatherer - Help Pages</title>
5</head>
6<body bgcolor="#E0F0E0" link="#000000" vlink="#000000">
7<table border="2" bgcolor="#B0D0B0" cellpadding="5" cellspacing="0" width="100%">
8 <tr>
9 <td align="center" width="15%">
10 <img height="45" src="gatherer_medium.gif" width="45">
11 </td>
12 <td align="center" width="*">
13 <font face="Verdana" size="5">
14 <strong>
157.7 Classifiers
16 </strong>
17 </font>
18 </td>
19 <td align="center" width="15%">
20 <img height="45" src="gatherer_medium.gif" width="45">
21 </td>
22 </tr>
23 <tr bgcolor="#E0F0E0">
24 <td colspan="3" width="100%">
25 <font face="Verdana" size="3">
26<p style="text-align:justify">
27This section explains the process of assigning classifiers to your collection using the Librarian Interface.
28</p>
29
30 </font>
31 </td>
32 </tr>
33 <tr bgcolor="#E0F0E0">
34 <td align="center" colspan="3" width="100%">
35 <table border="2" cellpadding="2" width="480" bgcolor="#B0D0B0">
36 <tr>
37 <td align="center">
38 <font face="Verdana" size="4">
39 <strong>
40 Contents
41 </strong>
42 </font>
43 </td>
44 </tr>
45 <tr>
46 <td>
47 <table background="gatherer.gif" bgcolor="#FFFFFF" border="0" cellpadding="2" width="100%">
48 <tr>
49 <td colspan="3">
50 <font face="Verdana" size="4">
51 <strong>
52<a href="#SI">Simple instructions</a>
53 </strong>
54 </a>
55 </font>
56 </td>
57 </tr>
58 <tr>
59 <td>
60 &nbsp;
61 </td>
62 <td colspan="2">
63 <font face="Verdana" size="4">
64Classifier selection and configuration
65 </font>
66 </a>
67 </td>
68 </tr>
69 <tr>
70 <td>
71 &nbsp;
72 </td>
73 <td colspan="2">
74 <font face="Verdana" size="4">
75Add a classifier
76 </font>
77 </a>
78 </td>
79 </tr>
80 <tr>
81 <td>
82 &nbsp;
83 </td>
84 <td colspan="2">
85 <font face="Verdana" size="4">
86Remove a classifier
87 </font>
88 </a>
89 </td>
90 </tr>
91 <tr>
92 <td>
93 &nbsp;
94 </td>
95 <td colspan="2">
96 <font face="Verdana" size="4">
97Configure a classifier
98 </font>
99 </a>
100 </td>
101 </tr>
102 <tr>
103 <td colspan="3">
104 <font face="Verdana" size="4">
105 <strong>
106<a href="#AI">Advanced instructions</a>
107 </strong>
108 </a>
109 </font>
110 </td>
111 </tr>
112 <tr>
113 <td>
114 &nbsp;
115 </td>
116 <td colspan="2">
117 <font face="Verdana" size="4">
118Rebuilding the classifier database
119 </font>
120 </a>
121 </td>
122 </tr>
123 <tr>
124 <td>
125 &nbsp;
126 </td>
127 <td colspan="2">
128 <font face="Verdana" size="4">
129Custom classifiers
130 </font>
131 </a>
132 </td>
133 </tr>
134 <tr>
135 <td>
136 &nbsp;
137 </td>
138 <td colspan="2">
139 <font face="Verdana" size="4">
140CustomAZList
141 </font>
142 </a>
143 </td>
144 </tr>
145 </font>
146 </table>
147 </td>
148 </tr>
149 </table>
150 </td>
151 </tr>
152 <tr bgcolor="#E0F0E0">
153 <td colspan="3" width="100%">
154 <img height="20" src="gatherer_small.gif" width="20">
155 <font face="Verdana" size="4">
156 <u>
157<a name="SI">Simple Instructions:</a>
158 </u>
159 <font size="3">
160<p style="text-align:justify">
161The classifiers sub-view is just the same as the plug-in sub-view, except that there are no movement controls.
162</p>
163<p style="text-align:justify">
164To add a classifier, choose it from the ComboBox of known classifiers. Click the [A]dd Specified Classifier button, configure the classifier as desired, and commit the changes. Once this is done the new classifier appears in the list of assigned classifiers.
165</p>
166<p style="text-align:justify">
167To remove a classifier, select it from the list and click [R]emove Selected Classifier.
168</p>
169<p style="text-align:justify">
170To change the argument configuration of a classifier, select it from the list and press [C]onfigure Selected Classifier. Instructions for the 'Configuring Arguments' dialog are just the same as for plug-ins (except for custom classifiers explained below).
171</p>
172
173 </font>
174 </p>
175 </td>
176 </tr>
177 <tr bgcolor="#E0F0E0">
178 <td colspan="3" width="100%">
179 <img height="20" src="gatherer_small.gif" width="20">
180 <font face="Verdana" size="4">
181 <u>
182<a name="AI">Advanced Instructions:</a>
183 </u>
184 <font size="3">
185<p style="text-align:justify">
186As for plug-ins, the Librarian Interface automatically rebuilds the classifier database when it detects that the old one is missing. This is how new standard classifiers can be registered with the Librarian Interface. Make sure that the classifier is in an appropriate directory, then rename the file 'classifiers.dat' from the Librarian Interface's installation directory. The next time the Librarian Interface requires classifier data it will rebuild the database, including the new classifier. Note that this is not the same as using custom classifiers. Also, as with plugins, you requires the latest classifier and clasinfo.pl to ensure the -xml flag is supported. Again such versions are available for download from the Librarian Interface site.
187</p>
188<p style="text-align:justify">
189A custom classifier is not a classifier in itself, but instead uses one or more basic classifiers to accomplish an advanced classification task. Custom classifiers are written in Java (not PERL like other classifiers) and dynamically loaded when the Librarian Interface is started. To add a new custom classifier, place it in the classes/org/greenstone/gatherer/cdm/custom directory within the Librarian Interface install directory. (On a more technical note, custom classifiers implement the class org.greenstone.gatherer.cdm.CustomClassifier.) Aside from the control differences explained below, custom classifiers are added, configured and removed in the same way as regular ones.
190</p>
191<p style="text-align:justify">
192The CustomAZList classifier, included with the Librarian Interface, is an example of a custom classifier. It allows users to build an AZList, and specify what the various letter ranges should be, e.g. #,A-F,G-P,Q-Z. This is accomplished by using a Hierarchy classifier behind the scenes, and adding hidden metadata to files in the collection.
193</p>
194<p style="text-align:justify">
195Custom classifiers provide a fully-customized set of controls for the purposes of configuration. The CustomAZList classifier has a distinct dialog window, with two familiar fields, metadata and button name, at the top. Most of the pane is taken by several rows of buttons, each one matching a letter of the alphabet (with # for numbers), and a field below that shows the current letter ranges. Toggling a button on (so it appears selected) indicates the letter a range should begin with. There are two buttons at the bottom. [C]reate Classifier causes the custom classifier to be applied to the collection. While adding normal classifiers is just a case of writing an extra line in the collection configuration file, custom classifiers may require changes to the entire collection. Thus the creation of a custom classifier can take considerable time. Clicking the [C]ancel button rolls back any changes and prevents the CustomAZList from being added.
196</p>
197
198 </font>
199 </p>
200 </td>
201 </tr>
202</table>
203&nbsp;<br>
204&nbsp;<br>
205&nbsp;<br>
206&nbsp;<br>
207&nbsp;<br>
208&nbsp;<br>
209&nbsp;<br>
210&nbsp;<br>
211&nbsp;<br>
212&nbsp;<br>
213&nbsp;<br>
214&nbsp;<br>
215&nbsp;<br>
216&nbsp;<br>
217&nbsp;<br>
218&nbsp;<br>
219&nbsp;<br>
220&nbsp;<br>
221&nbsp;<br>
222&nbsp;<br>
223&nbsp;<br>
224&nbsp;<br>
225&nbsp;<br>
226&nbsp;<br>
227&nbsp;<br>
228&nbsp;<br>
229&nbsp;<br>
230&nbsp;<br>
231&nbsp;<br>
232&nbsp;<br>
233&nbsp;<br>
234&nbsp;<br>
235</body>
236</html>
Note: See TracBrowser for help on using the repository browser.