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

Last change on this file since 6210 was 6210, checked in by nzdl, 20 years ago

Added a lot of stuff for the new 2.41 release.

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