root/branches/New_Config_Format-branch/gsdl/macros/english.dm @ 1279

Revision 1279, 35.2 KB (checked in by sjboddie, 20 years ago)

merged changes to trunk into New_Config_Format branch

  • Property svn:executable set to *
  • Property svn:keywords set to Author Date Id Revision
Line 
1######################################################################
2#
3# English Language text and icon macros
4#
5######################################################################
6#
7# This is the main macro file for translation when creating an
8# interface in another language.
9#
10# Under the 'text macros' comments are text macros of the form:
11# _macroname_ {macro value}
12# Everything between the {} is the text to be translated. This text
13# may itself contain macros (i.e. characters other than space between
14# underscore characters, e.g. _about:numdocs_ or _textpage_). These
15# macro names occurring within text shouldn't be translated but should
16# be left as they are. Underscores or curly brackets occurring
17# naturally within the text should be escaped with a leading backslash
18# (i.e. '\_', '\{' or '\}).
19#
20# Under the 'icons' comments are macros concerned with displaying
21# icons which themselves contain text.
22# Above each macro (or group of macros) for an icon is a comment line
23# that looks something like '## "HOME" ## top_nav_button ## chome ##'.
24# The first field of the comment ("HOME" in this case) is the text
25# that appears in the english version of the icon. This is the text
26# that must be translated, nothing needs to be done to the macros
27# themselves. The other two fields of the comments are used by
28# automatic icon generating software which reads the newly translated
29# file and generates appropriate icons.
30#
31# Comment lines (other than those described above) need not be
32# translated (i.e. any lines beginning with '#', like this line).
33#
34# The simplest way to translate this file is to save it as something
35# else (e.g. french.dm) and work through translating all the text
36# macro values and icon comments.
37#
38######################################################################
39
40
41######################################################################
42# Global (base) package
43package Global
44######################################################################
45
46
47#------------------------------------------------------------
48# text macros
49#------------------------------------------------------------
50
51_textdefaultcontent_ {The requested page could not be found. Please use
52your browsers 'back' button or the above home button to return to the
53Greenstone Digital Library.}
54
55_textdefaulttitle_ {GSDL Error}
56
57_collectionextra_ {This collection contains _about:numdocs_ documents.
58It was last built _about:builddate_ days ago.}
59
60_textimagecollection_ {}
61_textimageabout_ {About page}
62_textimagehome_ {Home page}
63_textimagehelp_ {Help page}
64_textimagepref_ {Preferences page}
65_textimagegreenstone_ {Greenstone Digital Library Software}
66
67_textimagesearch_ {Search for specific terms}
68_textimageTitle_ {Browse alphabetical list of titles}
69_textimageList_ {Browse document listing}
70_textimageCreator_ {Browse alphabetical list of authors}
71_textimageSeries_ {Browse by issue}
72_textimageDate_ {Browse by date}
73_textimageSubject_ {Browse by subject category}
74_textimageTo_ {Browse by To field}
75_textimageFrom_ {Browse by From field}
76_textimageOrganization_ {Browse by organization}
77_textimageHowto_ {Browse how to categories}
78_textimageTopic_ {Browse special topic issues}
79_textimageBrowse_ {Browse}
80_textimagePeople_ {Browse alphabetical list of People}
81
82_texticontabsearchgreen_{Search}
83_texticontabdategreen_{Dates}
84_texticontabseriesgreen_{Series}
85_texticontabauthorgreen_{Authors A-Z}
86_texticontabtitlegreen_{Titles A-Z}
87_texticontablistgreen_ {Listing}
88_texticontabsubjectgreen_{Subjects}
89_texticontabtogreen_{To}
90_texticontabfromgreen_{From}
91_texticontaborggreen_{Organization}
92_texticontabhowgreen_{How to}
93_texticontabtopicgreen_{Topics}
94_texticontabbrwsegreen_{Browse}
95_texticontabPeoplegreen_{People A-Z}
96
97_texticontext_ {View the document}
98_texticonclosedbook_ {open this document and view contents}
99_texticonnext_ {to next section}
100_texticonprev_ {to previous section}
101
102_page_ {page }
103_pages_ {pages}
104_of_ { of }
105_vol_ {Volume}
106_num_ {Number}
107
108_textmonth00_ {}
109_textmonth01_ {January}
110_textmonth02_ {February}
111_textmonth03_ {March}
112_textmonth04_ {April}
113_textmonth05_ {May}
114_textmonth06_ {June}
115_textmonth07_ {July}
116_textmonth08_ {August}
117_textmonth09_ {September}
118_textmonth10_ {October}
119_textmonth11_ {November}
120_textmonth12_ {December}
121
122_Document_ {Document}
123_Section_ {Section}
124_Paragraph_ {Paragraph}
125
126_magazines_ {Magazines}
127
128_nzdlpagefooter_ {<p>_iconblankbar_
129<p><a href="http://www.nzdl.org">New Zealand Digital Library Project</a>
130<br><a href="http://www.cs.waikato.ac.nz/cs">Department of Computer Science</a>,
131<a href="http://www.waikato.ac.nz">University of Waikato</a>,
132New Zealand}
133
134#------------------------------------------------------------
135# icons
136#------------------------------------------------------------
137
138## "HOME" ## top_nav_button ## chome ##
139_httpiconchomeof_ {_httpimg_/chomeof.gif}
140_httpiconchomeon_ {_httpimg_/chomeon.gif}
141_widthchomex_ {43}
142_heightchomex_ {20}
143
144## "HELP" ## top_nav_button ## chelp ##
145_httpiconchelpof_ {_httpimg_/chelpof.gif}
146_httpiconchelpon_ {_httpimg_/chelpon.gif}
147_widthchelpx_ {36}
148_heightchelpx_ {20}
149
150## "PREFERENCES" ## top_nav_button ## cpref ##
151_httpiconcprefof_ {_httpimg_/cprefof.gif}
152_httpiconcprefon_ {_httpimg_/cprefon.gif}
153_widthcprefx_ {87}
154_heightcprefx_ {20}
155
156## "help" ## green_title ## h_help ##
157_httpiconhhelp_ {_httpimg_/h\_help.gif}
158_widthhhelp_ {200}
159_heighthhelp_ {57}
160
161## "authors a-z" ## nav_bar_button ## tauth ##
162_httpicontauthgr_ {_httpimg_/tauthgr.gif}
163_httpicontauthof_ {_httpimg_/tauthof.gif}
164_httpicontauthon_ {_httpimg_/tauthon.gif}
165_widthtauthx_ {110}
166_heighttauthx_ {17}
167
168## "series" ## nav_bar_button ## tser ##
169_httpicontsergr_ {_httpimg_/tsergr.gif}
170_httpicontserof_ {_httpimg_/tserof.gif}
171_httpicontseron_ {_httpimg_/tseron.gif}
172_widthtserx_ {87}
173_heighttserx_ {17}
174
175## "dates" ## nav_bar_button ## tdate ##
176_httpicontdategr_ {_httpimg_/tdategr.gif}
177_httpicontdateof_ {_httpimg_/tdateof.gif}
178_httpicontdateon_ {_httpimg_/tdateon.gif}
179_widthtdatex_ {87}
180_heighttdatex_ {17}
181
182## "subjects" ## nav_bar_button ## tsubj ##
183_httpicontsubjgr_ {_httpimg_/tsubjgr.gif}
184_httpicontsubjon_ {_httpimg_/tsubjon.gif}
185_httpicontsubjof_ {_httpimg_/tsubjof.gif}
186_widthtsubjx_ {87}
187_heighttsubjx_ {17}
188
189## "to" ## nav_bar_button ## tto ##
190_httpiconttogr_ {_httpimg_/ttogr.gif}
191_httpiconttoon_ {_httpimg_/ttoon.gif}
192_httpiconttoof_ {_httpimg_/ttoof.gif}
193_widthttox_ {87}
194_heightttox_ {17}
195
196## "from" ## nav_bar_button ## tfrom ##
197_httpicontfromgr_ {_httpimg_/tfromgr.gif}
198_httpicontfromon_ {_httpimg_/tfromon.gif}
199_httpicontfromof_ {_httpimg_/tfromof.gif}
200_widthtfromx_ {87}
201_heighttfromx_ {17}
202
203## "organization" ## nav_bar_button ## torg ##
204_httpicontorggr_{_httpimg_/torggr.gif}
205_httpicontorgon_{_httpimg_/torgon.gif}
206_httpicontorgof_{_httpimg_/torgof.gif}
207_widthtorgx_ {109}
208_heighttorgx_ {17}
209
210## "how to" ## nav_bar_button ## thow ##
211_httpiconthowgr_{_httpimg_/thowgr.gif}
212_httpiconthowon_{_httpimg_/thowon.gif}
213_httpiconthowof_{_httpimg_/thowof.gif}
214_widththowx_ {87}
215_heightthowx_ {17}
216
217## "topic" ## nav_bar_button ## ttopic ##
218_httpiconttopicgr_{_httpimg_/ttopicgr.gif}
219_httpiconttopicon_{_httpimg_/ttopicon.gif}
220_httpiconttopicof_{_httpimg_/ttopicof.gif}
221_widthttopicx_ {87}
222_heightttopicx_ {17}
223
224## "browse" ## nav_bar_button ## tbrwse ##
225_httpicontbrwsegr_{_httpimg_/tbrwsegr.gif}
226_httpicontbrwseon_{_httpimg_/tbrwseon.gif}
227_httpicontbrwseof_{_httpimg_/tbrwseof.gif}
228_widthtbrwsex_ {87}
229_heighttbrwsex_ {17}
230
231## "search" ## nav_bar_button ## tsrch ##
232_httpicontsrchgr_ {_httpimg_/tsrchgr.gif}
233_httpicontsrchof_ {_httpimg_/tsrchof.gif}
234_httpicontsrchon_ {_httpimg_/tsrchon.gif}
235_widthtsrchx_ {87}
236_heighttsrchx_ {17}
237
238## "titles a-z" ## nav_bar_button ## ttitl ##
239_httpiconttitlgr_ {_httpimg_/ttitlgr.gif}
240_httpiconttitlof_ {_httpimg_/ttitlof.gif}
241_httpiconttitlon_ {_httpimg_/ttitlon.gif}
242_widthttitlx_ {87}
243_heightttitlx_ {17}
244
245## "people" ## nav_bar_button ## tpeop ##
246_httpicontpeopgr_ {_httpimg_/tpeopgr.gif}
247_httpicontpeopof_ {_httpimg_/tpeopof.gif}
248_httpicontpeopon_ {_httpimg_/tpeopon.gif}
249_widthtpeopx_ {97}
250_heighttpeopx_ {17}
251
252
253
254######################################################################
255# 'about' page
256package about
257######################################################################
258
259
260#------------------------------------------------------------
261# text macros
262#------------------------------------------------------------
263
264_textabcol_ {About this collection}
265
266_textsubcols1_ {<p>The complete collection comprises _1_ subcollections:
267<blockquote>}
268
269_textsubcols2_ {</blockquote>
270You can check (and alter) which subcollections you are
271currently using on the Preferences page.}
272
273
274#------------------------------------------------------------
275# icons
276#------------------------------------------------------------
277
278## "about" ## green_title ## h_about ##
279_httpiconhabout_ {_httpimg_/h\_about.gif}
280_widthhabout_ {200}
281_heighthabout_ {57}
282
283
284
285######################################################################
286# document package
287package document
288######################################################################
289
290
291#------------------------------------------------------------
292# text macros
293#------------------------------------------------------------
294
295_textTitlepage_ {_texticonhtitle_}
296_textCreatorpage_ {_texticonhauth_}
297_textSubjectpage_ {_texticonhsubj_}
298_textTopage_ {_texticonhto_}
299_textFrompage_ {_texticonhfrom_}
300_textSeriespage_ {_texticonhser_}
301_textDatepage_ {_texticonhdate_}
302_textHowtopage_ {_texticonhhow_}
303_textOrganizationpage_ {_texticonhorg_}
304_textBrowsepage_ {_texticonhbrwse_}
305_textPeoplepage_ {_texticonhpeople_}
306
307_texticonhtitle_ {Titles A-Z}
308_texticonhauth_ {Authors A-Z}
309_texticonhsubj_ {Subjects}
310_texticonhto_ {To}
311_texticonhfrom_ {From}
312_texticonhser_ {Series}
313_texticonhdate_ {Dates}
314_texticonhhow_ {How to}
315_texticonhorg_ {Organizations}
316_texticonhbrwse_ {Browse}
317_texticonhpeople_ {People A-Z}
318
319_texticonopenbookshelf_ {close this section of the library}
320_texticonclosedbookshelf_ {open this section of the library and view contents}
321_texticonopenbook_ {close this book}
322_texticonclosedfolder_ {Open this folder and view contents}
323_texticonclosedfolder2_ {open sub-section: }
324_texticonopenfolder_ {close this folder}
325_texticonopenfolder2_ {close sub-section: }
326_texticonsmalltext_ {View this section of the text}
327_texticonsmalltext2_ {view text: }
328_texticonpointer_ {current section}
329_texticondetach_ {Open this page in a new window}
330_texticonhighlight_ {Highlight search terms}
331_texticonnohighlight_ {Don't highlight search terms}
332_texticoncontracttoc_ {Collapse table of contents}
333_texticonexpandtoc_ {Expand table of contents}
334_texticonexpandtext_ {Display all text}
335_texticoncontracttext_ {Display text only for currently selected section}
336_texticonwarning_ {<b>Warning: </b>}
337_texticoncont_ {continue?}
338
339_textltwarning_ {
340<p><center>
341<table cellspacing=0 cellpadding=0 width=_pagewidth_>
342<tr valign=top><td>_iconwarning_Expanding the text here will generate a large
343amount of data for your browser to display _imagecont_
344</td></tr></table></center>
345}
346
347_textgoto_ {go to page}
348_textintro_ { <i>(introductory text)</i>}
349
350
351#------------------------------------------------------------
352# icons
353#------------------------------------------------------------
354
355## "titles a-z" ## green_title ## h_title ##
356_httpiconhtitle_ {_httpimg_/h\_title.gif}
357_widthhtitle_ {200}
358_heighthtitle_ {57}
359
360## "authors a-z" ## green_title ## h_auth ##
361_httpiconhauth_ {_httpimg_/h\_auth.gif}
362_widthhauth_ {200}
363_heighthauth_ {57}
364
365## "subjects" ## green_title ## h_subj ##
366_httpiconhsubj_ {_httpimg_/h\_subj.gif}
367_widthhsubj_ {200}
368_heighthsubj_ {57}
369
370## "to" ## green_title ## h_to ##
371_httpiconhto_ {_httpimg_/h\_to.gif}
372_widthhto_ {200}
373_heighthto_ {57}
374
375## "from" ## green_title ## h_from ##
376_httpiconhfrom_ {_httpimg_/h\_from.gif}
377_widthhfrom_ {200}
378_heighthfrom_ {57}
379
380## "series" ## green_title ## h_ser ##
381_httpiconhser_ {_httpimg_/h\_ser.gif}
382_widthhser_ {200}
383_heighthser_ {57}
384
385## "dates" ## green_title ## h_date ##
386_httpiconhdate_ {_httpimg_/h\_date.gif}
387_widthhdate_ {200}
388_heighthdate_ {57}
389
390## "how to" ## green_title ## h_how ##
391_httpiconhhow_ {_httpimg_/h\_how.gif}
392_widthhhow_ {200}
393_heighthhow_ {57}
394
395## "topics" ## green_title ## h_topic ##
396_httpiconhtopic_ {_httpimg_/h\_topic.gif}
397_widthhtopic_ {200}
398_heighthtopic_ {57}
399
400## "organization" ## green_title ## h_org ##
401_httpiconhorg_ {_httpimg_/h\_org.gif}
402_widthhorg_ {250}
403_heighthorg_ {57}
404
405## "browse" ## green_title ## h_brwse ##
406_httpiconhbrwse_ {_httpimg_/h\_brwse.gif}
407_widthhbrwse_ {200}
408_heighthbrwse_ {57}
409
410## "people" ## green_title ## h_people ##
411_httpiconhpeople_ {_httpimg_/h\_people.gif}
412_widthhpeople_ {200}
413_heighthpeople_ {57}
414
415## "CONTINUE?" ## top_nav_button ## cont ##
416_httpiconcontoff_ {_httpimg_/contoff.gif}
417_httpiconconton_ {_httpimg_/conton.gif}
418_widthcontx_ {76}
419_heightcontx_ {17}
420
421## "EXPAND TEXT" ## document_button ## eallt ##
422_httpiconealltof_ {_httpimg_/ealltof.gif}
423_httpiconeallton_ {_httpimg_/eallton.gif}
424_widthealltx_ {65}
425_heightealltx_ {30}
426
427## "CONTRACT CONTENTS" ## document_button ## econc ##
428_httpiconeconcof_ {_httpimg_/econcof.gif}
429_httpiconeconcon_ {_httpimg_/econcon.gif}
430_widtheconcx_ {65}
431_heighteconcx_ {30}
432
433## "DETACH" ## document_button ## edtch ##
434_httpiconedtchof_ {_httpimg_/edtchof.gif}
435_httpiconedtchon_ {_httpimg_/edtchon.gif}
436_widthedtchx_ {65}
437_heightedtchx_ {30}
438
439## "EXPAND CONTENTS" ## document_button ## eexpc ##
440_httpiconeexpcof_ {_httpimg_/eexpcof.gif}
441_httpiconeexpcon_ {_httpimg_/eexpcon.gif}
442_widtheexpcx_ {65}
443_heighteexpcx_ {30}
444
445## "CONTRACT TEXT" ## document_button ## etsec ##
446_httpiconetsecof_ {_httpimg_/etsecof.gif}
447_httpiconetsecon_ {_httpimg_/etsecon.gif}
448_widthetsecx_ {65}
449_heightetsecx_ {30}
450
451## "HIGHLIGHTING" ## document_button ## ehl ##
452_httpiconehlof_ {_httpimg_/ehlof.gif}
453_httpiconehlon_ {_httpimg_/ehlon.gif}
454_widthehlx_ {65}
455_heightehlx_ {30}
456
457## "NO HIGHLIGHTING" ## document_button ## enhl ##
458_httpiconenhlof_ {_httpimg_/enhlof.gif}
459_httpiconenhlon_ {_httpimg_/enhlon.gif}
460_widthenhlx_ {65}
461_heightenhlx_ {30}
462
463
464
465######################################################################
466# 'search' page
467package query
468######################################################################
469
470
471#------------------------------------------------------------
472# text macros
473#------------------------------------------------------------
474
475# this if statement produces the text 'results n1 - nn for query: querystring' or
476# 'No matches for query: querystring', depending on whether or not there were
477# any matches
478_textquerytitle_ {_If_(_thislast_,results _thisfirst_ - _thislast_ for query: _cgiargq_,No matches for query: _cgiargq_)}
479_textnoquerytitle_ {Search page}
480
481_texticonthispage_ {search}
482_textsome_ {_If_(_cgiargb_,ranked,some)}
483_textall_ {_If_(_cgiargb_,boolean,all)}
484_texticonqueryresultsbar_ {}
485_textfreqmsg1_ {Word count: }
486_textpostprocess_ {_If_(_quotedquery_,<br><i>post-processed to find _quotedquery_</i>
487)}
488
489_textmorethan_ {More than }
490_textapprox_ {About }
491_textnodocs_ {No documents matched the query.}
492_text1doc_ {1 document matched the query.}
493_textlotsdocs_ {documents matched the query.}
494_textmatches_ {Matches }
495_textbeginsearch_ {Begin Search}
496
497# the textselect macro may need to be overridden for some collections
498# _hselection_, _jselection_ and _nselection_ are set from within the server
499# some or all of them may remain unset
500_textselect_ {_If_(_cgiargb_,_textadvancedsearch_,_textsimplesearch_)}
501
502_textsimplesearch_ {Search for _If_(_hselection_, _hselection_)_If_(_jselection_,_textjselect_)_If_(_gselection_, at _gselection_ level)_If_(_nselection_, in _nselection_ language)
503which contain _querytypeselection_ of the words}
504
505_textadvancedsearch_ {Search_If_(_hselection_, _hselection_, _defaultindextext_)_If_(_jselection_,_textjselect_)_If_(_gselection_, at _gselection_ level)_If_(_nselection_, in _nselection_ language)
506using _querytypeselection_ query}
507
508_textjselect_ {_If_(_hselection_, of) _jselection_}
509
510_querytypeselection_ {
511<select name="t">
512<option value="1"_If_(_cgiargt_, selected)>_textsome_
513<option value="0"_If_(_cgiargt_,, selected)>_textall_
514</select>
515}
516
517_textstemon_ { (ignoring word endings)}
518_textclearhistory_ {Clear History}
519_textexpand_ {Expand}
520_textcontract_ {Contract}
521_textsearchhistory_ {Search History}
522_textquery_ {Query}
523_textresults_ {Results}
524_textview_ {View}
525_textnohistory_ {Search history not available}
526
527
528#------------------------------------------------------------
529# icons
530#------------------------------------------------------------
531
532## "search" ## green_title ## h_search ##
533_httpiconhsearch_ {_httpimg_/h\_search.gif}
534_widthhsearch_ {200}
535_heighthsearch_ {57}
536
537## "results" ## green_bar_left_aligned ## qryresb ##
538_httpiconqryresb_ {_httpimg_/qryresb.gif}
539_widthqryresb_ {_pagewidth_}
540_heightqryresb_ {17}
541
542## "display" ## hand_made ##
543_httpicondisplay_ {_httpimg_/display.gif}
544_widthdisplay_ {60}
545_heightdisplay_ {20}
546
547
548
549######################################################################
550# 'preferences' page
551package preferences
552######################################################################
553
554
555#------------------------------------------------------------
556# text macros
557#------------------------------------------------------------
558
559_textsearchprefs_ {Search preferences}
560_textcollectionprefs_ {Collection preferences}
561_textpresentationprefs_ {Presentation preferences}
562_textpreferences_ {Preferences}
563_textignorecase_ { ignore case differences}
564_textmatchcase_ { upper/lower case must match}
565_textstem_ { ignore word endings}
566_textnostem_ { whole word must match}
567_textprefop_ {Return up to _maxdocoption_ hits with _hitsperpageoption_ hits per page.}
568_textextlink_ {Access to external Web pages: }
569_textintlink_ {Source documents retrieved from:}
570_textlanguage_ {Interface language: }
571_textencoding_ {Encoding: }
572_textformat_ {Interface format: }
573_textall_ {all}
574_textsimplemode_ {simple query mode}
575_textadvancedmode_ {advanced query mode (allows boolean searching using !, &, |, and parentheses)}
576_textlinkinterm_ {through intermediate page}
577_textlinkdirect_ {go directly there}
578_textdigitlib_ {the digital library}
579_textweb_ {the web}
580_textlangeng_ {English}
581_textlanggerman_ {German}
582_textlangfrench_ {French}
583_textlangspanish_ {Spanish}
584_textlangmaori_ {M_amn_ori}
585_textlangchinese_ {Chinese}
586_textlangarabic_ {Arabic}
587_textgraphical_ {Graphical}
588_texttextual_ {Textual}
589_textcollectionoption_ {<p>
590Subcollections to include:
591<br>}
592_textfcoption_ {Include navigation bar at top of document pages}
593_texthloption_ {Highlight search terms within document text}
594_texthistorydisplay_ {display search history}
595
596
597#------------------------------------------------------------
598# icons
599#------------------------------------------------------------
600
601## "preferences" ## green_title ## h_pref ##
602_httpiconhpref_ {_httpimg_/h\_pref.gif}
603_widthhpref_ {200}
604_heighthpref_ {57}
605
606
607
608######################################################################
609# 'delete search history' page
610package delhistory
611######################################################################
612
613
614#------------------------------------------------------------
615# text macros
616#------------------------------------------------------------
617
618_textdsh_ {Delete Search History}
619
620_textselectdelete_ {<a href="_httpclearhistory_&hdh=1">Delete all
621records</a> or select records to <select name=hmode><option value=save>not
622delete<option value=delete selected>delete</select><br> Records can be
623selected by typing their numbers into the box,<br> or by clicking in the
624boxes in each record.<br> Acceptable values are 1,2,3-6,7- etc }
625
626_textclearselected_ {Clear selected}
627_textselect_ {select}
628
629
630#------------------------------------------------------------
631# icons
632#------------------------------------------------------------
633
634
635
636######################################################################
637# 'help' page -- this is lower priority for translating than the
638# rest of this file
639package help
640######################################################################
641
642
643#------------------------------------------------------------
644# text macros
645#------------------------------------------------------------
646
647_textHelp_ {Help}
648_textSearchshort_ {search for particular words}
649_textSeriesshort_ {access publications by series}
650_textDateshort_ {access publications by date}
651_textSubjectshort_ {access publications by subject}
652_textToshort_ {access publications by To field}
653_textFromshort_ {access publications by From field}
654_textTitleshort_ {access publications by title}
655_textBrowseshort_ {browse publications}
656_textCreatorshort_ {access publications by author}
657_textOrganizationshort_ {access publications by organization}
658_textHowtoshort_ {access publications by how to listing}
659_textTopicshort_ {access publications by topic}
660_textPeopleshort_ {access publications by people}
661_textdefaultshorttext_ {undefined classification}
662
663_textSearchlong_ { <p>You can <i>search for particular words</i> that
664appear in the text from the "search" page. This is the first page that
665comes up when you begin, and can be reached from other pages by pressing
666the <i>search</i> button.  }
667
668_textTitlelong_ { <p>You can <i>access publications by title</i> by
669pressing the <i>titles a-z</i> button.  This brings up a list of books in
670alphabetic order.  }
671
672_textOrganizationlong_ { <p>You can <i>access publications by
673organization</i> by pressing the <i>organization</i> button.  This brings
674up a list of organizations.  }
675
676_textHowtolong_ { <p>You can <i>access publications by how to listing</i>
677by pressing the <i>how to</i> button.  This brings up a list of how to
678strings.  }
679
680_textCreatorlong_ { <p>You can <i>access publications by author</i> by
681pressing the <i>authors a-z</i> button.  This brings up a list of books,
682sorted by author name.  }
683
684_textTopiclong_ { <p>You can <i>access publications by topic</i> by
685pressing the <i>topic</i> button.  This brings up a list of topics to
686browse.  }
687
688_textSubjectlong_ { <p>You can <i>access publications by subject</i> by
689pressing the <i>subjects</i> button.  This brings up a list of subjects,
690represented by bookshelves.  }
691
692_textTolong_ { <p>You can <i>access publications by To field</i> by
693pressing the <i>to</i> button.  This brings up a list of addressees.  }
694
695_textFromlong_ { <p>You can <i>access publications by From field</i> by
696pressing the <i>from</i> button.  This brings up a list of senders.  }
697
698_textSerieslong_ { <p>You can <i>access publications by series</i> by
699pressing the <i>series</i> button.  This brings up a list of those series
700which are currently in the collection.  }
701
702_textDatelong_ { <p>You can <i>access publications by date</i> by pressing
703the <i>dates</i> button.  This brings up a list of all the issues, sorted
704chronologically.  }
705
706_textBrowselong_ { <p>You can <i>browse publications</i> by pressing the
707<i>browse</i> button.  }
708
709_textPeoplelong_ { <p>You can <i>access publications by people</i> by
710pressing the <i>people a-z</i> button.  This brings up a list of entries,
711sorted by surname.  }
712
713_textdefaultlongtext_ { <p>Click on the <i>unknown</i> button to browse
714publications (listing is sorted by an unknown field).  }
715
716_texthelptopics_ {
717<h2 align=left>Topics</h2>
718<ul>
719  <li><a href="\#finding-information">_textsimplehelpheading_</a>
720  _topicreadingdocs_
721  <li><a href="\#searching">How to search for particular words</a>
722<ul>
723  <li><a href="\#query-terms">Search terms</a>
724  <li><a href="\#query-type">Query type</a>
725  <li><a href="\#scope-of-queries">Scope of queries</a>
726</ul>
727  <li><a href="\#preferences">_textchangeprefs_</a>
728<ul>
729  <li><a href="\#col-prefs">Collection preferences</a>
730  <li><a href="\#pres-prefs">Presentation preferences</a>
731  <li><a href="\#search-prefs">Search preferences</a>
732</ul>
733</ul>
734}
735
736# there are 4 versions of this section of the help text.
737# which version is used is currently set within the server
738# (it should probably use the macro language e.g. [type=book])
739# 1 = html (like fao collections) -- section is empty
740# 2 = book (like hdl collection) -- macros beginning with book
741# 3 = bibliographic (like csbib) -- macros beginning with bib
742# 4 = standard (like gberg) -- the default
743
744_topicreadingdocs_ {<li><a href="\#reading-docs">_textreadingdocs_</a>}
745
746_textreadingdocs_ {How to read the documents}
747_booktextreadingdocs_ {How to read the books}
748_bibtextreadingdocs_ {Getting more information on a bibliography item}
749
750_texthelpreadingdocs_ {
751<p>_iconblankbar_
752<a name=reading-docs>
753<h2>_textreadingdocs_</h2>
754
755<p>You can tell when you have arrived at an individual document because its
756title and author appear at the top left of the page. Beside these is the
757number of the current page, a box that allows you to select a new page, and
758forward and backward arrows.
759
760<p>Underneath is the text of the current section. When you have read
761through it, there are arrows at the bottom to take you on to the next
762section or back to the previous one.
763
764<p>Below the title and author are three buttons. Click on <i>expand
765text</i> to expand out the whole text of the current document. If the
766document is large, this could take a long time and use a lot of memory!
767Click on <i>detach</i> to make a new browser window for this
768document. (This is useful if you want to compare documents, or read two at
769once.)  Finally, when you do a search the words you search for are
770highlighted.  Click on <i>no highlighting</i> to remove the highlighting.
771<p>
772<table cellspacing="0" cellpadding="2" border="0">
773<tr><td colspan=2><img src="_httpiconmore_" border="0"></td><td>Click on the arrow to go to the next section ...</td></tr>
774<tr><td colspan=2><img src="_httpiconless_" border="0"></td><td>... or back to the previous section</td></tr>
775<tr><td><img src="_document:httpiconealltof_" border="0"></td><td><img
776src="_document:httpiconetsecof_" border="0"></td><td>Display all text, or not</td></tr>
777<tr><td colspan=2><img src="_document:httpiconedtchof_" border="0"></td><td>Open this page in a new window</td></tr>
778<tr><td><img src="_document:httpiconehlof_" border="0"></td><td><img
779src="_document:httpiconenhlof_" border="0"></td><td>Highlight search terms, or not</td></tr>
780</table>
781
782}
783
784_booktexthelpreadingdocs_ {
785<p>_iconblankbar_
786<a name=reading-docs>
787<h2>_textreadingdocs_</h2>
788
789<p>You can tell when you have arrived at an individual book because there
790is a photograph of its front cover at the top left of the page.  Beside the
791photograph is a table of contents with an arrow marking where you are.
792This table is expandable: click on the folders to open them or close them.
793Click on the open book at the top to close it.
794
795<p>Underneath is the text of the current section.  When you have read
796through it, there are arrows at the bottom to take you on to the next
797section or back to the previous one.
798
799<p>Below the photograph are four buttons. Click on <i>expand text</i> to
800expand out the whole text of the current section, or book.  If the book is
801large, this could take a long time and use a lot of memory! Click on
802<i>expand contents</i> to expand out the whole table of contents so that
803you can see the titles of all chapters and subsections. Click on
804<i>detach</i> to make a new browser window for this book.  (This is useful
805if you want to compare books, or read two at once.) Finally, when you do a
806search the words you search for are highlighted. Click on <i>no
807highlighting</i> to remove highlighting.
808
809<p>
810<table cellspacing="0" cellpadding="2" border="0">
811<tr><td colspan=2><img src="_httpiconbshelf_" border="0"></td><td>Open this bookshelf</td></tr>
812<tr><td><img src="_httpiconopenbook_" border="0"></td><td><img
813src="_httpiconbook_" border="0"></td><td>Open/close this book</td></tr>
814<tr><td colspan=2><img src="_httpiconitext_" border="0"></td><td>View this section of the text</td></tr>
815<tr><td><img src="_document:httpiconealltof_" border="0"></td><td><img
816src="_document:httpiconetsecof_" border="0"></td><td>Display all text, or not</td></tr>
817<tr><td><img src="_document:httpiconeexpcof_" border="0"></td><td><img
818src="_document:httpiconeconcof_" border="0"></td><td>Expand table of contents, or not</td></tr>
819<tr><td colspan=2><img src="_document:httpiconedtchof_" border="0"></td><td>Open this page in a new window</td></tr>
820<tr><td><img src="_document:httpiconehlof_" border="0"></td><td><img
821src="_document:httpiconenhlof_" border="0"></td><td>Highlight search terms, or not</td></tr>
822<tr><td colspan=2><img src="_httpiconmore_" border="0"></td><td>Click the arrow to go to the next section ...</td></tr>
823<tr><td colspan=2><img src="_httpiconless_" border="0"></td><td>... or back to the previous section</td></tr>
824</table>
825}
826
827_bibtexthelpreadingdocs_ {
828<p>_iconblankbar_
829<a name=reading-docs>
830<h2>_textreadingdocs_</h2>
831
832<p>Some bibliography items contain more information, such as an abstract.
833You can tell from the query response page if this is the case because they
834are shown with the _icontext_ icon instead of the _iconblanktext_ icon.
835
836<p>Clicking on the _icontext_ icon will give you more information about the
837bibliography item.
838
839<p> Below the bibliography item are two buttons. Click on <i>detach</i> to
840make a new browser window for this book. (This is useful if you want to compare
841bibliography items.) Finally, when you do a search the words you search for are
842highlighted. Click on <i>no highlighting</i> to remove the highlighting.
843
844<p>
845<table cellspacing="0" cellpadding="2" border="0">
846<tr><td colspan=2><img src="_document:httpiconedtchof_" border="0"></td><td>Open this page in a new window</td></tr>
847<tr><td><img src="_document:httpiconehlof_" border="0"></td><td><img
848src="_document:httpiconenhlof_" border="0"></td><td>Highlight search terms, or not</td></tr>
849</table>
850}
851
852_texthelpsearching_ {
853<h2>How to search for particular words</h2>
854<p>
855  From the search page, you make a query in these simple steps:<p>
856 
857  <ol><li>Specify what documents you want to search
858      <li>Say whether you want to search for all or just some of the words
859      <li>Type in the words you want to search for
860      <li>Click the <i>Begin Search</i> button
861  </ol>
862
863<p>When you make a query, the titles of twenty matching documents will be shown.
864There is a button at the end to take you on to the next twenty documents.  From
865there you will find buttons to take you on to the third twenty or back to the
866first twenty, and so on.  Click the title of any document, or the little button
867beside it, to see it.
868
869<p>A maximum of 100 is imposed on the number of
870  documents returned.  You can change this number by clicking the
871  <i>preferences</i> button at the top of the page.<p>
872
873<p>_iconblankbar_
874<a name=query-terms>
875<h3>Search terms</h3>
876
877<p>Whatever you type into the query box is interpreted as a list of words
878called "search terms."  Each term contains nothing but alphabetic characters
879and digits.  Terms are separated by white space.  If any other characters such
880as punctuation appear, they serve to separate terms just as though they were
881spaces.  And then they are ignored.  You can't search for words that include
882punctuation.
883
884<p>For example, the query<p>
885    <ul><kbd>Agro-forestry in the Pacific Islands: Systems for Sustainability (1993)</kbd></ul>
886      <p>will be treated the same as<p>
887      <ul><kbd>Agro forestry in the Pacific Islands  Systems for Sustainability  1993 </kbd></ul><p>
888
889<p>_iconblankbar_
890<a name=query-type>
891<h3>Query type</h3>
892
893<p>There are two different kinds of query.
894
895<ul>
896  <li>Queries for <b>all</b> of the words.  These look for documents that
897      contain all the words you have specified.  Documents that satisfy the
898      query are displayed, in alphabetical order.<p>
899
900  <li>Queries for <b>some</b> of the words.  Just list some terms that are
901      likely to appear in the documents you are looking for.  Documents are
902      displayed in order of how closely they match the query.  When determining
903
904      the degree of match,
905
906      <p><ul>
907        <li> the more search terms a document contains, the closer it matches;
908        <li> rare terms are more important than common ones;
909        <li> short documents match better than long ones.
910      </ul>
911</ul>
912
913<p>Use as many search terms as you like--a whole sentence, or even a
914whole paragraph.  If you specify only
915one term, documents will be ordered by its frequency of occurrence.<p>
916_texthelpscope_
917}
918
919_textchangeprefs_ {Changing your preferences}
920
921_texthelppreferences_ {<h2>_textchangeprefs_</h2>
922
923<p>When you click the <i>preferences</i> button at the top of the page you will
924be able to change some features of the interface to suit your own requirements.
925
926<p>_iconblankbar_
927<a name=col-prefs>
928<h3 align=left>Collection preferences</h3>
929
930Some collections comprise several subcollections, which can be searched
931independently or together, as one unit.  If so, you can select which
932subcollections to include in your searches on the Preferences page.
933
934<p>_iconblankbar_
935<a name=pres-prefs>
936<h3 align=left>Presentation preferences</h3>
937
938Depending on the particular collection, there may be several options you can
939set that control the presentation.
940
941Collections of Web pages allow you to suppress the Greenstone navigation bar at
942the top of each document page, so that once you have done a search you land at
943the exact Web page that matches without any Greenstone header.  To do another
944search you will have to use your browser's "back" button.  These collections
945also allow you to suppress Greenstone's warning message when you click a link
946that takes you out of the digital library collection and on to the Web itself.
947And in some Web collections you can control whether the links on the "Search
948Results" page take you straight to the actual URL in question, rather than to
949the digital library's copy of the page.
950
951Collections that are capable of being presented in different languages allow
952you to specify the interface language.  If the language is Chinese, you can
953also specify which of the standard Chinese encodings your browser uses.
954
955Finally, all collections allow you to switch to a textual interface format
956rather than the standard graphical one.  This is particularly useful for
957visually impaired users who use large screen fonts or speech synthesizers for
958output.
959
960<p>_iconblankbar_
961<a name=search-prefs>
962<h3 align=left>Search preferences</h3>
963Two pairs of buttons control the case sensitivity and stemming of the searches
964that you make. The first set of buttons controls whether upper and lower case
965must match (case sensitivity).  The second set controls whether to ignore word
966endings or not (stemming).
967
968<p>For example, if the buttons <i>ignore case differences</i> and
969<i>ignore word endings</i> are selected, the query<p>
970    <ul><kbd>African building</kbd></ul>
971      <p>will be treated the same as<p>
972      <ul><kbd>africa builds</kbd></ul><p>
973      because the uppercase letter in "African" will be transformed to
974      lowercase, and  the suffixes "n" and "ing" will be removed from
975      "African" and "building" respectively (also, "s" would be removed from
976      "builds").
977
978<p>You can also switch to an "advanced" query mode which allows you to
979combine terms using AND (&), OR (|), and NOT (!). This allows you to
980specify more precise queries.
981
982<p>Finally, you can control the number of hits returned, and the number
983presented on each screenful.
984
985}
986
987_texttanumbrowseoptions_ {There are _numbrowseoptions_ ways to find information in this collection:}
988
989_textsimplehelpheading_ {How to find information}
990
991_texthelpscope_ {
992<p>_iconblankbar_
993<a name=scope-of-queries>
994<h3 align=left>Scope of queries</h3>
995
996<p>
997In most collections you can choose different indexes to search. For example, there might
998be author or title indexes. Or there might be chapter or paragraph indexes. Generally,
999the full matching document is returned regardless of which index you search.
1000<p>If documents are books, they will be opened at the appropriate place.
1001}
1002
1003
1004#------------------------------------------------------------
1005# icons
1006#------------------------------------------------------------
Note: See TracBrowser for help on using the browser.