source: trunk/gsdl/macros/english.dm@ 11351

Last change on this file since 11351 was 11221, checked in by mdewsnip, 18 years ago

Removed the comments at the top about the icon macros (which no longer exist).

  • Property svn:executable set to *
  • Property svn:keywords set to Author Date Id Revision
File size: 35.6 KB
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_textsource_ {source ref: }
43_textdate_ {publication date: }
44_textnumpages_ {no. of pages: }
45
46_textsignin_ {sign in}
47
48_textdefaultcontent_ {The requested page could not be found. Please use
49your browsers 'back' button or the above home button to return to the
50Greenstone Digital Library.}
51
52_textdefaulttitle_ {GSDL Error}
53
54_textbadcollection_ {This collection (called "_cvariable_") is not installed on this Greenstone digital library system.}
55
56_textselectpage_ {-- Select Page --}
57
58_collectionextra_ {This collection contains _about:numdocs_ documents.
59It was last built _about:builddate_ days ago.}
60
61# this is only used by the collector (where the above _collectionextra_
62# macro will always be set to another value)
63_collectorextra_ {
64<p>This collection contains _numdocs_ _If_("_numdocs_" eq "1",document,documents), a total of _numbytes_.
65<p><a href="_httppagex_(bsummary)">Click here</a> to view the build summary for this collection.
66}
67
68_textdescrcollection_ {}
69_textdescrabout_ {About page}
70_textdescrhome_ {Home page}
71_textdescrhelp_ {Help page}
72_textdescrpref_ {Preferences page}
73_textdescrgreenstone_ {Greenstone Digital Library Software}
74_textdescrusab_ {What did you find hard to use?}
75
76_textdescrsearch_ {Search for specific terms}
77
78# Dublin Core Metadata Element Set, Version 1.1
79_textdescrTitle_ {Browse alphabetical list of titles} # Not true DC, kept for legacy reasons
80_textdescrCreator_ {Browse alphabetical list of authors} # Not true DC, kept for legacy reasons
81_textdescrSubject_ {Browse by subject}
82_textdescrDescription_ {Browse by description}
83_textdescrPublisher_ {Browse by publisher}
84_textdescrContributor_ {Browse by contributor}
85_textdescrDate_ {Browse by date}
86_textdescrType_ {Browse by resource type}
87_textdescrFormat_ {Browse by format}
88_textdescrIdentifier_ {Browse by resource identifier}
89_textdescrSource_ {Browse by original filename} # Not true DC, kept for legacy reasons
90_textdescrLanguage_ {Browse by language}
91_textdescrRelation_ {Browse by relation}
92_textdescrCoverage_ {Browse by coverage}
93_textdescrRights_ {Browse by rights}
94
95_textdescrOrganization_ {Browse by organization}
96_textdescrKeyword_ {Browse by keyword}
97_textdescrHowto_ {Browse how to categories}
98_textdescrList_ {Browse document listing}
99_textdescrSeries_ {Browse by issue}
100_textdescrTo_ {Browse by To field}
101_textdescrFrom_ {Browse by From field}
102_textdescrTopic_ {Browse special topic issues}
103_textdescrBrowse_ {Browse}
104_textdescrCollage_ {Browse by image collage}
105_textdescrPeople_ {Browse alphabetical list of people}
106_textdescrAcronym_ {Browse acronyms}
107_textdescrPhrase_ {Browse phrases}
108_textdescrArtist_ {Browse artists}
109_textdescrVolume_ {Browse by volume}
110_textdescrCountries_ {Browse by countries}
111_textdescrCaptions_ {Browse by photo captions}
112
113_labelSearch_ {Search}
114
115# Dublin Core Metadata Element Set, Version 1.1
116_labelTitle_ {Titles A-Z} # Not true DC, kept for legacy reasons
117_labelCreator_ {Authors A-Z} # Not true DC, kept for legacy reasons
118_labelSubject_ {Subjects}
119
120_labelDescription_ {Descriptions}
121_labelPublisher_ {Publishers}
122_labelContributor_ {Contributors}
123_labelDate_ {Dates}
124_labelTypes_ {Types}
125_labelFormat_ {Formats}
126_labelIdentifier_ {Identifiers}
127_labelSource_ {Filenames} # Not true DC, kept for legacy reasons
128_labelLanguage_ {Languages}
129_labelRelation_ {Relations}
130_labelCoverage_ {Coverage}
131_labelRights_ {Rights}
132
133_labelOrg_ {Organization}
134_labelKeyword_ {Keywords}
135_labelHow_ {How to}
136_labelSeries_ {Series}
137_labelList_ {Listing}
138_labelTo_ {To}
139_labelFrom_ {From}
140_labelTopic_ {Topics}
141_labelBrwse_ {Browse}
142_labelCollage_ {Collage}
143_labelbrows_ {Browse}
144_labelPeople_ {People A-Z}
145_labelAcronym_ {Acronyms}
146_labelPhrase_ {Phrases}
147_labelArtist_ {Artists}
148_labelVolume_ {Volumes}
149_labelCaptions_ {Captions}
150_labelCountries_ {Countries}
151
152
153_texticontext_ {View the document}
154_texticonclosedbook_ {open this document and view contents}
155_texticonnext_ {to next section}
156_texticonprev_ {to previous section}
157
158_texticonworld_ {View the web document}
159
160_texticonmidi_ {View the MIDI document}
161_texticonmsword_ {View the Microsoft Word document}
162_texticonmp3_ {View the MP3 document}
163_texticonpdf_ {View the PDF document}
164_texticonps_ {View the PostScript document}
165_texticonppt_ {View the PowerPoint document}
166_texticonrtf_ {View the RTF document}
167_texticonxls_ {View the Microsoft Excel document}
168
169_page_ {page }
170_pages_ {pages}
171_of_ { of }
172_vol_ {Vol.}
173_num_ {No.}
174
175_textmonth00_ {}
176_textmonth01_ {January}
177_textmonth02_ {February}
178_textmonth03_ {March}
179_textmonth04_ {April}
180_textmonth05_ {May}
181_textmonth06_ {June}
182_textmonth07_ {July}
183_textmonth08_ {August}
184_textmonth09_ {September}
185_textmonth10_ {October}
186_textmonth11_ {November}
187_textmonth12_ {December}
188
189_textdocument_ {Document}
190_textsection_ {Section}
191_textparagraph_ {Paragraph}
192
193_magazines_ {Magazines}
194
195_nzdlpagefooter_ {<div class="divbar">&nbsp;</div>
196<p><a href="http://www.nzdl.org">New Zealand Digital Library Project</a>
197<br><a href="http://www.cs.waikato.ac.nz">Department of Computer Science</a>,
198<a href="http://www.waikato.ac.nz">University of Waikato</a>,
199New Zealand}
200
201_linktextHOME_ {HOME}
202_linktextHELP_ {HELP}
203_linktextPREFERENCES_ {PREFERENCES}
204
205
206######################################################################
207# 'about' page
208package about
209######################################################################
210
211
212#------------------------------------------------------------
213# text macros
214#------------------------------------------------------------
215
216_textabcol_ {About this collection}
217
218_textsubcols1_ {<p>The complete collection comprises _1_ subcollections.
219Those currently available are:
220<blockquote>}
221
222_textsubcols2_ {</blockquote>
223You can check (and alter) which subcollections you are
224currently using on the Preferences page.}
225
226_titleabout_ {about}
227
228
229######################################################################
230# document package
231package document
232######################################################################
233
234
235#------------------------------------------------------------
236# text macros
237#------------------------------------------------------------
238
239# Dublin Core Metadata Element Set, Version 1.1
240
241
242_texticonopenbookshelf_ {close this section of the library}
243_texticonclosedbookshelf_ {open this section of the library and view contents}
244_texticonopenbook_ {close this book}
245_texticonclosedfolder_ {Open this folder and view contents}
246_texticonclosedfolder2_ {open sub-section: }
247_texticonopenfolder_ {close this folder}
248_texticonopenfolder2_ {close sub-section: }
249_texticonsmalltext_ {View this section of the text}
250_texticonsmalltext2_ {view text: }
251_texticonpointer_ {current section}
252_texticondetach_ {Open this page in a new window}
253_texticonhighlight_ {Highlight search terms}
254_texticonnohighlight_ {Don't highlight search terms}
255_texticoncontracttoc_ {Collapse table of contents}
256_texticonexpandtoc_ {Expand table of contents}
257_texticonexpandtext_ {Display all text}
258_texticoncontracttext_ {Display text only for currently selected section}
259_texticonwarning_ {<b>Warning: </b>}
260_texticoncont_ {continue?}
261
262_textltwarning_ {<div class="buttons">_imagecont_</div>
263_iconwarning_Expanding the text here will generate a large
264amount of data for your browser to display
265}
266
267_textgoto_ {go to page}
268_textintro_ { <i>(introductory text)</i>}
269
270_textCONTINUE_ {CONTINUE?}
271
272_textEXPANDTEXT_ {EXPAND\nTEXT}
273
274_textCONTRACTCONTENTS_ {CONTRACT\nCONTENTS}
275
276_textDETACH_ {DETACH}
277
278_textEXPANDCONTENTS_ {EXPAND\nCONTENTS}
279
280_textCONTRACT_ {CONTRACT\nTEXT}
281
282_textHIGHLIGHT_ {HIGH-\nLIGHTING}
283
284_textNOHIGHLIGHT_ {NO HIGH-\nLIGHTING}
285
286
287######################################################################
288# 'search' page
289package query
290######################################################################
291
292
293#------------------------------------------------------------
294# text macros
295#------------------------------------------------------------
296
297# this if statement produces the text 'results n1 - nn for query: querystring' or
298# 'No matches for query: querystring', depending on whether or not there were
299# any matches
300_textquerytitle_ {_If_(_thislast_,results _thisfirst_ - _thislast_ for query: _cgiargq_,No matches for query: _cgiargq_)}
301_textnoquerytitle_ {Search page}
302
303_textsome_ {some}
304_textall_ {all}
305_textboolean_ {boolean}
306_textranked_ {ranked}
307_textnatural_ {natural}
308#_textsome_ {_If_(_cgiargb_,ranked,some)}
309#_textall_ {_If_(_cgiargb_,boolean,all)}
310#_textformsome_ {_If_(_cgiargb_,ranked,some)}
311#_textformall_ {_If_(_cgiargb_,natural,all)}
312_texticonsearchhistorybar_ {search history}
313
314_textifeellucky_ {I'm feeling lucky!}
315
316#alt text for query buttons
317_textusequery_ {use this query}
318_textfreqmsg1_ {Word count: }
319_textpostprocess_ {_If_(_quotedquery_,<br><i>post-processed to find _quotedquery_</i>
320)}
321_textinvalidquery_ {Invalid query syntax}
322
323_textmorethan_ {More than }
324_textapprox_ {About }
325_textnodocs_ {No documents matched the query.}
326_text1doc_ {1 document matched the query.}
327_textlotsdocs_ {documents matched the query.}
328_textmatches_ {Matches }
329_textbeginsearch_ {Begin Search}
330_textrunquery_ {Run Query}
331_textclearform_ {Clear Form}
332
333#these go together in form search:
334#"Word or phrase (fold, stem) ... in field"
335_textwordphrase_ {Word or phrase}
336_textinfield_ {... in field}
337_textfoldstem_ {(fold, stem)}
338
339_textadvquery_ {Or enter a query directly:}
340_textallfields_ {all fields}
341_texttextonly_ {text only}
342_textand_ {and}
343_textor_ {or}
344_textandnot_ {and not}
345
346# _indexselection_, _jselection_, _nselection_ and _gselection_ are set from
347# within the server - _indexselection_ is always set, but the others may be
348# unset
349
350_textsimplesearch_ {Search for _indexselection_ _If_(_jselection_,of _jselection_ )_If_(_gselection_, at _gselection_ level )_If_(_nselection_,in _nselection_ language )that contain _querytypeselection_ of the words}
351
352_textadvancedsearch_ {Search _indexselection_ _If_(_jselection_,of _jselection_ )_If_(_gselection_,at _gselection_ level )_If_(_nselection_,in _nselection_ language )using _querytypeselection_ query}
353
354_textformsimplesearch_ {Search _If_(_jselection_,_jselection_ )_If_(_gformselection_,at _gformselection_ level )_If_(_nselection_,in _nselection_ language )for _formquerytypeselection_ of}
355
356_textformadvancedsearch_ {Search _If_(_jselection_,_jselection_ )_If_(_gformselection_,at _gformselection_ level )_If_(_nselection_,in _nselection_ language )and display results in _formquerytypeselection_ order}
357
358
359_textnojsformwarning_ {Warning: Javascript is disabled in your web browser. <br>To use form searching, please enable it.}
360_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.}
361_textstartdate_ {Start (or only) date:}
362_textenddate_ {End date:}
363_textbc_ {B.C.E.}
364_textad_ {C.E.}
365_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"}
366
367_textstemon_ { (ignoring word endings)}
368
369_textsearchhistory_ {Search History}
370
371#text macros for search history
372_textnohistory_ {No entries in the search history}
373_texthresult_ {result}
374_texthresults_ {results}
375_texthallwords_ {all words}
376_texthsomewords_ {some words}
377_texthboolean_ {boolean}
378_texthranked_ {ranked}
379_texthcaseon_ {case must match}
380_texthcaseoff_ {casefolded}
381_texthstemon_ {stemmed}
382_texthstemoff_ {unstemmed}
383
384
385######################################################################
386# 'preferences' page
387package preferences
388######################################################################
389
390
391#------------------------------------------------------------
392# text macros
393#------------------------------------------------------------
394
395_textprefschanged_ {
396Preferences have been set as follows. Do not use your browser's
397"back" button - it will unset them! Instead, click one of the
398buttons on the access bar above.
399}
400_textsetprefs_ {set preferences}
401_textsearchprefs_ {Search preferences}
402_textcollectionprefs_ {Collection preferences}
403_textpresentationprefs_ {Presentation preferences}
404_textpreferences_ {Preferences}
405_textcasediffs_ {Case differences:}
406_textignorecase_ { ignore case differences}
407_textmatchcase_ { upper/lower case must match}
408_textwordends_ {Word endings:}
409_textstem_ { ignore word endings}
410_textnostem_ { whole word must match}
411_textprefop_ {Return up to _maxdocoption_ hits with _hitsperpageoption_ hits per page.}
412_textextlink_ {Access to external Web pages:}
413_textintlink_ {Source documents retrieved from:}
414_textlanguage_ {Interface language:}
415_textencoding_ {Encoding:}
416_textformat_ {Interface format:}
417_textall_ {all}
418_textquerymode_ {Query mode:}
419_textsimplemode_ { simple query mode}
420_textadvancedmode_ { advanced query mode (allows boolean searching using !, &, |, and parentheses)}
421_textlinkinterm_ {through intermediate page}
422_textlinkdirect_ {go directly there}
423_textdigitlib_ {the digital library}
424_textweb_ {the web}
425_textgraphical_ {Graphical}
426_texttextual_ {Textual}
427_textcollectionoption_ {<p>
428Subcollections to include:
429<br>}
430
431_textrelateddocdisplay_ {display related documents}
432_textsearchhistory_ {Search history:}
433_textnohistory_ { No search history}
434_texthistorydisplay_ { display _historynumrecords_ search history records}
435_textnohistorydisplay_ { do not display search history}
436
437#_texttypesearch_ {Type of search:}
438#_texttextsearch_ {text search}
439_textformsearch_ {Form search:}
440_textplainsearch_ {Plain search:}
441_textqueryboxsize_ {Query box size:}
442_textregbox_ { regular query box}
443_textbigbox_ { large query box}
444_textformtype_ {Form type:}
445_textsimple_ { simple}
446_textadvanced_ { advanced}
447
448# used in "with 4 fields" in the form search box
449_textwith_ {with}
450_textfields_ {fields}
451
452
453#####################################################################
454# 'browse' package for the dynamic browsing interface
455package browse
456#####################################################################
457
458_textsortby_ {Sort documents by}
459_textalsoshowing_ {also showing}
460_textwith_ {with at most}
461_textdocsperpage_ {documents per page}
462
463_textfilterby_ {Get documents containing}
464_textall_ {all}
465_textany_ {any}
466_textwords_ {of the words}
467_textleaveblank_ {leave this box blank to get all the documents}
468
469_browsebuttontext_ {"Sort Documents"}
470
471_nodata_ {<i>no data</i>}
472_docs_ {documents}
473######################################################################
474# 'help' page -- this is lower priority for translating than the
475# rest of this file
476package help
477######################################################################
478
479
480#------------------------------------------------------------
481# text macros
482#------------------------------------------------------------
483
484_textHelp_ {Help}
485_textSearchshort_ {search for particular words}
486
487
488# Dublin Core Metadata Element Set, Version 1.1
489_textTitleshort_ {access publications by title}
490_textCreatorshort_ {access publications by author} # Not true DC, kept for legacy reasons
491_textSubjectshort_ {access publications by subject}
492_textDescriptionshort_ {access publications by description}
493_textPublishershort_ {access publications by publisher}
494_textContributorshort_ {access publications by contributor}
495_textDateshort_ {access publications by date}
496_textTypeshort_ {access publications by type}
497_textFormatshort_ {access publications by format}
498_textIdentifiershort_ {access publications by identifier}
499_textSourceshort_ {access publications by filename} # Not true DC, kept for legacy reasons
500_textLanguageshort_ {access publications by language}
501_textRelationshort_ {access publications by relation}
502_textCoverageshort_ {access publications by coverage}
503_textRightsshort_ {access publications by rights}
504
505_textSeriesshort_ {access publications by series}
506_textToshort_ {access publications by To field}
507_textFromshort_ {access publications by From field}
508_textBrowseshort_ {browse publications}
509_textOrganizationshort_ {access publications by organization}
510_textHowtoshort_ {access publications by "how to" listing}
511_textTopicshort_ {access publications by topic}
512_textPeopleshort_ {access publications by people}
513_textAcronymshort_ {access publications by acronym occurrence}
514_textPhraseshort_ {browse phrases occurring in publications}
515_textArtistshort_ {access publications by artist}
516_textKeywordshort_ {access publications by keyword}
517_textVolumeshort_ {access publications by volume}
518_textCountriesshort_ {access publications by country}
519_textdefaultshorttext_ {undefined classification}
520
521_textSearchlong_ { <p>You can <i>search for particular words</i> that
522appear in the text from the "search" page. This is the first page that
523comes up when you begin, and can be reached from other pages by pressing
524the <i>search</i> button. }
525
526
527# Dublin Core Metadata Element Set, Version 1.1
528
529_textTitlelong_ { <p>You can <i>access publications by title</i> by
530pressing the <i>titles a-z</i> button. This brings up a list of books in
531alphabetic order. }
532
533# Not true DC, kept for legacy reasons
534_textCreatorlong_ { <p>You can <i>access publications by author</i> by
535pressing the <i>authors a-z</i> button. This brings up a list of books,
536sorted by author name. }
537
538_textSubjectlong_ { <p>You can <i>access publications by subject</i> by
539pressing the <i>subjects</i> button. This brings up a list of subjects,
540represented by bookshelves. }
541
542_textDescriptionlong_ { <p>You can <i>access publications by description</i> by
543pressing the <i>descriptions</i> button. This brings up a list of descriptions to
544browse. }
545
546_textPublisherlong_ { <p>You can <i>access publications by publisher</i> by
547pressing the <i>publishers</i> button. This brings up a list of publishers to
548browse. }
549
550_textContributorlong_ { <p>You can <i>access publications by contributor</i> by
551pressing the <i>contributors</i> button. This brings up a list of contributors to
552browse. }
553
554_textDatelong_ { <p>You can <i>access publications by date</i> by pressing
555the <i>dates</i> button. This brings up a list of all the issues, sorted
556chronologically. }
557
558_textTypelong_ { <p>You can <i>access publications by type</i> by
559pressing the <i>types</i> button. This brings up a list of types to
560browse. }
561
562_textFormatlong_ { <p>You can <i>access publications by format</i> by
563pressing the <i>formats</i> button. This brings up a list of formats to
564browse. }
565
566_textIdentifierlong_ { <p>You can <i>access publications by identifier</i> by
567pressing the <i>identifiers</i> button. This brings up a list of identifiers to
568browse. }
569
570# Not true DC, kept for legacy reasons
571_textSourcelong_ { <p>You can <i>access publications by filename</i> by
572pressing the <i>filenames</i> button. This brings up a list of entries,
573sorted by original filename. }
574
575_textLanguagelong_ { <p>You can <i>access publications by language</i> by
576pressing the <i>languages</i> button. This brings up a list of entries,
577sorted by language. }
578
579_textRelationlong_ { <p>You can <i>access publications by relation</i> by
580pressing the <i>relations</i> button. This brings up a list of relations to
581browse. }
582
583_textCoveragelong_ { <p>You can <i>access publications by coverage</i> by
584pressing the <i>coverage</i> button. }
585
586_textRightslong_ { <p>You can <i>access publications by rights</i> by
587pressing the <i>rights</i> button. }
588
589
590
591_textOrganizationlong_ { <p>You can <i>access publications by
592organisation</i> by pressing the <i>organisations</i> button. This brings
593up a list of organisations. }
594
595_textHowtolong_ { <p>You can <i>access publications by "how to" listing</i>
596by pressing the <i>how to</i> button. This brings up a list of how to
597strings. }
598
599_textTopiclong_ { <p>You can <i>access publications by topic</i> by
600pressing the <i>topic</i> button. This brings up a list of topics to
601browse. }
602
603_textTolong_ { <p>You can <i>access publications by To field</i> by
604pressing the <i>to</i> button. This brings up a list of addressees. }
605
606_textFromlong_ { <p>You can <i>access publications by From field</i> by
607pressing the <i>from</i> button. This brings up a list of senders. }
608
609_textSerieslong_ { <p>You can <i>access publications by series</i> by
610pressing the <i>series</i> button. This brings up a list of those series
611which are currently in the collection. }
612
613_textBrowselong_ { <p>You can <i>browse publications</i> by pressing the
614<i>browse</i> button. }
615
616_textPeoplelong_ { <p>You can <i>access publications by people</i> by
617pressing the <i>people a-z</i> button. This brings up a list of entries,
618sorted by surname. }
619
620_textAcronymlong_ { <p>You can <i>access publications by acronym occurrence</i> by
621pressing the <i>acronyms</i> button. This brings up a list of the acronyms,
622and the places that they occur. }
623
624_textPhraselong_ { <p>You can <i>browse phrases occurring in publications</i> by
625pressing the <i>phrases</i> button. This uses the phind phrase browser. }
626
627_textArtistlong_ { <p>You can <i>access publications by artist</i> by
628pressing the <i>artists</i> button. This brings up a list of entries,
629sorted by artist name. }
630
631_textKeywordlong_ { <p>You can <i>access publications by keyword</i> by
632pressing the <i>keywords</i> button. This brings up a list of keywords. }
633
634_textVolumelong_ { <p>You can <i>access publications by volume</i> by
635pressing the <i>volumes</i> button. This brings up a list of volumes. }
636
637_textCaptionslong_ { <p>You can <i>access publications by caption</i> by
638pressing the <i>captions</i> button. This brings up a list of captions. }
639
640_textCountrieslong_ { <p>You can <i>access publications by country</i> by
641pressing the <i>countries</i> button. This brings up a list of countries. }
642
643
644_textdefaultlongtext_ { <p>Click on the <i>unknown</i> button to browse
645publications (listing is sorted by an unknown field). }
646
647_texthelptopics_ {
648<h2 align=left>Topics</h2>
649<ul>
650 <li><a href="\#finding-information">_textsimplehelpheading_</a>
651 _topicreadingdocs_
652 <li><a href="\#searching">How to search for particular words</a>
653<ul>
654 <li><a href="\#query-terms">Search terms</a>
655 <li><a href="\#query-type">Query type</a>
656 <li><a href="\#scope-of-queries">Scope of queries</a>
657</ul>
658 <li><a href="\#preferences">_textchangeprefs_</a>
659<ul>
660 <li><a href="\#col-prefs">Collection preferences</a>
661 <li><a href="\#lang-prefs">Language preferences</a>
662 <li><a href="\#pres-prefs">Presentation preferences</a>
663 <li><a href="\#search-prefs">Search preferences</a>
664</ul>
665</ul>
666}
667
668# there are 4 versions of this section of the help text.
669# which version is used is currently set within the server
670# (it should probably use the macro language e.g. [type=book])
671# 1 = html (like fao collections) -- section is empty
672# 2 = book (like hdl collection) -- macros beginning with book
673# 3 = bibliographic (like csbib) -- macros beginning with bib
674# 4 = standard (like gberg) -- the default
675
676_topicreadingdocs_ {<li><a href="\#reading-docs">_textreadingdocs_</a>}
677
678_textreadingdocs_ {How to read the documents}
679
680_texthelpreadingdocs_ {
681<div class="divbar">&nbsp;</div>
682<a name="reading-docs"></a>
683<h2>_textreadingdocs_</h2>
684
685<p>You can tell when you have arrived at an individual book or document
686because its title, or a photograph of the front cover, appears at the top
687left of the page. In some collections this is accompanied by a table of
688contents, while others contain just the number of the current page along
689with a box that allows you to select a new page and go forward and
690backward. In the table of contents, the current section heading is in bold
691face, and the table is expandable -- click on the folders to open or close
692them; click on the open book at the top to close it.</p>
693
694<p>Underneath is the text of the current section. When you have read
695through it, there are arrows at the bottom to take you on to the next
696section or back to the previous one.</p>
697
698<p>Below the title or front-cover photograph are some buttons. Click on
699<i>expand text</i> to expand out the whole text of the current section, or
700book. If the document is large, this could take a long time and use a lot
701of memory! Click on <i>expand contents</i> to expand out the whole table of
702contents so that you can see the titles of all chapters and
703subsections. Click on <i>detach</i> to make a new browser window for this
704document. (This is useful if you want to compare documents, or read two at
705once.) Finally, when you do a search the words you search for are
706highlighted. Click on <i>no highlighting</i> to remove highlighting.</p>
707
708<p>
709<table cellspacing="0" cellpadding="2" border="0">
710<tr><td colspan=2><img src="_httpiconbshelf_" border="0"></td><td>Open this bookshelf</td></tr>
711<tr><td><img src="_httpiconopenbook_" border="0"></td><td><img
712src="_httpiconbook_" border="0"></td><td>Open/close this book</td></tr>
713<tr><td colspan=2><img src="_httpiconitext_" border="0"></td><td>View this section of the text</td></tr>
714<tr><td><img src="_document:httpiconealltof_" border="0"></td><td><img
715src="_document:httpiconetsecof_" border="0"></td><td>Display all text, or not</td></tr>
716<tr><td><img src="_document:httpiconeexpcof_" border="0"></td><td><img
717src="_document:httpiconeconcof_" border="0"></td><td>Expand table of contents, or not</td></tr>
718<tr><td colspan=2><img src="_document:httpiconedtchof_" border="0"></td><td>Open this page in a new window</td></tr>
719<tr><td><img src="_document:httpiconehlof_" border="0"></td><td><img
720src="_document:httpiconenhlof_" border="0"></td><td>Highlight search terms, or not</td></tr>
721<tr><td colspan=2><img src="_httpiconmore_" border="0"></td><td>Click the arrow to go to the next section ...</td></tr>
722<tr><td colspan=2><img src="_httpiconless_" border="0"></td><td>... or back to the previous section</td></tr>
723</table>
724}
725
726_texthelpsearching_ {
727<h2>How to search for particular words</h2>
728<p>
729 From the search page, you make a query in these simple steps:<p>
730
731 <ol><li>Specify what items you want to search
732 <li>Say whether you want to search for all or just some of the words
733 <li>Type in the words you want to search for
734 <li>Click the <i>Begin Search</i> button
735 </ol>
736
737<p>When you make a query, the titles of twenty matching documents will be shown.
738There is a button at the end to take you on to the next twenty documents. From
739there you will find buttons to take you on to the third twenty or back to the
740first twenty, and so on. Click the title of any document, or the little button
741beside it, to see it.
742
743<p>A maximum of 100 is imposed on the number of
744 documents returned. You can change this number by clicking the
745 <i>preferences</i> button at the top of the page.<p>
746
747<div class="divbar">&nbsp;</div>
748<a name="query-terms"></a>
749<h3>Search terms</h3>
750
751<p>Whatever you type into the query box is interpreted as a list of words
752called "search terms." Each term contains nothing but alphabetic characters
753and digits. Terms are separated by white space. If any other characters such
754as punctuation appear, they serve to separate terms just as though they were
755spaces. And then they are ignored. You can't search for words that include
756punctuation.
757
758<p>For example, the query<p>
759 <ul><kbd>Agro-forestry in the Pacific Islands: Systems for Sustainability (1993)</kbd></ul>
760 <p>will be treated the same as<p>
761 <ul><kbd>Agro forestry in the Pacific Islands Systems for Sustainability 1993 </kbd></ul><p>
762
763<div class="divbar">&nbsp;</div>
764<a name="query-type"></a>
765<h3>Query type</h3>
766
767<p>There are two different kinds of query.
768
769<ul>
770 <li>Queries for <b>all</b> of the words. These look for documents (or
771 chapters, or titles) that contain all the words you have specified.
772 Documents that satisfy the query are displayed, in alphabetical
773 order.<p>
774
775 <li>Queries for <b>some</b> of the words. Just list some terms that are
776 likely to appear in the documents you are looking for. Documents are
777 displayed in order of how closely they match the query. When determining
778
779 the degree of match,
780
781 <p><ul>
782 <li> the more search terms a document contains, the closer it matches;
783 <li> rare terms are more important than common ones;
784 <li> short documents match better than long ones.
785 </ul>
786</ul>
787
788<p>Use as many search terms as you like--a whole sentence, or even a
789whole paragraph. If you specify only
790one term, documents will be ordered by its frequency of occurrence.<p>
791_texthelpscope_
792}
793
794_textdatesearch_ {Searching with Dates}
795
796_texthelpdatesearch_ {<h2>_textdatesearch_</h2>
797Date search lets you find documents that, as well as matching your search
798terms, are about events within a certain timeframe. You can search for
799documents from a certain year or from a range of years. Note that you do not
800have to have any search terms -- you can search by date alone; and also that
801you do not have to use dates in your search, if you do not type any dates in it
802 is just the same as if the date search didn't exist.<p>
803
804<div class="divbar">&nbsp;</div>
805<a name="datesearch-howto"></a>
806<h3>How to use this feature:</h3>
807<ul>
808 <li>To search for documents about a single year:<p>
809 <ul>
810 <li>Type in any ordinary search terms as you normally would.
811 <li>Type the year you want into the "Start (or only) date" box.
812 <li>If your date is from before the common era (also known as before
813 Christ), choose the "B.C.E" option from the pulldown menu next to that
814 box.
815 <li>Begin your search as you ordinarily would.
816 </ul>
817<p><li>To search for documents about a time period or range of years:<p>
818 <ul>
819 <li>Type in any ordinary search terms as you normally would.
820 <li>Type the earlier date into the "Start (or only) date" box.
821 <li>Type the later date into the "End date" box.
822 <li>Select "B.C.E" option from the pulldown menu next to any date from before
823 the common era (also known as before Christ).
824 <li>Begin your search as you ordinarily would.
825 </ul>
826</ul><p>
827
828<div class="divbar">&nbsp;</div>
829<a name="datesearch-results"></a>
830<h3>The way results of your search work</h3>
831
832Generally 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>
833}
834
835_textchangeprefs_ {Changing your preferences}
836
837_texthelppreferences_ {<h2>_textchangeprefs_</h2>
838
839<p>When you click the <i>preferences</i> button at the top of the page you will
840be able to change some features of the interface to suit your own requirements.
841
842<div class="divbar">&nbsp;</div>
843<a name="col-prefs"></a>
844<h3 align=left>Collection preferences</h3>
845
846Some collections comprise several subcollections, which can be searched
847independently or together, as one unit. If so, you can select which
848subcollections to include in your searches on the Preferences page.
849
850<div class="divbar">&nbsp;</div>
851<a name="lang-prefs"></a>
852<h3 align=left>Language preferences</h3>
853
854Each collection has a default presentation language, but you can switch to
855a different language if you like. You can also alter the encoding scheme
856used by Greenstone for output to the browser -- the software chooses
857sensible defaults, but with some browsers better visual results can be used
858by switching to a different encoding scheme. All collections allow you to
859switch from the standard graphical interface format to a textual one. This
860is particularly useful for visually impaired users who use large screen
861fonts or speech synthesizers for output.
862
863<div class="divbar">&nbsp;</div>
864<a name="pres-prefs"></a>
865<h3 align=left>Presentation preferences</h3>
866
867Depending on the particular collection, there may be several options you can
868set that control the presentation.
869
870<p>Collections of Web pages allow you to suppress the Greenstone navigation bar at
871the top of each document page, so that once you have done a search you land at
872the exact Web page that matches without any Greenstone header. To do another
873search you will have to use your browser's "back" button. These collections
874also allow you to suppress Greenstone's warning message when you click a link
875that takes you out of the digital library collection and on to the Web itself.
876And in some Web collections you can control whether the links on the "Search
877Results" page take you straight to the actual URL in question, rather than to
878the digital library's copy of the page.
879
880<div class="divbar">&nbsp;</div>
881<a name="search-prefs"></a>
882<h3 align=left>Search preferences</h3>
883<p>Two pairs of buttons control the kind of text matching in the searches that
884you make. The first set (labeled "case differences") controls whether upper and
885lower case must match. The second ("word endings") controls whether to ignore
886word endings or not. It is possible to get a large query box, so that you can
887easily do paragraph-sized searching. It is surprisingly quick to search for
888large amounts of text.
889
890<p>For example, if the buttons <i>ignore case differences</i> and
891<i>ignore word endings</i> are selected, the query<p>
892 <ul><kbd>African building</kbd></ul>
893 <p>will be treated the same as<p>
894 <ul><kbd>africa builds</kbd></ul><p>
895 because the uppercase letter in "African" will be transformed to
896 lowercase, and the suffixes "n" and "ing" will be removed from
897 "African" and "building" respectively (also, "s" would be removed from
898 "builds").
899
900<p>You can switch to an "advanced" query mode which allows you to combine terms
901using AND (&), OR (|), and NOT (!). This allows you to specify more precise
902queries. You can turn the search history feature, which shows you your last few
903queries. This makes it easy to repeat slightly modified versions of previous
904queries. Finally, you can control the number of hits returned, and the
905number presented on each screenful.
906}
907
908_texttanumbrowseoptions_ {There are _numbrowseoptions_ ways to find information in this collection:}
909
910_textsimplehelpheading_ {How to find information in the _collectionname_ collection}
911
912_texthelpscope_ {
913<div class="divbar">&nbsp;</div>
914<a name="scope-of-queries"></a>
915<h3 align=left>Scope of queries</h3>
916
917<p>
918In most collections you can choose different indexes to search. For example, there might
919be author or title indexes. Or there might be chapter or paragraph indexes. Generally,
920the full matching document is returned regardless of which index you search.
921<p>If documents are books, they will be opened at the appropriate place.
922}
Note: See TracBrowser for help on using the repository browser.