source: trunk/greenorg/macros/english.dm@ 6151

Last change on this file since 6151 was 6113, checked in by mdewsnip, 21 years ago

Added Armenian language maintainer.

  • Property svn:keywords set to Author Date Id Revision
File size: 57.6 KB
Line 
1package Global
2
3_t17_ {
4The downloads available from the <a href="_httppagex_(download)">download</a> page
5are hosted by <a href="http://sourceforge.net">Sourceforge</a>.
6}
7
8
9#######################################################################
10
11package home
12
13_t1_ {About Greenstone}
14
15_t2_ {
16Greenstone is a suite of software for building and distributing digital
17library collections. It provides a new way of organizing information and
18publishing it on the Internet or on CD-ROM. Greenstone is produced by the
19<b>New Zealand Digital Library Project</b> at the <b>University of
20Waikato</b>, and developed and distributed in cooperation with
21<b>UNESCO</b> and the <b>Human Info NGO</b>. It is <b>open-source,
22multilingual</b> software, issued under the terms of the GNU General Public
23License.
24}
25
26_t3_ {
27UNESCO is running regional training workshops on the use of Greenstone.<br>
28<a href="_httppagex_(report)">Here</a> is a report of one held in
29Bangalore, India, in August 2003. Another will be conducted in Dakar,
30Senegal in September 2003, and a third in Suva, Fiji, in November 2003.
31}
32
33_t4_ {
34Greenstone v2.40a has now been released! Download it from <a
35href="http://sourceforge.net/projects/greenstone/">here</a>. This release
36is the same as Greenstone v2.40, except it features better integration of
37the Librarian Interface tool.
38}
39
40_t5_ {
41One of the trickier parts of using Greenstone is coming up with a
42configuration file for your collection. To help learn how to do it, <a
43href="http://www.cs.waikato.ac.nz/~ihw/greenstone/inside.htm">here</a> is a
44new document that presents, and explains, the configuration files for a few
45actual Greenstone collections, and also gives an example of how
46Greenstone's appearance can be customized.
47}
48
49_t6_ {
50The complete Greenstone interface, and all documentation, is available in
51<b>English</b>, <b>French</b>, <b>Spanish</b>, <b>Russian</b> and
52<b>Kazakh</b>. Greenstone also has interfaces in many <a
53href="_httppagex_(intn)">other languages</a>. We are looking for <a
54href="_httppagex_(intn)#maintainers">volunteers</a> to add new language
55interfaces and help maintain existing ones.
56}
57
58_t7_ {
59The aim of the software is to empower users, particularly in universities,
60libraries, and other public service institutions, to build their own
61digital libraries. Digital libraries are radically reforming how
62information is disseminated and acquired in UNESCO's partner communities
63and institutions in the fields of education, science and culture around the
64world, and particularly in developing countries. We hope that this
65software will encourage the effective deployment of digital libraries to
66share information and place it in the public domain. Further information
67can be found in the book <a href="http://www.nzdl.org/howto">How to build a
68digital library</a>, authored by two of the the group's project members.
69}
70
71_t8_ {
72The collect.cfg files for many of the collections at <a
73href="http://www.nzdl.org">www.nzdl.org</a> have been made available <a
74href="_httppagex_(colcfg)">here</a>.
75}
76
77_t9_ {
78This software is developed and distributed as an international cooperative
79effort established in August 2000 among three parties.
80}
81
82_t10_ {
83New Zealand Digital Library Project at the University of Waikato
84}
85
86_t11_ {
87Greenstone software grew out of this project, and this initiative has been
88endorsed by the Communication Sub-Commission of the New Zealand National
89Commission for UNESCO as part of New Zealand's contribution to UNESCO's
90programme.
91}
92
93_t12_ {
94United Nations Educational, Scientific and Cultural Organization
95}
96
97_t13_ {
98The dissemination of educational, scientific and cultural information
99throughout the world, and particularly its availability in developing
100countries, is central to UNESCO's goals as pursued within its
101intergovernmental Information for All Programme, and appropriate,
102accessible information and communication technology is seen as an important
103tool in this context.
104}
105
106_t14_ {
107The Human Info NGO, based in Antwerp, Belgium
108}
109
110_t15_ {
111This project works with UN agencies and other NGOs, and has established a
112worldwide reputation for digitizing documentation of interest to human
113development and making it widely available, free of charge to developing
114nations and on a cost-recovery basis to others.
115}
116
117_t16_ {
118If you download Greenstone and install it with standard demonstration
119collections, or if you install it from the Greenstone CD-ROM, it will look
120exactly like <a
121href="http://www.nzdl.org/cgi-bin/democols/library">this</a>.
122}
123
124
125#######################################################################
126
127package download
128
129_t18_ {Download Greenstone}
130
131_t19_ {
132Greenstone is open-source software, distributed under the terms of the <a
133href="http://www.gnu.org/copyleft/gpl.html">GNU General Public
134License</a>. It runs on Windows and Unix, and both source code and binaries
135are available for download. It is fully documented in English, French,
136Spanish and Russian.
137}
138
139_t20_ {
140Select the Greenstone distribution you require from the list below. Each
141distribution provides a complete interface in English, French, Spanish and
142Russian.
143}
144
145_t21_ {
146Each distribution also includes the &quot;Greenstone Librarian
147Interface&quot;, a graphical tool for building digital libraries. It gives
148you access to Greenstone's functionality from an easy-to-use 'point and
149click' interface. To use this tool you will need a suitable Java Run-time
150Environment, which you can download from <a
151href="http://java.sun.com/j2se/1.4.1/download.html">here</a> (choose the
152JRE, not the SDK).
153}
154
155_t22_ {Windows distribution}
156
157_t23_ {
158This is the distribution you want if you're going to run Greenstone under
159any 32 bit Windows environment (that is, Windows 95/98/Me/NT/2000/XP etc.).
160}
161
162_t24_ {
163Note that Greenstone will also run on 16 bit Windows (that is, Windows
1643.1/3.11). The installer program used by this distribution will not work on
165these versions of Windows however. Please <a
166href="_httppagex_(support)">contact us</a> if you need a version of
167Greenstone for 16 bit Windows.
168}
169
170_t25_ {
171Using this distribution you may either install the &quot;local
172library&quot;, the &quot;web library&quot;, or install and compile the
173source code (click <a href="_httppagex_(faq-installing)#1">here</a> for a
174description of the differences between the &quot;local library&quot; and
175the &quot;web library&quot;). You will be asked which form of Greenstone
176you want during the installation process.
177}
178
179_t26_ {
180This distribution includes everything you need to run Greenstone (including
181a pre-built demonstration collection) and to build new Greenstone
182collections. Some functionality is not included however, mostly in an
183attempt to keep the distribution as small as possible. See <a
184href="#packages">below</a> for details on how to get this missing
185functionality.
186}
187
188_t27_ {
189This distribution uses a standard Windows installer program, simply
190download the file and double-click it to install (see the <a
191href="_httpguide_(Install,en)">Installer's Guide</a> for more detailed
192installation instructions).
193}
194
195_t28_ {Unix distribution}
196
197_t29_ {
198This is the recommended distribution if you're installing Greenstone on any
199form of Unix.
200}
201
202_t30_ {
203This distribution comes with statically linked linux binaries. However, it
204also contains the Greenstone source code for compiling on other forms of
205Unix (or on linux if you prefer not to use the provided binaries).
206}
207
208_t31_ {
209This distribution includes everything you need to run Greenstone (including
210a pre-built demonstration collection) and to build new Greenstone
211collections. Some functionality is not included however, mostly in an
212attempt to keep the distribution as small as possible. See <a
213href="#packages">below</a> for details on how to get this missing
214functionality.
215}
216
217_t32_ {
218To install this distribution, extract the gzipped tar archive and run the
219<i>Install.sh</i> shell script from within the <i>gsdl-X.XX-unix/Unix</i>
220directory (see the <a href="_httpguide_(Install,en)">Installer's Guide</a> for
221more detailed installation instructions).
222}
223
224_t33_ {Mac OS X distribution}
225
226_t34_ {
227This distribution contains dynamically linked binaries for Mac OS X running
228on PowerPC platforms.
229}
230
231_t35_ {
232This distribution has been tested on Mac OS X 10.2.6. It includes the
233pre-built binaries and also includes the demonstration collection,
234unbuilt. This is the first distribution for the Mac that includes the
235Greenstone Librarian Interface for building collections.
236}
237
238_t36_ {Source only distribution}
239
240_t37_ {
241This distribution contains the Greenstone source code along with the same
242demonstration collection as the distributions above (although the
243collection is not pre-built in this distribution).
244}
245
246_t38_ {
247This distribution does not have an automated installation proceedure
248(running <i>Install.sh</i> will not work). Unless you're sure you know what
249you're doing you probably want one of the distributions above, both of
250which also contain the Greenstone source. Note that you can obtain an
251up-to-date version of the Greenstone source code at any time by using <a
252href="_httppagex_(cvs)">cvs</a>.
253}
254
255_t39_ {
256The following extra packages may be downloaded and installed along with an
257existing Greenstone installation to add functionality that was left out of
258the distributions above.
259}
260
261_t40_ {Export to CD-ROM package}
262
263_t41_ {
264This package enables the &quot;export to CD-ROM&quot; function from within
265Greenstone's Collector.
266}
267
268_t42_ {
269To install, simply download the file (it will work on both Windows and Unix
270and any version of Greenstone above 2.34) and extract the zip archive into
271the gsdl\\bin\\windows directory of your existing Greenstone installation.
272}
273
274_t43_ {
275The following utilities have been developed to be used along with
276Greenstone.
277}
278
279_t44_ {The Organizer}
280
281_t45_ {
282The Organizer is a Windows application useful for automatically generating
283many of the configuration files (metadata.xml, sub.txt etc.) required by
284complex Greenstone collections.
285}
286
287_t46_ {
288To install, simply download and double-click the self-extracting executable
289file.
290}
291
292
293#######################################################################
294
295package examples
296
297_t47_ {Examples of Greenstone in Action}
298
299_t48_ {New Zealand Digital Library Project}
300
301_t49_ {
302A demonstration site set up by the developers of Greenstone, the New
303Zealand Digital Library Project. This site contains many collections,
304ranging from humanitarian information to computer science technical reports
305to demonstration collections of Chinese and Arabic documents.
306}
307
308_t50_ {Russian Greenstone Library}
309
310_t51_ {
311A Greenstone site containing several collections in the Russian
312language. This site was set up by a regional government department in the
313Mari El Republic of the Russian Federation.
314}
315
316_t52_ {Project Gutenberg}
317
318_t53_ {
319An on-going project to produce and distribute free electronic editions of
320literature, Project Gutenberg now contains more than 3,700 titles from
321Shakespeare to Dickens to the Bronte sisters. This site, maintained by
322Ibiblio, one of the original Gutenberg mirror sites, uses Greenstone to
323make the entire Gutenberg collection available in a fully searchable form.
324}
325
326_t54_ {University of Applied Sciences, Stuttgart}
327
328_t55_ {
329Hochschule der Medien - an &quot;Information and Media&quot; digital
330library created by the University of Applied Sciences, Stuttgart, Germany.
331}
332
333_t56_ {Gresham College Archive}
334
335_t57_ {
336A digital library created at Gresham College, London, England.
337}
338
339_t58_ {Center for the Study of Digital Libraries}
340
341_t59_ {
342Texas A&M University - A digital libraries research site containing
343prototypical Greenstone collections with an emphasis on Digital Floras.
344}
345
346_t60_ {Peking University Digital Library}
347
348_t61_ {
349Two experimental collections created at Peking University.
350}
351
352_t62_ {Music Information Retrieval Research}
353
354_t63_ {
355Virtual home of music information retrieval research.
356}
357
358_t64_ {Photograph Album}
359
360_t65_ {
361A collection of photographs taken by <a
362href="mailto:[email protected]">Gordon Paynter</a>.
363}
364
365_t66_ {Washington Research Library Consortium Special Collections}
366
367_t67_ {
368Digital material from the special collections of the eight universities of
369WRLC in Washington, D.C., USA.
370}
371
372_t68_ {Archives of Indian Labour}
373
374_t69_ {
375A collaborative project between the V.V. Giri National Labour Institute and
376the Association of Indian Labour Historians. The Archives of Indian Labour
377are dedicated to preserving and making accessible the fast depleting
378documents on the Indian working class.
379}
380
381_t70_ {NCSI Demonstration Collections}
382
383_t71_ {
384Demonstration collections created by students and staff at the National
385Centre for Science Information, Indian Institute of Science, Bangalore,
386India. Many of these collections include content in Kannada and Hindi.
387}
388
389_t72_ {New York Botanical Garden}
390
391_t73_ {
392The rare book digitization project of the LuEsther T. Mertz Library of the
393New York Botanical Garden.
394}
395
396_t74_ {Lehigh University Digital Bridges Collection}
397
398_t75_ {
399A collection containing thirty books about bridges, all of which were
400published between 1811 and 1899. The collection was created at Lehigh
401University, Pennsylvania and features a heavily customized user interface.
402}
403
404_t76_ {Chopin Early Editions}
405
406_t77_ {
407A collection of digital images of early printed editions of musical
408compositions by Fr&eacute;d&eacute;ric Chopin. This collection was created
409by the University of Chicago Library and, once completed, will include its
410entire collection of over 400 Chopin early editions. The greenstone
411collection configuration file for this collection has also been made
412available and can be downloaded <a
413href="http://chopin.lib.uchicago.edu/gsdl/collect/chopin/etc/collect.cfg">here</a>.
414}
415
416_t78_ {Slavonski Brod Public Library}
417
418_t79_ {
419The pilot project of digitization of local studies collection in Slavonski
420Brod Public Library, Croatia.
421}
422
423_ex1t_ {Mirabilia Vicomercati}
424
425_ex1d_ {
426Mirabilia Vicomercati is an on-going project managed by Vimercate Public Library (Milan, Italy), aimed at the digitization of local history primary sources. Several collections will be provided - photographs, postcards, maps, text, reference, multimedia - in order to make accessible, promote and preserve the historical memory of Vimercate and its territory.
427}
428
429_ex2t_ {Illinois Wesleyan University Argus Digital Collection}
430
431_ex2d_ {
432<table border="0" cellpadding="0" cellspacing="0" class="ex_d">
433<td>
434Illinois Wesleyan University's newspaper The Argus has been published under student supervision continuously since 1894. This digital collection is part of an on-going project to preserve and provide access to Argus volumes published from 1894-2000.
435</td>
436<td><img src="../images/new.gif"/></td>
437</table>
438}
439
440_ex3t_ {Human Rights in Argentina}
441
442_ex3d_ {
443<table border="0" cellpadding="0" cellspacing="0" class="ex_d">
444<td>
445This site contains documents, photos and books covering files of children kidnapped during the 1976-1983 dictatorship, leglislation on identity, jurisprudence-related information, and many other items. It was created by the Secretary of Human Rights of Argentina under the Comisi&oacute;n Nacional por el Derecho a la Identidad (CONADI), which is a National Commission that fights for the right that a person has for knowing his or her identity -- particularly when their parents have disappeared.
446</td>
447<td><img src="../images/new.gif"/></td>
448</table>
449}
450
451_ex4t_ {Auburn University Libraries Digital Library}
452
453_ex4d_ {
454<table border="0" cellpadding="0" cellspacing="0" class="ex_d">
455<td>
456This site contains two Greenstone collections. <a href="http://diglib.auburn.edu/gsdl/cgi-bin/library?site=localhost&a=p&p=about&c=postcard">Alabama Postcards</a> has over 300 postcards depicting buildings, natural settings, events and other scenes in various Alabama cities and towns in the early 20th century. These images are categorized by place as well as by title. <a href="http://diglib.auburn.edu/gsdl/cgi-bin/library?site=localhost&a=p&p=about&c=alauths">Alabama Authors</a> gives information about 20th Century Alabama Authors which is maintained and updated by the Alabama Library Association. This collection began life as a printed document created in WordPerfect 5.2 and has been through several iterations before becoming fully searchable under Greenstone.
457</td>
458<td><img src="../images/new.gif"/></td>
459</table>
460}
461
462
463#######################################################################
464
465package docs
466
467_t80_ {Greenstone Documentation}
468
469_t81_ {Manuals}
470
471_t82_ {
472The following Greenstone manuals are available in PDF format for
473download. They're available in English, Spanish, French, Russian and
474Kazakh.
475}
476
477_installersguide_ {Installer's Guide}
478
479_t83_ {english}
480
481_t84_ {spanish}
482
483_t85_ {french}
484
485_t86_ {russian}
486
487_t87_ {kazakh}
488
489_t88_ {
490Describes in detail the Greenstone installation process. Note that the
491<i>Installer's Guide</i> assumes that Greenstone is being installed from a
492CD-ROM distribution. The instructions should be adapted in the obvious way
493when installing from a web download.
494}
495
496_usersguide_ {User's Guide}
497
498_t90_ {
499General details on using Greenstone collections, the Collector web
500interface for building new collections, and Greenstone's administrative
501facilities.
502}
503
504_t92_ {sorry, no kazakh}
505
506_developersguide_ {Developer's Guide}
507
508_t94_ {
509A more detailed description of Greenstone's collection building process,
510including building collections from the command line or DOS prompt. Also a
511description of the structure of the Greenstone runtime system.
512}
513
514_t95_ {From Paper to Collection}
515
516_t96_ {
517A document describing the entire process of creating a digital library
518collection from paper documents. This includes the scanning and OCR process
519and the use of the &quot;Organizer&quot;.
520}
521
522_t97_ {Inside Greenstone Collections}
523
524_t98_ {english(HTML)}
525
526_t99_ {english(PDF)}
527
528_t100_ {
529One of the trickier parts of using Greenstone is coming up with a
530configuration file for your collection. To help learn how to do it, this
531document presents, and explains, the configuration files for a few actual
532Greenstone collections, and also gives an example of how Greenstone's
533appearance can be customized. (Note, this document is intended to be used
534with Greenstone version 2.40 and higher.)
535}
536
537_t101_ {MG/MG++}
538
539_t102_ {
540For information about the underlying indexing and retrieval systems used by
541Greenstone, please go <a href="http://www.nzdl.org/html/mg.html">here</a>
542for MG, or download the <a href="_httpdocsdir_/mgpp_user.pdf">MGPP user
543guide</a>.
544}
545
546_t103_ {Mailing Lists}
547
548_t104_ {
549There are two mailing lists intended primarily for discussions about the
550Greenstone digital library software. Active users of Greenstone should
551consider joining one or both of these lists and contributing to the
552discussions.
553}
554
555_t105_ {Greenstone User's List}
556
557_t106_ {
558This list is for general Greenstone discussions. To send a message to this
559list, address it to <a
560href="mailto:[email protected]">[email protected]</a>. There
561is an archive of previous messages to this list at <a
562href="http://www.nzdl.org/cgi-bin/library?a=p&p=about&c=gsarch">www.nzdl.org</a>.
563}
564
565_t107_ {Greenstone Developer's List}
566
567_t108_ {
568This list is for more technical discussions by people developing or
569modifying Greenstone. To send a message to this list, address it to <a
570href="mailto:[email protected]">[email protected]</a>.
571}
572
573_t369_ {User Supplied Documentation}
574
575_t370_ {Customizing the Greenstone User Interface}
576
577_t371_ {
578An illustrated guide to customizing the Greenstone user interface. Written
579by Allison Zhang of the Washington Research Library Consortium
580}
581
582#######################################################################
583
584package support
585
586_t109_ {Greenstone Support}
587
588_t110_ {
589Before asking for help, please read the <a
590href="_httppagex_(faq)">frequently asked questions</a> list.
591}
592
593_t111_ {
594For Greenstone technical support please consider joining one of the <a
595href="_httppagex_(docs)#mailing-lists">Greenstone mailing lists</a>.
596}
597
598_t112_ {
599Alternatively, fill in the form below and click the &quot;submit&quot;
600button to submit a query to the Greenstone support staff. Please fill in
601the form as fully as possible to aid our staff in giving the best possible
602service.
603}
604
605_t113_ {PERSONAL INFORMATION}
606
607_t114_ {Name}
608
609_t115_ {E-mail address}
610
611_t116_ {SYSTEM INFORMATION}
612
613_t117_ {Operating System}
614
615_t118_ {Windows 95}
616
617_t119_ {Windows 98}
618
619_t120_ {Windows ME}
620
621_t121_ {Windows NT 4}
622
623_t122_ {Windows 2000}
624
625_t123_ {Windows XP}
626
627_t124_ {Windows 3.11}
628
629_t125_ {Windows 3.1}
630
631_t126_ {Linux}
632
633_t127_ {Other (please specify below)}
634
635_t128_ {Other OS}
636
637_t129_ {CPU (type and speed)}
638
639_t130_ {Memory (RAM) in MB}
640
641_t131_ {Web browser}
642
643_t132_ {Netscape 4}
644
645_t133_ {Netscape 4.5}
646
647_t134_ {Netscape 6}
648
649_t135_ {Mozilla}
650
651_t136_ {Internet Explorer 4}
652
653_t137_ {Internet Explorer 5}
654
655_t138_ {Internet Explorer 6}
656
657_t139_ {Other web browser}
658
659_t140_ {Was your browser provided by your internet service provider?}
660
661_t141_ {no}
662
663_t142_ {yes}
664
665_t143_ {don't know}
666
667_t144_ {Is your browser configured to use a proxy?}
668
669_t145_ {Web server}
670
671_t146_ {not applicable}
672
673_t147_ {Apache 1.3}
674
675_t148_ {Apache 2.0}
676
677_t149_ {Microsoft IIS 4.0}
678
679_t150_ {Microsoft IIS 5.0}
680
681_t151_ {Microsoft PWS}
682
683_t152_ {Other server}
684
685_t153_ {GREENSTONE INFORMATION}
686
687_t154_ {Version}
688
689_t155_ {CD-ROM distribution}
690
691_t156_ {Installation type}
692
693_t157_ {local library}
694
695_t158_ {web library}
696
697_t159_ {PROBLEM DESCRIPTION}
698
699_t160_ {Problem type}
700
701_t161_ {question}
702
703_t162_ {problem/error}
704
705_t163_ {suggested enhancement}
706
707_t164_ {other}
708
709_t165_ {Can the problem be reproduced at will?}
710
711_t166_ {Short description}
712
713_t167_ {Long description}
714
715_t168_ {
716(If you are reporting a problem, please go into as much detail as possible.
717Make sure you describe all steps leading up to the problem and include any
718relevant URLs.)
719}
720
721
722#######################################################################
723
724package faq
725
726_greenstonefaq_ {Greenstone FAQ}
727
728_headinggeneral_ {General Information}
729
730_t171_ {What is Greenstone?}
731
732_t172_ {How is Greenstone licensed?}
733
734_t173_ {What platforms will Greenstone run on?}
735
736_t174_ {Are there any mailing lists concerned with Greenstone?}
737
738_t175_ {Are the mailing lists archived anywhere?}
739
740_t176_ {How do I contribute to Greenstone?}
741
742_headingobtaining_ {Obtaining Greenstone}
743
744_t178_ {Where do I get Greenstone from?}
745
746_t179_ {Are there binary distributions of Greenstone available?}
747
748_t180_ {Is Greenstone available on CD-ROM?}
749
750_t181_ {Is the Greenstone source code available via CVS?}
751
752_headinginstalling_ {Installing Greenstone}
753
754_t183_ {How do I compile Greenstone from a source or CVS distribution?}
755
756_t184_ {What is the difference between Greenstone's <i>local library</i> and <i>web library</i>?}
757
758_headingrunning_ {Running Greenstone}
759
760_t186_ {OK, I've installed Greenstone. Now how do I make it go?}
761
762_t187_ {What web browser do I need to view Greenstone collections?}
763
764_t188_ {When I start the Windows local library there are two buttons in the
765dialog box, &quot;Enter Library&quot; and &quot;Restricted
766Version&quot;. They both seem to do the same thing, what's the difference?}
767
768_t189_ {So when should I use the &quot;Restricted Version&quot; of the local library?}
769
770_t190_ {When I start the Windows local library my computer asks me to dial
771up my Internet Service Provider. Do I really need to be online to run
772Greenstone?}
773
774_t191_ {I'm trying to use the Windows local library. My web browser is
775starting up as expected but the Greenstone home page never gets loaded or gives an error message. What's wrong?}
776
777_t192_ {Where can I get more Greenstone collections?}
778
779_t193_ {When I attempt to access certain parts of Greenstone I'm asked for
780a username and password. What do I enter?}
781
782_t194_ {When I use the <i>large query box</i> function I occassionally get
783a <i>Not Found</i> error.}
784
785_headingbuilding_ {Building Greenstone Collections}
786
787_t196_ {What is &quot;the Collector&quot;?}
788
789_t197_ {How do I build a collection from the command line or DOS prompt?}
790
791_t198_ {I built a new Greenstone collection on my Windows
792machine. Everything appeared to work fine while building, however when I
793tried to view the collection some of the documents contained no
794text. Sometimes Greenstone appeared to crash completely. What have I done
795wrong?}
796
797_t199_ {Why won't the Collector's &quot;export to CD-ROM&quot; function work?}
798
799_t200_ {I'm trying to use the Collector on Windows 2000 but it's running
800extremely slowly. Is this normal?}
801
802_t201_ {What is &quot;the Organizer&quot;?}
803
804_t202_ {Where do I get the Organizer?}
805
806_t203_ {I'm attempting to build a collection with the collector but it
807keeps failing with an error. What am I doing wrong?}
808
809_t204_ {Where can I find some example collect.cfg configuration files?}
810
811_t205_ {How can I build my collection using MGPP?}
812
813_tfaqbuild11title_ {I've added a new type of classification to my collection. How do I create and add the navigation bar images?}
814
815_headingplugins_ {More About Plugins}
816
817_tfaqplugins1title_ {What metadata is available for each plugin?}
818
819_tfaqplugins2title_ {I'm having problems with my PDF files! What's wrong?}
820
821_t207_ {FAQ Main Page}
822
823_t372_ {Show entire FAQ on a single page}
824
825_t373_ {Show FAQ on multiple pages}
826
827#######################################################################
828
829package faqgen
830
831_t208_ {
832Greenstone is a suite of software which has the ability to serve digital
833library collections and build new collections. It provides a new way of
834organizing information and publishing it on the Internet or on CD-ROM.
835}
836
837_t209_ {
838Greenstone is open-source software, distributed under the terms of the <a
839href="http://www.gnu.org/copyleft/gpl.html">GNU General Public License</a>.
840}
841
842_t210_ {
843Greenstone has been tested on Windows 3.1/3.11/95/98/Me/NT/2000, most
844distributions of GNU/Linux, Darwin (Mac OS X), Solaris, and FreeBSD. It
845should in fact work on any Windows or Unix system. If you use a system
846other than those mentioned and you find Greenstone doesn't run, please <a
847href="_httppagex_(support)">contact</a> us.
848<p>Please note that the downloadable Windows distribution of Greenstone
849comes with an installer that will not work on 16 bit Windows. If you need
850to use Greenstone on Windows 3.1/3.11 please <a
851href="_httppagex_(support)">contact</a> us.</p>
852}
853
854_t211_ {
855There are two Greenstone mailing lists. You can subscribe to them from the
856<a href="_httppagex_(docs)#mailing-lists">documentation</a> page.
857}
858
859_t212_ {
860The most popular mailing list ([email protected]) is
861archived as a Greenstone collection at <a
862href="http://www.nzdl.org/cgi-bin/library?a=p&p=about&c=gsarch">www.nzdl.org</a>.
863Note that this collection is updated only sporadically so may not always be
864completely up to date.
865}
866
867_t213_ {
868We welcome contributions or improvements to the Greenstone software!
869<br />Before you send in any contribution, you first need to make sure that
870your changes are compatible with the latest snapshop of the Greenstone
871source code. To get the latest code you'll need to use CVS (see <a
872href="_httppagex_(cvs)">here</a> for details).
873<br />You should then send the modified files, along with details of the
874modifications you've made, to <a
875href="mailto:[email protected]">[email protected]</a>.
876
877<p>Before beginning work, you should announce what you're doing on the <a
878href="mailto:[email protected]">greenstone developer's list</a>
879to tell us what you plan to do and get some feedback.</p>
880}
881
882
883#######################################################################
884
885package faqob
886
887_t215_ {
888From the greenstone.org <a href="_httppagex_(download)">download</a> page.
889}
890
891_t216_ {
892Yes. At present there are binary distributions for 32 bit Windows, PowerPC
893Mac OS X, and i386 linux. They can be downloaded from the <a
894href="_httppagex_(download)">download</a> page.
895}
896
897_t217_ {
898While some version 2.37 and 2.38 CD-ROMs have been produced they're not
899currently being made widely available. You are encouraged to download the
900latest release of Greenstone from the <a
901href="_httppagex_(download)">download</a> page. If your internet connection
902is such that downloading Greenstone isn't possible please <a
903href="_httppagex_(support)">contact</a> us and we may be able to arrange
904for a CD-ROM to be sent out.
905}
906
907_t218_ {
908Yes, see our <a href="_httppagex_(cvs)">CVS page</a> for details.
909}
910
911
912#######################################################################
913
914package faqinst
915
916_t220_ {
917See our <a href="_httpdocsdir_/compiling.html">compiling page</a>.
918}
919
920_t221_ {
921Firstly, the <i>local library</i> is only available if you're running
922Greenstone under Windows. It's not yet available on Unix.
923
924<p>The major difference between the two is that the <i>local library</i>
925contains it's own built-in webserver. The <i>web library</i> however,
926requires an external webserver like Apache or Microsoft IIS. This makes the
927<i>local library</i> much easier to install and configure than the web
928library.</p>
929
930<p>For this reason, it's recommended that Windows users install the
931<i>local library</i> unless they're sure that they need the <i>web
932library</i>. Even if you think you might need the <i>web library</i>, try
933installing the <i>local library</i> first. You can always uninstall it
934later and install the <i>web library</i> if you then decide you need
935it.</p>
936
937<p>A situation where the <i>web library</i> may be preferable is if you
938plan to serve your Greenstone collections as a full-time service on the
939web. In this case you'll probably want the added stability that running the
940<i>web library</i> in conjunction with an external webserver can
941provide.</p>
942
943<p>Please note that the <i>local library</i> is quite capable of serving
944Greenstone collections over a local area network or the web (despite its
945rather misleading name).</p>
946}
947
948
949#######################################################################
950
951package faqrun
952
953_t223_ {
954If you're using the Windows <i>local library</i> you should be able to
955simply select &quot;Greenstone Digital Library&quot; from within the
956programs in your <i>start</i> menu.
957
958<p>If you're using the <i>web library</i> things are a little less obvious
959however. First make sure your webserver is configured correctly and is
960running (see the <a href="_httppagex_(docs)">Greenstone Installer's
961Guide</a> and your webserver's documentation for details). You can then
962simply open your web browser and point it at the URL of Greenstone's
963library executable. This is dependant on the way you configured Greenstone
964and your webserver. Typically it might be something like
965http://localhost/gsdl/cgi-bin/library.exe.</p>
966}
967
968_t224_ {
969Greenstone relies on a web browser that supports tables, javascript, and in
970some places, frames. Any reasonably modern browser will do. Examples are
971Microsoft Internet Explorer 4, Netscape 4, and Mozilla. Newer releases of
972all these browsers will also work.
973
974<p>If you find that your favourite web browser does not work with
975Greenstone, please <a href="_httppagex_(support)">contact us</a>.</p>
976
977<p>Note that there is an exception to the rule that any modern browser will
978do when running Greenstone. That is when you're using the restricted
979version of the Windows local library when you must use Netscape. See the
980discussion below on the differences between the &quot;Restricted
981Version&quot; and the standard &quot;Enter Library&quot; version of the
982local library for details.</p>
983}
984
985_t225_ {
986The webserver built into the local library uses the networking software
987built into your Windows operating system in order to function. If your
988computer has never been connected to a network this networking software may
989not be installed however. For this reason Greenstone comes with some
990networking software of it's own that it will use if it can't find any
991installed on your computer.
992
993<p>When you click the &quot;Enter Library&quot; button, Greenstone first
994checks to see if your computer has it's own networking software. If it
995does, it starts up using that, if not it starts up using it's own
996networking software.</p>
997
998<p>When you click the &quot;Restricted Version&quot; button, Greenstone
999doesn't bother checking your system for networking software, it just goes
1000ahead and uses it's own.</p>
1001
1002<p>The catch is that there are several limitations with using the
1003Greenstone supplied networking software. The most important limitations are
1004that the local library won't be accessible from the network if run in this
1005way (that is, it really will be &quot;local&quot; to the machine on which
1006it's running) and that it must use a Netscape web browser. Using your
1007computer's built-in networking software is therefore the prefered
1008option.</p>
1009}
1010
1011_t226_ {
1012Since Greenstone will automatically use it's own networking software if it
1013can't find any installed on your computer it should not normally be
1014necessary to run the &quot;Restricted Version&quot; explicitly.
1015
1016<p>Times when it may be necessary are.</p>
1017<ul>
1018<li>If your computer's networking software has been installed incorrectly.</li>
1019<li>If Windows keeps attempting to dial up your internet service provider
1020when you click the &quot;Enter Library&quot; button.</li>
1021</ul>
1022}
1023
1024_t227_ {
1025No you don't need to be online. This is caused by the webserver built into
1026Greenstone's local library sending a message to your computer's networking
1027software to make sure it's functioning correctly. On many Windows systems
1028this causes the familiar dial up dialog box to appear. In most situations
1029you can simply cancel the dialog box and (if required) press your browser's
1030<i>reload</i> button to continue.
1031
1032<p>If this does not solve the problem, try starting the local library by
1033clicking the &quot;Restricted Version&quot; button rather than the
1034&quot;Enter Library&quot; button. See the discussion above on the
1035differences between the standard and restricted versions of the local
1036library for further details.</p>
1037}
1038
1039_t228_ {
1040<ol>
1041<li>Check your web browser's internet proxy settings and turn proxies off (use
1042<i>Edit preferences</i> on Netscape or <i>Internet options</i> on
1043Explorer).</li>
1044
1045<li>If Internet Explorer gives a message saying "The page cannot be
1046displayed" and "Cannot find server or DNS error" at the bottom of the
1047page, check in your network settings that your computer's name is set
1048up correctly. For example, if there is a DNS suffix entered in your
1049TCP/IP properties (in the Control Panel), make sure that your host
1050name and suffix are correct for your computer.</li>
1051
1052</ol>
1053}
1054
1055_t229_ {
1056Collections like those at <a href="http://www.nzdl.org">www.nzdl.org</a>
1057will soon be made available for download.
1058}
1059
1060_t230_ {
1061The initial username required here is <i>admin</i>.
1062
1063<p>If you installed Greenstone using the InstallShield installer on Windows
1064or the Install.sh script on Unix you should have been asked to set a
1065password during the installation procedure.</p>
1066
1067<p>If you didn't, don't worry, the password defaults to being
1068<i>admin</i>.</p>
1069
1070<p>So if you don't know what to enter you should try username =
1071<i>admin</i>, password = <i>admin</i>.<p>
1072}
1073
1074_t231_ {
1075This may be caused by the URL becoming too long for your web
1076browser. Because Greenstone currently stores all state information in the
1077URL, if you do a search for a long phrase the URL can become very
1078long. Different browser's on different platforms have different maximum URL
1079lengths but in general it seems that Netscape can handle longer URLs than
1080can Microsoft Internet Explorer.
1081
1082<p>There is very little you can do to avoid this problem with the way
1083Greenstone is currently implemented (aside from not searching for long
1084phrases). Future versions of Greenstone may store some state information on
1085the server rather than in the URL but this has yet to be implemented.</p>
1086}
1087
1088
1089#######################################################################
1090
1091package faqbuild
1092
1093_t233_ {
1094The Collector is a web interface for building new collections, altering or
1095deleting existing collections, and exporting existing collections to
1096stand-alone CD-ROMs. The Collector is a standard part of a Greenstone
1097installation. To begin using the Collector, click the &quot;The
1098Collector&quot; button on your Greenstone home page. For further details on
1099using the Collector see the <a href="_httppagex_(docs)">Greenstone User's
1100Guide</a>.
1101}
1102
1103_t234_ {
1104It's occasionally preferable to build your Greenstone collections from the
1105command line rather than from the Collector. This allows you greater
1106control over how your new collection turns out. See the <a
1107href="_httppagex_(docs)">Greenstone Developer's Guide</a> for detailed step
1108by step instructions on building collections from the command line.
1109}
1110
1111_t235_ {
1112Are you running Norton Anti-Virus? There are some incompatibilities between
1113Norton and the Greenstone collection building process that cause
1114unpredictable things to happen if you build your collection while Norton is
1115running. Try disabling Norton and rebuilding the collection.
1116
1117<p>If you do not have Norton or disabling Norton does not solve the problem
1118please <a href="_httppagex_(support)">contact us</a> for further help.</p>
1119}
1120
1121_t236_ {
1122If you downloaded Greenstone from the web you will not have all the
1123components required to make the &quot;export to CD-ROM&quot; function
1124work. These extra components have been made available in a separate
1125download which you can get from the <a
1126href="_httppagex_(download)#packages">download</a> page.
1127}
1128
1129_t237_ {
1130Are you using a Netscape web browser with the local library? If so, try
1131using Internet Explorer instead. There are some socket connection problems
1132that show up on Windows 2000 when using Netscape.
1133}
1134
1135_t238_ {
1136The Organizer (also called the &quot;Collection Organizer&quot;) is a
1137Windows utility used for automatically generating some of the configuration
1138files (metadata.xml, sub.txt etc.) used by complex Greenstone collections.
1139}
1140
1141_t239_ {
1142From the <a href="_httppagex_(download)#utilities">download</a> page.
1143}
1144
1145_t240_ {
1146There are several reasons that the collector might fail to build a
1147collection and the error messages it produces are not always very helpful.
1148
1149<p>If you changed the default configuration during the <i>configure
1150collection</i> stage you'll need to make sure the changes were valid. For
1151example, if you added a new <i>classify</i> or <i>plugin</i> line you'll
1152need to make sure that the classifier and/or plugin names and arguments are
1153all correct. If they're not the collector will fail. A good test is to
1154build your collection without changing the configuration. If it builds ok
1155with the default configuration but fails after you change the configuration
1156you'll need to look closely at the changes you're making.</p>
1157
1158<p>Another good thing to do if having problems with the collector is to
1159build your collection from the command line instead. You'll get much more
1160feedback to help debug problems when building in this way. For details on
1161how to build a collection from the command line see the <a
1162href="_httppagex_(docs)">Greenstone developer's guide</a>.</p>
1163}
1164
1165_t241_ {
1166The collect.cfg files for many of the collections at <a
1167href="http://www.nzdl.org">www.nzdl.org</a> have been made available <a
1168href="_httppagex_(colcfg)">here</a>.
1169}
1170
1171_t242_ {
1172The <a href="_httpdocsdir_/mgpp_user.pdf">MGPP user manual</a> gives some
1173instructions.
1174}
1175
1176_tfaqbuild11body_ {
1177To create and add the new buttons for a new classifier, there are several macro files that need to be edited. This is an example for the Countries metadata. <i>Countries</i> is the metadata name (or buttonname), <i>count</i> is the short form used in image names, <i>countries</i> is the text that appears on the nav bar buttons and the green title.
1178<p>
1179These lines should all be put next to the other ones ones of the same type. Use Title as an example to search for the approriate place to insert.
1180<p>
1181<i>base.dm:</i>
1182<br>
1183<br>\_Countrieswidth\_ \{\_widthcountx\_ \}
1184
1185<br>\_imageCountries\_ \{\_gsimage\_(\_httpbrowseCountries\_,\_httpicontcountof\_,\_httpicontcounton\_,countries,\_textimageCountries\_)\}
1186<br>\_icontabCountriesgreen\_ \{&lt;img
1187src="\_httpicontcountgr\_" width=\_widthtcountx\_ border=0&gt;\}
1188<br>\_icontabCountriesgreen\_[v=1] \{\_texticontabCountriesgreen\_ \}
1189<p>
1190<i>document.dm:</i>
1191<br>
1192<br>\_textCountriespage\_ \{\_texticonhcount\_ \}
1193
1194<br>\_iconCountriespage\_ \{&lt;img src="\_httpiconhcount\_" width="\_widthhcount\_"
1195height="\_heighthcount\_"&gt;\}
1196<br>\_iconCountriespage\_ [v=1] \{&lt;h2&gt;\_texticonhcount\_&lt;/h2&gt;\}
1197
1198<p>
1199<i>english.dm:</i>
1200<br>
1201<br>\_textimageCountries\_ \{Browse by countries\}
1202<br>\_texticontabCountriesgreen\_ \{Countries\}
1203<br>\_texticonhcount\_ \{Countries\}
1204<br>\_textCountriesshort\_ \{access publications by country\}
1205<br>\_textCountrieslong\_ \{&lt;p&gt;You can &lt;i&gt;access publications by country&lt;/i&gt; by
1206pressing the &lt;i&gt;countries&lt;/i&gt; button. This brings up a list of countries. \}
1207<br>
1208<br>## "countries" ## nav\_bar\_button ## tcount ##
1209<br>\_httpicontcountgr\_ \{\_httpimg\_/tcountgr.gif\}
1210<br>\_httpicontcountof\_ \{\_httpimg\_/tcountof.gif\}
1211<br>\_httpicontcounton\_ \{\_httpimg\_/tcounton.gif\}
1212<br>\_widthtcountx\_ \{87\}
1213
1214<br>## "countries" ## green_title ## h_count ##
1215<br>\_httpiconhcount\_ \{\_httpimg\_/h\_count.gif\}
1216<br>\_widthhcount\_ \{200\}
1217<br>\_heighthcount\_ \{57\}
1218
1219
1220<p>
1221The images that are needed are the nav bar images, and the title image with the green bar in the background. There are 3 nav bar images: <i>tcountgr.gif</i> is the green one and <i>tcounton.gif</i> and <i>tcountof.gif</i> are the two yellow ones for the rollover effect.
1222<i>h_count.gif</i> is the title image.
1223
1224<p>These images can be generated by copying the two ## blocks from above into a temp file and running translate.pl on it eg.
1225
1226<br>translate.pl -language_symbol en temp.dm
1227
1228<p>To add the images in other languages, you need to edit the appropriate language macro file, and add the same items as for english.dm. And run the translate script to generate the images.
1229<p>English versions of the images should be placed in the $GSDLHOME/images directory, while other language versions should be placed in the appropriate subdirectory of $GSDLHOME/images, for example $GSDLHOME/images/fr for french images.
1230}
1231
1232#######################################################################
1233
1234package faqplugins
1235
1236
1237# base puts in surrounding <p> and </p>, so skip first and last ones
1238#
1239_metadata_ {
1240
1241"Default" means that the metadata fields will be automatically assigned (or
1242extracted if possible), while the "Available fields" lists other items
1243of metadata that the plugin may be able to assign based on any arguments
1244given to that plugin in the <tt>collect.cfg</tt> file.
1245All plugins are derived from BasPlug, and have following metadata fields:
1246
1247<table border="1">
1248<tr>
1249 <th> </th>
1250 <th> Default fields </th>
1251 <th> Available fields </th>
1252</tr>
1253<tr>
1254 <td> BasPlug </td>
1255 <td> Language, Encoding, Source </td>
1256 <td> FirstNNNN, kea, Acronym </td>
1257</tr>
1258</table>
1259</p>
1260
1261<p>
1262In addition, many plugins have additional fields available:
1263<table border="1">
1264
1265<tr>
1266 <th> Plugin name </th>
1267 <th> Default fields </th>
1268 <th> Available fields </th>
1269</tr>
1270
1271<tr>
1272 <td> BibTexPlug </td>
1273 <td> Title, Creator, Abstract, Author, Booktitle, Chapter, Copyright, Date,
1274 Edition, Editor, EntryType Journal, Keywords, Month, Note, Number,
1275 Pages, Publisher, PublisherAddress, Volume, Year </td>
1276 <td>&nbsp;</td>
1277</tr>
1278
1279<tr>
1280 <td> DBPlug </td>
1281 <td>&nbsp;</td>
1282 <td> (arbitrary metadata field names based on Database configuration file)
1283 </td>
1284</tr>
1285
1286<tr>
1287 <td> EMAILPlug </td>
1288 <td> Date, DateText, From, FromAddr, FromName, Headers, Subject,
1289 Title (based on subject, from, and date), To
1290 </td>
1291 <td>&nbsp;</td>
1292</tr>
1293
1294<tr>
1295 <td> ExcelPlug </td>
1296 <td>&nbsp;</td>
1297 <td> (all fields as in HTMLPlug) </td>
1298</tr>
1299
1300<tr>
1301 <td> HTMLPlug </td>
1302 <td> Title, URL </td>
1303 <td> Author, Creator, Email (others as found in the <tt>-metadata_fields</tt> option) </td>
1304</tr>
1305
1306<tr>
1307 <td> ImagePlug </td>
1308 <td> Image, ImageHeight, ImageSize, ImageType, ImageWidth, ScreenHeight,
1309 screenicon, ScreenSize, ScreenType, ScreenWidth, Source, srclink,
1310 srcicon, Thumb, ThumbHeight, ThumbType, ThumbWidth </td>
1311 <td>&nbsp;</td>
1312</tr>
1313
1314<tr>
1315 <td> IndexPlug </td>
1316 <td> as in the <tt>index.txt</tt> file </td>
1317 <td> (use metadata.xml files instead of using this plugin) </td>
1318</tr>
1319
1320<tr>
1321 <td> MARCPlug </td>
1322 <td> Creator, Description, MarcIdentifier, MarcSource, URL, Publisher,
1323 Relation, Rights, Subject, Title, Type </td>
1324 <td> (Metadata fields as in the <tt>marctodc.txt</tt> file) </td>
1325</tr>
1326
1327<tr>
1328 <td> OAIPlug </td>
1329 <td> URL, (all metadata in <tt>.oai</tt> markup file) </td>
1330 <td>&nbsp;</td>
1331</tr>
1332
1333<tr>
1334 <td> PDFPlug </td>
1335 <td>&nbsp;</td>
1336 <td> (all fields in HTMLPlug) </td>
1337</tr>
1338
1339<tr>
1340 <td> PPTPlug </td>
1341 <td>&nbsp;</td>
1342 <td> (all fields in HTMLPlug) </td>
1343</tr>
1344
1345<tr>
1346 <td> PSPlug </td>
1347 <td> Title </td>
1348 <td> Date, Pages, (all fields in TextPlug) </td>
1349</tr>
1350
1351<tr>
1352 <td> ReferPlug </td>
1353 <td> Abstract, BookConfOnly, Booktitle, Copyright, Creator, Date, Editor,
1354 Keywords, Journal, JournalsOnly, Number, Pages, Publisher,
1355 Publisheraddr, Report, Title, Volume </td>
1356 <td>&nbsp;</td>
1357</tr>
1358
1359<tr>
1360 <td> RTFPlug </td>
1361 <td>&nbsp;</td>
1362 <td> (all fields in HTMLPlug) </td>
1363</tr>
1364
1365<tr>
1366 <td> SRCPlug </td>
1367 <td> Title, filename, includes, class, classdecl </td>
1368 <td>&nbsp;</td>
1369</tr>
1370
1371<tr>
1372 <td> TEXTPlug </td>
1373 <td> Title </td>
1374 <td>&nbsp;</td>
1375</tr>
1376
1377<tr>
1378 <td> UnknownPlug </td>
1379 <td> (as given in the <tt>-assoc_field</tt> plugin argument) </td>
1380 <td>&nbsp;</td>
1381</tr>
1382
1383<tr>
1384 <td> WordPlug </td>
1385 <td>&nbsp;</td>
1386 <td> (all fields in HTMLPlug) </td>
1387</tr>
1388
1389</table>
1390</p>
1391
1392<p>See section two of the _docs:developersguide_ for information about
1393options to plugins, or run the <tt>pluginfo.pl</tt> command on the
1394plugin name after setting up your environment for Greenstone.
1395(For example, "<tt>perl&nbsp;-S&nbsp;pluginfo.pl&nbsp;BasPlug</tt>".)
1396</p>
1397
1398<p>
1399In addition, every document can be manually assigned arbitrary metadata
1400fields and values through use of <tt>metadata.xml</tt> files, as discussed
1401in the manual.
1402}
1403
1404# base puts in surrounding <p> and </p>, so skip first and last ones
1405#
1406_pdfproblems_ {
1407PDF is a "page description language". This means that the document contains
1408objects and commands such as "draw this text here" and "draw this
1409image here".
1410</p>
1411
1412<p>
1413Greenstone uses an external program called "<tt>pdftohtml</tt>" to
1414extract text out of PDF files. Sometimes, there is no text that can be
1415extracted. This often depends on how the PDF was created.
1416
1417<ol>
1418<li>Adobe Acrobat Writer can be used to create PDFs from paper
1419documents that are scanned in by a scanner. In this case, the PDF file
1420contains images of text, rather than computer-readable text. Therefore,
1421<tt>pdftohtml</tt> cannot find any text to extract.</li>
1422
1423<li>Some programs (such as older versions of <tt>GNU ghostscript</tt>,
1424which is used by <tt>ps2pdf</tt> on Unix computers) sometimes create
1425"bitmap fonts", which means that every character in the document is
1426really an image rather than a computer readable letter. The
1427<tt>LaTeX</tt> type-setting program sometimes does this when the
1428"Computer Modern Roman" font is used.</li>
1429
1430<li>Certain characters and character combinations may be extracted incorrectly,
1431depending on the program that generated the PDF file. For example, "ligatures"
1432such as "fi", "fl", "ff" and "ffl" are often rendered using a special glyph
1433rather than as individual characters, and this information may be lost in
1434the textual representation. Also, some PDF generating programs may not
1435correctly encode accented characters. For example, to draw a lowercase "u"
1436with an umlaut accent, LaTeX draws a "u" and then draws an umlaut accent over
1437it. This means that <tt>pdftohtml</tt> will extract two separate characters
1438('š' and 'u') rather than a single accented character (Ì).</li>
1439
1440<li>PDF contains pieces of text, and coordinates for where that text
1441should be displayed. This means that <tt>pdftohtml</tt> may
1442incorrectly guess the order that the text fragments are supposed to
1443occur in. For example, for text that is in two or more columns, the text
1444may be extracted as the first sentence of each column, then the second
1445sentence of each column, and so on. In this case, the extracted text
1446is still usable for indexing purposes, but should not be displayed.
1447
1448In this case, a format statement should be added to the <tt>collect.cfg</tt>
1449file to provide a link to the original PDF file but not to the extracted
1450text, such as:
1451<center>
1452<small><tt>format SearchVList "&lt;td valign=top&gt;[srclink][srcicon][/srclink]&lt;/td&gt; &lt;td&gt;[srclink][Title][/srclink]&lt;/td&gt;"</tt></small>
1453</center>
1454</li>
1455
1456<li>Because of the way that images are embedded in PDF files,
1457<tt>pdftohtml</tt> occasionally extracts an image upside-down, or mirrored.
1458This appears to be a bug in the program.</li>
1459
1460</ol>
1461}
1462
1463#######################################################################
1464
1465package cvs
1466
1467_cvstitle_ {CVS}
1468
1469_cvscheckout_ {
1470To check out the Greenstone source code from our server do the following:
1471}
1472
1473_cvsupdate_ {
1474Once you have the code you may update it at any time by changing to the
1475gsdl directory and typing:
1476}
1477
1478_notice_ {Note about versions}
1479
1480_recentversion_ {Make sure that your version of CVS is 1.11 or later. Some
1481operating systems (including Mac OS X and Solaris) have older versions
1482that can not connect to a non-default port. This causes an error such
1483the following:}
1484
1485_download_ {You can download pre-compiled packages of recent versions of CVS
1486from <a href="http://ftp.cvshome.org/release/binary/">http://ftp.cvshome.org/release/binary/</a>.}
1487#######################################################################
1488
1489package colcfg
1490
1491_t246_ {Collection Configuration File Samples}
1492
1493_t247_ {collect.cfg file}
1494
1495_t248_ {Acronym Extraction Demo}
1496
1497_t249_ {Agricultural Information Modules}
1498
1499_t250_ {Arabic Collection}
1500
1501_t251_ {Bibliotheque pour le Developpement}
1502
1503_t252_ {Chinese Demonstration collection}
1504
1505_t253_ {Collection on Critical Global Issues (2nd edition)}
1506
1507_t254_ {Colt Bibliography}
1508
1509_t255_ {Computer Science Bibliographies}
1510
1511_t256_ {The Computists' Weekly}
1512
1513_t257_ {Crystal}
1514
1515_t258_ {FAO document repository}
1516
1517_t259_ {FAO on the Internet (1998)}
1518
1519_t260_ {Food and Nutrition Library 1.1}
1520
1521_t261_ {Greenstone Archives}
1522
1523_t262_ {HCI Bibliography}
1524
1525_t263_ {Humanity Development Library}
1526
1527_t264_ {Indigenous Peoples}
1528
1529_t265_ {Kiwi Aircraft Images}
1530
1531_t266_ {Language Extraction Demo}
1532
1533_t267_ {Medical and Health Library}
1534
1535_t268_ {MSWord and PDF Demonstration}
1536
1537_t269_ {Music Videos}
1538
1539_t270_ {OAI Plugin demo}
1540
1541_t271_ {Poverty Alleviation}
1542
1543_t272_ {Project Gutenberg}
1544
1545_t273_ {TidBITS}
1546
1547_t274_ {Virtual Disaster Library}
1548
1549_t275_ {Women's History}
1550
1551_t276_ {World Environment Library}
1552
1553_t277_ {Youth Oral History}
1554
1555
1556#######################################################################
1557
1558package intn
1559
1560_t278_ {Internationalizing Greenstone}
1561
1562_t279_ {There are several different levels of Greenstone language support.}
1563
1564_t280_ {Core languages}
1565
1566_t281_ {
1567English, French, Spanish, and Russian are Greenstone core languages. For
1568these there is a full translation, including interface, documentation,
1569sample collections, installation instructions. They have been produced in
1570conjunction with UNESCO and are distributed with all versions of
1571Greenstone, including the CD-ROM version. They are updated whenever the
1572CD-ROM is re-issued (so far, approximately once a year).
1573}
1574
1575_t282_ {Full translation}
1576
1577_t283_ {
1578Full translations of Greenstone include the interface and all the
1579documentation. Translating the documentation is a big job, and so far,
1580apart from the UNESCO-supported CD-ROM project, there is only one example
1581-- Kazakh. We would like to encourage more people to do full translations.
1582}
1583
1584_t284_ {Maintained interface-only translation}
1585
1586_t285_ {
1587&quot;Maintained&quot; translations include the language interface and a
1588designated person who updates it. The Greenstone interface has been
1589translated into many languages. However, the system is growing and language
1590interfaces become out-dated as new features are added to the software. For
1591each language, we are hoping to find a volunteer who undertakes to
1592periodically maintain the interface for that language.
1593}
1594
1595_t286_ {Unmaintained interface-only translation}
1596
1597_t287_ {
1598The interface comes in two parts: a &quot;core&quot; part that contains the
1599basic digital library interface, and an &quot;auxiliary&quot; part that
1600that concerns functionality that is generally only used by the library
1601maintainer (e.g. the Administration pages and the Collector). Many language
1602interfaces just contain the core part; since the core changes relatively
1603slowly these are mostly fairly complete. However, some unmaintained
1604translations are rather out of date.
1605}
1606
1607_t288_ {In progress}
1608
1609_t289_ {For some languages, the translation process is still in progress.}
1610
1611_t290_ {
1612When you download Greenstone, the core language interfaces (English,
1613French, Spanish and Russian) come automatically. The other languages are
1614provided in a separate package which can be <a
1615href="http://sourceforge.net/project/showfiles.php?group_id=12123&release_id=173035">downloaded</a>
1616and installed as required. This makes the downloads smaller, and for those
1617who do not need all the languages Greenstone is slightly smaller and
1618faster.
1619}
1620
1621_tnzdl_ {NZDL Project}
1622
1623_tunesco_ {UNESCO}
1624
1625_t291_ {Here is a summary of the languages currently supported:}
1626
1627_t292_ {Language}
1628
1629_t293_ {Status}
1630
1631_t294_ {Maintainer}
1632
1633_t302_ {core}
1634
1635_t313_ {full}
1636
1637_t300_ {maintained}
1638
1639_t296_ {unmaintained}
1640
1641_t298_ {in progress}
1642
1643_t295_ {Arabic}
1644
1645_armenian_ {Armenian}
1646
1647_lng5_ {Bosnian}
1648
1649_t297_ {Chinese}
1650
1651_lng4_ {Croatian}
1652
1653_t299_ {Czech}
1654
1655_t301_ {English}
1656
1657_t303_ {Dutch}
1658
1659_t304_ {French}
1660
1661_lng1_ {Finnish}
1662
1663_t305_ {Galician}
1664
1665_t306_ {German}
1666
1667_t307_ {Greek}
1668
1669_t308_ {Hebrew}
1670
1671_lng2_ {Hindi}
1672
1673_t309_ {Indonesian}
1674
1675_t310_ {Italian}
1676
1677_t311_ {Japanese}
1678
1679_lng3_ {Kannada}
1680
1681_t312_ {Kazakh}
1682
1683_t314_ {Maori}
1684
1685_t315_ {Nepalese}
1686
1687_t316_ {Portuguese (Brazil)}
1688
1689_t317_ {Portuguese (Portugal)}
1690
1691_t318_ {Russian}
1692
1693_t319_ {Serbian}
1694
1695_t320_ {Spanish}
1696
1697_t321_ {Thai}
1698
1699_t322_ {Turkish}
1700
1701_t323_ {Ukrainian}
1702
1703_t324_ {Vietnamese}
1704
1705_t325_ {Information for language maintainers}
1706
1707_t326_ {
1708There are two methods for working with Greenstone language interface (apart
1709from editing the macro files directly, which is not recommended).
1710}
1711
1712_t327_ {Spreadsheet}
1713
1714_t328_ {
1715We send you an Excel spreadsheet that contains all the English text
1716strings, with empty cells for the translation. You fill it in and return
1717it, and we install it in Greenstone. This method is probably the best for
1718large-scale translation, but requires Microsoft software.
1719}
1720
1721_t329_ {Greenstone Translator's Interface}
1722
1723_t330_ {
1724The Greenstone translator's interface is a Web tool that presents the
1725English text strings needing translation, and provides boxes for entering
1726the translated text. Once submitted, translations are stored in the
1727appropriate language file. The system automatically determines which text
1728strings need translating or updating, and can easily be used to update a
1729language interface.
1730}
1731
1732_t331_ {
1733Generally it is best to use the spreadsheet to create the basic interface
1734and the translation interface to fine tune or update it in the future. In
1735either case you need a username and password, which we supply to designated
1736Greenstone language maintainers. If you are interested, you can play with
1737an open version of the system by logging into <a
1738href="http://www.nzdl.org/cgi-bin/translate/library">this page</a> with
1739username "guest" and no password, though if you do this you cannot save the
1740results.
1741}
1742
1743_t332_ {
1744To register as a designated Greenstone language maintainer, please send a
1745request to Michael Dewsnip (<a
1746href="mailto:[email protected]">[email protected]</a>). As
1747soon as you receive your password please change it by going to <a
1748href="http://www.nzdl.org/cgi-bin/translate/library">this page</a>,
1749choosing the administration option, clicking the "change password" option
1750on the left hand side, and following the instructions.
1751}
1752
1753_t333_ {
1754As soon as you log in, the front page of the translator's interface is
1755presented to you. Read the instructions and start translating! You don't
1756have to translate all the strings in one session -- you can stop and
1757continue work later. There is a link at the bottom of each page under the
1758"submit" button that allows you to view a Greenstone site in the language
1759you have chosen, and see your translations take effect. (However, the
1760images are not yet created as you go.)
1761}
1762
1763_t334_ {Language-dependent text in Greenstone}
1764
1765_t335_ {
1766For your information and interest, the language-dependent text in
1767Greenstone comes in these places. We do not attempt to translate the
1768comments that appear in program code, scripts, or configuration files. Our
1769guideline is that non-programming users doing standard things with
1770Greenstone should be able to work entirely in their own language.
1771}
1772
1773_t336_ {User interface}
1774
1775_t337_ {Core}
1776
1777_t338_ {Text used in the basic digital library interface for Greenstone}
1778
1779_t339_ {On-line help for the basic digital library interface}
1780
1781_t340_ {Auxiliary}
1782
1783_t341_ {Text that is generally directed at the library maintainer (e.g. the
1784Administration pages and the Collector)}
1785
1786_t342_ {Text used in the Greenstone Librarian Interface}
1787
1788_t343_ {Text in scripts for running (and compiling) the GLI}
1789
1790_t344_ {The gli.txt help file}
1791
1792_t345_ {On-line help for the GLI}
1793
1794_t346_ {Collection building}
1795
1796_t347_ {Option descriptions and error messages in perl scripts, and plugins
1797and classifiers}
1798
1799_t348_ {Images}
1800
1801_t349_ {Text strings that appear in images that form part of the user
1802interface}
1803
1804_t350_ {Documentation}
1805
1806_t351_ {Manuals}
1807
1808_t352_ {Installer's guide (35 pp.)}
1809
1810_t353_ {User's guide (50 pp.)}
1811
1812_t354_ {Developer's guide (115 pp.)}
1813
1814_t355_ {From Paper to Collection (45 pp.)}
1815
1816_t356_ {Installation}
1817
1818_t357_ {Unix}
1819
1820_t358_ {Text in install.sh and setup.bash.}
1821
1822_t359_ {We do not translate text strings that appear during the
1823configuration process (./configure), because people installing programs on
1824Unix usually do so using English.}
1825
1826_t360_ {Windows}
1827
1828_t361_ {Text in the InstallShield installer used for Greenstone, and
1829setup.bat.}
1830
1831_t362_ {InstallShield comes with many different languages, and we are not
1832responsible for these translations.}
1833
1834_t363_ {Both}
1835
1836_t364_ {The install.txt file}
1837
1838_t365_ {Licence}
1839
1840_t366_ {
1841The GNU General Public Licence is written in English, and official
1842translations into other languages do not exist. However, an unofficial
1843translation is appended to the licence text that is presented during the
1844installation process.
1845}
1846
1847_t367_ {Sample Collections}
1848
1849_t368_ {Collection configuration files for sample collections supplied with
1850Greenstone.}
1851
1852
Note: See TracBrowser for help on using the repository browser.