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

Last change on this file since 6778 was 6778, checked in by mdewsnip, 20 years ago

Extra macros necessary to support the "PREFERENCES" button.

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