root/main/trunk/greenstone2/macros/english.dm @ 31975

Revision 31934, 37.8 KB (checked in by kjdon, 2 years ago)

text changes to go with removing docs page, and updating text on home and gsdl pages

  • Property svn:executable set to *
  • Property svn:keywords set to Author Date Id Revision
Line 
1# this file must be UTF-8 encoded
2#####################################################################
3#
4# English Language text and icon macros
5#
6######################################################################
7#
8# This is the main macro file for translation when creating an
9# interface in another language.
10
11# Under the 'text macros' comments are text macros of the form:
12# _macroname_ {macro value}
13# Everything between the {} is the text to be translated. This text
14# may itself contain macros (i.e. characters other than space between
15# underscore characters, e.g. _about:numdocs_ or _textpage_). These
16# macro names occurring within text shouldn't be translated but should
17# be left as they are. Underscores or curly brackets occurring
18# naturally within the text should be escaped with a leading backslash
19# (i.e. '\_', '\{' or '\}).
20#
21# Comment lines (other than those described above) need not be
22# translated (i.e. any lines beginning with '#', like this line).
23#
24# The simplest way to translate this file is to save it as something
25# else (e.g. french.dm) and work through translating all the text
26# macro values and icon comments.
27#
28######################################################################
29
30
31######################################################################
32# Global (base) package
33package Global
34######################################################################
35
36
37#------------------------------------------------------------
38# text macros
39#------------------------------------------------------------
40
41_textperiodicals_ {Periodicals}
42
43# these three used by the default format statement of the demo and dls collections.
44_textsource_ {source ref: }
45_textdate_ {publication date: }
46_textnumpages_ {no. of pages: }
47
48_textsignin_ {sign in}
49
50_texttruncated_ {[truncated]}
51
52_textdefaultcontent_ {The requested page could not be found. Please use
53your browsers 'back' button or the above home button to return to the
54Greenstone Digital Library.}
55
56_textdefaulttitle_ {GSDL Error}
57
58_textbadcollection_ {This collection (called "_cvariable_") is not installed on this Greenstone digital library system.}
59
60_textselectpage_ {-- Select Page --}
61
62_collectionextra_ {This collection contains _about:numdocs_ documents.
63It was last built _about:builddate_ days ago.}
64
65# this is only used by the collector (where the above _collectionextra_
66# macro will always be set to another value)
67_collectorextra_ {
68<p>This collection contains _numdocs_ _If_("_numdocs_" eq "1",document,documents), a total of _numbytes_ of indexed text and metadata.
69<p><a href="_httppagex_(bsummary)">Click here</a> to view the build summary for this collection.
70}
71
72_textdescrcollection_ {}
73_textdescrabout_ {About page}
74_textdescrhome_ {Home page}
75_textdescrhelp_ {Help page}
76_textdescrpref_ {Preferences page}
77_textdescrdeposit_ {Deposit item into the collection}
78_textdescrlogin_ {Login page}
79_textdescrlogout_ {Logout as _cgiargunHtmlsafe_}
80
81_textdescrgreenstone_ {Greenstone Digital Library Software}
82_textdescrusab_ {What did you find hard to use?}
83
84
85# Metadata names and navigation bar labels
86
87_textSearch_ {Search}
88_labelSearch_ {Search}
89
90# Dublin Core Metadata Element Set, Version 1.1
91_textTitle_ {Title}
92_labelTitle_ {Titles}
93_textCreator_ {Creator}
94_labelCreator_ {Creators}
95_textSubject_ {Subject}
96_labelSubject_ {Subjects}
97_textDescription_ {Description}
98_labelDescription_ {Descriptions}
99_textPublisher_ {Publisher}
100_labelPublisher_ {Publishers}
101_textContributor_ {Contributor}
102_labelContributor_ {Contributors}
103_textDate_ {Date}
104_labelDate_ {Dates}
105_textType_ {Type}
106_labelType_ {Types}
107_textFormat_ {Format}
108_labelFormat_ {Formats}
109_textIdentifier_ {Identifier}
110_labelIdentifier_ {Identifiers}
111_textSource_ {Filename}  # Not true DC, kept for legacy reasons
112_labelSource_ {Filenames}  # Not true DC, kept for legacy reasons
113_textLanguage_ {Language}
114_labelLanguage_ {Languages}
115_textRelation_ {Relation}
116_labelRelation_ {Relations}
117_textCoverage_ {Coverage}
118_labelCoverage_ {Coverage}
119_textRights_ {Rights}
120_labelRights_ {Rights}
121
122# DLS metadata set
123_textOrganization_ {Organization}
124_labelOrganization_ {Organizations}
125_textKeyword_ {Keyword}
126_labelKeyword_ {Keywords}
127_textHowto_ {How to}
128_labelHowto_ {How to}
129
130# Miscellaneous Greenstone metadata
131_textPhrase_ {Phrase}
132_labelPhrase_ {Phrases}
133_textCollage_ {Collage}
134_labelCollage_ {Collage}
135_textBrowse_ {Browse}
136_labelBrowse_ {Browse}
137_textTo_ {To}
138_labelTo_ {To}
139_textFrom_ {From}
140_labelFrom_ {From}
141_textAcronym_ {Acronym}
142_labelAcronym_ {Acronyms}
143_textAuthor_ {Author}
144_textAuthors_ {Authors}
145
146# Navigation bar tooltip - to customize this for a specific metadata, add a macro named _textdescrXXX_ where XXX is the metadata name
147_textdescrdefault_ {Browse by _1_}
148
149_textdescrSearch_ {Search for specific terms}
150_textdescrType_ {Browse by resource type}
151_textdescrIdentifier_ {Browse by resource identifier}
152_textdescrSource_ {Browse by original filename}  # Not true DC, kept for legacy reasons
153_textdescrTo_ {Browse by To field}
154_textdescrFrom_ {Browse by From field}
155_textdescrCollage_ {Browse by image collage}
156_textdescrAcronym_ {Browse acronyms}
157_textdescrPhrase_ {Browse phrases}
158_textdescrHowto_ {Browse how to categories}
159_textdescrBrowse_ {Browse documents}
160_texticontext_ {View the document}
161_texticonclosedbook_ {open this document and view contents}
162_texticonnext_ {to next section}
163_texticonprev_ {to previous section}
164
165_texticonworld_ {View the web document}
166
167_texticonmidi_ {View the MIDI document}
168_texticonmsword_ {View the Microsoft Word document}
169_texticonmp3_ {View the MP3 document}
170_texticonpdf_ {View the PDF document}
171_texticonps_ {View the PostScript document}
172_texticonppt_ {View the PowerPoint document}
173_texticonrtf_ {View the RTF document}
174_texticonxls_ {View the Microsoft Excel document}
175_texticonogg_ {View the Ogg Vorbis document}
176_texticonrmvideo_ {View the Real Media document}
177
178_page_ {page }
179_pages_ {pages}
180_of_ { of }
181_vol_ {Volume}
182_num_ {No.}
183
184_textmonth00_ {}
185_textmonth01_ {January}
186_textmonth02_ {February}
187_textmonth03_ {March}
188_textmonth04_ {April}
189_textmonth05_ {May}
190_textmonth06_ {June}
191_textmonth07_ {July}
192_textmonth08_ {August}
193_textmonth09_ {September}
194_textmonth10_ {October}
195_textmonth11_ {November}
196_textmonth12_ {December}
197
198_texttext_ {Text}
199_labeltext_ {_texttext_}
200_textdocument_ {Document}
201_textsection_ {Section}
202_textparagraph_ {Paragraph}
203_textchapter_ {Chapter}
204_textbook_ {Book}
205
206_magazines_ {Magazines}
207
208_nzdlpagefooter_ {<div class="divbar">&nbsp;</div>
209<p><a href="http://www.nzdl.org">New Zealand Digital Library Project</a>
210<br><a href="http://www.cs.waikato.ac.nz">Department of Computer Science</a>,
211<a href="http://www.waikato.ac.nz">University of Waikato</a>,
212New Zealand}
213
214_linktextHOME_ {HOME}
215_linktextHELP_ {HELP}
216_linktextPREFERENCES_ {PREFERENCES}
217_linktextDEPOSIT_ {DEPOSIT}
218_linktextLOGIN_ {LOGIN}
219_linktextLOGGEDIN_ {(logged in as _cgiargunHtmlsafe_)}
220_linktextLOGOUT_ {LOGOUT}
221
222
223######################################################################
224# 'home' page
225package home
226######################################################################
227
228_textpagetitle_ {Greenstone Digital Library}
229
230_textnocollections_ {No valid (i.e. built and public) collections are available}
231
232_textadmin_ {Administration Page}
233_textabgs_ {About Greenstone}
234
235_textdescradmin_ {
236Allows you to add new users, summarizes the collections in the system,
237gives technical information on the Greenstone installation
238}
239
240_textdescrgogreenstone_ {
241Tells you about the Greenstone software and provides links to further information such as sample collections, technical details, and documentation.
242}
243
244
245#####################################################################
246# some macros used on the home page from other packages
247#####################################################################
248package gli
249
250_textgli_ {The Librarian Interface}
251_textdescrgli_ {
252Helps you create new collections, modify or add to existing ones, or delete
253collections
254}
255
256package collector
257
258_textcollector_ {The Collector}
259_textdescrcollector_ {
260Helps you create collections online. This predates the Librarian Interface, and for most practical purposes the Librarian Interface should be used instead
261}
262
263package depositor
264
265_textdepositor_ {The Depositor}
266_textdescrdepositor_  {
267Helps you to add documents to existing collections online, instead of using GLI.
268}
269
270_textdepositorlocal_{Start New Deposit}
271package gti
272
273_textgti_ {The Greenstone Translator Interface}
274_textdescrtranslator_ {
275Helps you keep the multilingual versions of the Greenstone interface
276up to date
277}
278
279
280######################################################################
281# 'about' page
282package about
283######################################################################
284
285
286#------------------------------------------------------------
287# text macros
288#------------------------------------------------------------
289
290_textabcol_ {About this collection}
291
292_textsubcols1_ {<p>The complete collection comprises _1_ subcollections.
293Those currently available are:
294<blockquote>}
295
296_textsubcols2_ {</blockquote>
297You can check (and alter) which subcollections you are
298currently using on the Preferences page.}
299
300_titleabout_ {about}
301
302
303######################################################################
304# document package
305package document
306######################################################################
307
308
309#------------------------------------------------------------
310# text macros
311#------------------------------------------------------------
312
313_texticonopenbookshelf_ {close this section of the library}
314_texticonclosedbookshelf_ {open this section of the library and view contents}
315_texticonopenbook_ {close this book}
316_texticonclosedfolder_ {Open this folder and view contents}
317_texticonclosedfolder2_ {open sub-section: }
318_texticonopenfolder_ {close this folder}
319_texticonopenfolder2_ {close sub-section: }
320_texticonsmalltext_ {View this section of the text}
321_texticonsmalltext2_ {view text: }
322_texticonpointer_ {current section}
323_texticondetach_ {Open this page in a new window}
324_texticonhighlight_ {Highlight search terms}
325_texticonnohighlight_ {Don't highlight search terms}
326_texticoncontracttoc_ {Collapse table of contents}
327_texticonexpandtoc_ {Expand table of contents}
328_texticonexpandtext_ {Display all text}
329_texticoncontracttext_ {Display text only for currently selected section}
330_texticonwarning_ {<b>Warning: </b>}
331_texticoncont_ {continue?}
332
333_textltwarning_ {<div class="buttons">_imagecont_</div>
334_iconwarning_Expanding the text here will generate a large
335amount of data for your browser to display
336}
337
338_textcommentusername_ {User name}
339_textaddusercomment_ {Add Comment}
340_textusercommentlogout_ {Logout}
341_textaddcomment_ {submit comment}
342_textcommentsubmitted_ {Comment Submitted}
343_textisempty_ {Comment was empty.}
344_textusercommentssection_ {Comments}
345
346_textgoto_ {go to page}
347_textintro_ { <i>(introductory text)</i>}
348
349_textCONTINUE_ {CONTINUE?}
350
351_textEXPANDTEXT_ {EXPAND TEXT}
352
353_textCONTRACTCONTENTS_ {CONTRACT CONTENTS}
354
355_textDETACH_ {DETACH}
356
357_textEXPANDCONTENTS_ {EXPAND CONTENTS}
358
359_textCONTRACT_ {CONTRACT TEXT}
360
361_textHIGHLIGHT_ {HIGHLIGHTING}
362
363_textNOHIGHLIGHT_ {NO HIGHLIGHTING}
364
365_textPRINT_ {PRINT}
366
367_textnextsearchresult_{next search result}
368_textprevsearchresult_{previous search result}
369
370# macros for printing page
371_textreturnoriginal_ {Return to the original page}
372_textprintpage_ {Print this page}
373_textshowcontents_ {Show the table of contents}
374_texthidecontents_ {Hide the table of contents}
375
376######################################################################
377# 'search' page
378package query
379######################################################################
380
381
382#------------------------------------------------------------
383# text macros
384#------------------------------------------------------------
385
386# this if statement produces the text 'results n1 - nn for query: querystring' or
387# 'No matches for query: querystring', depending on whether or not there were
388# any matches
389_textquerytitle_ {_If_(_thislast_,results _thisfirst_ - _thislast_ for query: _cgiargqHtmlsafe_,No matches for query: _cgiargqHtmlsafe_)}
390_textnoquerytitle_ {Search page}
391
392_textsome_ {some}
393_textall_ {all}
394_textboolean_ {boolean}
395_textranked_ {ranked}
396_textnatural_ {natural}
397_textsortbyrank_ {relevance rank}
398_textsortbynone_ {build order}
399_textascending_ {ascending}
400_textdescending_ {descending}
401_texticonsearchhistorybar_ {search history}
402
403_textifeellucky_ {I'm feeling lucky!}
404
405#alt text for query buttons
406_textusequery_ {use this query}
407_textfreqmsg1_ {Word count: }
408_textpostprocess_ {_If_(_quotedquery_,<br><i>post-processed to find _quotedquery_</i>
409)}
410_textinvalidquery_ {Invalid query syntax}
411_textstopwordsmsg_ {The following words are too common and were ignored: }
412_textlucenetoomanyclauses_ {Your query contained too many search terms; please try a more specific query.}
413
414_textmorethan_ {More than }
415_textapprox_ {About }
416_textnodocs_ {No documents matched the query.}
417_text1doc_ {1 document matched the query.}
418_textlotsdocs_ {documents matched the query.}
419_textmatches_ {Matches }
420_textbeginsearch_ {Begin Search}
421_textrunquery_ {Run Query}
422_textclearform_ {Clear Form}
423
424#these go together in form search:
425#"Words  fold case fold accents stem  ... in field"
426_textwordphrase_ {Words}
427_textinfield_ {... in field}
428_textformcasefold_ {ignore case}
429_textformaccentfold_ {ignore accents}
430_textformstem_ {stem}
431
432_textadvquery_ {Or enter a query directly:}
433_textallfields_ {all fields}
434_texttextonly_ {text only}
435_textand_ {and}
436_textor_ {or}
437_textandnot_ {and not}
438
439# _indexselection_, _jselection_, _nselection_ and _gselection_ are set from
440# within the server - _indexselection_ is always set, but the others may be
441# unset
442
443# the space after "level" (before the right bracket) is required, otherwise no space between "Search" and "in"
444
445_textsimplesearch_ {Search in _indexselection__If_(_jselection_, associated with _jselection_)_If_(_gselection_, at _gselection_ level )_If_(_nselection_, in _nselection_ language)_If_(_sfselection_,\,_allowformbreak_ sorting results by _sfselection_\, _sortorderselection_\,) for _querytypeselection_ of the words}
446_textsimplesqlsearch_ {Search in _indexselection__If_(_jselection_, associated with _jselection_)_If_(_gselection_, at _gselection_ level )_If_(_nselection_, in _nselection_ language)_If_(_sqlsfselection_,\,_allowformbreak_ sorting results by _sqlsfselection_) for _querytypeselection_ of the words}
447
448_textadvancedsearch_ {Search in _indexselection__If_(_jselection_, associated with _jselection_)_If_(_gselection_, at _gselection_ level )_If_(_nselection_, in _nselection_ language) using _querytypeselection_ query}
449
450_textadvancedmgppsearch_ {Search in _indexselection__If_(_jselection_, associated with _jselection_)_If_(_gselection_, at _gselection_ level )_If_(_nselection_, in _nselection_ language), and display results in _formquerytypeadvancedselection_ order, for}
451
452_textadvancedlucenesearch_ {Search in _indexselection__If_(_jselection_, associated with _jselection_)_If_(_gselection_, at _gselection_ level )_If_(_nselection_, in _nselection_ language)_If_(_sfselection_,\,_allowformbreak_ sorting results by _sfselection_\,_sortorderselection_\,) for }
453_textadvancedsqlsearch_ {Search in _indexselection__If_(_jselection_, associated with _jselection_)_If_(_gselection_, at _gselection_ level )_If_(_nselection_, in _nselection_ language)_If_(_sqlsfselection_,\,_allowformbreak_ sorting results by _sqlsfselection_\,) for }
454
455# the space after "Search" is required, otherwise no space between "Search" and "in"
456
457_textformsimplesearch_ {Search _If_(_jselection_, in _jselection_)_If_(_gformselection_, at _gformselection_ level )_If_(_nselection_, in _nselection_ language)_If_(_sfselection_,\, sorting results by _sfselection_\, _sortorderselection_\,) for _formquerytypesimpleselection_ of }
458_textformsimplesearchsql_ {Search _If_(_jselection_, in _jselection_)_If_(_gformselection_, at _gformselection_ level )_If_(_nselection_, in _nselection_ language)_If_(_sqlsfselection_,\, sorting results by _sqlsfselection_\,) for _formquerytypesimpleselection_ of }
459
460_textformadvancedsearchmgpp_ {Search _If_(_jselection_, in _jselection_)_If_(_gformselection_, at _gformselection_ level )_If_(_nselection_, in _nselection_ language), and display results in _formquerytypeadvancedselection_ order, for }
461
462_textformadvancedsearchlucene_ {Search _If_(_jselection_, in _jselection_)_If_(_gformselection_, at _gformselection_ level )_If_(_nselection_, in _nselection_ language)_If_(_sfselection_,\, sorting results by _sfselection_\, _sortorderselection_\,) for }
463_textformadvancedsearchsql_ {Search _If_(_jselection_, in _jselection_)_If_(_gformselection_, at _gformselection_ level )_If_(_nselection_, in _nselection_ language)_If_(_sqlsfselection_,\, sorting results by _sqlsfselection_\,) for }
464
465_textnojsformwarning_ {Warning: Javascript is disabled in your web browser. <br>To use form searching, please enable it.}
466_textdatesearch_ {This collection can be searched for documents within a date range, or documents that contain a particular date. This is an optional feature of the search.}
467_textstartdate_ {Start (or only) date:}
468_textenddate_ {End date:}
469_textbc_ {B.C.E.}
470_textad_ {C.E.}
471_textexplaineras_ {C.E. and B.C.E are alternatives for A.D. and B.C. respectively.  These terms are considered to be culture indiscriminate, and stand for "Common Era" and "Before the Common Era"}
472
473_textstemon_ { (ignoring word endings)}
474
475_textsearchhistory_ {Search History}
476
477#text macros for search history
478_textnohistory_ {No entries in the search history}
479_texthresult_ {result}
480_texthresults_ {results}
481_texthallwords_ {all words}
482_texthsomewords_ {some words}
483_texthboolean_ {boolean}
484_texthranked_ {ranked}
485_texthcaseon_ {case must match}
486_texthcaseoff_ {casefolded}
487_texthstemon_ {stemmed}
488_texthstemoff_ {unstemmed}
489
490
491######################################################################
492# 'preferences' page
493package preferences
494######################################################################
495
496
497#------------------------------------------------------------
498# text macros
499#------------------------------------------------------------
500
501_textprefschanged_ {
502Preferences have been set as follows. Do not use your browser's
503"back" button - it will unset them! Instead, click one of the
504buttons on the access bar above.
505}
506_textsetprefs_ {set preferences}
507_textsearchprefs_ {Search preferences}
508_textcollectionprefs_ {Collection preferences}
509_textpresentationprefs_ {Presentation preferences}
510_textpreferences_ {Preferences}
511_textcasediffs_ {Case differences:}
512_textignorecase_ {ignore case differences}
513_textmatchcase_ {upper/lower case must match}
514_textwordends_ {Word endings:}
515_textstem_ {ignore word endings}
516_textnostem_ {whole word must match}
517_textaccentdiffs_ {Accent differences:}
518_textignoreaccents_ {ignore accents}
519_textmatchaccents_ {accents must match}
520
521_textprefop_ {Return up to _maxdocoption_ hits with _hitsperpageoption_ hits per page.}
522_textextlink_ {Access to external Web pages:}
523_textintlink_ {Source documents retrieved from:}
524_textlanguage_ {Interface language:}
525_textencoding_ {Encoding:}
526_textformat_ {Interface format:}
527_textall_ {all}
528_textquerymode_ {Query mode:}
529_textsimplemode_ {simple query mode}
530_textadvancedmode_ {advanced query mode (allows boolean searching using !, &amp;, |, and parentheses)}
531_textlinkinterm_ {through intermediate page}
532_textlinkdirect_ {go directly there}
533_textdigitlib_ {the digital library}
534_textweb_ {the web}
535_textgraphical_ {Graphical}
536_texttextual_ {Textual}
537_textcollectionoption_ {<p>
538Subcollections to include:
539<br>}
540
541_textsearchtype_ {Query style:}
542_textformsearchtype_ {fielded with _formnumfieldoption_ fields}
543_textsqlformsearchtype_ {SQL fielded with _sqlformnumfieldoption_ fields}
544_textplainsearchtype_ {normal with _boxsizeoption_ query box}
545_textregularbox_ {single line}
546_textlargebox_ {large}
547
548_textrelateddocdisplay_ {display related documents}
549_textsearchhistory_ {Search history:}
550_textnohistory_ {No search history}
551_texthistorydisplay_ {display _historynumrecords_ search history records}
552_textnohistorydisplay_ {do not display search history}
553
554_textbookoption_  {Book viewer mode:}
555_textbookvieweron_ {on}
556_textbookvieweroff_ {off}
557
558# html options
559_textdoclayout_ {Document page layout:}
560_textlayoutnavbar_ {navigation bar at top}
561_textlayoutnonavbar_ {no navigation bar}
562
563_texttermhighlight_ {Search term highlighting:}
564_texttermhighlighton_ {highlight search terms}
565_texttermhighlightoff_ {don't highlight search terms}
566
567#####################################################################
568# 'browse' package for the dynamic browsing interface
569package browse
570#####################################################################
571
572_textsortby_ {Sort documents by}
573_textalsoshowing_ {also showing}
574_textwith_ {with at most}
575_textdocsperpage_ {documents per page}
576
577_textfilterby_ {Get documents containing}
578_textall_ {all}
579_textany_ {any}
580_textwords_ {of the words}
581_textleaveblank_ {leave this box blank to get all the documents}       
582
583_browsebuttontext_ {"Sort Documents"}
584
585_nodata_ {<i>no data</i>}
586_docs_ {documents}
587######################################################################
588# 'help' page -- this is lower priority for translating than the
589# rest of this file
590package help
591######################################################################
592
593
594#------------------------------------------------------------
595# text macros
596#------------------------------------------------------------
597
598_textHelp_ {Help}
599
600# Macros giving a brief help message for navigation bar access buttons
601# The arguments to this will be _textXXX_ and _labelXXX_, where XXX is the metadata name. For example, to print out the help message for a titles classifier, the library will use _textdefaulthelp_(_textTitle_,_labelTitle_)
602# To customize this for a specific metadata, add a macro named _textXXXhelp_ where XXX is the metadata name
603_textdefaulthelp_{browse documents by _1_ by clicking the _2_ button}
604
605_textSearchhelp_ {search for particular words that appear in the text by clicking the _labelSearch_ button}
606_textTohelp_ {browse documents by To field by clicking the _labelTo_ button}
607_textFromhelp_ {browse documents by From field by clicking the _labelFrom_ button}
608_textBrowsehelp_ {browse documents}
609_textAcronymhelp_ {browse documents by acronym occurrence by clicking the _labelAcronym_ button}
610_textPhrasehelp_ {browse phrases occurring in documents by clicking the _labelPhrase_ button. This uses the phind phrase browser.}
611
612_texthelptopicstitle_ {Topics}
613
614_textreadingdocs_ {How to read the documents}
615
616_texthelpreadingdocs_ {
617<p>You can tell when you have arrived at an individual book or document
618because its title, or an image of the front cover, appears at the top
619left of the page. In some collections, a table of contents appears, while in others
620(eg. when the paged image option is used)
621just the page number is shown, along with a box that allows you to select a
622new page and go forward and backward. In the table of contents, the current
623section heading is in bold face, and the table is expandable -- click on the folders
624to open or close them; click on the open book at the top to close it.</p>
625
626<p>Underneath is the text of the current section. When you have read
627through it, there are arrows at the bottom to take you on to the next
628section or back to the previous one.</p>
629
630<p>Below the title or front-cover image are some buttons. Click on
631<i>_document:textEXPANDTEXT_</i> to expand out the whole text of the current section, or
632book. If the document is large, this could take a long time and use a lot
633of memory! Click on <i>_document:textEXPANDCONTENTS_</i> to expand out the whole table of
634contents so that you can see the titles of all chapters and
635subsections. Click on <i>_document:textDETACH_</i> to make a new browser window for this
636document. (This is useful if you want to compare documents, or read two at
637once.) Finally, when you do a search the words you search for are
638highlighted. Click on <i>_document:textNOHIGHLIGHT_</i> to remove highlighting.</p>
639}
640
641# help about the icons
642_texthelpopenbookshelf_ {Open this bookshelf}
643_texthelpopenbook_ {Open/close this book}
644_texthelpviewtextsection_ {View this section of the text}
645_texthelpexpandtext_ {Display all text, or not}
646_texthelpexpandcontents_ {Expand table of contents, or not}
647_texthelpdetachpage_ {Open this page in a new window}
648_texthelphighlight_ {Highlight search terms, or not}
649_texthelpsectionarrows_ {Go to the previous/next section}
650
651
652_texthelpsearchingtitle_ {How to search for particular words}
653
654_texthelpsearching_ {
655<p>
656  From the search page, you make a query in these simple steps:<p>
657 
658  <ol><li>Specify what items you want to search
659      <li>Say whether you want to search for all or just some of the words
660      <li>Type in the words you want to search for
661      <li>Click the <i>Begin Search</i> button
662  </ol>
663
664<p>When you make a query, the titles of twenty matching documents will be shown.
665There is a button at the end to take you on to the next twenty documents.  From
666there you will find buttons to take you on to the third twenty or back to the
667first twenty, and so on.  Click the title of any document, or the little button
668beside it, to see it.
669
670<p>A maximum of 50 is imposed on the number of
671  documents returned.  You can change this number by clicking the
672  <i>_Global:linktextPREFERENCES_</i> button at the top of the page.<p>
673}
674
675_texthelpquerytermstitle_ {Search terms}
676_texthelpqueryterms_ {
677<p>Whatever you type into the query box is interpreted as a list of words or phrases
678called "search terms."  A term is a single word containing only letters and digits, or a phrase consisting of a sequence of words enclosed in double quotes ("...").  Terms are separated by white spaces.  If any other characters such
679as punctuation appear, they serve to separate terms just as though they were
680spaces.  And then they are ignored.  You can't search for words that include
681punctuation.
682
683<p>For example, the query<p>
684    <ul><kbd>Agro-forestry in the Pacific Islands: Systems for Sustainability (1993)</kbd></ul>
685      <p>will be treated the same as<p>
686      <ul><kbd>Agro forestry in the Pacific Islands  Systems for Sustainability  1993 </kbd></ul><p>
687}
688
689_texthelpmgppsearching_ {
690For collections built with MGPP a few other options are available.
691
692<ul>
693<li>A <b>*</b> at the end of a query term  matches all words <b>starting with</b> that word, e.g. <b>comput*</b> matches all words starting with <b>comput</b>.
694<li><b>/x</b> can be used to give higher weight to one or more of the query terms, eg <b>computer/10 science</b> gives computer 10 times more weight than science when ranking documents.
695</ul>
696}
697
698_texthelplucenesearching_ {
699For collections built with Lucene a few other options are available.
700
701<ul>
702<li><b>?</b> can be used as a wildcard in place of a single letter. For example, <b>b?t</b> will match  <b>bet</b>, <b>bit</b> and <b>bat</b> etc.
703<li><b>*</b> can be used as a wildcard in place of multiple letters. For example, <b>comput*</b> matches all words starting with <b>comput</b>.
704</ul>
705Both of these wildcards can be used in the middle of a term, or at the end. They cannot be used at the start of a search term.
706}
707
708_texthelpquerytypetitle_ {Query type}
709_texthelpquerytype_ {
710<p>There are two different kinds of query.
711
712<ul>
713  <li>Queries for <b>all</b> of the words.  These look for documents (or
714      chapters, or titles) that contain all the words you have specified.
715      Documents that satisfy the query are displayed, in build order.
716<p>
717
718  <li>Queries for <b>some</b> of the words.  Just list some terms that are
719      likely to appear in the documents you are looking for.  Documents are
720      displayed in order of how closely they match the query.  When determining
721      the degree of match,
722
723      <p><ul>
724        <li> the more search term occurrences a document contains, the closer it matches;
725        <li> terms which are rare in the collection as a whole are more important than common ones;
726        <li> short documents match better than long ones.
727      </ul>
728</ul>
729
730<p>Use as many search terms as you like--a whole sentence, or even a
731whole paragraph.  If you specify only
732one term, documents will be ordered by its frequency of occurrence.<p>
733}
734
735_texthelpadvancedsearchtitle_ {Advanced searching using the _1_ search engine}
736
737_texthelpadvancedsearch_ {
738<p>If you have selected advanced query mode (in preferences) you have slightly different search options.
739}
740
741_texthelpadvsearchmg_ {
742Advanced searching in MG collections gives you two options, ranked and boolean.
743A <b>ranked</b> search is exactly the same as the <b>some</b> search descibed in <a href="\#query-type">_texthelpquerytypetitle_</a>.
744<p>_texthelpbooleansearch_
745}
746
747_texthelpbooleansearch_ {
748A <b>boolean</b> search allows you to combine terms
749using &amp; (for "and"), | (for "or"), and ! (for "not"), using parentheses for grouping if desired. The default operator is | (for "or").
750<p>
751For example, <b>snail &amp; farming</b> will match documents which contain both <b>snail</b> AND <b>farming</b>, whereas <b>snail | farming</b> will match documents that contain either <b>snail</b> OR <b>farming</b>.
752<b>snail !farming</b> will match documents that contain <b>snail</b> AND DO NOT contain <b>farming</b>.
753<p>
754More precise queries can be specified using combinations of operators and parentheses. For example, <b>(sheep | cattle) &amp; (farm | station)</b>, or <b>sheep | cattle | goat !pig</b>.
755}
756
757_texthelpadvsearchmgpp_ {
758Advanced searches in MGPP collections use boolean operators. _texthelpbooleansearch_
759<p>The results can be displayed in <b>ranked</b> order, as described for the <b>some</b> search in <a href="\#query-type">_texthelpquerytypetitle_</a>, or in "natural" (or "build") order. The latter is the order that documents were processed during the creation of the collection.
760<p>
761Further operators include <b>NEARx</b> and <b>WITHINx</b>.
762NEARx is used to specify the maximum distance (x words)
763which can separate two query terms for a document to match.
764WITHINx specifies that the second term must occur within x words <i>after</i> the first term. This is similar to NEAR but the order is important. The default distance is 20.
765}
766
767_texthelpadvancedsearchextra_{NOTE: These operators are all ignored if you are searching in simple query mode.}
768
769_texthelpadvsearchlucene_ {
770Advanced searches in Lucene collections use boolean operators. _texthelpbooleansearch_
771}
772
773_texthelpformsearchtitle_ {Fielded searching}
774
775_texthelpformsearch_ {
776<p>Fielded searching provides the opportunity to combine searches across fields. For example, one can search for "Smith" in Title AND "snail farming" in Subject. In simple query mode, each line of the form behaves like a normal single line search. The individual lines of the form are combined using AND (for an "all" search) or OR (for a "some" search). Terms inside the field are also combined the same way. In advanced mode, you can specify different combinations of AND/OR/NOT between the fields using the drop-down lists, and inside a field you can use boolean operators.
777}
778
779_texthelpformstemming_ {The "fold" and "stem" boxes allow you to specify whether the terms inside that field are casefolded or stemmed. These are both switched off by default for advanced form searching.}
780
781_textdatesearch_ {Searching with Dates}
782
783_texthelpdatesearch_ {
784Date search lets you find documents that, as well as matching your search
785terms, are about events within a certain timeframe.  You can search for
786documents from a certain year or from a range of years.  Note that you do not
787have to have any search terms -- you can search by date alone; and also that
788you do not have to use dates in your search, if you do not type any dates in it
789 is just the same as if the date search didn't exist.<p>
790}
791
792_texthelpdatehowtotitle_ {How to use this feature:}
793_texthelpdatehowto_ {
794<ul>
795   <li>To search for documents about a single year:<p>
796   <ul>
797       <li>Type in any ordinary search terms as you normally would.
798       <li>Type the year you want into the "Start (or only) date" box.
799       <li>If your date is from before the common era (also known as before
800           Christ), choose the "B.C.E" option from the pulldown menu next to that
801           box.
802       <li>Begin your search as you ordinarily would.
803   </ul>
804<p><li>To search for documents about a time period or range of years:<p>
805   <ul>
806       <li>Type in any ordinary search terms as you normally would.
807       <li>Type the earlier date into the "Start (or only) date" box.
808       <li>Type the later date into the "End date" box.
809       <li>Select "B.C.E" option from the pulldown menu next to any date from before
810           the common era (also known as before Christ).
811       <li>Begin your search as you ordinarily would.
812   </ul>   
813</ul><p>
814}
815
816_texthelpdateresultstitle_ {The way results of your search work}
817_texthelpdateresults_ {
818Generally speaking a search for documents about the year 1903 will not return documents that, say, reference books written in 1903, just documents about 1903.  However, the way that the documents' dates are found, it will return documents that have a date range (for example 1899-1911) that includes 1903, and also those documents which, as part of their text name the century that 1903 is a part of (for example 20th century or twentieth century).  This means that for some documents, the dates in your search will not actually appear in the document text.  For a range search, all of this applies to every date in the range.<p>
819}
820
821_textchangeprefs_ {Changing your preferences}
822
823_texthelppreferences_ {
824<p>When you click the <i>_Global:linktextPREFERENCES_</i> button at the top of the page you will
825be able to change some features of the interface to suit your own requirements.
826}
827
828_texthelpcollectionprefstitle_ {Collection preferences}
829_texthelpcollectionprefs_ {
830<p>Some collections comprise several subcollections, which can be searched
831independently or together, as one unit.  If so, you can select which
832subcollections to include in your searches on the Preferences page.
833}
834
835_texthelplanguageprefstitle_ {Language preferences}
836_texthelplanguageprefs_ {
837<p>Each collection has a default presentation language, but you can switch to
838a different language if you like.  You can also alter the encoding scheme
839used by Greenstone for output to the browser -- the software chooses
840sensible defaults, but with some browsers it may be necessary to switch to
841a different encoding scheme to ensure correct character display.
842All collections allow you to
843switch from the standard graphical interface format to a textual one. This
844is particularly useful for visually impaired users who use large screen
845fonts or speech synthesizers for output.
846}
847
848_texthelppresentationprefstitle_ {Presentation preferences}
849_texthelppresentationprefs_ {
850Depending on the particular collection, there may be several options you can
851set that control the presentation.
852
853<p>Collections of Web pages allow you to suppress the Greenstone navigation bar at
854the top of each document page, so that once you have done a search you land at
855the exact Web page that matches without any Greenstone header.  To do another
856search you will have to use your browser's "back" button.  These collections
857also allow you to suppress Greenstone's warning message when you click a link
858that takes you out of the digital library collection and on to the Web itself.
859And in some Web collections you can control whether the links on the search
860results page take you straight to the actual URL in question, rather than to
861the digital library's copy of the page.
862}
863
864_texthelpsearchprefstitle_ {Search preferences}
865_texthelpsearchprefs_ {
866<p>You can switch to an "advanced" query mode which allows you to combine terms
867using &amp; (for "and"), | (for "or"), and ! (for "not"), using parentheses for
868grouping if desired. This allows you to specify more precise queries.
869<p>_selectsearchtypeprefs_
870<p>_selectwordmodificationprefs_
871<p>You can turn on the search history feature, which shows you your last few
872queries.  This makes it easy to repeat slightly modified versions of previous
873queries.
874<p>Finally, you can control the number of hits returned, and the
875number presented on each screenful.
876}
877
878_textcasefoldprefs_ {A pair of buttons controls whether upper and lower case must match when searching. For example, if "_preferences:textignorecase_" is selected, <i>snail farming</i> will be treated the same as <i>Snail Farming</i> and <i>SNAIL FARMING</i>.}
879_textstemprefs_{A pair of buttons controls whether to ignore word endings or not when searching. For example, if "_preferences:textstem_" is selected, <i>snail farming</i> will be treated the same as <i>snails farm</i> and <i>snail farmer</i>. This currently only works properly for English language text. _selectstemoptionsprefs_}
880_textaccentfoldprefs_ {A pair of buttons controls whether accented and unaccented letters must match when searching. For example, if "_preferences:textignoreaccents_" is selected, <i>fédération</i> will be treated the same as <i>fedération</i> and <i>federation</i>.}
881 
882_textstemoptionsprefs_ {It may be more convenient and precise to use the search term truncation facility described above in "_texthelpquerytermstitle_".}
883
884_textsearchtypeprefsplain_ {It is possible to get a large query box, so that you can easily do paragraph-sized searching. It is surprisingly quick to search for large amounts of text.}
885
886_textsearchtypeprefsform_ {You can change the number of fields shown in the search form.}
887
888_textsearchtypeprefsboth_ {You can switch the search type of the collection between "normal" search, and "fielded" search.
889<ul>
890<li>Normal search provides a single query box. _textsearchtypeprefsplain_</li>
891<li>Fielded search provides a number of query boxes, each querying a different field of the index. This enables searching over different fields at once. _textsearchtypeprefsform_ </li>
892</ul>
893}
894
895
896
897_texttanumbrowseoptions_ {There are _numbrowseoptions_ ways to find information in this collection:}
898
899_textsimplehelpheading_ {How to find information in the _collectionname_ collection}
900
901_texthelpscopetitle_ {Scope of queries}
902_texthelpscope_ {
903<p>
904In most collections you are given a choice of different indexes to search. For example, there might
905be author or title indexes. Or there might be chapter or paragraph indexes. Generally,
906the full matching document is returned regardless of which index you search.
907<p>If documents are books, they will be opened at the appropriate place.
908}
Note: See TracBrowser for help on using the browser.