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

Last change on this file since 1095 was 1095, checked in by gwp, 24 years ago

The DL meeting on April 13, 2000 approved (or rather, did not object to) a broad set of changes to the NZDL.org web pages. These changes include a page for projects, upadtes on the people involved, rearranging the home page, and the removal of th technology pages.

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