root/collections/documented-examples/trunk/garish-e/etc/collect.cfg @ 19115

Revision 19115, 56.3 KB (checked in by kjdon, 11 years ago)

changed paths for style.css, and changed example links from dls-e to demo

  • Property svn:executable set to *
Line 
1creator     greenstone@cs.waikato.ac.nz
2maintainer  greenstone@cs.waikato.ac.nz
3public      true
4
5buildtype   mgpp
6searchtypes plain,form
7
8indexes     text dls.Title,Title dls.Subject dls.Organization dls.Keyword
9
10levels  section document
11
12plugin  GreenstoneXMLPlugin
13plugin  HTMLPlugin -description_tags
14plugin  MetadataXMLPlugin
15plugin  ArchivesInfPlugin
16plugin  DirectoryPlugin
17
18classify    List -metadata dls.Title
19
20classify    Hierarchy -metadata "dls.Subject" -sort dls.Title
21
22classify    List -sort_leaf_nodes_using dls.Title -metadata dls.Organization -bookshelf_type always
23
24classify    List -metadata dls.Keyword -buttonname Howto
25
26format CL4VList "<td>[link][icon][/link]</td><td>[link][dls.Keyword][/link]"
27
28format SearchVList "<td valign=top>[link]<img src='[DocImage]' height='21'>[/link]</td><td>{If}{[parent(All\': \'):Title],[parent(All\': \'):Title]:}[link][Title][/link]</td>"
29
30format VList "<td valign=top>[link][icon][/link]</td><td valign=top>[highlight]{Or}{[Title],Untitled}[/highlight]{If}{[Date],<br><small><i>_textdate_[Date]</i></small>}{If}{[NumPages],<br><small><i>_textnumpages_[NumPages]</i></small>}{If}{[Source],<br><small><i>_textsource_[Source]</i></small>}</td>"
31
32format DocumentText "<h3>[Title]</h3>\\n\\n<p>[Text]</p>"
33format DocumentImages true
34format DocumentButtons "Expand Text|Expand Contents|Highlight|Detach|Print"
35format DocumentSearchResultLinks true
36
37format HList "[link][highlight][Title][/highlight][/link]"
38
39format DocumentHeading "{Or}{[parent(Top):Title],[Title],untitled}<br>"
40
41format SearchTypes "plain,form"
42
43# -- English strings ----------------
44collectionmeta  collectionname [l=en] "Garish version of demo collection"
45
46collectionmeta  .text [l=en] "text"
47collectionmeta  .dls.Title,Title [l=en] "titles"
48collectionmeta  .dls.Subject [l=en] "subjects"
49collectionmeta  .dls.Organization [l=en] "organizations"
50collectionmeta  .dls.Keyword [l=en] "how to"
51
52collectionmeta  .document [l=en] "book"
53collectionmeta  .section [l=en] "chapter"
54
55collectionmeta  depositormetadata [l=en] "{\"name\":\"dls.Title\",\"label\":\"Title\",\"tooltip\":\"dls.Title: The title of this resource.\",\"type\":\"text\"}, {\"name\":\"dls.Organization\",\"label\":\"Organization\",\"tooltip\":\"dls.Organization: The organization responsible for producing this resource.\",\"type\":\"text\"}, {\"name\":\"dls.Subject\",\"label\":\"Subject\",\"tooltip\":\"dls.Subject: The subject of this resource.\",\"type\":\"text\"}, {\"name\":\"dls.Keyword\",\"label\":\"Keyword\",\"tooltip\":\"dls.Keyword: A more specific indication of what the resource can be used for.\",\"type\":\"text\"}, {\"name\":\"dls.Language\",\"label\":\"Language\",\"tooltip\":\"dls.Language: The language of this resource.\",\"type\":\"text\"}"
56
57# -- French strings ----------------
58collectionmeta  collectionname [l=fr] "Version Garish de la collection de démonstration"
59
60collectionmeta  .text [l=fr] "texte"
61collectionmeta  .dls.Title,Title [l=fr] "titres"
62collectionmeta  .dls.Subject [l=fr] "sujets"
63collectionmeta  .dls.Organization [l=fr] "organisations"
64collectionmeta  .dls.Keyword [l=fr] "comment faire"
65collectionmeta  .document [l=fr] "livre"
66collectionmeta  .section [l=fr] "châpitre"
67
68# -- Spanish strings ----------------
69collectionmeta  collectionname [l=es] "Versión Garish de la colección de muestra"
70
71collectionmeta  .text [l=es] "texo"
72collectionmeta  .dls.Title,Title [l=es] "títulos"
73collectionmeta  .dls.Subject [l=es] "temas"
74collectionmeta  .dls.Organization [l=es] "organizaciones"
75collectionmeta  .dls.Keyword [l=es] "cómo"
76collectionmeta  .document [l=es] "libro"
77collectionmeta  .section [l=es] "capítulo"
78
79# -- Russian strings ----------------
80collectionmeta  collectionname [l=ru] "Резкая версОя ЎеЌПМстрацОПМ-МПй кПллекцОО"
81
82collectionmeta  .text [l=ru] "текст"
83collectionmeta  .dls.Title,Title [l=ru] "загПлПвкО"
84collectionmeta  .dls.Subject [l=ru] "указателО"
85collectionmeta  .dls.Organization [l=ru] "ПргаМОзацОО"
86collectionmeta  .dls.Keyword [l=ru] "спПсПбы"
87collectionmeta  .document [l=ru] "кМОга"
88collectionmeta  .section [l=ru] "глава"
89
90# -- Arabic strings ----------------
91
92collectionmeta  .text [l=ar] "نص"
93collectionmeta  .dls.Title,Title [l=ar] "العناوين"
94collectionmeta  .dls.Subject [l=ar] "الموضوعات"
95collectionmeta  .dls.Organization [l=ar] "المن؞مات"
96collectionmeta  .dls.Keyword [l=ar] "إر؎اد"
97collectionmeta  .document [l=ar] "كتاؚ"
98collectionmeta  .section [l=ar] "فصل"
99
100# -- Brazilian Portuguese strings ----------------
101
102collectionmeta  .text [l=pt-br] "texto"
103collectionmeta  .dls.Title,Title [l=pt-br] "títulos"
104collectionmeta  .dls.Subject [l=pt-br] "assuntos"
105collectionmeta  .dls.Organization [l=pt-br] "organizações"
106collectionmeta  .dls.Keyword [l=pt-br] "como fazer"
107collectionmeta  .document [l=pt-br] "livro"
108collectionmeta  .section [l=pt-br] "capítulo"
109
110# -- Thai strings ----------------
111collectionmeta  .text [l=th] "àž‚à¹‰àž­àž„àž§àž²àž¡"
112collectionmeta  .dls.Title,Title [l=th] "àžŠàž·à¹ˆàž­à¹€àž£àž·à¹ˆàž­àž‡"
113collectionmeta  .dls.Subject [l=th] "àž«àž±àž§à¹€àž£àž·à¹ˆàž­àž‡"
114collectionmeta  .dls.Organization [l=th] "àž«àž™à¹ˆàž§àž¢àž‡àž²àž™"
115collectionmeta  .dls.Keyword [l=th] "àž§àžŽàž˜àžµà¹ƒàžŠà¹‰"
116
117collectionmeta  .document [l=th] "àž«àž™àž±àž‡àžªàž·àž­"
118collectionmeta  .section [l=th] "àžšàž—"
119
120# -- Simplified Chinese strings ----------------
121collectionmeta  .text [l=zh] "文本"
122collectionmeta  .dls.Title,Title [l=zh] "题名"
123collectionmeta  .dls.Subject [l=zh] "䞻题"
124collectionmeta  .dls.Organization [l=zh] "机构"
125collectionmeta  .dls.Keyword [l=zh] "劂䜕"
126
127collectionmeta  .document [l=zh] "乊"
128collectionmeta  .section [l=zh] "ç« "
129
130# -- English text ----------------
131collectionmeta  collectionextra [l=en] "This demonstration collection contains the same material as the original Greenstone demo collection, but its appearance has been altered to look garish.\n
132
133<h3>How the collection works</h3>\n
134
135<p> 
136The appearance of Greenstone collections is defined by \"macro files\" in the
137<i>greenstone/macros</i> directory, and can be completely altered by changing the contents of these files.
138Editing them will change the appearance of all collections. To change the appearance of just one collection, place appropriately modified macros in a file called <i>extra.dm</i> in the collection's <i>macros</i> directory. For example, this collection uses the file <a href=\"_httpcollection_/macros/extra.dm\">greenstone/collect/_cgiargc_/macros/extra.dm</a>. \n
139<p>
140To separate presentation details from the macro files,
141Greenstone uses <i>Cascading Style Sheets</i>
142(see <a href=\"http://www.w3.org/Style/CSS/\">http://www.w3.org/Style/CSS/</a> for
143more information), which allow you to specify fonts, colours, spacings, and
144other elements for HTML pages. The standard Greenstone stylesheet is located in <a href=\"_httpstyle_/style.css\">greenstone/web/style/style.css</a>. This collection specifies an auxiliary stylesheet, <a href=\"_httpcstyle_/style.css\">greenstone/collect/_cgiargc_/style/style.css</a>, to be used in addition to the default ones. It includes some comments
145for those unfamiliar with cascading style sheets. Some of the
146macros in <i>extra.dm</i> reference images that have been placed in
147<i>greenstone/collect/_cgiargc_/images</i>.\n
148<p>
149The
150<a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
151macro file overrides some of the macros that Greenstone
152uses by default. In macro files, the \"\#\" character signals a comment line
153(<i>extra.dm</i> is commented to help explain what it does).
154Macros themselves are signalled by
155underscores, and they can reference other macros. This means that the
156content of a page can be split into many small chunks, and it can be
157difficult to work through the chain of which macro calls what. Fortunately,
158changes in macros (like changes in format strings) take effect immediately
159unless you are using the Greenstone local library server, in which case the
160server needs to be restarted. This makes it easy to experiment by editing
161the macro files.\n
162
163<p>
164Macros are grouped into \"packages\". But each package does not necessarily reside in
165a single file. The <i>Global</i> package, most of which is in file
166<a href=\"_httpprefix_/macros/base.dm\" target=macro>base.dm</a>
167(parts of it are also in the language-specific macro files such as
168<a href=\"_httpprefix_/macros/english.dm\" target=macro>english.dm</a> and
169<a href=\"_httpprefix_/macros/french.dm\" target=macro>french.dm</a>),
170contains default macros that can be overridden by macros in other packages. Here is the part
171of <i>extra.dm</i> that redefines global macros.
172<pre>
173##########################################################################\n
174package Global\n
175##########################################################################\n
176\n
177&#095;starthighlight&#095; {&lt;b&gt;}\n
178&#095;endhighlight&#095;   {&lt;/b&gt;}\n
179\n
180&#095;navbarspacer&#095; { \n
181&lt;br/&gt;\n
182&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
183&lt;br/&gt;\n
184}\n
185</pre>\n
186The values of <i>starthighlight</i> and <i>endhighlight</i> are used to
187highlight query terms when displaying a document. The default is to set the
188background to yellow. The first specification above places query terms in
189bold instead.\n
190
191<p>
192Next, the <i>navbarspacer</i> macro is what separates the search button and
193classifier buttons in the navigation bar. It is normally Greenstone\'s
194familiar horizontal green bar. The following definition has the effect of
195stacking the buttons vertically, one above the other.
196<pre>
197&#095;navbarspacer&#095; {&lt;br\/&gt;}
198</pre>\n
199
200 The definition of <i>navbarspacer</i> given earlier uses the image
201<i>horzline.gif</i> as a separator (this image appears in the
202<i>images</i> directory of the collection). The effect can be seen at the top of this page.\n
203
204<p>
205To arrange the buttons horizontally, still using
206<i>horzline.gif</i> instead of the green bar as separator,
207remove the <i>br</i> tags and define the body of the macro
208(the part in curly brackets) to be:
209<pre>
210&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
211   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
212</pre>\n
213
214The <i>widthtspace</i> variable gives the width of the gap between the
215buttons, which Greenstone calculates.\n
216
217<p>
218The part of <i>extra.dm</i> reproduced below redefines macros in the
219<i>Style</i> package, which is responsible for creating the header and
220footer of every page, and defining common style information:
221<pre>
222##########################################################################\n
223package Style\n
224##########################################################################\n
225\n
226
227&#095;collectionspecificstyle&#095; {\n
228&lt;link rel=\"stylesheet\" href=\"&#095;httpcstyle&#095;/style.css\" type=\"text/css\" \n
229   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
230&lt;style&gt;\n
231body.bgimage \\\{ background-image: none; \\\}\n
232a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
233&lt;/style&gt;\n
234}\n
235\n
236&#095;pagebanner&#095; {\n
237&lt;div class=\"pageinfo\"&gt; \n
238&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
239&lt;/div&gt;\n
240}\n
241</pre>\n
242
243Greenstone\'s page header macro, which is called <i>header</i> in
244<a href=\"_httpprefix_/macros/style.dm\" target=macro>style.dm</a>,
245prints the collection\'s name or logo, and links to the
246home, help, and preferences pages. It calls the macro <i>htmlhead</i> which
247outputs the beginning of an HTML file. This calls the macro <i>cssheader</i> which outputs style information for the page. This macro includes the <i>collectionspecificstyle</i> macro which allows a collection to add some style elements to the default.
248
249<p>To use an entirely new style for the collection, specify the <i>cssheader</i> macro in <i>extra.dm</i>. To just add just a few style declarations to the default style, specify <i>collectionspecificstyle</i> in <i>extra.dm</i>. That is what this collection has done. The above <i>collectionspecificstyle</i> macro includes the collection's own stylesheet, and also overrides a couple of the image declarations, getting rid of the green swirly bar background, and changing the hover background for navigation bar buttons to blue.
250
251<p>
252 The page header macro also calls <i>pagebanner</i> to include the collection\'s logo,
253home/help/preferences buttons, and the image at the top left that
254identifies the page (about page, search page, etc). The code above
255redefines the banner to suppress all these images except for the home page button -- as you can see, they don\'t appear
256at the top of this page.\n
257
258<p>
259The next part of <i>extra.dm</i> redefines macros in the <i>about</i>
260package (contained in
261<a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>), which generates the
262\"About this collection\" page that you are looking at now:
263<pre>
264##########################################################################\n
265package about\n
266##########################################################################\n
267\n
268&#095;content&#095; {\n
269&#095;navigationbar&#095;\n
270\n
271&#095;textabout&#095;\n
272\n
273&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
274&#095;help:simplehelp&#095;\n
275}
276</pre>\n
277
278The macro <i>content</i> for the <i>About</i> page normally contains the
279navigation bar (with links to <i>Search</i> and any classifiers),
280followed by \"About this collection\" and \"how to find information\"
281text. Because it changes from one collection to another, the
282<i>navigationbar</i> macro is defined internally by Greenstone, and uses
283the <i>navbarspacer</i> macro discussed above. The <i>content</i> macro for
284the <i>About</i> page, given above, differs from the regular one
285(such as the one for the demo collection <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=p&p=about\">here</a>)
286in that the navigation bar is not centered, and there is no search box.\n
287
288<p>
289The next part of <i>extra.dm</i> redefines macros in the <i>query</i> package (in
290<a href=\"_httpprefix_/macros/query.dm\" target=macro>query.dm</a>),
291which is used to generate the
292<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">search page</a>:
293<pre>
294##############################################################################\n
295package query\n
296##############################################################################\n
297
298&#095;content&#095; {\n
299&#095;navigationbar&#095;\n
300\n
301&lt;center&gt;\n
302&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
303&lt;/center&gt;\n
304&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
305&lt;center&gt;\n
306&#095;searchhistorylist&#095;\n
307&lt;/center&gt;)\n
308&#095;If&#095;(&#095;cgiargq&#095;,&lt;small&gt;&#095;freqmsg&#095; &#095;textpostprocess&#095;&lt;/small&gt;&lt;br&gt;&#095;resultline&#095;,)\n
309&lt;br&gt;\n
310}\n
311</pre>\n
312
313The definition of <i>content</i> in the standard <i>query</i> package is
314similar to the version given above, except that it centers the
315<i>navigationbar</i> macro, whereas the above version does not, and it
316includes an additional green bar. Compare
317<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">this</a>
318and
319<a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=q\">this</a>.\n
320
321<p>
322The file
323<a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
324also redefines macros in the <i>document</i> package,
325which is used to display documents (see
326<a href=\"_httpprefix_/macros/document.dm\" target=macro>document.dm</a>). In fact, pages
327generated by classifiers (e.g. lists of titles) are also governed by these macros.
328<pre>
329##########################################################################\n
330package document\n
331##########################################################################\n
332\n
333&#095;textheader&#095; {\n
334&#095;cgihead&#095;\n
335&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
336}\n
337\n
338&#095;content&#095; {\n
339&#095;navigationbar&#095;\n
340\n
341&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
342&lt;p style=\"text-align: center;\"&gt;\n
343&#095;phindclassifier&#095;\n
344&#095;collageclassifier&#095;\n
345&lt;/p&gt;\n
346)\n
347\n
348&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
349&lt;ul id=\"searchresults\"&gt;\n
350&#095;prevsearchresult&#095;\n
351&#095;nextsearchresult&#095;\n
352&lt;/ul&gt;)\n
353\n
354&lt;div class=\"document\"&gt;\n
355}\n
356</pre>\n
357
358Greenstone overrides the <i>header</i> macro if a document (and not a
359classifier) is being displayed. Suppose we don\'t want it to. The code
360above redefines the <i>textheader</i> macro (normally defined in
361<i>document.dm</i>) to be the content of the original <i>header</i> macro. The definition of <i>content</i> above overrides the
362default so that the navigation bar is not centered.
363"
364
365
366# -- French text ----------------
367collectionmeta  collectionextra [l=fr] "
368Cette collection de démonstration contient le même matériel que la collection de démontration originale de Greenstone, mais son apparence a été altéré pour avoir une allure criarde.
369
370<h3>Comment la collection marche</h3>
371
372<p>
373L'apparence des collections Greenstone est définie par des \"fichiers de macros\" dans le répertoire <i>greenstone/macros</i> et elle peut être complÚtement modifiée en changeant le contenu de ces fichiers. L' édition de ceux-ci changera l' apparence de toutes les collections.Pour changer l' apparence d' une seule collection, il faut placer correctement les macros modifiés dans un fichier appelé <i>extra.dm</i> dans le répertoirede la collection <i>macros</i>. Par exemple, cette collection utilise le fichier <a href=\"_httpcollection_/macros/extra.dm\">greenstone/collect/_cgiargc_/macros/extra.dm</a>. \n
374<p>
375Pour séparer certains détails de présentation des fichiers de macros, Greenstone utilise <i>Cascading Style Sheets</i>(voir <a href=\"http://www.w3.org/Style/CSS/\">http://www.w3.org/Style/CSS/</a> pour plus d' information), ce qui vous permet de spécifier la police, les couleurs, les espaces, et autres éléments pour les pages HTML. Le 'stylesheet' de Greenstone standardisé est alloqué dans <a href=\"_httpstyle_/style.css\">greenstone/web/style/style.css</a>. Cette collection spécifie un 'stylesheet' auxiliaire, <a href=\"_httpcstyle_/style.css\">greenstone/collect/_cgiargc_/style/style.css</a>, à être utilisé à part ceux du défaut. Ceci inclus quelques commentaires qui ont été placés dans <i>greenstone/collect/_cgiargc_/images</i>.\n
376<p>
377Le fichier de macros <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
378l'emporte sur certaines des macros que Greenstone utilise par défaut. Dans des fichiers de macros, le caractÚre \"\#\" signale une ligne de commentaire(<i>extra.dm</i> est commenté pour expliquer ce qu'il fait). Les macros elles-mêmes sont signalées par des caractÚres \"souligné\" (\"_\") et elles peuvent référencer d'autres macros. Ceci signifie que le contenu d'une page peut être éclaté en plusieurs petits morceaux et il peut être difficile de retrouver dans la chaîne et de savoir quelle macro appelle quoi. Heureusement, des modifications dans des macros (comme des modifications dans les chaînes de format) prennent effet immédiatement, à moins que vous n'utilisiez le serveur de bibliothÚque locale de Greenstone; dans ce cas, le serveur doit être redémarré. Ceci rend facile l'expérimentation en éditant les fichiers de macros.
379
380<p>
381Les macros sont regroupées en \"paquetages\". Mais chaque paquetage ne réside pas forcément dans un fichier unique. Le paquetage <i>Global</i>, dont la majeure partie réside dans le fichier
382<a href=\"_httpprefix_/macros/base.dm\" target=macro>base.dm</a> (d'autres parties se trouvent aussi dans les fichiers de macros spécifiques aux langues, comme <a href=\"_httpprefix_/macros/english.dm\" target=macro>english.dm</a> et <a href=\"_httpprefix_/macros/french.dm\" target=macro>french.dm</a>),
383contient des macros par défaut qui peuvent être écrasées par des macros d'autres paquetages. Voici la partie de <i>extra.dm</i> qui redéfinit des macros globales.
384
385<pre>
386##########################################################################\n
387package Global\n
388##########################################################################\n
389\n
390&#095;starthighlight&#095; {&lt;b&gt;}\n
391&#095;endhighlight&#095;   {&lt;/b&gt;}\n
392\n
393&#095;navbarspacer&#095; { \n
394&lt;br/&gt;\n
395&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
396&lt;br/&gt;\n
397}\n
398</pre>\n
399
400Les valeurs de <i>starthighlight</i> et <i>endhighlight</i> sont utilisées pour mettre en valeur des termes de requête au moment de l'affichage d'un document. Le défaut est de mettre l'arriÚre-plan en jaune. La premiÚre des spécifications ci-dessus place les termes de requête en gras.
401
402<p>
403Ensuite, la macro <i>navbarspacer</i> est ce qui sépare le bouton de recherche des bouton de classificateurs dans la barre de navigation. C'est normalement la horizontale verte familiÚre de Greenstone. La définition suivante a l' effet d' entasser les boutons verticalement, un sur l' autre.
404<pre>
405&#095;navbarspacer&#095; {&lt;br\/&gt; }
406</pre>\n
407
408La définition de <i>navbarspace</i> donnée auparavant utilise l' image <i>horzline.gif</i> comme un séparateur (cette image apparaît dans le répertoire <i>images</i> de la collection). L' effet peut être visualisé dans la partie suppérieure de cette page. \n
409
410<p>
411Pour ranger les boutons horizontalement, utilisez toujours <i>horzline.gif</i> comme séparateur au lieu de la barre verte, supprimez les étiquettes <i>br</i> et définissez le corps de la macro (la partie entre parenthÚses) comme ceci:
412<pre>
413&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
414   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
415</pre>\n
416
417La variable <i>widthtspace</i> donne la largeur de l'espace entre les boutons que Greenstone calcule.
418
419<p>
420La partie de <i>extra.dm</i> reproduite ci-dessous redéfinit des macros dans le paquetage <i>Style</i>, qui est responsable de la création de l'en-tête et du pied de chaque page, et définissant information de style commun:
421
422<pre>
423##########################################################################\n
424package Style\n
425##########################################################################\n
426\n
427
428&#095;collectionspecificstyle&#095; {\n
429&lt;link rel=\"stylesheet\" href=\"&#095;httpcstyle&#095;/style.css\" type=\"text/css\" \n
430   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
431&lt;style&gt;\n
432body.bgimage \\\{ background-image: none; \\\}\n
433a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
434&lt;/style&gt;\n
435}\n
436\n
437&#095;pagebanner&#095; {\n
438&lt;div class=\"pageinfo\"&gt; \n
439&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
440&lt;/div&gt;\n
441}\n
442</pre>\n
443
444La macro de l'en-tête de la page de Greenstone, appelée <i>header</i> dans
445<a href=\"_httpprefix_/macros/style.dm\" target=macro>style.dm</a>, affiche le nom ou le logo de la collection, et crée un lien vers la page d'accueil, l'aide, et les pages des préférences. Elle appelle la macro <i>htmlhead</i> qui affiche le début d'une page HTML. Ceci appelle le macro <i>cssheader</i> qui output le style d' information pour cette page. Ce macro comprend le macro <i>collectionspecificstyle</i> qui permet la collection d' additionner quelques éléments-style au défaut.
446<p>
447Pour utiliser entiÚrement un nouveau style pour la collection, spécifiez le macro <i>cssheader</i> dans <i>extra.dm</i>. Pour ajouter seulement quelques déclarations de style, spécifiez le <i>collectionspecificstyle</i> dans <i>extra.dm</i>. C' est ceci ce que la collection a fait. Le macro ci-dessus <i>collectionspecificstyle</i> comprend la feuillestyle de la propre collection, et annule aussi quelques une des déclarations images, enlevant la barre verte curvée du fond d' écran, et en changeant le fond hover pour les boutons de la barre de navigation en bleu. \n
448<p>
449La macro d'entête de page appelle aussi <i>pagebanner</i> pour inclure le logo de la collection, des boutons /accueil/aide/préférences, et l'image en haut à gauche qui identifie la page (page \"à propos\", page de recherche, etc). Le code ci-dessus redéfinit la banniÚre pour supprimer ces images à l' exception du bouton de la page d' entrée -- comme vous pouvez le voir, elles n'apparaissent pas en haut de cette page. \n
450
451<p>
452La partie suivante de <i>extra.dm</i> redéfinit des macros dans la paquetage <i>about</i> (\"<i>à propos</i>\") (contenu dans <a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>), qui génÚre la page \"About this collection\" que vous voyez actuellement:
453<pre>
454##########################################################################\n
455package about\n
456##########################################################################\n
457\n
458&#095;content&#095; {\n
459&#095;navigationbar&#095;\n
460\n
461&#095;textabout&#095;\n
462\n
463&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
464&#095;help:simplehelp&#095;\n
465}
466</pre>\n
467
468La macro <i>content</i> pour la page <i>About</i> (\"<i>A propos</i>\") contient normallement la barre de navigation (avec des liens vers <i>Search</i> et tous classificateurs), suivie du texte \"About this collection\" (\"A propos de cette collection\") et \"how to find information\" (\"comment trouver de l'information\"). Parce qu'elle change d'une collection à l'autre, la macro de la <i>barre de navigation</i> est définie en interne par Greenstone, et utilise la macro <i>navbarspacer</i> traitéé ci-dessus. La macro <i>content</i> (\"<i>contenu</i>\") pour la page <i>About</i> (\"<i>A propos</i>\"), donnée ci-dessus, diffÚre de la macro habituelle (comme celle pour la collection Demo <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=p&p=about\">ici</a>)
469en ce sens que la barre de navigation n'est pas centrée et qu'il n'y a pas de boîte de recherche.
470
471<p>
472La partie suivante de <i>extra.dm</i> redéfinit des macros dans le paquetage <i>query</i> (\"<i>requête</i>\") (dans <a href=\"_httpprefix_/macros/query.dm\" target=macro>query.dm</a>),
473qui est utilisé pour générer la <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">page de recherche</a>:
474<pre>
475##############################################################################\n
476package query\n
477##############################################################################\n
478
479&#095;content&#095; {\n
480&#095;navigationbar&#095;\n
481\n
482&lt;center&gt;\n
483&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
484&lt;/center&gt;\n
485&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
486&lt;center&gt;\n
487&#095;searchhistorylist&#095;\n
488&lt;/center&gt;)\n
489&#095;If&#095;(&#095;cgiargq&#095;,&lt;small&gt;&#095;freqmsg&#095; &#095;textpostprocess&#095;&lt;/small&gt;&lt;br&gt;&#095;resultline&#095;,)\n
490&lt;br&gt;\n
491}\n
492</pre>\n
493
494La définition de <i>content</i> dans le paquetage de <i>requête</i> standard est similaire à la version donnée ci-dessus, excepté le fait qu'elle centre la macro <i>barre de navigation</i>, alors que la version ci-dessu ne le fait pas, et qu'elle inclut une barre verte supplémentaire. Comparez
495<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">ceci</a> Ã  <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=q\">ceci</a>.
496
497<p>
498Le fichier <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> redéfinit aussi des macros dans le paquetage <i>document</i> qui est utilisé pour afficher des documents (voir
499<a href=\"_httpprefix_/macros/document.dm\" target=macro>document.dm</a>). En fait, les pages générées par des classificateurs (par xemple listes de titres) sont aussi contrÎlées par ces macros.
500
501<pre>
502##########################################################################\n
503package document\n
504##########################################################################\n
505\n
506&#095;textheader&#095; {\n
507&#095;cgihead&#095;\n
508&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
509}\n
510\n
511&#095;content&#095; {\n
512&#095;navigationbar&#095;\n
513\n
514&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
515&lt;p style=\"text-align: center;\"&gt;\n
516&#095;phindclassifier&#095;\n
517&#095;collageclassifier&#095;\n
518&lt;/p&gt;\n
519)\n
520\n
521&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
522&lt;ul id=\"searchresults\"&gt;\n
523&#095;prevsearchresult&#095;\n
524&#095;nextsearchresult&#095;\n
525&lt;/ul&gt;)\n
526\n
527&lt;div class=\"document\"&gt;\n
528}\n
529</pre>\n
530
531Greenstone neutralise le macro <i>header</i> si un document (et non un classificateur) est en-train d' être visualisé. Supposons qu' on ne veut pas ceci. Le code ci-dessus redéfinit le macro <i>textheader</i> (normalement définit dans <i>document.dm,/i>) pour être le contenu du macro <i>header</i> originel. La définition de <i>content</i> ci-dessus neutralise le défault pour que la barre de navigation ne soit pas sentrée.
532"
533
534
535# -- Spanish text ----------------
536collectionmeta  collectionextra [l=es] "
537Esta colección de muestra contiene el mismo material que la colección de muestra Greenstone original, pero su apariencia ha sido modificada para hacerla más llamativa.
538<p>
539
540<h3>Cómo trabaja esta colección</h3>
541<p>
542La apariencia de las colecciones Greenstone se define por medio de los \"archivos de macros\" que se encuentran en el directorio de <i>macros</i> y puede ser modificada completamente cambiando el contenido de estos archivos. Editando estos cambiará la apariencia de todas las colecciones. Para cambiar la apariencia de unicamente una colección, coloque apropiadamente la macros modificado en un archivo llamado <i>extra.dm</i> en el directorio de la colección <i>macros</i>. Por ejemplo, este directorio utiliza un archivo llamado <a href=\"_httpcollection_/macros/extra.dm\">greenstone/collect/_cgiargc_/macros/extra.dm</a>. \n
543
544<p>
545Para separar ciertos detalles de la presentación de los archivos de macros, Greenstone utiliza <i>Cascading Style Sheets</i>(ver <a href=\"http://www.w3.org/Style/CSS/\">http://www.w3.org/Style/CSS/</a> para mas información), que le permite especificar la fuente, los colores, espacios, y otros elementos para las páginas HTML. La hojaestilo Greenstone estándar está alocada en <a href=\"_httpstyle_/style.css\">greenstone/web/style/style.css</a>. Esta colección especifica una hojaestilo auxiliar, <a href=\"_httpcstyle_/style.css\">greenstone/collect/_cgiargc_/style/style.css</a>, a ser usada en adición a las de defaul. Esto incluye algunos comentarios para aquellos para aquellos que no están familiarizados con hojas estilo cascada. Algunos de los macro en <i>extra.dm</i> refieren a imágenes que han sido colocadas en <i>greenstone/collect/_cgiargc_/images</i>.\n
546
547<p>
548
549El archivo <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> sustituye algunas de las macros que Greenstone utiliza por omisión. En los archivos de macros el carácter \"\#\" indica una línea de comentario (<i>extra.dm</i> incluye comentarios que explican lo que hace). Las macros se indican por medio de corchetes y pueden hacer referencia a otras macros. Esto significa que el contenido de una página puede dividirse en muchas cadenas más pequeñas, ya que puede resultar difícil trabajar a través de la cadena a la cual la macro hace referencia. Afortunadamente los cambios en las macros (al igual que los cambios en las cadenas de formato) tienen efecto inmediatamente a menos que se esté usando el servidor local Greenstone, en cuyo caso el servidor necesita reiniciarse. Esto hace que sea fácil experimentar editando archivos de macros.
550<p>
551
552Las macros se agrupan en \"paquetes\". Pero cada paquete no reside necesariamente en un solo archivo. El paquete <i>Global</i>, cuya mayor parte se encuentra en el archivo <a href=\"_httpprefix_/macros/base.dm\" target=macro>base.dm</a> (partes de él también están en los archivos de macros específicas de cada idioma como <a href=\"_httpprefix_/macros/english.dm\" target=macro>english.dm</a> y <a href=\"_httpprefix_/macros/french.dm\" target=macro>french.dm</a>) contiene macros por omisión que se pueden sustituir por macros de otros paquetes. Esta es la parte de <i>extra.dm</i> que redefine las macros globales.
553<p>
554
555<pre>
556##########################################################################\n
557package Global\n
558##########################################################################\n
559\n
560&#095;starthighlight&#095; {&lt;b&gt;}\n
561&#095;endhighlight&#095;   {&lt;/b&gt;}\n
562\n
563&#095;navbarspacer&#095; { \n
564&lt;br/&gt;\n
565&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
566&lt;br/&gt;\n
567}\n
568</pre>\n
569
570<p>
571Los valores de <i>starthighlight</i> y <i>endhighlight</i> se utilizan para resaltar los términos de la consulta cuando aparece en pantalla un documento. El valor por omisión es poner el fondo en amarillo. En vez de eso la primera especificación que aparece arriba pone los términos de la consulta en negritas.
572<p>
573
574A continuación la macro <i>navbarspacer</i> es la que separa el botón de búsqueda y los botones de los clasificadores en la barra de navegación. Por lo general es la familiar barra verde horizontal de Greenstone. La siguiente definición tiene el efecto de amontonar los botones verticalmente, uno sobre el otro.
575<p>
576
577<pre>
578&#095;navbarspacer&#095; {&lt;br\/&gt;} \n
579</pre>\n
580<p>
581
582La definición de <i>navbarspacer</i> data anteriormente usa la imágen <i>horzline.gif</i> como un separador (esta imágen aparece en el directorio de la colección <i>images</i>).  El efecto puede ser visto en la parte superior de esta página. \n
583<p>
584
585Para ordenar los botones horizontalmente y seguir usando <i>horzline.gif</i> en vez de la barra verde como separador, quite las etiquetas <i>br</i> y defina el cuerpo de la macro (la parte entre llaves {} ) de la siguiente manera:
586<p>
587
588<pre>
589&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
590   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
591</pre>\n
592<p>
593
594La variable <i>widthtspace</i> da el ancho del espacio entre los botones, lo cual es calculado por Greenstone.
595<p>
596
597La parte de <i>extra.dm</i> que se reproduce a continuación redefine las macros que se encuentran en el paquete de <i>Estilo</i>, el cual es responsable de crear el encabezado y pie de cada página, y define información de estylo común:
598
599<p>
600
601<pre>
602##########################################################################\n
603package Style\n
604##########################################################################\n
605\n
606
607&#095;collectionspecificstyle&#095; {\n
608&lt;link rel=\"stylesheet\" href=\"&#095;httpcstyle&#095;/style.css\" type=\"text/css\" \n
609   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
610&lt;style&gt;\n
611body.bgimage \\\{ background-image: none; \\\}\n
612a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
613&lt;/style&gt;\n
614}\n
615\n
616&#095;pagebanner&#095; {\n
617&lt;div class=\"pageinfo\"&gt; \n
618&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
619&lt;/div&gt;\n
620}\n
621</pre>\n
622
623<p>
624
625La macro de encabezado de página de Greenstone, llamado <i>encabezado</i> en <a href=\"_httpprefix_/macros/style.dm\" target=macro>style.dm</a>, imprime el nombre o el logotipo de la colección y establece vínculos con las páginas principal, de ayuda y de preferencias. También remite a la macro <i>htmlhead</i>, que muestra el inicio de un archivo HTML. Esto llama al macro <i>cssheader</i> lo que hace que salga información para la página. Este macro incluye el macro <i>collectionspecificstyle</i> el cual permite a la colección sumar algunos elementos de estilo a la falla.
626
627<p>
628Para utilizar enteramente el nuevo estilo para la colección, especifique el macro <i>cssheader</i> en <i>extra.dm</i>. Para simplemente agregar un par de declaraciones de estilos al estilo de falla, especifique <i>collectionspecificstyle</i> en <i>extra.dm</i>. Eso es lo que la colección ha hecho. El macro arriba <i>collectionspecificstyle</i> incluye el 'stylesheet' de la colección misma, y a la vez anula un par de declaraciones de imágen, deshaciendose del fondo de pantalla de la barra verde curva, y cambiando a azul el fondo planeado para los botones de la barra de navegación.
629<p>
630La macro de encabezado de la página también remite a <i>pagebanner</i> para incluir el logotipo de la colección, los botones principal/ayuda/preferencias y la imagen en la parte superior izquierda que identifica la página (acerca de esta página, buscar página, etc.). Este código redefine el rótulo con el fin de suprimir estas imágenes a la exepción del boton de la página de entrada-- como se puede ver aquí, no aparecen en la parte superior de esta página.
631<p>
632
633La siguiente parte de <i>extra.dm</i> redefine las macros del paquete <i>acerca de</i> (que se encuentra en <a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>), el cual genera la página \"Acerca de esta colección\" que usted está viendo en este momento.
634<p>
635
636<pre>
637##########################################################################\n
638package about\n
639##########################################################################\n
640\n
641&#095;content&#095; {\n
642&#095;navigationbar&#095;\n
643\n
644&#095;textabout&#095;\n
645\n
646&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
647&#095;help:simplehelp&#095;\n
648}
649</pre>\n
650<p>
651
652La macro de <i>contenido</i> para la página <i>Acerca de</i> normalmente contiene la barra de navegación (con vínculos hacia <i>Búsqueda</i> y cualquier clasificador) seguida por el texto \"Acerca de esta colección\" y \"cómo encontrar información\". Debido a que éste cambia de una colección a otra, la macro <i>navigationbar</i> es definida internamente por Greenstone y utiliza la macro <i>navbarspacer</i> descrita arriba. La macro de <i>contenido</i> para la página <i>Acerca de</i> que se menciona arriba difiere de la normal (como la de la colección Demo que se puede ver <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=p&p=about\">aquí</a>) en que la barra de navegación no está centrada y no hay cuadro de búsqueda.
653<p>
654
655La siguiente parte de <i>extra.dm</i> redefine las macros del paquete de <i>consulta</i> (que se encuentra en <a href=\"_httpprefix_/macros/query.dm\" target=macro>query.dm</a>), el cual se utiliza para generar la <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">página de búsqueda</a>.
656<p>
657
658<pre>
659##############################################################################\n
660package query\n
661##############################################################################\n
662
663&#095;content&#095; {\n
664&#095;navigationbar&#095;\n
665\n
666&lt;center&gt;\n
667&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
668&lt;/center&gt;\n
669&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
670&lt;center&gt;\n
671&#095;searchhistorylist&#095;\n
672&lt;/center&gt;)\n
673&#095;If&#095;(&#095;cgiargq&#095;,&lt;small&gt;&#095;freqmsg&#095; &#095;textpostprocess&#095;&lt;/small&gt;&lt;br&gt;&#095;resultline&#095;,)\n
674&lt;br&gt;\n
675}\n
676</pre>\n
677<p>
678
679La definición de <i>contenido</i> en el paquete de <i>consulta</i> estándar es similar a la versión dada arriba, excepto que centra la macro <i>navigationbar</i>, mientras que la versión de arriba no lo hace, e incluye una barra verde adicional. Compárese <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">ésta</a> con <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=q\">ésta</a>.
680<p>
681
682El archivo <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> también redefine las macros del paquete de <i>documentos</i>, el cual se utiliza para mostrar los documentos en pantalla (véase <a href=\"_httpprefix_/macros/document.dm\" target=macro>document.dm</a>). De hecho, las páginas generadas por medio de clasificadores (p. ej. las listas de títulos) también se rigen por estas macros.
683<p>
684
685<pre>
686##########################################################################\n
687package document\n
688##########################################################################\n
689\n
690&#095;textheader&#095; {\n
691&#095;cgihead&#095;\n
692&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
693}\n
694\n
695&#095;content&#095; {\n
696&#095;navigationbar&#095;\n
697\n
698&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
699&lt;p style=\"text-align: center;\"&gt;\n
700&#095;phindclassifier&#095;\n
701&#095;collageclassifier&#095;\n
702&lt;/p&gt;\n
703)\n
704\n
705&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
706&lt;ul id=\"searchresults\"&gt;\n
707&#095;prevsearchresult&#095;\n
708&#095;nextsearchresult&#095;\n
709&lt;/ul&gt;)\n
710\n
711&lt;div class=\"document\"&gt;\n
712}\n
713</pre>\n
714<p>
715
716Greenstone anula el macro <i>header</i> si el documento (y no un clasificador) está siendo mostrado. Supongamos que no queremos que esto suceda. El código aqui arriba redefine el macro <i>textheader</i> (normalmente definido en <i>document.dm</i>) para ser el contenido del macro original <i>header</i>. La definición de <i>content</i> aqui arriba anula la omisión para que la barra de navidgación no esté centrada.
717"
718
719
720# -- Russian text ----------------
721collectionmeta  collectionextra [l=ru] "
722Эта ЎеЌПМстрацОПММая кПллекцОя сПЎержОт тПт же ЌатерОал, чтП О ПрОгОМальМая ЎеЌПМстрацОПММая кПллекцОя Greenstone, МП её вОЎ был ОзЌеМеМ., чтПбы улучшОть резкПсть.
723<p>
724
725<h3>Как рабПтает кПллекцОя</h3>
726<p>
727ВОЎ кПллекцОй ГрОМстПуМ заЎается «ЌакрПфайлаЌО» в ЎОректПрОО ЌакрПса (<i>greenstone/macros</i>>) О ЌПжет быть пПлМПстью ОзЌеМеМП с пПЌПщью ЌПЎОфОкацОй в файлах ÐŒÐ°ÐºÑ€ÐŸÑÐŸÐ². ЭтО ЌПЎОфОкацОО ОзЌеМят вОЎ всех ÐºÐŸÐ»Ð»ÐµÐºÑ†ÐžÐ¹. ЧтПбы ОзЌеМОть вОЎ всегП лОшь ПЎМПй кПллекцОО, пПЌестОте сППтветствующОй ЌПЎОфОцОрПваММый ЌакрПс в файл МазваММый <i>extra.dm</i> в папке <i>macros</i> этПй кПллекцОО. НапрОЌер, эта кПллекцОя ОспПльзует файл <a href=\"_httpcollection_/macros/extra.dm\">greenstone/collect/_cgiargc_/macros/extra.dm</a>.\n
728<p>
729
730Для ПтЎелеМОя МекПтПрых ÐŽÐµÑ‚алей презеМтацОО Пт ЌакрПфайлПв ГрОМстПуМ ОспПльзует  <i>Cascading Style Sheets</i> (сЌ. ЎПпПлМОтельМую ОМфПрЌацОя Ма <a href=\"http://www.w3.org/Style/CSS/\">http://www.w3.org/Style/CSS/</a>), кПтПрые пПзвПляют ВаЌ устаМавлОвать шрОфты, цвета, ОМтервалы О ЎругОе элеЌеМты Ўля страМОц HTML. Ѐайл сП стаМЎартМыЌ МабПрПЌ стОлей в ГрОМстПуМ пПЌещеМ зЎесь: <a href=\"_httpstyle_/style.css\">greenstone/web/style/style.css</a> (ПМ пПЌещеМ в ЎОректПрОО <i>images</i>, пПтПЌу чтП ЌакрП файлы ЌПгут сПЎержать уЎПбМые ссылкО к этПй ЎОректПрОО.) Эта кПллекцОя ОЌеет вспПЌПгательМый стОлевПй файл, <a href=\"_httpcstyle_/style.css\">greenstone/collect/_cgiargc_/style/style.css</a>, кПтПрый сПЎержОт МескПлькП кПЌЌеМтарОев Ўля тех, ктП Ме разбОрается с CSS. НекПтПрые ЌакрПсы в <i>extra.dm</i> ОЌеют ссылкО к ОзПбражеМОяЌ пПЌещеММыЌ в <i>greenstone/collect/_cgiargc_/images</i>.\n
731
732<p>
733
734МакрПфайл <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> Птвергает часть ЌакрПсПв, кПтПрые ОспПльзуются в Greenstone пП уЌПлчаМОю. В ЌакрПфайлах \"\#\" ПпПвещает П стрПке кПЌЌеМтарОев (<i>extra.dm</i> сПЎержОт кПЌЌеМтарОО, чтПбы пПЌПчь ПбъясМОть, чтП ПМ Ўелает). СаЌО ЌакрПсы сППбщаются путеЌ пПЎчеркОваМОя, О ПМО ЌПгут Пбращаться к ЎругОЌ ЌакрПсаЌ. ЭтП ПзМачает, чтП сПЎержаМОе страМОцы ЌПжет быть разбОтП Ма ЌМПгОе ЌалеМькОе кускО, О ЌПгут вПзМОкать труЎМПстО прО рабПте пП цепО, кПтПрую ЌакрПс вызывает. К счастью, ОзЌеМеМОя в ЌакрПсах, пПЎПбМП ОзЌеМеМОяЌ в фПрЌатМых ÑÑ‚рПках, вступают в сОлу МеЌеЎлеММП, еслО Вы Ме ОспПльзуете сервер лПкальМПй бОблОПтекО Greenstone, в случае чегП сервер МужЎается в перезагрузке. ЭтП Пблегчает эксперОЌеМтОрПваМОе путеЌ реЎактОрПваМОя ЌакрПфайлПв.
735<p>
736
737
738МакрПсы сгруппОрПваМы в «пакеты». НП кажЎый пакет Ме ПбязательМП разЌещается в ПтЎельМПЌ файле. <i>ГлПбальМый</i>  пакет, бПльшая часть кПтПрПгП МахПЎОтся в файле <a href=\"_httpprefix_/macros/base.dm\" target=macro>base.dm</a> (часть егП МахПЎОтся также в спецОфОческОх ÑÐ·Ñ‹ÐºÐŸÐ²Ñ‹Ñ… ÐŒÐ°ÐºÑ€ÐŸÑ„айлах Ñ‚Опа <a href=\"_httpprefix_/macros/english.dm\" target=macro>english.dm</a> О <a href=\"_httpprefix_/macros/french.dm\" target=macro>french.dm</a>), сПЎержОт ЌакрПсы пП уЌПлчаМОю, кПтПрые ЌПгут быть ПтвергМутыЌО ЌакрПсаЌО в ЎругОх Ð¿Ð°ÐºÐµÑ‚ах. ЗЎесь ОЌеется часть <i>extra.dm</i>.
739
740<pre>
741##########################################################################\n
742package Global\n
743##########################################################################\n
744\n
745&#095;starthighlight&#095; {&lt;b&gt;}\n
746&#095;endhighlight&#095;   {&lt;/b&gt;}\n
747\n
748&#095;navbarspacer&#095; { \n
749&lt;br/&gt;\n
750&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
751&lt;br/&gt;\n
752}\n
753</pre>\n
754
755кПтПрая ПпреЎеляет глПбальМые ЌакрПсы, зМачеМОя <i>starthighlight</i> О <i>endhighlight</i> ОспПльзуются Ўля пПЎсвечОваМОя терЌОМПв запрПса прО преЎставлеМОО ЎПкуЌеМта. ПП уЌПлчаМОю ЎПлжеМ быть устаМПвлеМ желтый фПМ. Первая спецОфОкацОя вЌестП этПгП выЎеляет запрПс пПлужОрМыЌ шрОфтПЌ.
756<p>
757
758СлеЎующОй ЌакрПс <i>navbarspacer</i> служОт Ўля тПгП, чтПбы ПтЎелОть кМПпку пПОска О кМПпкО классОфОкатПрПв в МавОгацОПММПй лОМейке. ОбычМП этП хПрПшП зМакПЌая в Greenstone гПрОзПМтальМая зелеМая лОМейка. СлеЎущее ПпреЎелеМОе ОЌеет эффект вертОкальМПгП распПлПжеМОя кМПпПк, ПЎМа МаЎ ЎругПй.
759<p>
760<pre>
761&#095;navbarspacer&#095; {&lt;br\/&gt;}
762</pre>\n
763<p>
764
765ОпреЎелеМОе <i>navbarspacer</i>, ЎаММПе раМее ОспПльзует рОсуМПк <i>horzline.gif</i> в качестве разЎелОтеля (этПт рОсуМПк сПЎержОтся в папке кПллекцОО пПЎ МазваМОеЌ <i>images</i>). Эффект вОЎеМ в Мачале этПй страМОцы.\n
766
767<p>
768
769РазЌещеМОе кМПпПк гПрОзПМтальМП, все ещё ОспПльзуя <i>horzline.gif</i>, вЌестП зелеМПй лОМейкО как разЎелОтеля, уЎаляя тэгО <i>br</i> О ПпреЎеляет телП ЌакрПса (часть в фОгурМых ÑÐºÐŸÐ±ÐºÐ°Ñ…), как:
770
771<p>
772<pre>
773&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
774   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
775</pre>\n
776
777<p>
778ПереЌеММая <i>widthtspace</i> заЎаёт шОрОМу прПЌежутка ЌежЎу кМПпкаЌО, кПтПрую вычОсляет Greenstone.
779<p>
780
781
782Часть <i>extra.dm</i>, вПспрПОзвеЎеММая МОже, переПпреЎеляет ЌакрПсы в пакете <i>Style</i>, кПтПрый Птвечает за сПзЎаМОе загПлПвка О МОжМей сМПскО Ма кажЎПй страМОце:\n
783
784<p>
785
786<pre>
787##########################################################################\n
788package Style\n
789##########################################################################\n
790\n
791
792&#095;collectionspecificstyle&#095; {\n
793&lt;link rel=\"stylesheet\" href=\"&#095;httpcstyle&#095;/style.css\" type=\"text/css\" \n
794   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
795&lt;style&gt;\n
796body.bgimage \\\{ background-image: none; \\\}\n
797a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
798&lt;/style&gt;\n
799}\n
800\n
801&#095;pagebanner&#095; {\n
802&lt;div class=\"pageinfo\"&gt; \n
803&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
804&lt;/div&gt;\n
805}\n
806</pre>\n
807
808<p>
809
810ЌакрПс загПлПвка страМОцы Greenstone, кПтПрый Мазывается <i>header</i> в <a href=\"_httpprefix_/macros/style.dm\" target=macro>style.dm</a>, печатает МаОЌеМПваМОе кПллекцОО О её эЌблеЌу О связывает её с ЎПЌашМей страМОцей, пПЌПщью О страМОцаЌО преЎпПчтеМОй. ОМ вызывает ЌакрПс <i>htmlhead</i>, кПтПрый ПпреЎеляет МачалП файла HTML. ЭтП вызывает ЌакрП <i>cssheader</i>, кПтПрый пПказывает ОМфПрЌацОю П стОле страМОцы. ЭтПт ЌакрП включает ЌакрП <i>collectionspecificstyle</i>, кПтПрый пПзвПляет ЎПбавОть к кПллекцОО стОлОстОческОе элеЌеМты к МабПру пП уЌПлчаМОю.
811
812<p>
813ЧтПбы ОспПльзПвать сПвершеММП ЎругПй стОль в кПллекцОО, выберОте ЌакрП <i>cssheader</i> в <i>extra.dm</i>. ЧтПбы всегП лОшь ЎПбавОть МескПлькП МПвых ÑÑ‚Олевых ÐŸÐ¿Ñ€ÐµÐŽÐµÐ»ÐµÐœÐžÐ¹ к стОлю пП уЌПлчаМОю, выберОте <i>collectionspecificstyle</i> в <i>extra.dm</i>. ЭтП былП сЎелаМП в этПй кПллекцОО. ВышеуказаМый ЌакрП <i>collectionspecificstyle</i> сПЎержОт таблОцу стОлей кПллекцОО, О переПпреЎеляет пару стОлей Ўля ОзПбражеМОй: ЗелеМая фПМПвая плаМка с завОткаЌО Осчезла, а фПМ МавОгацОПММПй паМелО теперь сОМОй.\n
814
815<p>
816МакрПс загПлПвкО страМОцы также вызывает <i>pagebanner</i>, чтПбы включОть эЌблеЌу кПллекцОО, кМПпкО home/help/preferences О ОзПбражеМОе слева вверху, кПтПрПе ОЎеМтОфОцОрует страМОцу (П страМОце, пПОскПвая страМОца О т.ÐŽ.). ПрПграЌЌа, указаММая выше, ПпреЎеляет баММер, чтПбы пПЎавОть этО ОзПбражеМОя. Как Вы ЌПжете вОЎеть, ПМО Ме пПявляются Маверху этПй страМОцы.\n
817
818<p>
819СлеЎующая часть <i>extra.dm</i> переПпреЎеляет ЌакрПс Ўля ПпОсаМОя О <i>пакете</i>, сПЎержащОйся в <a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>, кПтПрый геМерОрует страМОцу <i>«Об этПй кПллекцОО»</i>, кПтПрую Вы вОЎОте сейчас.
820
821<pre>
822##########################################################################\n
823package about\n
824##########################################################################\n
825\n
826&#095;content&#095; {\n
827&#095;navigationbar&#095;\n
828\n
829&#095;textabout&#095;\n
830\n
831&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
832&#095;help:simplehelp&#095;\n
833}
834</pre>\n
835
836МакрПсПЎержаМОе Ўля текста <i>О страМОце</i> ПбычМП сПЎержОт МавОгацОПММую лОМейку (сП ссылкаЌО к ППОску О любыЌ классОфОкатПраЌ), сПпрПвПжЎаеЌую ПпОсаМОеЌ «Об этПй кПллекцОО» О текстПЌ «Как МайтО ОМфПрЌацОю». ППскПльку ПМО ОзЌеМяются Пт ПЎМПй кПллекцОО к ЎругПй, ЌакрПc <i>navigationbar</i> ПпреЎелеМ вМутрО Greenstone О ОспПльзует ЌакрПс <i>navbarspacer</i>, кПтПрый был ПбсужЎеМ выше. МакрПс <i>content</i> Ўля ПпОсаМОя <i>О страМОце</i>, преЎставлеММый выше, ПтлОчается Пт ПбычМПгП (такПгП, как кПллекцОО <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=p&p=about\">Demo</a>) теЌ, чтП МавОгацОПММая лОМейка Ме ПтцеМтрОрПваМа О зЎесь Мет МОкакПгП пПля пПОска.
837<p>
838
839СлеЎующая часть <i>extra.dm</i> переПпреЎеляет ЌакрПс в пакете <i>запрПса</i> (<i>query</i>) в <a href=\"_httpprefix_/macros/query.dm\" target=macro>query.dm</a>), кПтПрый ОспПльзуется Ўля геМерацОО <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">пПОскПвПй страМОцы</a>.
840
841<pre>
842##############################################################################\n
843package query\n
844##############################################################################\n
845
846&#095;content&#095; {\n
847&#095;navigationbar&#095;\n
848\n
849&lt;center&gt;\n
850&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
851&lt;/center&gt;\n
852&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
853&lt;center&gt;\n
854&#095;searchhistorylist&#095;\n
855&lt;/center&gt;)\n
856&#095;If&#095;(&#095;cgiargq&#095;,&lt;small&gt;&#095;freqmsg&#095; &#095;textpostprocess&#095;&lt;/small&gt;&lt;br&gt;&#095;resultline&#095;,)\n
857&lt;br&gt;\n
858}\n
859</pre>\n
860
861ОпреЎелеМОе <i>сПЎержаМОя</i> в стаМЎартМПЌ пакете <i>запрПса</i> пПЎПбМП версОО, ЎаММПй выше, за ОсключеМОеЌ тПгП, чтП ПМП пПЌещает в цеМтре ЌакрПс <i>navigationbar</i>, тПгЎа как вышеупПЌяМутая версОя Ме Ўелает этПгП О включает ЎПпПлМОтельМую зелеМую лОМейку. СравМОте <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">тП</a> О <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=q\">этП</a>.
862<p>
863
864
865Ѐайл <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> также переПпреЎеляет ЌакрПс в пакете <i>ЎПкуЌеМт</i> (<i>document</i>), кПтПрый ОспПльзуется Ўля тПгП, чтПбы пПказать ЎПкуЌеМты (сЌ. <a href=\"_httpprefix_/macros/document.dm\" target=macro>document.dm</a>). ЀактОческО страМОцы, геМерОруеЌые классОфОкатПраЌО (МапрОЌер, спОскПЌ МаОЌеМПваМОй) также управляются О этОЌО ЌакрПсаЌО.
866
867<pre>
868##########################################################################\n
869package document\n
870##########################################################################\n
871\n
872&#095;textheader&#095; {\n
873&#095;cgihead&#095;\n
874&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
875}\n
876\n
877&#095;content&#095; {\n
878&#095;navigationbar&#095;\n
879\n
880&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
881&lt;p style=\"text-align: center;\"&gt;\n
882&#095;phindclassifier&#095;\n
883&#095;collageclassifier&#095;\n
884&lt;/p&gt;\n
885)\n
886\n
887&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
888&lt;ul id=\"searchresults\"&gt;\n
889&#095;prevsearchresult&#095;\n
890&#095;nextsearchresult&#095;\n
891&lt;/ul&gt;)\n
892\n
893&lt;div class=\"document\"&gt;\n
894}
895</pre>\n
896
897ГрОМстПуМ аММулОрует ЌакрП <i>header</i>, еслО ОзПбражеМ ЎПкуЌеМт (а Ме классОфОкатПр). ПреЎпПлПжОЌ, Ќы Ме хПтОЌ этПгП. ВышестПящОй кПЎ переПпреЎеляет ЌакрП <i>textheader</i> (ПбычМП ПпреЎелеММПЌ в <i>document.dm</i>) в качестве первПМачальМПгП сПЎержаМОя ЌакрП <i>header</i>. ВышестПящее ПпреЎелеМОе  <i>content</i> аММулОрует зМачеМОе пП-уЌПлчаМОю, так чтП МавОгацОПММПе ЌеМю Ме цеМтрОруется.
898"
Note: See TracBrowser for help on using the browser.