Changeset 5334


Ignore:
Timestamp:
2003-08-28T16:44:32+12:00 (21 years ago)
Author:
kjdon
Message:

checked the help against the code. some bits are added for the future

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/gli/help/in.txt

    r5279 r5334  
    55The Greenstone Librarian Interface is a tool for collecting and marking up documents, then building digital
    66library collections.  It provides access to the Greenstone Digital Library
    7 Software's functionality from an graphical point and click interface.
     7Software's functionality from a graphical point and click interface.
    88<$FOOTER>
    99
     
    6363To access a menu, hold down [ALT] and press the corresponding letter
    6464(underlined).  For example, for the "File" menu press [ALT] + [F].  To choose an
    65 item, press the corresponding key.  For example.  Thus once in the File menu
     65item, press the corresponding key.  For example, while in the File menu
    6666press [S] to "Save" a collection.
    6767
     
    1031032.0 Starting Off
    104104<$DESCRIPTION>
    105 This chapter covers how to create, save and load a collection.
     105This section covers how to create, save and load a collection.
    106106<$FOOTER>
    107107
     
    142142need to, in the design view.
    143143
    144 "Title" is the text displayed at the top of your collection's homepage.  It can
     144"Title" is the text displayed at the top of your collection's home page.  It can
    145145be any length.
    146146
     
    194194Save your work regularly by opening the "File" menu and choosing "Save".
    195195Saving a collection is not the same as making it ready for use in Greenstone
    196 (see Chapter 8 -- Producing Your Collection).
     196(see Section 8 -- Producing Your Collection).
    197197
    198198The Librarian Interface protects your work by saving it whenever you exit the
     
    255255<$DESCRIPTION>
    256256
    257 The Librarian Interface can run in different configurations.  This chapter only
    258 applies when the "browse" and/or "mirror" views are enabled.  If these tabs do
     257The Librarian Interface can run in different configurations.  This section only
     258applies when the "hunt" and/or "mirror" views are enabled.  If these tabs do
    259259not appear, advanced users can enable them by editing the "config.xml" file in
    260260the Librarian Interface installation folder (or, on a multiuser system, in your
    261 home directory's ".gli" folder) to set the values of "workspace.browse" and
    262 "workspace.mirror" to "true".
     261home directory's ".gli" folder) to set the values of "workflow.browse" and
     262"workflow.mirror" to "true".
    263263
    264264When using web resources, the Librarian Interface operates in two stages.  This
    265 chapter describes the first, Hunting, where you browse the Internet for files
    266 of interest.
     265section describes the first, Hunting, where you browse the Internet for files
     266of interest. The next section describes the second stage, Mirroring, where these files can be downloaded.
    267267
    268268<$FOOTER>
     
    2992994.0 Downloading Chosen Files
    300300<$DESCRIPTION>
    301 To enable web mirroring see Section 3.1 -- The Hunt View.
     301To enable web mirroring see Section 3.0 -- Hunting For Your Files.
    302302To download web pages you need to install the mirroring tool wget (version v1.8
    303303recommended) and make it accessible from the Librarian Interface "install"
    304304folder.
    305305
    306 When using web resources, the second stage is to download (or "mirror") the
    307 files you need.  This chapter explains the Librarian Interface's mirroring
     306Once web resources, the second stage is to download (or "mirror") the
     307files you need.  This section explains the Librarian Interface's mirroring
    308308process.
    309309
     
    334334<a name="SI">Simple Instructions:</a>
    335335
    336 Access the "Mirror" view by clicking its tab.  On the left is the workspace tree
    337 described in section 5.1 -- The Gather View.  The bottom of the screen shows a
    338 list of pending download jobs.  On the right are the controls used to control
    339 downloading.
     336Access the "Mirror" view by clicking its tab. The top half of the screen shows the downloading controls. The bottom half is initially empty, but will show a list of pending downloading jobs if there are some.
    340337
    341338Files are downloaded into a folder in the workspace tree called "Public
    342339WebCache" (only present when mirroring is enabled), and can be used in all
    343340collections built with the Librarian Interface.  When a collection is open a
    344 second folder, "Private WebCache", appears, associated with that collection so
    345 that it alone has access.  Files in both these areas are named by their full web
     341second folder, "Private WebCache", appears, which only that collection can access files from.  Files in both these areas are named by their full web
    346342URL.  A new folder is created for each host, followed by others for each part
    347343of the path.  This ensures that each file is distinct.
    348344
    349 Use the first of the download configuration controls to enter the URL of a
     345Use the first of the download configuration controls, "Source URL", to enter the URL of a
    350346target resource.  If you have come from the "Hunt" view, this field points to
    351347the last page visited.  Use the "Download Depth" control to determine how many
    352 hyperlinks to follow when downloading: 0 means no hyperlinks and grabs just the
    353 target resource; "infinite" would grab the entire Internet! The depth limit is
    354 ignored when downloading media other than html pages.  Use the next radio
     348 hyperlinks deep to go when downloading: 0 means follow no hyperlinks and grabs just the
     349target resource. The depth limit is
     350ignored when downloading media other than html pages.  Use the "Destination Folder" radio
    355351button control to choose whether the files are cached into the shared public
    356 folder or the private collection-specific folder.  Checking "Automatically
    357 download embedded objects" also downloads any objects needed to render the page
    358 properly (irrespective of the depth setting).  Use the next control to
    359 determine whether to mirror files from paths above the target URL.  "Only
    360 mirror within the same site" restricts the mirroring to files with the same
    361 host name.  The next control determines whether local files can be overwritten
    362 during download.  The next one, in the "Download List Options" group,
    363 determines what happens to download tasks that fail for some reason.  This
    364 takes effect immediately, rather than pertaining to a specific download job as
    365 the other specifications do.  The final control is a "Download" button which
    366 adds to the download list a new job corresponding to the configuration
     352folder or the private collection-specific folder (if available). Next, there are four checkbox controls which can be set to turn on the specified feature for a specific download. A fifth checkbox control "Automatically remove failed downloads..." does not pertain to a specific download, but instead clears the list of any failed download information, and prevents any future failures from appearing in the list. The final control is a "Download" button, which adds to the download list a new job corresponding to the configuration
    367353settings.
    368354
     
    374360pauses the current download.  The "stop" square on the right button removes the
    375361current download task from the list.  Download tasks are removed from the list
    376 when they finish successfully (ones that fail are controlled by the "Download
    377 List Options").
     362when they finish successfully (ones that fail are controlled by the "Automatically remove failed downloads..." checkbox).
    378363
    379364<$NORMAL>
     
    394379Once you have a new collection you need to get some files into it.  These may
    395380come from your ordinary file space, or from other Greenstone collections.  Some
    396 may already have attached metadata.  This chapter describes how to import files.
     381may already have attached metadata.  This section describes how to import files.
    397382
    398383<$FOOTER>
     
    433418
    434419Select an item in the tree by clicking it.  (There are other ways; see below.)
    435 Double-click a folder, or the switch symbol beside it, to expand (or collapse)
     420Double-click a folder, or single-click the switch symbol beside it, to expand (or collapse)
    436421its contents.  Double-click a file to open it using its associated application
    437422program (see Section 10.2 -- File Associations).
     
    453438Interface: how many items are selected and what action is requested.  It
    454439reports on the progress of actions that involve files, which can take some time
    455 to complete.
    456 
    457 Three large buttons occupy the lower right corner of the screen.  "Cancel"
    458 stops any file movement tasks that are occurring.  "New Folder", with a picture
    459 of a folder, creates new folders (see Section 5.2 -- Creating folders).
    460 "Delete", with a garbage can, removes files.
     440to complete. The "Stop" button stops any action that is currently in progress.
     441
     442Two large buttons occupy the lower right corner of the screen. "New Folder", with a picture
     443of a folder, creates new folders (see Section 5.2 -- Creating folders).
     444"Delete", with a garbage can, removes files. Clicking the Delete button will remove any selected files from the Collection file tree. Alternatively, files can be deleted by dragging them onto the Delete button.
    461445
    462446<$NORMAL> <a name="AI">Advanced Instructions:</a>
    463447
    464 To select several contiguous items, select the first and then hold down [Shift]
     448To select several sequential items, select the first and then hold down [Shift]
    465449and click on the last -- the selection will encompass all intervening
    466450items.  Select non-sequential files by holding down [Ctrl] while clicking.  Use
     
    468452
    469453Certain folders -- such as the one containing your own web pages -- sometimes
    470 have special significance.  The Librarian Interface can map such pages to at
     454have special significance.  The Librarian Interface can map such folders to
    471455the first level of the file tree.  To do this, right-click the desired
    472456folder.  Select "Map", and enter a name for the folder.  To remove an item,
     
    491475<a name="SI">Simple Instructions:</a>
    492476
    493 Use folders in the Workspace file tree to group files together and make them
     477Use folders in the Collection file tree to group files together and make them
    494478easier to find.  Folders can be placed inside folders.  There is virtually no
    495479limit to how many folders you can have or how deeply they can be nested.
     
    603587<a name="SI">Simple Instructions:</a>
    604588
    605 The "All Files" pull-down menu underneath each tree shows a list of predefined
     589The "Show Files" pull-down menu underneath each tree shows a list of predefined
    606590filters, such as "Images".  Choosing this temporarily hides all other files in
    607591the tree.  To restore the tree, change the filter back to "All Files".  These
     
    624608
    625609Having gathered several files into the collection, now enrich them with
    626 additional information called "metadata".  This chapter explains how metadata is
     610additional information called "metadata".  This section explains how metadata is
    627611created, edited, assigned and retrieved, and how to use external metadata
    628 sources (see Chapter 2 of the Greenstone Developer's Guide -- Getting the most
     612sources (also see Chapter 2 of the Greenstone Developer's Guide -- Getting the most
    629613out of your documents).
    630614
     
    657641the author's name).
    658642
    659 On the left of the "Enrich" view is the Collection Tree.  When you select files
    660 their details appear in the Metadata Table on the right.
    661 
    662 The Metadata Table appears the upper right of the screen when files are
    663 selected and shows all metadata for the selected files.  Columns are named in
     643On the left of the "Enrich" view is the Collection Tree. To the right is the Metadata Table, which shows metadata for any selected files or folders in the Collection Tree.  Columns are named in
    664644grey at the top, and can be resized by dragging the separating line.  Clicking
    665645any row transfers its details to the MetaEdit Controls below.  If several files
     
    680660opens a larger editing box.  In the buttons below, "Append" assigns the value as
    681661new metadata and adds it to any existing values for the selected element,
    682 "Replace" overwrites any existing value(s) with the new one, and "Remove clears
    683 any existing values.  Underneath, labelled "All Previous Values", is the "Value
     662"Replace" overwrites the selected existing value with the new one, and "Remove" clears
     663the selected value.  Underneath, labelled "All Previous Values", is the "Value
    684664Tree".
    685665
     
    690670typed.  Pressing [Enter] auto-completes the typing with the selected value.
    691671
    692 The Value Tree also shows hierarchical structures.  Values can be grouped
    693 together, and a group can be assigned as a metadata value.  Each value has a
    694 "path" obtained by tracing down to it from the tree root, and the path can be
    695 typed into the text field using the character "\" to separate the levels.  For
    696 example, in a hierarchy that represents a pack of playing cards you might type
    697 "Cards\Red\Diamonds\Seven".
     672Metadata values can be organised into a hierarchy. This is shown in the Value Tree using folders for internal levels. Hierarchical values can be entered using the character "\" to separate the levels.  For
     673example, "Cards\Red\Diamonds\Seven" might be used in a hierarchy that represents a pack of playing cards. This enables values to be grouped together. Groups can also be assigned as metadata to files.
    698674
    699675Greenstone extracts metadata automatically from documents into a metadata set
     
    733709metadata set is pre-pended to the element name.  For instance the Dublin Core
    734710element Creator becomes "dc.Creator".  Metadata sets are stored in the
    735 Librarian Interface's folder and have the suffix ".mds".
     711Librarian Interface's metadata folder and have the suffix ".mds".
    736712
    737713To add a metadata set, choose "Metadata Sets" from the menu bar and select the
    738714"Import Set" action.  A list appears that shows the sets stored in the Librarian
    739715Interface's metadata folder.  Choose one and open it, or click "Browse" to
    740 locate metadata set files stored elsewhere.  You may be asked whether to import
     716locate metadata set files stored elsewhere. If the metadata elements have associated value trees, you will be asked whether to import
    741717all values associated with the elements in the set, just those values that make
    742718up the structure of hierarchy-based metadata, or no values at all.
     
    820796it automatically inherit the folder's values.
    821797
    822 When you add metadata to an element that already has some, you need to decide
    823 what to do.  You are shown the name of the file in question, the element's
     798When you add metadata to multiple files at once, you will be prompted for confirmation for any files that already have a value for that metadata. You are shown the name of the file in question, the element's
    824799title, previously-assigned values for this element, and the new value.  The
    825800buttons offer different options: "Append" appends the metadata to the file
    826801without altering any existing values; "Append All" adds the new value to all
    827 other files too; "Replace" replaces the previous value; "Replace All" replaces
    828 it for all other files too; "Skip File" proceeds to the next file; "Cancel"
     802other files too, without requiring individual confirmation; "Skip File" proceeds to the next file; "Cancel"
    829803undoes any changes and cancels the action.
    830804
     
    835809<a name="AI">Advanced Instructions:</a>
    836810
    837 You can add structure to metadata values by using paths as described in section
     811You can add structure to metadata values by using paths as described in Section
    8388126.1 -- The Enrich View.  Correct any mistakes in creating hierarchies by using
    839 the metadata set editor explained in Chapter 11.1 -- Editing Metadata Sets.
     813the metadata set editor explained in Section 11.1 -- Editing Metadata Sets.
    840814
    841815<$FOOTER>
     
    859833
    860834To add metadata that has an existing value, first select the file, then select
    861 the required value from the value tree, expanding subject folders as
     835the required value from the value tree, expanding hierarchy folders as
    862836necessary.  The value of the selected entry automatically appears in the Value
    863837text field (alternatively, use the value tree's auto-select and auto-complete
     
    961935<a name="SI">Simple Instructions:</a>
    962936
    963 Sometimes you need to see the metadata assigned to all files -- for instance,
     937Sometimes you need to see the metadata assigned to many or all files at once -- for instance,
    964938to determine how many files are left to work on, or to get some idea of the
    965939spread of dates.
    966940
    967 >From the "Metadata Set" menu choose "Assigned Metadata...".  A window called
     941Select the files you wish to examine, and from the "Metadata Set" menu choose "Assigned Metadata...".  A window called
    968942"All Metadata", dominated by a large table with many columns, appears.  The
    969943first column shows file names; the rows show all metadata values assigned to
    970 that file.
    971 
    972 Drawing the table can take some time.  You can continue to use the Librarian
     944those files.
     945
     946Drawing the table can take some time if many files are selected.  You can continue to use the Librarian
    973947Interface while the "All Metadata" window is open.
    974948
     
    10451019Once you have specified how to import a certain piece of metadata, the mapping
    10461020information is retained for the collection's lifetime.  To correct any mistakes
    1047 during importing, use the metadata set editor described in Chapter 11 -- Editing
     1021during importing, use the metadata set editor described in Section 11 -- Editing
    10481022Metadata Sets.
    10491023
    1050 For details on how design metadata.xml files see Chapter 2 of the Greenstone
     1024For details on the metadata.xml files which Greenstone uses to store the metadata, see Chapter 2 of the Greenstone
    10511025Developer's Guide -- Getting the most out of your documents.
    10521026
     
    10621036searchable?  What ways are provided to browse through the documents?  What
    10631037languages are supported?  Where do the buttons appear on the page?  These
    1064 things can be customized; this chapter describes how to do it.
     1038things can be customized; this section describes how to do it.
    10651039
    10661040<$FOOTER>
     
    11301104<$FILE name=7-3.htm>
    11311105<$HEADER>
    1132 7.3 Plug-Ins
    1133 <$DESCRIPTION>
    1134 This section describes how to configure the document plug-ins the
     11067.3 Document Plugins
     1107<$DESCRIPTION>
     1108This section describes how to configure the document plugins the
    11351109collection uses.  It explains how you specify what
    1136 plug-ins to use, what parameters to pass to them, and in what order
    1137 they occur.  Under "Design Sections", click "Plug-ins".
    1138 
    1139 <$CONTENTS_HEADER>
    1140 <$SECTION>
    1141 <a href="#SI">Simple instructions</a>
    1142 <$SUBSECTION>
    1143 Add a plug-in
    1144 <$SUBSECTION>
    1145 Remove a plug-in
    1146 <$SUBSECTION>
    1147 Configure a plug-in
    1148 <$SUBSECTION>
    1149 Change plug-in order
     1110plugins to use, what parameters to pass to them, and in what order
     1111they occur.  Under "Design Sections", click "Document Plugins".
     1112
     1113<$CONTENTS_HEADER>
     1114<$SECTION>
     1115<a href="#SI">Simple instructions</a>
     1116<$SUBSECTION>
     1117Add a plugin
     1118<$SUBSECTION>
     1119Remove a plugin
     1120<$SUBSECTION>
     1121Configure a plugin
     1122<$SUBSECTION>
     1123Change plugin order
    11501124<$SECTION>
    11511125<a href="#AI">Advanced instructions</a>
     
    11531127Custom configuration
    11541128<$SUBSECTION>
    1155 Rebuilding the plug-in database
    1156 <$CONTENTS_FOOTER>
    1157 <$NORMAL>
    1158 <a name="SI">Simple Instructions:</a>
    1159 
    1160 To add a plug-in, use the "Select plug-in to add" pull-down list near the
    1161 bottom and then click "Add Specified Plug-in".  A window appears entitled
     1129Rebuilding the plugin database
     1130<$CONTENTS_FOOTER>
     1131<$NORMAL>
     1132<a name="SI">Simple Instructions:</a>
     1133
     1134To add a plugin, select it using the "Select plugin to add" pull-down list near the
     1135bottom and then click "Add Plugin".  A window appears entitled
    11621136"Configuring Arguments"; it is described later.  Once you have configured the
    1163 new plug-in, it is added to the end of the "Currently Assigned Plug-Ins" list.
    1164 Note that a plug-in may only occur once in the list.
    1165 
    1166 To remove a plug-in, select it in the list and click "Remove Selected Plug-in".
    1167 
    1168 Plug-Ins are configured by providing arguments.  To alter them, select the
    1169 plug-in from the list and click "Configure Selected Plug-in" (or double-click
    1170 the plug-in).  A "Configuring Arguments" dialog appears with three parts: a
     1137new plugin, it is added to the end of the "Currently Assigned Plugins" list.
     1138Note that a plugin may only occur once in the list.
     1139
     1140To remove a plugin, select it in the list and click "Remove Plugin".
     1141
     1142Plugins are configured by providing arguments.  To alter them, select the
     1143plugin from the list and click "Configure Plugin" (or double-click
     1144the plugin).  A "Configuring Arguments" dialog appears with three parts: a
    11711145text field for entering custom arguments, an area containing controls for
    11721146specifying arguments, and two buttons at the bottom.
    11731147
    11741148There are different kinds of controls.  Some are checkboxes, and clicking one
    1175 adds the appropriate option to the plug-in.  Others are text strings, with a
     1149adds the appropriate option to the plugin.  Others are text strings, with a
    11761150checkbox and a text field.  Click the box to enable the argument, then type
    11771151appropriate text (regular expression, file path etc) in the box.  Others are
     
    11831157
    11841158When you have changed the configuration, click "OK" to commit the changes and
    1185 close the dialog, or "Cancel" to close the dialog without changing any plug-in
     1159close the dialog, or "Cancel" to close the dialog without changing any plugin
    11861160arguments.
    11871161
    1188 The plug-ins in the list are executed in order, and the ordering is sometimes
    1189 important.  Two plug-ins, ArcPlug and RecPlug, are vital to the collection
     1162The plugins in the list are executed in order, and the ordering is sometimes
     1163important.  Two plugins, ArcPlug and RecPlug, are vital to the collection
    11901164building process, and are fixed in place at the end of the list (with a
    1191 separator line).  To change the ordering, select the plug-in you want to move
     1165separator line).  To change the ordering of the other ones, select the plugin you want to move
    11921166and click "Move To Top", "Move Up", "Move Down", or "Move To Bottom".
    11931167
    11941168<$NORMAL> <a name="AI">Advanced Instructions:</a>
    11951169
    1196 The Librarian Interface does its best to determine what arguments a plug-in
     1170The Librarian Interface does its best to determine what arguments a plugin
    11971171supports.  However, there may be cases where the user wants to specify special
    11981172arguments, and for this a text field called "Custom Arguments" (at the top) is
    1199 provided.  Any text in it is appended verbatim to the end of the plug-in
     1173provided.  Any text in it is appended verbatim to the end of the plugin
    12001174command.
    12011175
     
    12251199When you enter the Search Types view, first check "Enable Advanced
    12261200Searches", which activates the other controls.  This migrates the collection to
    1227 Greenstone 2.4 format, which supports for fielded searching, and means that (a)
     1201Greenstone 2.4 format, which supports fielded searching, and means that (a)
    12281202the index design is different (explained in section 7.5 -- Search Indexes),
    12291203(b) there are more text fragments to translate (see Section 7.10 --
     
    12341208re-enter them manually.
    12351209
    1236 To add a search type, select it from the "Search Types" list and click "Add New
    1237 Search Type".  Each type can only appear in the list once.
     1210To add a search type, select it from the "Search Types" list and click "Add Search Type".  Each type can only appear in the list once.
    12381211
    12391212To remove a search type, select it from the "Currently Assigned Search Types"
    1240 list and click "Remove Selected Search Type".  The list must contain at least
     1213list and click "Remove Search Type".  The list must contain at least
    12411214one search type.
    12421215
    12431216To change to order of a search type, select it from the list and click "Move
    1244 Up" or "Move Down".
     1217Up" or "Move Down". The first one will be the default.
    12451218
    12461219<$FOOTER>
     
    12801253The default index, the one used on the collection's search page, is tagged with
    12811254"[Default Index]" in the "Assigned Indexes" list.  To set it, select an index
    1282 from the list and click "Set Default".  To reset it, click "Clear Index".
    1283 
    1284 If advanced searching is enabled, the index controls are different.  Each index
    1285 is based on just one data source.  There is a new data source "allfields" which
    1286 is equivalent to entering a list of all the metadata elements.  Levels are not
     1255from the list and click "Set Default".  To reset it, click "Clear Default".
     1256
     1257If advanced searching is enabled (via the Search Types view), the index controls are different.  Each index
     1258is based on just one data source.  There is a new pseudo-data source "allfields" which provides searching across all specified indexes at once.  Levels are not
    12871259assigned to a specific index, but apply across all indexes: thus indexes and
    12881260levels are added separately.  Indexes are removed in the same way as above, but
    1289 the default index can no longer controls be set and cleared -- it is simply the
     1261the default index can no longer be set -- it is simply the
    12901262first index assigned.
    12911263
     1264To create indexes on all sources, click the "Add All" button. The name of each index will default to the source name. To change the name, select an index, change its details, and click "Replace Index".
    12921265<$FOOTER>
    12931266
     
    13361309"Excluding" them.  Finally, you can specify any of the standard PERL regular
    13371310expression flags to use when matching (e.g.  "i" for case-insensitive matching).
    1338 Finally, click "Add" to add the filter to the "Defined Subcollection Filters"
     1311Finally, click "Add Filter" to add the filter to the "Defined Subcollection Filters"
    13391312list.
    13401313
    1341 To remove a filter, select it from the list and click "Remove".
     1314To remove a filter, select it from the list and click "Remove Filter".
    13421315
    13431316To alter a filter, select it from the list, change any of the values that
    1344 appear in the editing controls and click "Update" to commit the changes.
     1317appear in the editing controls and click "Replace Filter" to commit the changes.
    13451318
    13461319<$FOOTER>
     
    13681341Having defined a subcollection filter, use the "Assign Partitions" tab to build
    13691342indexes for it (or for a group of filters).  Select the desired filter (or
    1370 filters) from the "Defined Subcollection Filters" list and click "Add
    1371 Partition".
     1343filters) from the "Defined Subcollection Filters" list, enter a name for your partition in the "Partition Name" field,  and click "Add Partition".
    13721344
    13731345To remove a partition, select it from the list and click "Remove Partition".
    13741346
    13751347To make a partition the default one, select it from the list and click "Set
    1376 Default Partition".
    1377 
    1378 To clear the default partition, click "Clear Default Partition".
     1348Default".
     1349
     1350To clear the default partition, click "Clear Default".
    13791351<$FOOTER>
    13801352
     
    14101382"Remove Language".
    14111383
    1412 To set the default language, select it from the list and click "Set Default
    1413 Language".
    1414 
    1415 To clear the default language, click "Clear Default Language".
     1384To set the default language, select it from the list and click "Set Default".
     1385
     1386To clear the default language, click "Clear Default".
    14161387<$FOOTER>
    14171388
     
    14231394Greenstone can search across several different collections as though they were
    14241395one.  This is done by creating a "super-collection" that comprises the
    1425 individual collections.  Under "Design Sections", click "Super-Collection".
     1396individual collections.  Under "Design Sections", click "Cross-Collection Search".
    14261397
    14271398<$CONTENTS_HEADER>
     
    14341405<a name="SI">Simple Instructions:</a>
    14351406
    1436 The Super-Collection view shows a checklist of available collections.  The
     1407The Cross-Collection Search view shows a checklist of available collections.  The
    14371408current collection is ticked and cannot be deselected.  To add another
    14381409collection to be searched in parallel, click it in the list (click again to
     
    14491420
    14501421This section explains how to assign "classifiers", which are used for browsing,
    1451 to the collection.  Under "Design Sections", click "Classifiers".
     1422to the collection.  Under "Design Sections", click "Browsing Classifiers".
    14521423
    14531424<$CONTENTS_HEADER>
     
    14721443<a name="SI">Simple Instructions:</a>
    14731444
    1474 To add a classifier, use the "Select classifier to add" pull-down list near the
     1445To add a classifier, select it using the "Select classifier to add" pull-down list near the
    14751446bottom and then click "Add Specified Classifier".  A window appears entitled
    14761447"Configuring Arguments"; instructions for this dialog are just the same as for
    1477 plug-ins (see Section 7.3 -- Plug-Ins).  Once you have configured the new
     1448plugins (see Section 7.3 -- Plugins).  Once you have configured the new
    14781449classifier, it is added to the end of the "Currently Assigned Classifiers"
    14791450list.
     
    15181489to develop, and you should read Chapter 2 of the Greenstone Developer's Guide.
    15191490This section discusses the format settings, and how the Librarian Interface
    1520 gives access to them.  Under "Design Sections", click "Format".
     1491gives access to them.  Under "Design Sections", click "Format Features".
    15211492
    15221493<$CONTENTS_HEADER>
     
    15311502<$SUBSECTION>
    15321503Update format command
     1504<$SECTION>
     1505<a href="#AI">Advanced instructions</a>
     1506<$SUBSECTION>
     1507Extended formatting options
    15331508<$CONTENTS_FOOTER>
    15341509<$NORMAL>
     
    15391514you select a feature, there are two types of control.  Some features are simply
    15401515enabled or disabled, and this is controlled by a checkbox.  Others require a
    1541 format string to be specified.  For these there is a text area ("Edit Format
    1542 String") for entering the string, a pull-down list ("Affected Component") for
    1543 selecting which part of the feature the string applies to (if necessary), and a
    1544 selection of predefined "Variables".  To insert a variable into the current
    1545 position in the format string, select it from the pull-down list and click
    1546 "Insert".
     1516format string to be specified.  For these there is a pull-down list ("Affected
     1517Component") for selecting which part of the feature the string applies to
     1518(if necessary), a text area ("HTML Format String") for entering the string,
     1519and a selection of predefined "Variables".  To insert a variable into the
     1520current position in the format string, select it from the pull-down list and
     1521click "Insert".
    15471522
    15481523You can specify a default format for a particular component by selecting the
    15491524blank feature.  This format is then applied to all applicable features unless
    15501525otherwise specified.
    1551 
    1552 For more information about variables and the feature components, read Chapter 2
    1553 of the Greenstone Developer's Guide.
    15541526
    15551527To add a new format command, fill out the information as explained above and
     
    15611533
    15621534To change a format command, select it from the list, modify the settings, and
    1563 click "Update Format".
     1535click "Replace Format".
     1536
     1537For more information about variables and the feature components, read Chapter 2
     1538of the Greenstone Developer's Guide.
     1539
     1540<$NORMAL>
     1541<a name="AI">Advanced Instructions:</a>
     1542
     1543If the "Allow Extended Options" checkbox is ticked, some advanced formatting options are enabled. The list of features that can be formatted is changed slightly, and more variables are available to be used in the format command, providing greater control over the page layout.
    15641544
    15651545<$FOOTER>
     
    15721552This section describes the translation view, where you can define
    15731553language-specific text fragments for parts of the collection's interface.
    1574 Under "Design Sections", click "Translation".
     1554Under "Design Sections", click "Translate Text".
    15751555
    15761556<$CONTENTS_HEADER>
     
    15971577
    15981578To edit a translation, select it, edit it in the "Translated Text" text
    1599 area, and click "Update Translation".
     1579area, and click "Replace Translation".
    16001580
    16011581<$FOOTER>
     
    16311611Having collected the documents for the collection, annotated them with
    16321612metadata, and designed how the collection will appear, you can now produce the
    1633 collection using Greenstone.  This chapter explains how.
     1613collection using Greenstone.  This section explains how.
    16341614
    16351615<$FOOTER>
     
    16491629collection-building scripts on the information you have provided.  This is
    16501630generally straightforward: just click "Build Collection" at the bottom of the
    1651 screen.  However, the building process can be customized.  You can also use this
    1652 view is to review details of previous attempts to build this collection,
     1631screen.  However, the building process can be customized.  You can also use
     1632this view to review details of previous attempts to build this collection,
    16531633whether successful or not.
    16541634
     
    16821662<$SUBSECTION>
    16831663Build settings
    1684 <$SUBSECTION>
    1685 All settings
    1686 <$SUBSECTION>
    1687 Spinner control
    1688 <$SUBSECTION>
    1689 CheckList control
    16901664<$CONTENTS_FOOTER>
    16911665<$NORMAL>
     
    16951669give settings that apply to the import and build scripts respectively.
    16961670
    1697 Controlling the various settings is done in the same way as for the
    1698 "Configuring Arguments" window described under Section 7.3 -- Plug-Ins.  Some
     1671Controlling the various settings is done in a similar way to the
     1672"Configuring Arguments" window described under Section 7.3 -- Plugins.  Some
    16991673fields require numeric arguments, and you can either type these in or use the
    17001674up and down arrows to increase or decrease the current value (in some cases,
     
    17411715
    17421716When you start to build a collection, the view changes immediately.  The
    1743 controls described in the first section of this chapter are replaced by two
     1717controls described in the first section of this section are replaced by two
    17441718progress bars and a text area.  The bars indicate progress through the import
    17451719phase, then the build phase.  The text area shows the Message Log mentioned in
     
    175117259.0 Previewing the Collection
    17521726<$DESCRIPTION>
    1753 This chapter explains how to use the "Preview" view to inspect the collection you have produced.
     1727This section explains how to use the "Preview" view to inspect the collection you have produced.
    17541728<$FOOTER>
    17551729
     
    1778175210.0 Miscellaneous
    17791753<$DESCRIPTION>
    1780 This chapter describes features of the Librarian Interface that are not associated
     1754This section describes features of the Librarian Interface that are not associated
    17811755with any particular view.
    17821756<$FOOTER>
     
    18011775<a name="SI">Simple Instructions:</a>
    18021776
    1803 There are two "General" options.  If "View Extracted Metadata" is selected, the
     1777There are three "General" options.  If "View Extracted Metadata" is checked, the
    18041778various controls dealing with metadata always show all metadata that has been
    1805 extracted automatically from documents.  "Hide Extracted Metadata" hides it
     1779extracted automatically from documents.  Deselecting it hides this metadata
    18061780(although it is still available during collection design, and within the
    18071781final Greenstone collection).
    18081782
    1809 The second "General" option is a pull-down list of the various languages that
     1783If "Show File Size" is checked, the file size is shown next to each file in the Workspace and Collection file trees in the Gather and Enrich views.
     1784
     1785The third "General" option is a pull-down list of the various languages that
    18101786the Librarian Interface can be presented in.  These correspond to the
    18111787dictionaries located in the "classes" folder of the Librarian Interface's
     
    18651841choose the application from the "Browse" dialog.  "%1" can be used in the launch
    18661842command to insert the name of the file being opened.  Once these are filled out,
    1867 "Add" is enabled and can be clicked to add the association.
     1843"Add Association" is enabled and can be clicked to add the association.
    18681844
    18691845To edit an association, select an existing file extension.  Any existing
    18701846associated command is shown in the launch command field.  Edit it, and then
    1871 click "Update".
    1872 
    1873 To remove an association, select an existing file extension and click "Remove".
     1847click "Replace Association".
     1848
     1849To remove an association, select an existing file extension and click "Remove Association".
    18741850(The file extension remains in the "For Files Ending" pull-down list.)
    18751851
    1876 File associations are stored in the Librarian Interface's folder, in a file
     1852File associations are stored in the Librarian Interface's main folder, in a file
    18771853called "associations.xml".
    18781854
     
    18841860<$DESCRIPTION>
    18851861
    1886 This chapter explains how to edit metadata sets used by the Librarian
     1862This section explains how to edit metadata sets used by the Librarian
    18871863Interface.  This is the only way to remove a value from the "Previous Values"
    1888 tree.  Although you can use the Librarian Interface to remove a certain value
     1864tree.  Although you can use the Enrich view to remove a certain value
    18891865from a record, the value remains in the value tree.  To remove it (or any
    18901866part of the metadata set, including its elements), use the metadata set editor.
     
    19181894editing or removing the various parts; alongside them is the "Close" button.
    19191895Many buttons are greyed out initially, and are activated by selections in the
    1920 tables.  Now we describe how to edit sets, elements and profiles.
     1896tables.  Now we describe how to edit sets and elements.
    19211897
    19221898To define a new metadata set, beside "Set" click "Add", fill out the
    1923 information requested, and click "OK".  "Namespace" is a short identifer for
     1899information requested, and click "OK".  "Namespace" is a short identifier for
    19241900the new set (e.g.  "dc" for Dublin Core; "dls" for the Development Library
    19251901Subset).
     
    19411917selected; when clicked the attribute is removed.
    19421918
    1943 For metadata elements you can add an element, remove it, and remove values from
     1919Double clicking on a set in the list on the left will display a list of metadata elements in that set. You can add an element, remove it, and remove values from
    19441920it.  To add an element, beside "Element" click "Add" and specify the new
    19451921element's name.
     
    19571933attributes of a metadata set, explained above.  In this case the pull-down
    19581934lists in the add and edit prompts may contain values from the same attribute of
    1959 other elements within the set.  Also, you can alter the "value tree", which
    1960 contains all the values that have been assigned to a particular element.  You
    1961 can "Add" a value whenever an element is selected.  Choose the parent subject
    1962 (if any), enter the value and optionally the alias, and click "OK" to put the
     1935other elements within the set.
     1936
     1937You can also alter the "value tree" for an element, which
     1938contains all the values that have been assigned to it.  You
     1939can "Add" a value whenever an element is selected.  Choose a parent folder
     1940(if any), enter the value and click "OK" to put the
    19631941new value in the tree.  You can "Edit" a value that you have selected in the
    19641942value tree; click "OK" to commit the changes.  Note that changing the parent
     
    19891967after the collection to which it applies -- that is, the collection that
    19901968documents are coming from.  You can add a profile by clicking "Add" beside
    1991 "File" and specifying the name of the collection that it should apply to.  You
    1992 can remove a profile by selecting it and click "Remove" beside "File".
     1969"Profile" and specifying the name of the collection that it should apply to.  You
     1970can remove a profile by selecting it and click "Remove" beside "Profile".
    19931971
    19941972When a profile is selected, its mapping table appears.  Each line gives a
     
    20031981Once you have finished changing the metadata importing profile, click
    20041982"Close".
    2005 <$FOOTER>
     1983<$FOOTER> and optionally the alias,
Note: See TracChangeset for help on using the changeset viewer.