source: trunk/gsdl-documentation/manuals/xml-source/fr/Install_fr.xml@ 14099

Last change on this file since 14099 was 14099, checked in by lh92, 14 years ago

Added the copyright information

  • Property svn:keywords set to Author Date Id Revision
File size: 82.9 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<Manual id="Install" lang="fr">
3<Heading>
4<Text id="1"/><Updated date="1-Mar-2004 by unknown"/>
5</Heading>
6<Title>
7<Text id="2">Guide d'installation de la bibliothÚque numérique Greenstone</Text><Updated date="1-Mar-2004 by unknown"/>
8</Title>
9<Author>
10<Text id="3">Ian H. Witten et Stefan Boddie</Text>
11</Author>
12<Affiliation>
13<Text id="4">Département d'informatique,<br/>Université de Waikato, Nouvelle-Zélande</Text>
14</Affiliation>
15<SupplementaryText>
16<Text id="manual_index">Retourner à l'indexe du manuel</Text>
17<Text id="top_index">Retourner à l'indexe du dessus</Text>
18</SupplementaryText>
19<Text id="5">Greenstone est une suite logicielle destinée à la construction et à la distribution de collections de bibliothÚques numériques. Cette suite fournit une nouvelle maniÚre d'organiser l'information et de la publier sur l'Internet ou sur un cédérom. Greenstone est produit par le projet de bibliothÚque numérique de Nouvelle-Zélande (dépendant de l'université de Waikato), et distribué en coopération avec l'UNESCO et le projet de bibliothÚques pour l'humanité. C'est un logiciel Open Source, qu'on peut obtenir à l'URL http://greenstone.org, et qui est diffusé selon les termes de la licence publique générale de GNU.</Text>
20<Comment>
21<Text id="6">Nous souhaitons nous assurer que ce logiciel fonctionne bien pour vous.<br/>Faites-nous part, en anglais, de tout problÚme à l'adresse électronique greenstone@cs.waikato.ac.nz.</Text>
22</Comment>
23<Version>
24<Text id="7">Greenstone gsdl-2.50</Text>
25</Version>
26<Date>
27<Text id="8">Mars 2004</Text>
28</Date>
29<Section id="about_this_manual">
30<Title>
31<Text id="9">À propos de ce manuel</Text>
32</Title>
33<Content>
34<Text id="10">Ce document explique comment installer Greenstone pour pouvoir l'utiliser sur votre ordinateur. Il explique aussi comment obtenir les logiciels associés, qui sont librement disponibles: le serveur web Apache et Perl. Nous avons fait au mieux pour simplifier au maximum la procédure d'installation.</Text>
35<Text id="11">Ce logiciel fonctionne sur différentes plates-formes et différentes configurations. Par conséquent, de nombreux détails pourront impacter la procédure d'installation. La section <CrossRef target="Chapter" ref="versions_of_greenstone"/> liste des questions qu'il faudra se poser avant d'installer Greenstone. La section <CrossRef target="Chapter" ref="installation_procedure"/> détaille la procédure d'installation pour les différentes versions; ne lisez que la portion relative à votre systÚme d'exploitation. La section <CrossRef target="Chapter" ref="greenstone_collections"/> décrit les collections de bibliothÚques numériques de démonstration comprises dans la distribution. La section <CrossRef target="Chapter" ref="setting_up_webserver"/> explique comment configurer des serveurs web communs, Apache et PWS/IIS de Microsoft, de maniÚre à les faire fonctionner avec Greenstone. La section <CrossRef target="Chapter" ref="configuring_your_site"/> décrit plusieurs options de configuration de Greenstone, et la section <CrossRef target="Chapter" ref="personalizing"/> montre comment créer une page d'accueil personnalisée pour votre installation de bibliothÚque numérique. Enfin, une annexe <CrossRef target="Chapter" ref="appendix_associated_software"/> liste des logiciels associés et donne pour chacun la maniÚre de l'obtenir.</Text>
36</Content>
37</Section>
38<Section id="companion_documents">
39<Title>
40<Text id="12">Documents d'accompagnement</Text>
41</Title>
42<Content>
43<Text id="13">L'ensemble des documents de Greenstone comprend cinq volumes:</Text>
44<BulletList>
45<Bullet>
46<Text id="14">Guide d'installation de la bibliothÚque numérique Greenstone (<i>ce document-ci</i>)</Text>
47</Bullet>
48<Bullet>
49<Text id="15">Guide de l'utilisateur de la bibliothÚque numérique Greenstone</Text>
50</Bullet>
51<Bullet>
52<Text id="16">Guide du développeur de la bibliothÚque numérique Greenstone</Text>
53</Bullet>
54<Bullet>
55<Text id="17">BibliothÚque numérique Greenstone: du papier à la collection</Text>
56</Bullet>
57<Bullet>
58<Text id="18">BibliothÚque numérique Greenstone: Utilisation de "L'organizer"</Text>
59</Bullet>
60</BulletList>
61</Content>
62</Section>
63<Section id="copyright">
64<Title>
65<Text id="copyright-title">Copyright</Text>
66</Title>
67<Content>
68<Text id="right-text-1">Copyright 2002 2003 2004 2005 2006 2007 by the <Link url="http://www.nzdl.org">New Zealand Digital Library Project</Link> at <Link url="http://www.waikato.ac.nz">the University of Waikato</Link>, New Zealand.</Text>
69<Text id="right-text-2">Permission is granted to copy, distribute and/or modify this document under the terms of the <Link url="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License</Link>, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled <Link url="http://greenstonewiki.cs.waikato.ac.nz/wiki/gsdoc/GNUFDL.html">“GNU Free Documentation License.”</Link></Text>
70</Content>
71</Section>
72<Section id="acknowledgements">
73<Title>
74<Text id="19">Remerciements</Text>
75</Title>
76<Content>
77<Text id="20">Le logiciel Greenstone a vu le jour grâce à un effort de collaboration entre de nombreuses personnes. Rodger McNab et Stefan Boddie en sont les principaux architectes et développeurs. Des contributions ont été faites par David Bainbridge, George Buchanan, Hong Chen, Michael Dewsnip, Katherine Don, Elke Duncker, Carl Gutwin, Geoff Holmes, Dana McKay, John McPherson, Craig Nevill-Manning, Dynal Patel, Gordon Paynter, Bernhard Pfahringer, Todd Reed, Bill Rogers, John Thompson, et Stuart Yeates. D'autres membres du Projet de bibliothÚque numérique de Nouvelle-Zélande ont également donné des conseils et inspiré les concepteurs du systÚme: Mark Apperley, Sally Jo Cunningham, Steve Jones, Te Taka Keegan, Michel Loots, Malika Mahoui, et Lloyd Smith. Nous remercions aussi tous ceux qui ont contribué au développement des modules sous licence GNU GPL qui font partie de cette distribution: MG, GDBM, PDFTOHTML, PERL, WGET, WVWARE, XLHTML.</Text>
78</Content>
79</Section>
80<Chapter id="versions_of_greenstone">
81<Title>
82<Text id="21">Les versions de Greenstone</Text>
83</Title>
84<Content>
85<Text id="22">Greenstone fonctionne sur différentes plates-formes et configurations, comme résumé figure <CrossRef target="Figure" ref="different_options"/>.</Text>
86<Figure id="different_options">
87<Title>
88<Text id="23"><b>Figure:</b>Les options disponibles pour Windows et Unix de Greenstone</Text>
89</Title>
90<File width="542" height="264" url="images/Install_Fig_1.png"/>
91</Figure>
92<Text id="24">La procédure d'installation dépend de nombreux paramÚtres. Avant de continuer la lecture, posez-vous les questions suivantes:</Text>
93<BulletList>
94<Bullet>
95<Text id="25">Utilisez-vous Windows ou Unix?</Text>
96</Bullet>
97<Bullet>
98<Text id="26">Si vous utilisez Windows, utilisez-vous 3.1/3.11 ou bien une version plus récente? Bien qu'il soit possible de visualiser des collections et de servir d'autres ordinateurs sur le même réseau avec des machines pourvues de Windows 3.1/3.11, il n'est pas possible d'y construire de nouvelles collections. La version complÚte de Greenstone fonctionne sur Windows 95/98/Me, et sur NT/2000.</Text>
99</Bullet>
100<Bullet>
101<Text id="27">Si vous utilisez Unix, s'agit-il de Linux ou d'une autre version d'Unix? Dans le cas de Linux, une version binaire du systÚme complet, facile à installer, est fournie. Pour d'autres Unix il vous faudra installer le code source et le compiler, ce qui pourra nécessiter l'installation d'autres logiciels.</Text>
102</Bullet>
103<Bullet>
104<Text id="28">Dans le cas des systÚmes Windows NT/2000 ou Unix, pouvez-vous vous connecter en tant qu'«administrateur» ou «root»? Ceci est parfois nécessaire pour configurer un serveur web de maniÚre adéquate pour qu'il puisse fonctionner avec Greenstone.</Text>
105</Bullet>
106<Bullet>
107<Text id="29">Souhaitez-vous disposer du code source? Si vous utilisez Windows ou Linux, vous pouvez vous contenter d'installer des binaires. Mais si vous souhaitez également disposer du code source, il est dans la distribution de Greenstone.</Text>
108</Bullet>
109<Bullet>
110<Text id="30">Souhaitez-vous construire de nouvelles collections de bibliothÚques numériques? Si tel est le cas, il vous faudra disposer de Perl, qui est librement disponible pour Windows comme pour Unix.</Text>
111</Bullet>
112<Bullet>
113<Text id="31">Votre ordinateur comprend-il un serveur web? Greenstone est fourni avec un serveur web pour Windows. Cependant, si vous disposez déjà d'un serveur web, vous pouvez souhaitez continuer à l'employer. Dans le cas des systÚmes Unix, il vous faudra utiliser un serveur web.</Text>
114</Bullet>
115<Bullet>
116<Text id="32">Savez-vous comment configurer votre serveur web? Si vous n'utilisez pas le serveur web fourni avec Greenstone, il vous faudra légÚrement modifier la configuration de votre serveur web pour qu'il puisse reconnaître Greenstone.</Text>
117</Bullet>
118</BulletList>
119</Content>
120</Chapter>
121<Chapter id="installation_procedure">
122<Title>
123<Text id="33">La procédure d'installation</Text>
124</Title>
125<Content>
126<Text id="34">Il existe des versions Windows et Unix de Greenstone, sous formes binaire comme de code source. L'interface utilisateur de Greenstone utilise un navigateur web: Netscape Navigator ou Internet Explorer conviennent tous deux, à partir de leurs versions 4.0. Si vous ne disposez pas de navigateur web, le cédérom comprend les versions Windows de Netscape.</Text>
127<Section id="windows">
128<Title>
129<Text id="35">Windows</Text>
130</Title>
131<Content>
132<Text id="36">Si c'est Unix que vous employez, rendez-vous directement à la section <CrossRef target="Section" ref="unix"/>. Les utilisateurs de Windows qui se contenteront d'une installation simple et immédiate iront lire quant à eux la procédure d'installation simplifiée, section <CrossRef target="Subsection" ref="simple_installation"/>. Greenstone occupe environ 40 méga-octets d'espace disque.</Text>
133<Text id="37">Si vous souhaitez vous écarter un tant soit peu de la configuration par défaut, il vous faudra décider d'installer le binaire ou le code source. En cas de doute, optez pour le binaire. La procédure d'installation est la même dans les deux cas, et les sections suivantes détaillent les options disponibles.</Text>
134<Text id="38">À la fin de l'installation, sautez à la section <CrossRef target="Section" ref="how_to_find_greenstone"/>.</Text>
135<Subsection id="simple_installation">
136<Title>
137<Text id="39">Installation simplifiée</Text>
138</Title>
139<Content>
140<Text id="40">Pour installer la version Windows à partir du cédérom, insérez le disque dans le lecteur (par exemple, sous <i>D:</i>). Si aprÚs environ 20 secondes d'attente la procédure d'installation n'a toujours pas automatiquement démarré, cliquez sur le menu <i>Démarrer</i>, choisissez <i>Exécuter</i> et tapez <i>D:\Windows\Setup.exe</i>, où <i>«D»</i> représente la lettre identifiant votre lecteur de cédérom. Les utilisateurs de Windows 3.1 choisiront <i>Exécuter</i> à partir du Gestionnaire de fichiers et taperont, eux aussi, <i>D:\Windows\Setup.exe</i>.</Text>
141<Text id="41">Pour que l'installation se déroule le plus simplement possible, contentez-vous d'accepter les choix par défaut à chaque étape en cliquant sur le bouton <i>Suivant</i>. C'est tout! Greenstone est installé dans <i>C:\Program Files\gsdl</i>.</Text>
142<Text id="42">À la fin de l'installation, vous démarrerez Greenstone en cliquant sur le bouton <i>Démarrer</i>, ouvrirez le menu <i>Programmes</i>, et sélectionnerez <i>BibliothÚque Numérique Greenstone (Greenstone Digital Library)</i>. Ceci invoquera une boîte de dialogue; cliquez simplement sur <i>Entrer dans la bibliothÚque</i>. Voilà qui démarrera automatiquement votre navigateur web et chargera la page d'accueil de la bibliothÚque numérique Greenstone, qui devrait ressembler à la figure <CrossRef target="Figure" ref="your_greenstone_home_page"/>. Vous pourrez alors entrer dans la collection de démonstration de Greenstone en cliquant sur son icone.</Text>
143<Figure id="your_greenstone_home_page">
144<Title>
145<Text id="43">La page d'accueil de Greenstone</Text>
146</Title>
147<File width="395" height="327" url="images/Install_Fig_2.png"/>
148</Figure>
149</Content>
150</Subsection>
151<Subsection id="windows_binaries">
152<Title>
153<Text id="44">Binaires pour Windows</Text>
154</Title>
155<Content>
156<Text id="45">Le cédérom comprend deux binaires distincts pour Windows: la <i>BibliothÚque locale</i> et la <i>BibliothÚque Web</i>. L'installation par défaut décrite ci-dessus sélectionne la version «BibliothÚque locale», que nous vous recommandons chaudement d'utiliser. La «BibliothÚque Web», qui est bien plus difficile à utiliser, n'est nécessaire que si vous employez déjà un serveur web et rencontrez des conflits d'affectation de numéro de port en utilisant la «BibliothÚque locale». Malgré une appellation modeste, cette derniÚre fournit un service web complet et autonome.AprÚs avoir choisi la version à installer, vous devrez choisir une installation «complÚte» ou «condensée». L’installation complÚte comprend tout. L’installation condensée
157(qui est le choix par défaut) comprend tout sauf les manuels de Greenstone et la fonctionnalité «Exporter vers un cédérom». L’installation condensée utilise trois fois moins d’espace disque que l’installation complÚte.</Text>
158<Text id="46">BibliothÚque locale. Ceci permet à tout ordinateur équipé de Windows de servir des collections Greenstone déjà construites. La collection Greenstone «Demo» sera installée automatiquement; vous pourrez également installer les autres collections présentes sur le cédérom (voyez ceci en <CrossRef target="Chapter" ref="greenstone_collections"/>). Le logiciel de bibliothÚque locale est le même que celui qui est présent sur les cédéroms produits par le systÚme Greenstone.</Text>
159<Text id="47">La bibliothÚque locale est destinée aux ordinateurs isolés, ou aux ordinateurs non équipés de serveur web. Elle contient un petit serveur web pour que les autres ordinateurs du même réseau puissent également accéder à la bibliothÚque (mais ce serveur web n'est pas trÚs configurable).</Text>
160<Text id="48">Le logiciel de bibliothÚque locale détecte automatiquement si l'ordinateur dispose de logiciels de communication en réseau ou s'il est connecté à un réseau. Il fonctionnera correctement dans toutes les combinaisons possibles, mais on pourra néanmoins rencontrer deux problÚmes. Il se peut que Greenstone:</Text>
161<BulletList>
162<Bullet>
163<Text id="49">provoque une connexion téléphonique non désirée;</Text>
164</Bullet>
165<Bullet>
166<Text id="50">ou échoue à cause de la présence de logiciels de communication en réseau mal installés.</Text>
167</Bullet>
168</BulletList>
169<Text id="51">C'est pour de telles situations qu'une version restreinte de la bibliothÚque locale est fournie, version qui ne fonctionne qu'avec Netscape (et pas Internet Explorer). Lors de l'invocation de la version «BibliothÚque locale» de Greenstone, la boîte de dialogue qui apparaît propose un bouton pour sélectionner cette version restreinte. À moins que les problÚmes mentionnés ci-dessus ne se posent, préférez-lui toujours la version standard.</Text>
170<Text id="52"><b>BibliothÚque Web</b>. Ceci permet à tout ordinateur disposant d'un serveur web de servir des collections Greenstone déjà construites. Comme dans le cas de la bibliothÚque locale mentionné ci-dessus, la collection Greenstone «Demo» sera installée automatiquement. Vous pourrez également installer les autres collections présentes sur le cédérom (voyez ceci en section <CrossRef target="Chapter" ref="greenstone_collections"/>).</Text>
171<Text id="53">La bibliothÚque web diffÚre de la bibliothÚque locale en ce sens qu'elle est destinée aux ordinateurs qui disposent déjà d'un serveur web.</Text>
172<Text id="54">Pour utiliser la bibliothÚque web, vous aurez aussi besoin</Text>
173<BulletList>
174<Bullet>
175<Text id="55">d'un logiciel serveur web, comme Apache par exemple (voyez l'annexe <CrossRef target="Chapter" ref="appendix_associated_software"/> à ce sujet).</Text>
176</Bullet>
177<Bullet>
178<Text id="56"><b>Le Collector</b>. Ce composant, inclus à la fois dans la bibliothÚque locale et dans la bibliothÚque web, vous permet de construire des collections autour de contenus de votre choix. Pour l'utiliser, vous aurez aussi besoin de Perl. Nous recommandons ActivePerl (voyez l'annexe <CrossRef target="Chapter" ref="appendix_associated_software"/> à ce sujet).</Text>
179</Bullet>
180</BulletList>
181</Content>
182</Subsection>
183<Subsection id="">
184<Title>
185<Text id="57">Configuration de serveur web pour Windows (ne concerne que la bibliothÚque web)</Text>
186</Title>
187<Content>
188<Text id="58">La version de Greenstone en bibliothÚque locale a cet avantage qu'elle fonctionne directement, sans nécessiter de configuration particuliÚre. Dans le cas de la version en bibliothÚque web, il vous faudra en revanche apporter quelques modifications aux réglages de votre serveur web.</Text>
189<Text id="59">Si vous disposez déjà d'un serveur web, il faudra apporter quelques modifications à sa configuration pour pouvoir utiliser votre installation de Greenstone. Le script d'installation détaille ces modifications dans le cas du serveur web Apache -- voyez la section <CrossRef target="Section" ref="pws_and_iis_webservers"/> pour obtenir des instructions relatives à la configuration des serveurs web PWS et IIS. Vous aurez peut-être besoin d'un administrateur systÚme pour reconfigurer un serveur web déjà installé -- votre administrateur systÚme devrait comprendre les instructions fournies par le script d'installation.</Text>
190<Text id="60">Si vous ne disposez pas déjà d'un serveur web, il vous faudra en installer un (voyez l'annexe <CrossRef target="Chapter" ref="appendix_associated_software"/> pour obtenir des informations sur le serveur Apache). Il vous faudra ensuite le configurer de maniÚre appropriée. La section <CrossRef target="Chapter" ref="setting_up_webserver"/> détaille les portions de l'installation d'un serveur web qui concernent Greenstone, et comment il faut les modifier. Tout revient à ajouter une petite dizaine de lignes à un fichier de configuration.</Text>
191</Content>
192</Subsection>
193<Subsection id="windows_source">
194<Title>
195<Text id="61">Code source pour Windows</Text>
196</Title>
197<Content>
198<Text id="62">Le code source de Greenstone occupe 50 méga-octets d'espace disque, mais 90 méga-octets seront nécessaires pour procéder à la compilation. Pour compiler ce code source sur Windows vous devrez également disposer</Text>
199<BulletList>
200<Bullet>
201<Text id="63">du compilateur Microsoft Visual C++ (nous travaillons actuellement sur l'aplanissement de petits problÚmes posés par la compilation de Greenstone avec diverses versions de GCC pour Windows).</Text>
202</Bullet>
203</BulletList>
204<Text id="64">(Vous n'aurez pas besoin de GDBM, le gestionnaire de bases de données de GNU, car il est inclus dans la distribution de Greenstone).</Text>
205<Text id="65">Il est peu probable que vous parveniez à compiler Greenstone sur une machine fonctionnant sous un systÚme Windows 3.1/3.11.</Text>
206<Text id="66">Au cas où vous recompilez Greenstone et souhaitez utiliser la version recompilée pour créer des cédéroms, sachez que le code produit par les versions récentes du compilateur Microsoft Visual C++ ne fonctionne pas sous les systÚmes Windows 3.1/3.11, mais fonctionne sans problÚmes sous des systÚmes ultérieurs (95, 98, Me, NT, 2000). Si vous souhaitez que vos cédéroms puissent être utilisés sur des versions anciennes de Windows, il vous faudra utiliser une autre version du compilateur. De plus, Greenstone utilise STL, la bibliothÚque standard de patrons (templates) pour C++, et même si d'anciens compilateurs sont parfois fournis avec STL, la version fournie ne fonctionne pas toujours trÚs bien. C'est pourquoi, pour recompiler Greenstone de telle sorte qu'il produise des cédéroms qui fonctionneront sur d'anciennes versions de Windows, vous aurez besoin</Text>
207<BulletList>
208<Bullet>
209<Text id="67">du compilateur Microsoft Visual C++, version 4.0 ou 4.2.</Text>
210</Bullet>
211<Bullet>
212<Text id="68">d'une version externe de STL, la bibliothÚque standard de patrons pour C++. STL est empaquetée avec Greenstone afin d'être utilisée avec ces versions du compilateur.</Text>
213</Bullet>
214</BulletList>
215<Text id="69">Vous remarquerez que la procédure d'installation pour Windows ne tente pas de compiler Greenstone si vous choisissez d'installer le code source. Pour obtenir des instructions de compilation de Greenstone propres à votre plate-forme et à votre compilateur, voyez le fichier Install, placé dans le répertoire principal de Greenstone (<i>C:\Program Files\gsdl</i> par défaut) pendant la procédure d'installation.</Text>
216</Content>
217</Subsection>
218</Content>
219</Section>
220<Section id="unix">
221<Title>
222<Text id="70">Unix</Text>
223</Title>
224<Content>
225<Text id="71">La présente section s'adresse aux utilisateurs d'Unix; les utilisateurs de Windows auront avantage à consulter la section <CrossRef target="Section" ref="how_to_find_greenstone"/>. Il vous faut choisir d'installer le binaire ou le code source: le binaire occupe 50 méga-octets d'espace disque, et le code source a besoin de 160 méga-octets pour compiler.</Text>
226<Subsection id="unix_binaries">
227<Title>
228<Text id="72">Binaires Unix</Text>
229</Title>
230<Content>
231<Text id="73">Le binaire est prévu pour une distribution Linux pour puce Intel de type x86, avec support pour les binaires ELF. Voici des exemples de distributions qui remplissent ces conditions:</Text>
232<BulletList>
233<Bullet>
234<Text id="74">RedHat 5.1</Text>
235</Bullet>
236<Bullet>
237<Text id="75">SuSE Linux 6.1</Text>
238</Bullet>
239<Bullet>
240<Text id="76">Debian 2.1</Text>
241</Bullet>
242<Bullet>
243<Text id="77">Slackware 4.0</Text>
244</Bullet>
245</BulletList>
246<Text id="78">Cela devrait également être le cas de versions plus récentes de ces distributions.</Text>
247<Text id="79">Il vous faudra un serveur web: nous recommandons Apache. Nous recommandons aussi trÚs chaudement d'installer le serveur web <i>avant</i> d'installer Greenstone -- ceci facilitera grandement la réponse aux questions posées pendant la procédure d'installation de Greenstone. Si vous souhaitez construire de nouvelles collections de bibliothÚques numériques, il vous faudra également installer Perl, s'il est absent de votre systÚme. Pour savoir si Perl est installé, invoquez un terminal, tapez <i>perl -v</i>, et voyez si le message qui apparaît précise, entre autres choses, un numéro de version. Perl est installé par défaut dans la plupart des versions de Linux. L'annexe <CrossRef target="Chapter" ref="appendix_associated_software"/> donne des précisions sur la maniÚre d'obtenir Apache et Perl.</Text>
248</Content>
249</Subsection>
250<Subsection id="unix_source">
251<Title>
252<Text id="80">Code source Unix</Text>
253</Title>
254<Content>
255<Text id="81">Le code source est le même pour Windows et pour Unix. Il a été compilé et testé sous les systÚmes Linux, Solaris, et Macintosh OS/X; cela devrait être immédiat de le porter vers d'autres Unix.</Text>
256<Text id="82">Pour compiler le code source de Greenstone sous Unix, il vous faut:</Text>
257<BulletList>
258<Bullet>
259<Text id="83">GCC, le compilateur C++ de GNU;</Text>
260</Bullet>
261<Bullet>
262<Text id="84">GDBM, le gestionnaire de bases de données de GNU.</Text>
263</Bullet>
264</BulletList>
265<Text id="85">Pour faire fonctionner Greenstone, il vous faudra également un serveur web et le langage Perl, tel qu'expliqué ci-dessus dans la <i>Binaires Unix</i>.</Text>
266</Content>
267</Subsection>
268<Subsection id="unix_installation">
269<Title>
270<Text id="86">Installation sous Unix</Text>
271</Title>
272<Content>
273<Text id="87">Pour installer la version d'Unix du CD-ROM, insérer le disque dans la commande, et dactylographier</Text>
274<Table class="hidden" id="table_commands">
275<Title/>
276<TableContent>
277<tr>
278<th width="151">
279<CodeLine>mount /cdrom</CodeLine>
280</th>
281<th width="246">
282<Text id="88">monte le périphérique de cédéroms (cette commande peut changer d'un systÚme à l'autre; sous OS/X, par exemple, il suffit de se rendre, par la commande cd, dans le répertoire /Volumes et de se rendre ensuite dans le sous-répertoire approprié pour le cédérom)</Text>
283</th>
284</tr>
285<tr>
286<th width="151">
287<CodeLine>cd /cdrom</CodeLine>
288</th>
289<th width="246">
290<Text id="89">se déplace dans le répertoire principal du cédérom</Text>
291</th>
292</tr>
293<tr>
294<th width="151">
295<CodeLine>cd Unix</CodeLine>
296</th>
297<th width="246">
298<Text id="90">se déplace dans le répertoire abritant le script d'installation pour Unix</Text>
299</th>
300</tr>
301<tr>
302<th width="151">
303<CodeLine>sh Install.sh</CodeLine>
304</th>
305<th width="246">
306<Text id="91">exécute le processus d'installation (nous précisons explicitement le nom de l'interpréteur -- sh -- car de nombreuses installations interdisent l'exécution de programmes directement depuis le cédérom)</Text>
307</th>
308</tr>
309</TableContent>
310</Table>
311<Text id="92">Cette derniÚre commande entame un dialogue interactif dont le but est d'obtenir de vous les informations nécessaires à l'installation de Greenstone sur votre systÚme, et qui vous donne des informations détaillées sur les résultats des opérations effectuées.</Text>
312<Text id="93">La procédure d'installation commence par vous demander dans quel répertoire installer Greenstone. Le premier fichier qui y sera placé sera «uninstall», programme qui nettoiera toute installation partielle, au cas où vous rencontreriez des problÚmes ou mettriez fin prématurément à la procédure d'installation. Vous choisirez ensuite si vous souhaitez installer les binaires ou le code source, puis viennent des questions relatives à la configuration de votre serveur web. Vous devez disposer d'un répertoire où stocker des scripts CGI exécutables (communément appelé «cgi-bin» dans les systÚmes Unix); vous pouvez en créer un nouveau ou utiliser celui qui existe déjà. Si vous en créez un nouveau, il vous faudra en informer votre serveur web par le truchement de son fichier de configuration. Dans chacun de ces deux cas de figure, il vous faudra saisir l'adresse web du répertoire CGI. Le dialogue d'installation vous guidera au travers de tous ces choix. Il est important de mettre en place des droits d'accÚs corrects à certains répertoires, et on vous demandera les informations nécessaires. Enfin, on vous demandera le mot de passe de l'utilisateur en charge de l'administration systÚme de Greenstone.</Text>
313<Text id="94">Par défaut, Greenstone s'installe dans le répertoire <i>/usr/local/gsdl</i> si c'est l'utilisateur root qui effectue l'installation, et dans le répertoire <i>/gsdl</i> dans le cas contraire, où «» dénote le répertoire personnel de l'utilisateur concerné.</Text>
314<Text id="95">L'installation des binaires ne prend que quelques minutes, juste assez pour vous laisser le temps de répondre aux questions appropriées. Si vous installez le code source, le script d'installation procédera à sa compilation, opération qui peut prendre de 10 minutes à une heure ou plus, en fonction de la vitesse de votre processeur.</Text>
315<Text id="96">Pour désinstaller le logiciel, tapez:</Text>
316<CodeLine>cd ~/gsdl</CodeLine>
317<Text id="97">ou <i>/usr/local/gsdl</i> si c'est l'utilisateur root qui a installé Greenstone</Text>
318<CodeLine>sh Uni nstall.sh</CodeLine>
319<Text id="98">Pendant la procédure d'installation, on vous demandera si vous souhaitez installer des collections Greenstone. La collection Greenstone «Demo» est installée automatiquement; les autres collections du cédérom sont décrites en section <CrossRef target="Chapter" ref="greenstone_collections"/>.</Text>
320</Content>
321</Subsection>
322<Subsection id="unix_webserver_configuration">
323<Title>
324<Text id="99">Configuration de serveur web sous Unix</Text>
325</Title>
326<Content>
327<Text id="100">Si vous disposez déjà d'un serveur web, il faudra y apporter quelques modifications pour rendre votre installation de Greenstone opérationnelle. Le script d'installation détaille ces modifications. Vous aurez peut-être besoin d'un administrateur systÚme pour reconfigurer le serveur web -- votre administrateur systÚme devrait comprendre les instructions fournies par le script d'installation. Pour votre confort, la sortie du script d'installation est consignée dans un fichier appelé INSTALL_RECORD et situé dans le répertoire d'installation de Greenstone.</Text>
328<Text id="101">Si vous ne disposez pas déjà d'un serveur web, il vous faudra en installer un. L'annexe <CrossRef target="Chapter" ref="appendix_associated_software"/> fournit des informations relatives à Apache. Il vous faudra ensuite le configurer de maniÚre appropriée. La section <CrossRef target="Chapter" ref="setting_up_webserver"/> détaille les portions de l'installation d'un serveur web qui concernent Greenstone, et comment il faut les modifier. Tout revient à ajouter une petite dizaine de lignes à un fichier de configuration.</Text>
329<Text id="102">Nul besoin d'effectuer la procédure d'installation ci-dessus détaillée sous l'identifiant «root». Cependant, de tels privilÚges peuvent être nécessaires pour modifier un serveur Apache existant -- tout dépend de sa configuration. Si vous installez Apache vous-même, vous pouvez procéder en tant que simple utilisateur, sans utiliser de privilÚges réservés à «root». Dans le cas où vous avez affaire à un administrateur systÚme réticent, vous pourrez toujours contourner la difficulté en installant un deuxiÚme serveur web Apache sur votre ordinateur -- même si un tel serveur est déjà installé.</Text>
330</Content>
331</Subsection>
332</Content>
333</Section>
334<Section id="how_to_find_greenstone">
335<Title>
336<Text id="103">Où trouver Greenstone</Text>
337</Title>
338<Content>
339<Subsection id="local_library_windows_only">
340<Title>
341<Text id="104">BibliothÚque locale (seulement pour Windows)</Text>
342</Title>
343<Content>
344<Text id="105">Si vous utilisez la bibliothÚque locale, il suffit d'invoquer le programme <i>«Greenstone»</i> depuis le menu <i>Démarrer</i>. Ceci démarrera automatiquement le navigateur web et chargera la page d'accueil de la bibliothÚque numérique Greenstone, d'où la collection «Demo» de Greenstone devrait être accessible.</Text>
345</Content>
346</Subsection>
347<Subsection id="web_library_windows_and_unix">
348<Title>
349<Text id="106">BibliothÚque Web (Windows et Unix)</Text>
350</Title>
351<Content>
352<Text id="107">Si vous utilisez la bibliothÚque web, utilisez l'URL suivante pour entrer sur le systÚme Greenstone, aprÚs avoir installé le logiciel et configuré le serveur web:</Text>
353<Text id="108"><i>http://localhost/gsdl/cgi-bin/library</i></Text>
354<Text id="109">La collection «Demo» de Greenstone devrait être accessible depuis cette page.</Text>
355</Content>
356</Subsection>
357<Subsection id="the_collector">
358<Title>
359<Text id="110">Le Collector</Text>
360</Title>
361<Content>
362<Text id="111">Un lien menant vers le Collector est fourni sur la page d'accueil de la bibliothÚque numérique.</Text>
363</Content>
364</Subsection>
365<Subsection id="administration">
366<Title>
367<Text id="112">Administration</Text>
368</Title>
369<Content>
370<Text id="113">Un lien menant vers les pages d'administration est fourni sur la page d'accueil de la bibliothÚque numérique. L'utilisateur en charge de l'administration s'appelle <i>«admin»</i>, et vous avez dû spécifier son mot de passe pendant le processus d'installation. L'administrateur a le droit d'ajouter de nouveaux utilisateurs et de construire des collections.</Text>
371</Content>
372</Subsection>
373</Content>
374</Section>
375<Section id="the_greenstone_librarian_interface_(gli)">
376<Title>
377<Text id="114">l'Interface Bibliothécaire de Greenstone (GLI)</Text>
378</Title>
379<Content>
380<Text id="115">Greenstone "Librarian Interface" (l'Interface Bibliothécaire de Greenstone) (GLI) est un outil d'assistance à la mise sur pied de bibliothÚques numériques utilisant Greenstone. Il vous donne accÚs à la fonctionnalité de création de collection Greenstone, à partir d'une interface commode "pointer et cliquer".</Text>
381<Text id="116">GLI est installé automatiquement avec toutes les distributions de Greenstone. Il est placé dans le sous-répertoire <i>"gli"</i> du répertoire racine de Greenstone (C:\Program Files\gsdl\gli, par défaut). Il faut noter qu'il fonctionne conjointement avec Greenstone et ne le fera correctement que s'il est placé dans un sous répertoire de votre installation Greenstone. Et ce sera le cas si on a téléchargé une des distributions de Greenstone.</Text>
382<Text id="117">Pour utiliser "GLI", l'ordinateur doit disposer de l'environnement "JAVA Runtime". Si tel n'est pas le cas, l'installation propose une version incluse dans le CD-ROM. Dans Unix, on doit s'assurer que PERL est installé (pour Windows, Perl est déjà inclus dans le logiciel Greenstone ). PriÚre signaler à greenstone@cs.waikato.ac.nz tout problÚme intervenu dans l'exécution ou l'utilisation du "Librarian Interface" (Interface Bibliothécaire).</Text>
383<Subsection id="running_under_windows">
384<Title>
385<Text id="118">Exécution sous Windows</Text>
386</Title>
387<Content>
388<Text id="119">Pour exécuter "GLI" sous Windows, parcourir le répertoire <i>gli</i> dans votre installation Greenstone (par exemple en utilisant l'explorateur de Windows), et double-cliquer sur le fichier appelé <i>gli.bat</i>. Ce fichier vérifie que Greenstone, l'environnement Java Runtime et Perl sont tous installés, et démarre "Greenstone Librarian Interface" (l'Interface Bibliothécaire de Greenstone).</Text>
389</Content>
390</Subsection>
391<Subsection id="running_under_unix">
392<Title>
393<Text id="120">Exécution sous Unix</Text>
394</Title>
395<Content>
396<Text id="121">Pour exécuter GLI sous Unix, passer au répertoire <i>gli</i> de votre installation Greenstone, et ensuite exécuter le script <i>gli.sh</i>. Ce script vérifie que Greenstone, l'environnement Java Runtime et Perl sont tous installés et sont sur votre chemin de recherche, et démarre "Greenstone Librarian Interface" (l'Interface Bibliothécaire de Greenstone).</Text>
397</Content>
398</Subsection>
399<Subsection id="getting_help">
400<Title>
401<Text id="122">Obtenir de l'aide</Text>
402</Title>
403<Content>
404<Text id="123">"Greenstone Librarian Interface" (l'Interface Bibliothécaire de Greenstone) a en ligne des fonctions d'aide étendues. On peut obtenir de l'aide en cliquant sur le bouton <i>Help</i> situé en haut à droite de l'écran. Ceci ouvre le texte sur une section qui traite de ce qu'on est en train de faire, d'un des panneaux utilisés. On peut parcourir le texte d'aide et s'informer sur ce qu'on cherche. Utilisez-le.</Text>
405</Content>
406</Subsection>
407<Subsection id="compiling_gli">
408<Title>
409<Text id="124">Compiler le l'Interface Bibliothécaire de Greenstone</Text>
410</Title>
411<Content>
412<Text id="125">Si on a téléchargé une distribution source de Greenstone, le code source Java de "Greenstone Librarian Interface" (l'Interface Bibliothécaire de Greenstone) est mis à disposition. Pour le compiler, l'ordinateur doit avoir un kit de développement Java. L'appendice <CrossRef target="Chapter" ref="appendix_associated_software"/> fournit l'information sur la maniÚre de l'obtenir. Pour compiler le code source, exécuter les fichiers <i>makegli.bat</i> (Windows) ou <i>makegli.sh</i> (Unix). Une fois compilé, vous pouvez exécuter GLI comme décrit ci-dessus.</Text>
413</Content>
414</Subsection>
415</Content>
416</Section>
417<Section id="testing_and_troubleshooting">
418<Title>
419<Text id="126">Tests et diagnostics</Text>
420</Title>
421<Content>
422<Text id="127">Pour tester Greenstone, pointez votre navigateur web vers la page d'accueil de Greenstone afin d'explorer la collection «Demo» ou toute autre collection installée. Pas d'inquiétude -- vous ne pouvez rien casser. Cliquez partout et sans crainte: la plupart des images qui apparaîtront sur votre écran réagissent aux clics. Si vous maintenez le pointeur de la souris au-dessus d'une image, la plupart des navigateurs afficheront un message qui vous expliquera ce qui se passera si vous cliquez. Faites l'expérience! Choisissez des mots communs tels que «le» (the) ou «et» (and) en tant que critÚres de recherche -- voilà qui devrait fournir des réponses, et vous ne pourrez rien casser. Pour plus d'informations à ce sujet, consultez le <i>Guide de l'utilisateur de la bibliothÚque numérique Greenstone</i>.</Text>
423<Subsection id="troubleshooting">
424<Title>
425<Text id="128">Diagnostics et remÚdes</Text>
426</Title>
427<Content>
428<Table id="table_troubleshooting">
429<Title/>
430<TableContent>
431<tr>
432<th width="132"/>
433<th width="151">
434<Text id="129"><b>ProblÚme</b></Text>
435</th>
436<th width="246">
437<Text id="130"><b>Essayez ceci</b></Text>
438</th>
439</tr>
440<tr>
441<th width="132">
442<Text id="131">BIBLIOTHÈQUE LOCALE (SEULEMENT POUR WINDOWS)</Text>
443</th>
444<th width="151">
445<Text id="132">Quand je démarre Greenstone, mon ordinateur me demande de me connecter à mon fournisseur d’accÚs Internet par téléphone.</Text>
446</th>
447<th width="246">
448<Text id="133">Cliquez sur le bouton<i>Annuler</i>de la boîte de dialogue. Ceci résout généralement ce problÚme.</Text>
449</th>
450</tr>
451<tr>
452<th width="132"/>
453<th width="151">
454<Text id="134">Quand je démarre Greenstone, mon ordinateur me demande<i>encore</i>de me connecter à mon fournisseur d’accÚs Internet par téléphone.</Text>
455</th>
456<th width="246">
457<Text id="135">Choisissez la «version restreinte» lorsque vous démarrez Greenstone. Cette version ne fonctionne qu’avec Netscape.</Text>
458</th>
459</tr>
460<tr>
461<th width="132"/>
462<th width="151">
463<Text id="136">Quand je pointe mon navigateur vers la bibliothÚque numérique, il ne trouve pas la page d’accueil.</Text>
464</th>
465<th width="246">
466<Text id="137">Vérifiez vos réglages de mandataire (<i>proxy</i>) Internet et désactivez ces derniers (utilisez<i>Éditer les préférences</i>pour Netscape ou<i>Options Internet</i>pour Internet Explorer).</Text>
467</th>
468</tr>
469<tr>
470<th width="132"/>
471<th width="151">
472<Text id="138">Le Collector me semble fonctionner trÚs lentement!</Text>
473</th>
474<th width="246">
475<Text id="139">Utilisez-vous Netscape sous Windows 2000 ? Si c’est le cas, essayez plutÃŽt d’employer Internet Explorer — sousWindows 2000 (et seulement sous ce systÚme), il semble y avoir une incompatibilité avec Netscape.</Text>
476</th>
477</tr>
478<tr>
479<th width="132">
480<Text id="142">BIBLIOTHÈQUE WEB (WINDOWS ET UNIX)</Text>
481</th>
482<th width="151">
483<Text id="143">Quand je démarre Apache, il termine immédiatement.</Text>
484</th>
485<th width="246">
486<Text id="144">Ajoutez une directive ServerName localhost dans le fichier de configuration d’Apache (voyez à ce sujet la section <CrossRef target="Section" ref="apache_web_server"/>).</Text>
487</th>
488</tr>
489<tr>
490<th width="132"/>
491<th width="151">
492<Text id="145">Quand je pointe mon navigateur vers la bibliothÚque numérique, il affiche n’importe quoi — un fichier binaire.</Text>
493</th>
494<th width="246">
495<Text id="146">Vérifiez la directive ScriptAlias dans le fichier de configuration d’Apache, et assurez-vous qu’elle précÚde la directive Alias (voyez à ce sujet la section 4.1).</Text>
496</th>
497</tr>
498<tr>
499<th width="132"/>
500<th width="151">
501<Text id="147">J’obtiens bien la page d’accueil de Greenstone de la figure <CrossRef target="Figure" ref="your_greenstone_home_page"/>, mais l’icone de la collection «Demo» n’apparaît pas.</Text>
502</th>
503<th width="246">
504<Text id="148">Exécutez le programme library, situé dans le répertoire cgi-bin, depuis l’interpréteur de commandes de DOS ou du shell, afin d’obtenir des informations de débogage qui vous aideront à mieux localiser le problÚme.</Text>
505</th>
506</tr>
507<tr>
508<th width="132">
509<Text id="149">LES DEUX VERSIONS</Text>
510</th>
511<th width="151">
512<Text id="150">Quand je pointe mon navigateur vers la bibliothÚque numérique, il ne trouve pas la page d’accueil.</Text>
513</th>
514<th width="246">
515<Text id="151">Essayez d’utiliser la chaîne 127.0.0.1 en lieu et place de localhost. Ce numéro IP réservé correspond à une «boucle de retour» (<i>loopback</i>) vers votre ordinateur local.</Text>
516</th>
517</tr>
518<tr>
519<th width="132"/>
520<th width="151">
521<br/>
522<Text id="152">Mon navigateur se plaint de ne pas trouver le fichier main.cfg.</Text>
523</th>
524<th width="246">
525<Text id="153">Vérifiez que les fichiers de Greenstone existent bien et sont lisibles par tous. Si vous utilisez la bibliothÚque web, essayez d’exécuter le programme library depuis l’interpréteur de commandes. S’il s’exécute sans heurts, le problÚme est à chercher du cÃŽté des permissions de fichiers (voir à ce sujet la section <CrossRef target="Section" ref="file_permissions"/>). Dans le cas contraire, la variable GSDLHOME a probablement reçu une valeur incorrecte dans le fichier de configuration gsdlsite.cfg (voir à ce sujet la section <CrossRef target="Section" ref="gsdlsite_configuration_file"/>).</Text>
526</th>
527</tr>
528<tr>
529<th width="132"/>
530<th width="151">
531<Text id="154">J’ai des soucis avec le Collector.</Text>
532</th>
533<th width="246">
534<Text id="155">Lisez le <i>Guide de l’utilisateur de la bibliothÚque numérique Greenstone</i>, section <CrossRef external="User" lang="fr" target="Chapter" ref="making_greenstone_collections"/>.</Text>
535</th>
536</tr>
537<tr>
538<th width="132"/>
539<th width="151">
540<Text id="156">J’ai ajouté un nouvel utilisateur mais il ne semble pas pouvoir se connecter.</Text>
541</th>
542<th width="246">
543<Text id="157">Vérifier que le répertoire <i>C:\Program Files\gsdl\etc</i> ainsi que tous les fichiers qu’il contient sont inscriptibles par tous (voir à ce sujet la section <CrossRef target="Section" ref="file_permissions"/>).</Text>
544</th>
545</tr>
546</TableContent>
547</Table>
548</Content>
549</Subsection>
550</Content>
551</Section>
552<Section id="learn_more">
553<Title>
554<Text id="158">Pour en savoir plus</Text>
555</Title>
556<Content>
557<Text id="159">Pour en savoir plus sur les entrailles de votre installation de Greenstone, consultez le <i>Guide du développeur de la bibliothÚque numérique Greenstone</i>. Il comprend, entre autres choses, les détails de la structure arborescente de répertoires qui a été mise en place, ainsi que des informations sur la maniÚre de configurer votre site Greenstone.</Text>
558</Content>
559</Section>
560</Content>
561</Chapter>
562<Chapter id="greenstone_collections">
563<Title>
564<Text id="160">Les collections de Greenstone</Text>
565</Title>
566<Content>
567<Text id="161">Plusieurs collections de démonstration de Greenstone sont inclus dans le CD-ROM. Si vous avez un accÚs web, beaucoup d'autres peuvent être téléchargés sous forme finie ou non, à partir du site web de la "New Zealand Digital Library Project (<i>nzdl.org</i>)".</Text>
568<Text id="162">La collection de démonstration de Greenstone est un petit composant de "Humanity Development Library (HDL)", une collection bien entretenue. Elle illustre le fait que des possibilités de navigation relativement riches peuvent être fournies (aussi longtemps qu'une méta-donnée appropriée est disponible). Elle est automatiquement incluse à l'installation du logiciel.</Text>
569<Text id="163">Greenstone vient aussi avec quelques exemples de collections bien documentées dont la page "about" décrit la maniÚre avec laquelle ils ont été élaborés. Ils démontrent diverses possibilités de Greenstone. La boîte de dialogue "install" vous proposera de les inclure ou non dans l'installation de Greenstone; l'espace disque approximatif nécessaire à chaque collection est indiqué ci-dessous.</Text>
570<Table class="hidden" id="table_collections">
571<Title/>
572<TableContent>
573<tr>
574<th width="60">
575<Text id="164"><i>demo</i></Text>
576</th>
577<th width="182">
578<Text id="165">Démonstration de Greenstone (7 MO)</Text>
579</th>
580<th width="294">
581<Text id="166">Une petite composante de HDL. Si vous clonez cette collection, la totalité des fonctions n’apparaîtra que si vos nouveaux fichiers fournissent l’information méta-donnée appropriée.</Text>
582</th>
583</tr>
584<tr>
585<th width="60">
586<Text id="167"><i>dls-e</i></Text>
587</th>
588<th width="182">
589<Text id="168">Sous-ensemble de la collection BibliothÚque de Développement (150 MO)</Text>
590</th>
591<th width="294">
592<Text id="169">A l’instar de "Greenstone Demo", c’est une composante de HDL, mais plus grande. Elle contient 250 livres de publications, rapports et magazines dans divers domaines du développement humain (la totalité de HDL contient 1230 publications). Elle a la même structure que "Greenstone Demo". Elle est assez complexe et si on est tout juste débutant, il serait peut-être préférable de consulter d’abord d’autres collections (Exemple : <i>démonstration MS Word et PDF</i>, les <i>archives Greenstone</i>, ou la <i>collection "simple image"</i>).</Text>
593</th>
594</tr>
595<tr>
596<th width="60">
597<Text id="170"><i>wrdpdf-e</i></Text>
598</th>
599<th width="182">
600<Text id="171">Démonstration MSWord et PDF (4 MO)</Text>
601</th>
602<th width="294">
603<Text id="172">Elle contient des documents en PDF, MS Word, RTF, et des formats Postscript, qui attestent de la possibilité de former des collections à partir de documents de différents formats. Le fichier de configuration de la collection est trÚs simple.</Text>
604</th>
605</tr>
606<tr>
607<th width="60">
608<Text id="173"><i>gsarch-e</i></Text>
609</th>
610<th width="182">
611<Text id="174">Collection des Archives de Greenstone (5 MO)</Text>
612</th>
613<th width="294">
614<Text id="175">Une collection de messages e-mail à partir des archives de listes d’adresses de Greenstone, elle utilise le plugin e-mail qui analyse les fichiers en formats e-mail. Le fichier de configuration de la collection est trÚs simple.</Text>
615</th>
616</tr>
617<tr>
618<th width="60">
619<Text id="176"><i>cltbib-e</i></Text>
620</th>
621<th width="182">
622<Text id="177">Collection bibliographie (7 MO)</Text>
623</th>
624<th width="294">
625<Text id="178">Avec environ 4000 entrées bibliographiques, cette collection incorpore une interface de recherche basée sur un formulaire qui permet une recherche par champ. Elle est assez complexe.</Text>
626</th>
627</tr>
628<tr>
629<th width="60">
630<Text id="179"><i>cltext-e</i></Text>
631</th>
632<th width="182">
633<Text id="180">Supplément bibliographie (1 MO)</Text>
634</th>
635<th width="294">
636<Text id="181">Cette petite collection de 10 entrées bibliographiques illustre la fonction "supercollection" qui recherche plusieurs collections à la fois. Elle fonctionne avec la collection <i>bibliographie</i> et son fichier de configuration est presque le même.</Text>
637</th>
638</tr>
639<tr>
640<th width="60">
641<Text id="182"><i>MARC-e</i></Text>
642</th>
643<th width="182">
644<Text id="183">Exemple MARC (1 MO)</Text>
645</th>
646<th width="294">
647<Text id="184">Basé sur quelques enregistrements Marc de la Librairie du CongrÚs, c’est est une collection simple (et ne permet pas une recherche basée sur formulaire).</Text>
648</th>
649</tr>
650<tr>
651<th width="60">
652<Text id="185"><i>oai-e</i></Text>
653</th>
654<th width="182">
655<Text id="186">Démo OAI (18 MO)</Text>
656</th>
657<th width="294">
658<Text id="187">En utilisant la caractéristique "Open Archive Protocol" et <i>"Import Form"</i>, elle extrait des méta-données d’une archive et confectionne une collection à partir des enregistrements. Dans ce cas, ce sont des images ; ainsi, aussi bien les plugins OAI que les images sont utilisés.</Text>
659</th>
660</tr>
661<tr>
662<th width="60">
663<Text id="188"><i>image-e</i></Text>
664</th>
665<th width="182">
666<Text id="189">Collection d’images simple (1 MO)</Text>
667</th>
668<th width="294">
669<Text id="190">Cette collection d’images simples standard ne contient aucun texte et aucune métadonnée explicite, ce qui la rend plutÃŽt irréaliste. Le fichier de configuration est tout aussi simple et accessible.</Text>
670</th>
671</tr>
672<tr>
673<th width="60">
674<Text id="191"><i>authen-e</i></Text>
675</th>
676<th width="182">
677<Text id="192">Démonstration de formatage et d’authentification (8 MO)</Text>
678</th>
679<th width="294">
680<Text id="193">Avec le même matériel que la collection de démonstration Greenstone originale, elle affiche deux caractéristiques indépendantes : le formatage de document non-standard et l’accÚs contrÃŽlé aux documents par le biais d’une authentification de l’utilisateur.</Text>
681</th>
682</tr>
683<tr>
684<th width="60">
685<Text id="194"><i>garish</i></Text>
686</th>
687<th width="182">
688<Text id="195">Version Garish de la collection de démonstration (8 MO)</Text>
689</th>
690<th width="294">
691<Text id="196">Cette collection contient aussi le même matériel que la collection de démonstration Greenstone. Sa présentation a été altérée pour montrer comment les pages générées peuvent être affichées différemment. Elle dépend d’un fichier macro non standard qui est fourni avec Greenstone.</Text>
692</th>
693</tr>
694<tr>
695<th width="60">
696<Text id="197"><i>isis-e</i></Text>
697</th>
698<th width="182">
699<Text id="198">Exemple CDS/ISIS (1 MO)</Text>
700</th>
701<th width="294">
702<Text id="199">Cette collection est construite a partir des données CDS/ISIS de quelques 150 entrées bibliographiques. Elle utilize le plugin ISISPlug, qui lit les fichiers standards ISIS .mst et .fdt et les convertit en metadonnées de Greenstone.</Text>
703</th>
704</tr>
705</TableContent>
706</Table>
707</Content>
708</Chapter>
709<Chapter id="setting_up_webserver">
710<Title>
711<Text id="200">Configuration du serveur web</Text>
712</Title>
713<Content>
714<Text id="201">Nous décrivons dans cette section la maniÚre de configurer votre serveur web pour qu'il fonctionne avec Greenstone. Toutes ces précisions sont inutiles à qui utilise la bibliothÚque locale sous Windows, car le logiciel fonctionne alors «tel que», sans nécessiter un serveur web.</Text>
715<Text id="202">Nous traiterons à la fois le cas du serveur web Apache, qui est librement disponible pour Windows comme pour Unix (reportez-vous à l'annexe <CrossRef target="Chapter" ref="appendix_associated_software"/> pour plus de détails à ce sujet), et des serveurs web «Personal Web Server (PWS)» et «Internet Information Services (IIS)» de Microsoft. PWS est le serveur web standard fourni par Microsoft pour Windows 95/98; IIS est celui des versions 2000 et XP de Windows. Windows NT peut utiliser chacun de ces deux serveurs. La description concernant Apache s'applique aussi à la bibliothÚque web, versions Windows comme Unix (bien que nous utilisions les terminologies et chemins d'accÚs propres à Windows). La section PWS/IIS ne s'applique qu'à la bibliothÚque web sous Windows.</Text>
716<Text id="203">AprÚs avoir installé le serveur web, il faut installer Greenstone. Nous supposerons que lors de la procédure d'installation, vous avez choisi l'action par défaut à chaque étape, en cliquant sur le bouton Suivant. Au final, vous disposez d'un répertoire CProgram Filesgsdl contenant le binaire de la bibliothÚque web, ainsi que quelques fichiers complémentaires.</Text>
717<Text id="204">Tous les serveurs web utilisent l'URL spéciale «localhost» pour représenter l'ordinateur sur lequel le serveur fonctionne. C'est pourquoi, lors de l'installation d'un serveur web, vous pourrez accéder à vos documents HTML en tapant l'URL http://localhostdans un navigateur. Si votre ordinateur possÚde un nom dans le DNS (ou systÚme de noms), c'est ce nom qui sera utilisé en lieu et place de «localhost» pour identifier votre ordinateur depuis des sites distants. C'est ainsi que sur l'ordinateur de la bibliothÚque numérique de Nouvelle-Zélande, les URL <i>http://nzdl.org</i> et <i>http://localhost</i> sont équivalentes. Si vous tapez <i>http://nzdl.org</i> sur votre ordinateur, vous accéderez au serveur web de la bibliothÚque numérique de Nouvelle-Zélande, alors que si vous tapez <i>http://localhost</i> vous accéderez au serveur web de votre propre ordinateur.</Text>
718<Section id="apache_web_server">
719<Title>
720<Text id="205">Le serveur web Apache</Text>
721</Title>
722<Content>
723<Text id="206">Le serveur web Apache est généralement installé dans le répertoire <i>C:\Program Files\Apache Group\Apache</i>, et il est configuré de sorte que son répertoire cgi-bin soit dans le sous-répertoire <i>cgi-bin</i> et que le répertoire racine des documents corresponde au sous-répertoire <i>htdocs</i>. On peut modifier sa configuration en éditant le fichier de configuration situé sous <i>C:\Program Files\Apache Group\Apache\conf\httpd.conf</i>. Ce fichier étant un fichier texte, il est trÚs facile à lire et de voir comment les choses sont configurées.</Text>
724<Text id="207">En fonction de la configuration des logiciels de communication en réseau de votre ordinateur, vous devrez peut-être ajouter la ligne suivante au fichier de configuration <i>httpd.conf</i> de votre serveur Apache:</Text>
725<CodeLine>ServerName localhost</CodeLine>
726<Text id="208">En l'absence de cette ligne, le systÚme tentera de déterminer le nom de votre serveur. Cependant, des bogues présents dans certaines versions de Windows font échouer cette opération. Dans un tel cas de figure, Apache sort immédiatement lorsqu'on le démarre. Il affiche bien un message d'erreur, mais ce dernier est tout de suite effacé et vous n'aurez probablement pas le temps de le lire.</Text>
727<Subsection id="setting_up_cgi-bin_directory">
728<Title>
729<Text id="209">Mettre en place le répertoire cgi-bin de Greenstone</Text>
730</Title>
731<Content>
732<Text id="210">Le répertoire cgi-bin est celui où le serveur web traite les documents en tant que programmes à exécuter. On utilise la directive <i>ScriptAlias</i> d'Apache pour créer un répertoire cgi-bin. Vous remarquerez que cette directive permet de transformer n'importe quel répertoire en répertoire d'exécutables CGI -- nul besoin pour le répertoire de s'appeler «cgi-bin»! De même, un répertoire appelé «cgi-bin» ne joue aucun rÎle particulier en l'absence de directive <i>ScriptAlias</i> le concernant.</Text>
733<Text id="211">Une fois installé, Apache possÚde le répertoire cgi-bin suivant: <i>C:\Program Files\Apache Group\Apache\cgi-bin</i>. Ceci signifie que si on lui fournit l'URL <i>http://localhost/cgi-bin/bonjour</i>, le serveur web tentera d'exécuter un fichier bonjour situé dans le répertoire précédent.</Text>
734<Text id="212">Greenstone comprend un programme, appelé «library.exe», qui doit être exécuté par le serveur web: il lit alors un fichier appelé le «fichier de configuration de site de Greenstone», ou «gsdlsite.cfg», qui doit se trouver dans le même répertoire.</Text>
735<Text id="213">La meilleure maniÚre d'obtenir ce résultat est d'utiliser la directive <i>ScriptAlias</i> d'Apache pour créer un nouveau répertoire cgi-bin. Voici l'extrait du fichier de configuration d'Apache, <i>httpd.conf</i>, qui ajoute le répertoire <i>C:\Program Files\gsdl\cgi-bin</i> à la liste des répertoires de type cgi-bin:</Text>
736<CodeLine>ScriptAlias /gsdl/cgi-bin/ "C:/Program Files/gsdl/cgi-bin/"</CodeLine>
737<CodeLine>&lt;Directory C:/Program Files/gsdl/cgi-bin&gt;</CodeLine>
738<CodeLine> Options None</CodeLine>
739<CodeLine> AllowOverride None</CodeLine>
740<CodeLine>&lt;/Directory&gt;</CodeLine>
741<Text id="214">Vous remarquerez que les fichiers de configuration d'Apache utilisent des barres de division ((forward) slash) en lieu et place des barres obliques inversées (backslash), communes sous Windows.</Text>
742<Text id="215">Ceci signifie que toutes les URL de la forme <i>http://localhost/gsdl/cgi-bin...</i> seront recherchées dans le répertoire de chemin CProgram Filesgsdlcgi-bin et exécutées par le serveur web. Par exemple, si on lui demande l'URL <i>http://localhost/gsdl/cgi-bin/bonjour</i>, le serveur web tentera de lire <i>C:\Program Files\gsdl\cgi-bin\bonjour</i>, et de l'exécuter. Mais l'URL <i>http://localhost/cgi-bin/bonjour</i> continuera comme avant à examiner le répertoire cgi-bin d'Apache à la recherche de <i>C:\Program Files\Apache Group\Apache\cgi-bin\bonjour</i>, pour exécuter ce fichier.</Text>
743</Content>
744</Subsection>
745<Subsection id="document_root_directory">
746<Title>
747<Text id="216">Le répertoire racine des documents</Text>
748</Title>
749<Content>
750<Text id="217">Le répertoire racine des documents est la racine de la structure arborescente des répertoires de votre serveur web. Lors de son installation, Apache dispose comme racine de documents du répertoire de chemin <i>C:\Program Files\Apache Group\Apache\htdocs</i>. Cela signifie que si on lui demande l'URL <i>http://localhost/bonjour.html</i>, le serveur web tentera de lire un fichier appelé <i>bonjour.html</i> dans le répertoire ci-dessus.</Text>
751<Text id="218">Greenstone contient plusieurs fichiers qu'il faut que le serveur web lise. La maniÚre la plus simple de procéder est d'utiliser la directive Alias, qui ressemble à <i>ScriptAlias</i> à ceci prÚs qu'elle s'applique aux pages web normales, et pas aux scripts CGI. Insérez les lignes suivantes dans le fichier de configuration de votre Apache, aprÚs la directive <i>ScriptAlias</i>, afin d'ajouter le répertoire <i>C:\Program Files\gsdl</i> comme lieu de recherche de documents.</Text>
752<CodeLine>Alias /gsdl/ "C:/Program Files/gsdl/"</CodeLine>
753<CodeLine>&lt;Directory C:/Program Files/gsdl&gt;</CodeLine>
754<CodeLine> Options Indexes MultiViews FollowSymLinks</CodeLine>
755<CodeLine> AllowOverride None</CodeLine>
756<CodeLine> Order allow,deny</CodeLine>
757<CodeLine> Allow from all</CodeLine>
758<CodeLine>&lt;/Directory&gt;</CodeLine>
759<Text id="219">Ceci signifie que toute URL correspondant au premier argument de la directive Alias (gsdl) est recherchée sous la forme de fichiers situés dans le répertoire donné en deuxiÚme argument. En d'autres termes, une URL de la forme http://localhost/gsdl/... aura pour effet la recherche de fichiers dans le répertoire CProgram Filesgsdl. Si par exemple on fournit au serveur web l'URL http://localhost/gsdl/bonjour.html, il tentera de rechercher le fichier CProgram Filesgsdlbonjour.html. Mais l'URL http://localhost/bonjour.htmlcontinuera comme avant à examiner le répertoire htdocs normal d'Apache à la recherche du fichier CProgram FilesApache GroupApachehtdocsbonjour.html.</Text>
760<Text id="220">Assurez-vous d'ajouter la directive Alias aprÚs la directive ScriptAlias. Définir auprÚs d'Apache l'alias/gsdlavant l'alias/gsdl/cgi-binreconnaîtrait l'URL/gsdl/cgi-bin/libraryavec la directive Alias et non pas avec la directive ScriptAlias, et cette URL serait interprétée comme une requête de document au lieu d'une requête du résultat de l'exécution d'un programme. On obtiendrait alors l'«affichage» du fichier binaire du programme en tant que page web dans le navigateur web, sans jamais l'avoir exécuté.</Text>
761</Content>
762</Subsection>
763<Subsection id="security">
764<Title>
765<Text id="221">Sécurité</Text>
766</Title>
767<Content>
768<Text id="222">Gardez à l'esprit le fait que si la version «bibliothÚque web» de Greenstone est configurée en suivant les instructions données ci-dessus, n'importe qui aura le droit de télécharger tout fichier situé dans la structure arborescente de répertoire démarrant sous gsdl. Ceci comprend les fichiers d'indexation, les documents source de toute collection que vous construirez, la base de données utilisateur, les journaux d'utilisation, etc.</Text>
769<Text id="223">Si vous souhaitez éviter cela, vous pouvez facilement resserrer la configuration de votre serveur web afin d'en augmenter la sécurité. Dans le cas du serveur web Apache, remplacez les lignes données dans la section précédente par les lignes suivantes dans le fichier de configuration:</Text>
770<CodeLine>Alias /gsdl/ "C:/Program Files/gsdl/"</CodeLine>
771<CodeLine>&lt;Directory "C:/Program Files/gsdl"&gt;</CodeLine>
772<CodeLine> Order allow,deny</CodeLine>
773<CodeLine> Deny from all</CodeLine>
774<CodeLine> &lt;FilesMatch</CodeLine>
775<CodeLine>"\.(gif|jpe?g|png|css|mov|mpeg|ps|pdf|doc|rtf|jar|class)$"&gt;</CodeLine>
776<CodeLine> Order allow,deny</CodeLine>
777<CodeLine> Allow from all</CodeLine>
778<CodeLine> &lt;/FilesMatch&gt;</CodeLine>
779<CodeLine>&lt;/Directory&gt;</CodeLine>
780<Text id="224">Ceci aura pour effet de n'autoriser en téléchargement que les fichiers dont le nom vérifie l'expression rationnelle donnée dans la ligne <i>FilesMatch</i> (c'est-à-dire, dans le cas présent, de n'autoriser qu'une liste fixée d'extensions de noms de fichiers).</Text>
781</Content>
782</Subsection>
783</Content>
784</Section>
785<Section id="pws_and_iis_webservers">
786<Title>
787<Text id="225">Les serveurs web PWS et IIS</Text>
788</Title>
789<Content>
790<Text id="226">Bien qu'aucun de ces deux serveurs ne soit installé par défaut dans les systÚmes Windows actuels, on peut facilement les installer à l'aide du panneau de contrÎle Ajouter/Supprimer des programmes. Si vous ne les trouvez pas sur le cédérom de votre distribution de Windows, il vous faudra les télécharger depuis le site web de Microsoft (<i>www.microsoft.com</i>).</Text>
791<Text id="227">La procédure de mise en place de Greenstone est la même pour PWS et pour IIS. Invoquez le gestionnaire personnel de web et effectuez les actions suivantes:</Text>
792
793<NumberedList>
794<NumberedItem>
795<Text id="228">Sélectionnez Avancé pour obtenir l'écran d'Options Avancées.</Text>
796</NumberedItem>
797<NumberedItem>
798<Text id="229">Sélectionnez Accueil et cliquez sur Ajouter. Remplissez les champs comme suit:</Text>
799<Text id="230">Champ<i>Répertoire</i>:<i>C:\Program Files\gsdl</i></Text>
800<Text id="231">Champ<i>Alias</i>:<i>gsdl</i></Text>
801<Text id="232">Permissions d’accÚs:<i>Lecture</i></Text>
802<Text id="233">Permissions d’application:<i>Aucune</i></Text>
803<Text id="234">Cliquez sur OK.</Text>
804<Text id="235">Voilà qui rendra les fichiers de Greenstone accessibles au serveur web.</Text>
805</NumberedItem>
806<NumberedItem>
807<Text id="236">De retour dans l'écran d'Options avancées, sélectionnez gsdl et cliquez sur Ajouter. Remplissez les champs comme suit:</Text>
808<Text id="237">Champ<i>Répertoire</i>:<i>C:\Program Files\gsdl\cgi-bin</i></Text>
809<Text id="238">Champ<i>Alias</i>:<i>cgi-bin</i></Text>
810<Text id="239">Permissions d’accÚs:<i>Aucune</i></Text>
811<Text id="240">Permissions d’application:<i>Exécution</i></Text>
812<Text id="241">Cliquez sur OK.</Text>
813<Text id="242">Voilà qui rendra le programme library.exe de Greenstone exécutable par le serveur web.</Text>
814</NumberedItem>
815<NumberedItem>
816<Text id="243">Rendez-vous à l'URL http://localhost/cgi-bin/library.exe</Text>
817<Text id="244">Remarque: avec les serveurs PWS et IIS, il vous faut préciser l'extension de fichier .exe.</Text>
818</NumberedItem>
819</NumberedList>
820</Content>
821</Section>
822</Content>
823</Chapter>
824<Chapter id="configuring_your_site">
825<Title>
826<Text id="245">Configurer son site</Text>
827</Title>
828<Content>
829<Text id="246">Pour que Greenstone puisse fonctionner correctement, il faut mettre en place les droits d'accÚs à certains fichiers. On trouve aussi un fichier de configuration associé à chaque site Greenstone. La procédure d'installation crée un fichier de configuration générique qui repose sur les choix effectués durant l'installation, mais son contenu peut être adapté à différentes situations. La présente section détaille ces deux questions.</Text>
830<Section id="file_permissions">
831<Title>
832<Text id="247">Droits d'accÚs aux fichiers</Text>
833</Title>
834<Content>
835<Text id="248">La présente section ne concerne par les utilisateurs de Windows 95/98, car leurs systÚmes d'exploitation n'identifient pas les propriétaires des fichiers.</Text>
836<Text id="249">Sous Windows NT et 2000 ainsi que sous les systÚmes Unix, les scripts CGI ne sont pas exécutés avec des droits d'utilisateurs normaux, car il n'est pas possible d'identifier les utilisateurs sur le web. Ils sont plutÎt exécutés au nom de l'utilisateur qui a démarré le serveur web (sur les systÚmes de type Windows), ou au nom d'un utilisateur particulier (souvent appelé nobody sur les systÚmes Unix). C'est pourquoi tous les fichiers et répertoires contenus dans l'arborescence <i>C:\Program Files\gsdl</i> doivent être lisibles par tous (ou en tout cas lisibles par l'utilisateur des scripts CGI, qui peut être <i>nobody</i>). Pour tester la bonne mise en place des permissions sur les fichiers, exécutez le programme <i>library.exe</i> depuis l'interpréteur de commandes. Si les fichiers se trouvent aux bons endroits mais que les permissions sont incorrectes, il fonctionnera correctement depuis l'interpréteur de commandes. Cette situation est à comparer à l'exécution depuis un navigateur web, où il est alors exécuté avec les droits de l'utilisateur <i>nobody</i>, situation qui devrait échouer en cas de droits incorrects. Un autre test consiste à l'exécuter au nom d'un autre utilisateur aprÚs s'être connecté en tant que tel, pour vérifier si les droits d'accÚs aux fichiers sont spécifiques au compte utilisateur original.</Text>
837<Text id="250">Pour fonctionner depuis un navigateur web, tous les répertoires de Greenstone doivent être lisibles par tous. Le répertoire <i>C:\Program Files\gsdl\etc</i> et son contenu doivent de même être inscriptibles par tous. Il s'agit du répertoire où le programme library inscrira les journaux d'utilisation, d'erreur et d'initialisation, ainsi que diverses bases de données utilisateur. Si vous êtes réticent à rendre ce répertoire inscriptible par tous, mettez en place des permissions de sorte que seuls les fichiers <i>errout.txt, initout.txt, key.db, users.db, history.db</i>, et <i>usage.txt</i> soient inscriptibles par l'utilisateur CGI.</Text>
838<Text id="251">Si les droits d'accÚs sous le répertoire <i>C:\Program Files\gsdl\etc</i> sont incorrects, vous remarquerez peut-être que l'authentification des utilisateurs et la recherche dans l'historique ne fonctionneront pas, ainsi que l'absence de génération du journal d'utilisation (<i>usage.txt</i>).</Text>
839</Content>
840</Section>
841<Section id="gsdlsite_configuration_file">
842<Title>
843<Text id="252">Le fichier de configuration gsdlsite.cfg</Text>
844</Title>
845<Content>
846<Text id="253">La procédure d'installation crée un fichier de configuration de Greenstone générique qui repose sur les choix effectués durant l'installation. Dans le cas de notre installation c'est <i>C:\Program Files\gsdl\cgi-bin\gsdlsite.cfg</i>, dont voici le contenu:</Text>
847<CodeLine># Site configuration file for Greenstone.</CodeLine>
848<CodeLine># Lines begining with</CodeLine>
849<CodeLine># are comments.</CodeLine>
850<CodeLine># This file should be placed in the same directory as your library</CodeLine>
851<CodeLine># executable file. it should be edited to suit your site.</CodeLine>
852<CodeLine># points to the GSDLHOME directory</CodeLine>
853<CodeLine>gsdlhome “C:/Program Files/gsdl ”</CodeLine>
854<CodeLine># this is the http address of GSDLHOME</CodeLine>
855<CodeLine># if your webservers DocumentRoot is set to $GSDLHOME</CodeLine>
856<CodeLine># then httpprefix can be commented out</CodeLine>
857<CodeLine>httpprefix /gsdl</CodeLine>
858<CodeLine># this is the http address of the directory which</CodeLine>
859<CodeLine># contains the images for the interface.</CodeLine>
860<CodeLine>httpimg /gsdl/images</CodeLine>
861<CodeLine># should contain the http address of this cgi script. This</CodeLine>
862<CodeLine># is not needed if the http server sets the environment variable</CodeLine>
863<CodeLine># SCRIPT_NAME</CodeLine>
864<CodeLine>#gwcgi /cgi-bin/library</CodeLine>
865<CodeLine># maxrequests is the most requests a fastcgi process</CodeLine>
866<CodeLine># will serve before it exits. This can be set to a</CodeLine>
867<CodeLine># low figure (like 1) while debugging and then set</CodeLine>
868<CodeLine># to a high figure (like 10000) when everything is</CodeLine>
869<CodeLine># working well.</CodeLine>
870<CodeLine>#maxrequests 10000</CodeLine>
871<Text id="254">Vous pouvez personnaliser votre installation en éditant ce fichier, mais il est peu probable que vous en éprouviez le besoin.</Text>
872<Text id="255">La ligne <i>gsdlhome</i> pointe tout simplement vers le répertoire <i>C:\Program Files\gsdl</i>.</Text>
873<Text id="256"><i>httpprefix</i> est l'adresse web du répertoire où Greenstone est installé. Nous avons expliqué plus haut comment créer un alias de maniÚre que les URL de la forme <i>http://localhost/gsdl/...</i> soient recherchées dans le répertoire <i>C:\Program Files\gsdl</i>. Placer la ligne <i>httpprefix/gsdl</i> dans le fichier de configuration gsdlsite met en place les mêmes conventions pour le logiciel Greenstone.</Text>
874<Text id="257"><i>httpimg</i> est l'adresse web de <i>C:\Program Files\gsdl\images</i>, répertoire qui contient toutes les images (au format GIF) utilisées par l'interface. Dans toutes les installations standard de Greenstone ce sera <i>httpprefix/images</i>, et vous n'interviendrez pas sur cette ligne.</Text>
875<Text id="258"><i>gwcgi</i> est l'adresse web du programme CGI library. La plupart des serveurs web (dont Apache) n'en ont pas besoin, et cette ligne doit alors rester commentée, donc inactive. N'Îtez le commentaire que si vous êtes sûr de vous, car cela peut poser certains problÚmes.</Text>
876<Text id="259"><i>maxrequests</i> n'est utilisé que par les versions de Greenstone qui ont activé l'option «Fast-CGI» lors de la compilation. La distribution binaire standard n'inclut pas cette option, car tous les serveurs web ne sont pas configurés de maniÚre compatible. L'option «Fast-CGI» accélÚre l'exécution des scripts CGI en gardant l'exécutable principal en mémoire entre deux invocations du logiciel, au lieu de le charger depuis le disque dur à chaque requête d'une page web depuis le logiciel Greenstone. Le compromis à trouver est un équilibre avec la quantité de mémoire utilisée, qui peut augmenter si le programme demeure longtemps en mémoire. AprÚs la génération de <i>maxrequests</i> pages web, le programme CGI rend la main, libérant ainsi toute la mémoire accumulée. Pour répondre à la prochaine requête provoquée par une page web, le programme CGI est alors relu depuis le disque dur, et un nouveau cycle de requêtes de pages démarre. La plupart des installations utilisent le protocole standard CGI, ce qui signifie qu'on peut ignorer sans crainte le paramÚtre <i>maxrequests</i>.</Text>
877</Content>
878</Section>
879</Content>
880</Chapter>
881<Chapter id="personalizing">
882<Title>
883<Text id="260">Personnaliser son installation</Text>
884</Title>
885<Content>
886<Text id="261">La premiÚre chose que vous aurez probablement envie de faire aprÚs l'installation de Greenstone et la vérification de son bon fonctionnement, c'est de personnaliser la page d'accueil. Le fichier qui engendre la page d'accueil de Greenstone s'appelle <i>home.dm</i>, et se situe dans le sous-répertoire <i>macros</i> du répertoire où vous avez installé Greenstone. Pour les systÚmes Windows, la valeur par défaut est donc <i>C:\Program Files\gsdl\macros\home.dm</i>. C'est un fichier texte qu'il faudra éditer pour créer une nouvelle page d'accueil. Au lieu de l'éditer, nous recommandons de créer un nouveau fichier, disons <i>yourhome.dm</i> (chez moi). Ce fichier ressemblera au fichier <i>home.dm</i> mais définira le «paquetage home» -- la portion active -- un peu différemment.</Text>
887<Text id="262">Quand on met en place une autre page d'accueil, il faut pouvoir la relier d'une façon ou d'une autre aux pages de la bibliothÚque numérique de maniÚre à pouvoir effectuer des recherches et naviguer dans les collections sur votre systÚme. La solution adoptée par Greenstone est d'utiliser des «macros». C'est la raison pour laquelle le fichier correspondant à la page d'accueil a un nom qui se termine en «.dm» et non pas en «.html» -- c'est un fichier «de macros», et non pas un fichier HTML habituel. Pas d'inquiétude cependant: le fichier de macros ne contient que de l'HTML, entremêlé de quelques incantations mystiques expliquées ci-dessous. Le langage de macros regorge de potentialités puissantes, et nous n'en décrivons ici qu'une faible portion (reportez-vous au <i>Guide du développeur de la bibliothÚque numérique Greenstone</i> pour obtenir plus d'informations à son sujet).</Text>
888<Section id="example">
889<Title>
890<Text id="263">Exemple</Text>
891</Title>
892<Content>
893<Figure id="your_own_greenstone_home_page">
894<Title>
895<Text id="264">Votre propre page d'accueil de Greenstone</Text>
896</Title>
897<File width="395" height="227" url="images/Install_Fig_3.png"/>
898</Figure>
899<Text id="265">La figure <CrossRef target="Figure" ref="your_own_greenstone_home_page"/> montre un exemple d'une nouvelle page d'accueil pour la bibliothÚque numérique. Chacun des liens mentionnant «Cliquez ici» vous emmÚnera sur la portion correspondante de Greenstone. Cette page fut engendrée par le fichier <i>yourhome.dm</i>, présenté en figure <CrossRef target="Figure" ref="yourhome_dm"/>.</Text>
900<Figure id="yourhome_dm">
901<Title>
902<Text id="266">Fichier yourhome.dm utilisé pour créer la figure <CrossRef target="Figure" ref="your_own_greenstone_home_page"/></Text>
903</Title>
904<CodeLine>package home</CodeLine>
905<CodeLine>_content_ {</CodeLine>
906<CodeLine>&lt;h2&gt;Your own Greenstone home page&lt;/h2&gt;</CodeLine>
907<CodeLine>&lt;ul&gt;</CodeLine>
908<CodeLine>&lt;table&gt;</CodeLine>
909<CodeLine>&lt;tr valign=top&gt;&lt;td&gt;Search page for the demo collection&lt;br&gt;&lt;/td&gt;</CodeLine>
910<CodeLine> &lt;td&gt;&lt;a href="_httpquery_&amp;c=demo"&gt;Click here&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
911<CodeLine>&lt;tr&gt;&lt;td&gt;"About" page for the demo collection&lt;/td&gt;</CodeLine>
912<CodeLine> &lt;td&gt;&lt;a href="_httppageabout_&amp;c=demo"&gt;Click here&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
913<CodeLine>&lt;tr&gt;&lt;td&gt;Preferences page for the demo collection&lt;/td&gt;</CodeLine>
914<CodeLine> &lt;td&gt;&lt;a href="_httppagepref_&amp;c=demo"&gt;Click here&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
915<CodeLine>&lt;tr&gt;&lt;td&gt;Home page&lt;/td&gt;</CodeLine>
916<CodeLine> &lt;td&gt;&lt;a href="_httppagehome_"&gt;Click here&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
917<CodeLine>&lt;tr&gt;&lt;td&gt;Help page&lt;/td&gt;</CodeLine>
918<CodeLine> &lt;td&gt;&lt;a href="_httppagehelp_"&gt;Click here&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
919<CodeLine>&lt;tr&gt;&lt;td&gt;Administration page&lt;/td&gt;</CodeLine>
920<CodeLine> &lt;td&gt;&lt;a href="_httppagestatus_"&gt;Click here&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
921<CodeLine>&lt;tr&gt;&lt;td&gt;The Collector&lt;/td&gt;</CodeLine>
922<CodeLine> &lt;td&gt;&lt;a href="_httppagecollector_"&gt;Click here&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;</CodeLine>
923<CodeLine>&lt;/table&gt;</CodeLine>
924<CodeLine>&lt;/ul&gt;</CodeLine>
925<CodeLine>}</CodeLine>
926<CodeLine># if you hate the squirly green bar down the left-hand side of the</CodeLine>
927<CodeLine># page, uncomment these lines:</CodeLine>
928<CodeLine># _header_ {</CodeLine>
929<CodeLine># }</CodeLine>
930</Figure>
931<Text id="267">Vous pouvez utiliser la figure <CrossRef target="Figure" ref="yourhome_dm"/> comme un patron pour créer votre propre page d'accueil de Greenstone. Pour simplifier, il définit une macro «content», et les accolades renferment de l'HTML ordinaire, ainsi que toute commande de mise en forme HTML, pour inclure le contenu que vous souhaitez voir apparaître sur la page. Le texte étant de l'HTML standard, vous pouvez si vous le souhaitez inclure des liens hypertexte et utiliser toutes les autres fonctionnalités du HTML.</Text>
932<Text id="268">Pour relier votre nouvelle page d'accueil à d'autres pages de la bibliothÚque numérique, vous devrez utilisez une formule magique appropriée. Dans ce langage de macros, les formules magiques sont entourées de caractÚres de soulignement -- vous pouvez en voir dans la figure <CrossRef target="Figure" ref="yourhome_dm"/>. Par exemple,<i>_httppagehome_</i>vous emmÚne sur la page d'accueil,<i>_httppagehelp_</i>vers la page d'aide, etc. Dans certains cas il vous faudra préciser le nom d'une collection. La chaîne qui suit,<i>_httpquery_&amp;c=demo</i>, donne la page de recherche pour la collection «Demo»; dans le cas d'autres collections vous remplacerez la chaîne «<i>demo</i>» par le nom de la collection désirée.</Text>
933<Text id="269">La macro<i>_content_</i>contient directement du HTML. On peut placer n'importe quel code HTML dans une définition de macro. Cependant, les caractÚres spéciaux<i>{</i>,<i>}</i>,<i>\</i>, et<i>_</i>devront être précédés d'une barre oblique inversée (backslash, c'est-à-dire «») pour leur éviter d'être interprétés par l'interpréteur du langage de macros.</Text>
934<Text id="270">Vous remarquerez que la définition de macro<i>_content_</i>ne contient ni en-tête ni pied de page HTML. Si vous souhaitez intervenir sur ces éléments dans votre page d'accueil, ce sont les macros<i>_header_</i>et/ou<i>_footer_</i>qu'il vous faudra personnaliser respectivement, en les ajoutant à votre fichier yourhome.dm sous la forme</Text>
935<CodeLine>_macroname_ {</CodeLine>
936<CodeLine>...</CodeLine>
937<CodeLine>}</CodeLine>
938<Text id="271">Par exemple, la barre verte ondulante sur la gauche des pages Greenstone est définie dans la macro<i>_header_</i>, et elle disparaîtra si on déclare cette macro comme étant vide, comme indiqué à la fin de la figure <CrossRef target="Figure" ref="yourhome_dm"/>.</Text>
939</Content>
940</Section>
941<Section id="how_to_make_it_work">
942<Title>
943<Text id="272">Mise en place</Text>
944</Title>
945<Content>
946<Text id="273">Il faut informer Greenstone de l'existence de la nouvelle page d'accueil, de nom <i>yourhome.dm</i>. Le systÚme charge les fichiers de macros spécifiés dans le fichier de configuration principal <i>main.cfg</i>, c'est pourquoi il faut y indiquer tout nouveau fichier créé. Les collisions de noms sont gérées comme on pourrait s'y attendre: les définitions les plus récentes ont la priorité.</Text>
947<Text id="274">Ainsi, pour faire en sorte que le logiciel de bibliothÚque numérique Greenstone utilise la page d'accueil de la figure <CrossRef target="Figure" ref="your_own_greenstone_home_page"/> en lieu et place de la page par défaut, il faut commencer par placer le fichier <i>yourhome.dm</i> de la figure <CrossRef target="Figure" ref="yourhome_dm"/> dans le répertoire <i>macros</i>. Il faut ensuite éditer le fichier de configuration <i>main.cfg</i> et y remplacer <i>home.dm</i> par <i>yourhome.dm</i> dans la liste des fichiers de macros chargés au démarrage.</Text>
948</Content>
949</Section>
950<Section id="redirecting_a_url_to_greenstone">
951<Title>
952<Text id="275">Renvoyer une URL vers Greenstone</Text>
953</Title>
954<Content>
955<Text id="276">Vous éprouverez peut-être l'envie de rediriger une URL plus pratique vers le CGI de Greenstone. Sur notre systÚme, par exemple, l'URL <i>http://nzdl.org</i> (qui est un raccourci pour <i>http://nzdl.org/index.html</i>) est renvoyée vers <i>http://nzdl.org/cgi-bin/library</i>. C'est la directive Redirect qui s'occupe de cela pour le serveur web Apache. Comme les autres directives, elle prend place dans le fichier de configuration <i>C:\Program Files\Apache Group\Apache\conf\httpd.conf</i>. Pour renvoyer l'URL <i>http://www.monserveur.com</i> vers <i>http://www.monserveur.com/cgi-bin/library</i>, ajoutez la ligne suivante dans le fichier <i>httpd.conf</i>:</Text>
956<CodeLine>Redirect /index.html http://www.yourserver.com/cgi-bin/library</CodeLine>
957<Text id="277">Vous pourrez ensuite atteindre votre systÚme de bibliothÚque numérique directement depuis l'URL <i>http://www.monserveur.com</i>. Si vous souhaitez plutÎt que ce soit l'URL <i>http://www.monserveur.com/greenstone</i> qui soit renvoyée vers <i>http://www.monserveur.com/cgi-bin/library</i>, c'est la ligne suivante qu'il faudra inclure dans le fichier <i>httpd.conf</i>:</Text>
958<CodeLine>Redirect /greenstone http://www.yourserver.com/cgi-bin/library</CodeLine>
959<Text id="278">Si votre ordinateur ne dispose pas de nom dans le DNS (ou systÚme de noms), tel que «www.monserveur.com» dans l'exemple donné ci-dessus, il suffit de remplacer <i>www.monserveur.com</i> par <i>localhost</i> dans toutes les lignes d'exemple. Tant que le navigateur et le serveur web fonctionnent sur la même machine -- ce qui est sûrement le cas si votre ordinateur ne dispose pas de nom dans le DNS -- l'effet obtenu sera exactement le même.</Text>
960<Text id="279">Au lieu de placer les directives de redirection dans le fichier <i>httpd.conf</i>, on peut tout aussi bien les placer dans un fichier appelé <i>.htaccess</i>, et placé dans le répertoire racine des documents du serveur web. Cette solution présente même deux avantages sur la précédente. D'abord, les modifications apportées au fichier <i>.htaccess</i> sont immédiatement actives, alors qu'il faut redémarrer le serveur web Apache pour observer les effets de changements apportés au fichier <i>httpd.conf</i>. Ensuite, il faut généralement être connecté en tant que l'utilisateur «root» sur les systÚmes Unix pour pouvoir éditer le fichier <i>httpd.conf</i>, mais ce n'est souvent pas le cas du fichier <i>.htaccess</i>.</Text>
961</Content>
962</Section>
963</Content>
964</Chapter>
965<Chapter id="appendix_associated_software">
966<Title>
967<Text id="280">Logiciels associés</Text>
968</Title>
969<Content>
970<Text id="281">Voici comment obtenir les paquetages logiciels mentionnés dans ce document.</Text>
971<Section id="apache_webserver">
972<Title>
973<Text id="282">Le serveur web Apache</Text>
974</Title>
975<Content>
976<Text id="283">Toutes les versions de Greenstone, à l'exception de la version bibliothÚque locale pour Windows, requiÚrent un serveur web externe. De nombreuses installations, et en particulier les plus volumineuses, disposeront déjà d'un serveur web. Si vous utilisez Linux, Apache se trouve peut-être sur votre cédérom sans avoir été sélectionné lors de la procédure d'installation. Le serveur web Apache, disponible à l'URL <i>www.apache.org</i>, est libre et facile à installer.</Text>
977</Content>
978</Section>
979<Section id="perl">
980<Title>
981<Text id="284">Perl</Text>
982</Title>
983<Content>
984<Text id="285">Pour construire des collections avec Greenstone il faut disposer du langage Perl, version 5 ou ultérieure. Dans le cas des systÚmes Windows, nous recommandons ActivePerl, disponible surwww.activestate.com. La plupart des systÚmes Unix disposeront déjà d'une installation de Perl mais dans le cas contraire, vous en trouverez le code source ainsi que des binaires pour de nombreuses plates-formes Unix, le tout librement téléchargeable, à l'URL <i>www.perl.com</i>.</Text>
985</Content>
986</Section>
987<Section id="gcc">
988<Title>
989<Text id="286">GCC</Text>
990</Title>
991<Content>
992<Text id="287">La version Unix de Greenstone se compile avec le compilateur C++ de GNU, GCC. Greenstone utilise intensivement la bibliothÚque standard de patrons pour C++, STL (nous avons remarqué qu'elle était cassée sur d'anciennes versions GCC; veuillez nous signaler tout problÚme relatif à STL que vous rencontreriez). Prenez note du fait que cette version de Greenstone ne compilera pas avec la version 3.0 de GCC.</Text>
993</Content>
994</Section>
995<Section id="gdbm">
996<Title>
997<Text id="288">GDBM</Text>
998</Title>
999<Content>
1000<Text id="289">Toutes les versions de Greenstone utilisent GDBM, le gestionnaire de bases de données de GNU. Il est fourni avec toutes les versions Windows de Greenstone et installé automatiquement pendant la procédure d'installation. Les systÚmes Linux en disposant déjà, nous ne le fournissons pas pour ces derniers. La plupart des autres systÚmes Unix en disposent, mais si nécessaire vous pourrez le télécharger depuis l'URL <i>www.gnu.org</i>.</Text>
1001</Content>
1002</Section>
1003<Section id="java_runtime_environment">
1004<Title>
1005<Text id="290">Environnement Java Runtime</Text>
1006</Title>
1007<Content>
1008<Text id="291">Pour utiliser "Greenstone Librarian Interface" (l'Interface Bibliothécaire de Greenstone), il est nécessaire de disposer d'une version appropriée de Java Runtine Environment. Si on n'en dispose pas, une version appropriée est incluse dans le CD-ROM; le cas échéant, le téléchargement de la derniÚre version est possible à partir de http://java.sun.com/j2se/downloads.html. La version 1.4.0 ou supérieure est requise.</Text>
1009</Content>
1010</Section>
1011<Section id="java_compiler">
1012<Title>
1013<Text id="292">Compilateur Java</Text>
1014</Title>
1015<Content>
1016<Text id="293">Pour compiler le code source de l'Interface du Bibliothécaire Greenstone, vous devez d'abord installer un Java Development Toolkit. Vous pouvez télécharger J2SE (Software Development Kit) de l'URL http://java.sun.com/j2se/downloads.html. La version 1.4.0 or supérieur est nécessaire.</Text>
1017</Content>
1018</Section>
1019</Content>
1020</Chapter>
1021</Manual>
Note: See TracBrowser for help on using the repository browser.