root/documented-example-collections/trunk/garish-e/etc/collect.cfg @ 19029

Revision 19029, 56.7 KB (checked in by kjdon, 11 years ago)

updated extra.dm and collect.cfg for current macros, matching extra and the description, changing paths to work with the collection inside a collect group

  • 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=\"_httpprefix_/images/style.css\">greenstone/images/style.css</a> (it is placed in the <i>images</i> directory because
145macro files can easily reference this directory). This collection specifies an auxiliary stylesheet, <a href=\"_httpcimages_/style.css\">greenstone/collect/_cgiargc_/images/style.css</a>, to be used in addition to the default ones. It includes some comments
146for those unfamiliar with cascading style sheets. Some of the
147macros in <i>extra.dm</i> reference images that have been placed in
148<i>greenstone/collect/_cgiargc_/images</i>.\n
149<p>
150The
151<a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
152macro file overrides some of the macros that Greenstone
153uses by default. In macro files, the \"\#\" character signals a comment line
154(<i>extra.dm</i> is commented to help explain what it does).
155Macros themselves are signalled by
156underscores, and they can reference other macros. This means that the
157content of a page can be split into many small chunks, and it can be
158difficult to work through the chain of which macro calls what. Fortunately,
159changes in macros (like changes in format strings) take effect immediately
160unless you are using the Greenstone local library server, in which case the
161server needs to be restarted. This makes it easy to experiment by editing
162the macro files.\n
163
164<p>
165Macros are grouped into \"packages\". But each package does not necessarily reside in
166a single file. The <i>Global</i> package, most of which is in file
167<a href=\"_httpprefix_/macros/base.dm\" target=macro>base.dm</a>
168(parts of it are also in the language-specific macro files such as
169<a href=\"_httpprefix_/macros/english.dm\" target=macro>english.dm</a> and
170<a href=\"_httpprefix_/macros/french.dm\" target=macro>french.dm</a>),
171contains default macros that can be overridden by macros in other packages. Here is the part
172of <i>extra.dm</i> that redefines global macros.
173<pre>
174##########################################################################\n
175package Global\n
176##########################################################################\n
177\n
178&#095;starthighlight&#095; {&lt;b&gt;}\n
179&#095;endhighlight&#095;   {&lt;/b&gt;}\n
180\n
181&#095;navbarspacer&#095; { \n
182&lt;br/&gt;\n
183&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
184&lt;br/&gt;\n
185}\n
186</pre>\n
187The values of <i>starthighlight</i> and <i>endhighlight</i> are used to
188highlight query terms when displaying a document. The default is to set the
189background to yellow. The first specification above places query terms in
190bold instead.\n
191
192<p>
193Next, the <i>navbarspacer</i> macro is what separates the search button and
194classifier buttons in the navigation bar. It is normally Greenstone\'s
195familiar horizontal green bar. The following definition has the effect of
196stacking the buttons vertically, one above the other.
197<pre>
198&#095;navbarspacer&#095; {&lt;br\/&gt;}
199</pre>\n
200
201 The definition of <i>navbarspacer</i> given earlier uses the image
202<i>horzline.gif</i> as a separator (this image appears in the
203<i>images</i> directory of the collection). The effect can be seen at the top of this page.\n
204
205<p>
206To arrange the buttons horizontally, still using
207<i>horzline.gif</i> instead of the green bar as separator,
208remove the <i>br</i> tags and define the body of the macro
209(the part in curly brackets) to be:
210<pre>
211&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
212   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
213</pre>\n
214
215The <i>widthtspace</i> variable gives the width of the gap between the
216buttons, which Greenstone calculates.\n
217
218<p>
219The part of <i>extra.dm</i> reproduced below redefines macros in the
220<i>Style</i> package, which is responsible for creating the header and
221footer of every page, and defining common style information:
222<pre>
223##########################################################################\n
224package Style\n
225##########################################################################\n
226\n
227
228&#095;collectionspecificstyle&#095; {\n
229&lt;link rel=\"stylesheet\" href=\"&#095;httpcimages&#095;/style.css\" type=\"text/css\" \n
230   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
231&lt;style&gt;\n
232body.bgimage \\\{ background-image: none; \\\}\n
233a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
234&lt;/style&gt;\n
235}\n
236\n
237&#095;pagebanner&#095; {\n
238&lt;div class=\"pageinfo\"&gt; \n
239&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
240&lt;/div&gt;\n
241}\n
242</pre>\n
243
244Greenstone\'s page header macro, which is called <i>header</i> in
245<a href=\"_httpprefix_/macros/style.dm\" target=macro>style.dm</a>,
246prints the collection\'s name or logo, and links to the
247home, help, and preferences pages. It calls the macro <i>htmlhead</i> which
248outputs 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.
249
250<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.
251
252<p>
253 The page header macro also calls <i>pagebanner</i> to include the collection\'s logo,
254home/help/preferences buttons, and the image at the top left that
255identifies the page (about page, search page, etc). The code above
256redefines the banner to suppress all these images except for the home page button -- as you can see, they don\'t appear
257at the top of this page.\n
258
259<p>
260The next part of <i>extra.dm</i> redefines macros in the <i>about</i>
261package (contained in
262<a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>), which generates the
263\"About this collection\" page that you are looking at now:
264<pre>
265##########################################################################\n
266package about\n
267##########################################################################\n
268\n
269&#095;content&#095; {\n
270&#095;navigationbar&#095;\n
271\n
272&#095;textabout&#095;\n
273\n
274&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
275&#095;help:simplehelp&#095;\n
276}
277</pre>\n
278
279The macro <i>content</i> for the <i>About</i> page normally contains the
280navigation bar (with links to <i>Search</i> and any classifiers),
281followed by \"About this collection\" and \"how to find information\"
282text. Because it changes from one collection to another, the
283<i>navigationbar</i> macro is defined internally by Greenstone, and uses
284the <i>navbarspacer</i> macro discussed above. The <i>content</i> macro for
285the <i>About</i> page, given above, differs from the regular one
286(such as the one for the DLS collection <a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=p&p=about\">here</a>)
287in that the navigation bar is not centered, and there is no search box.\n
288
289<p>
290The next part of <i>extra.dm</i> redefines macros in the <i>query</i> package (in
291<a href=\"_httpprefix_/macros/query.dm\" target=macro>query.dm</a>),
292which is used to generate the
293<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">search page</a>:
294<pre>
295##############################################################################\n
296package query\n
297##############################################################################\n
298
299&#095;content&#095; {\n
300&#095;navigationbar&#095;\n
301\n
302&lt;center&gt;\n
303&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
304&lt;/center&gt;\n
305&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
306&lt;center&gt;\n
307&#095;searchhistorylist&#095;\n
308&lt;/center&gt;)\n
309&#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
310&lt;br&gt;\n
311}\n
312</pre>\n
313
314The definition of <i>content</i> in the standard <i>query</i> package is
315similar to the version given above, except that it centers the
316<i>navigationbar</i> macro, whereas the above version does not, and it
317includes an additional green bar. Compare
318<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">this</a>
319and
320<a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=q\">this</a>.\n
321
322<p>
323The file
324<a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
325also redefines macros in the <i>document</i> package,
326which is used to display documents (see
327<a href=\"_httpprefix_/macros/document.dm\" target=macro>document.dm</a>). In fact, pages
328generated by classifiers (e.g. lists of titles) are also governed by these macros.
329<pre>
330##########################################################################\n
331package document\n
332##########################################################################\n
333\n
334&#095;textheader&#095; {\n
335&#095;cgihead&#095;\n
336&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
337}\n
338\n
339&#095;content&#095; {\n
340&#095;navigationbar&#095;\n
341\n
342&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
343&lt;p style=\"text-align: center;\"&gt;\n
344&#095;phindclassifier&#095;\n
345&#095;collageclassifier&#095;\n
346&lt;/p&gt;\n
347)\n
348\n
349&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
350&lt;ul id=\"searchresults\"&gt;\n
351&#095;prevsearchresult&#095;\n
352&#095;nextsearchresult&#095;\n
353&lt;/ul&gt;)\n
354\n
355&lt;div class=\"document\"&gt;\n
356}\n
357</pre>\n
358
359Greenstone overrides the <i>header</i> macro if a document (and not a
360classifier) is being displayed. Suppose we don\'t want it to. The code
361above redefines the <i>textheader</i> macro (normally defined in
362<i>document.dm</i>) to be the content of the original <i>header</i> macro. The definition of <i>content</i> above overrides the
363default so that the navigation bar is not centered.
364"
365
366
367# -- French text ----------------
368collectionmeta  collectionextra [l=fr] "
369Cette 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.
370
371<h3>Comment la collection marche</h3>
372
373<p>
374L'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
375<p>
376Pour 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=\"_httpprefix_/images/style.css\">greenstone/images/style.css</a> (il est placé dans le répertoire <i>images</i> car les macros fichiers peuvent reférer ce répertoire facilement). Cette collection spécifie un 'stylesheet' auxiliaire, <a href=\"_httpcimages_/style.css\">greenstone/collect/_cgiargc_/images/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
377<p>
378Le fichier de macros <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
379l'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.
380
381<p>
382Les 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
383<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>),
384contient 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.
385
386<pre>
387##########################################################################\n
388package Global\n
389##########################################################################\n
390\n
391&#095;starthighlight&#095; {&lt;b&gt;}\n
392&#095;endhighlight&#095;   {&lt;/b&gt;}\n
393\n
394&#095;navbarspacer&#095; { \n
395&lt;br/&gt;\n
396&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
397&lt;br/&gt;\n
398}\n
399</pre>\n
400
401Les 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.
402
403<p>
404Ensuite, 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.
405<pre>
406&#095;navbarspacer&#095; {&lt;br\/&gt; }
407</pre>\n
408
409La 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
410
411<p>
412Pour 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:
413<pre>
414&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
415   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
416</pre>\n
417
418La variable <i>widthtspace</i> donne la largeur de l'espace entre les boutons que Greenstone calcule.
419
420<p>
421La 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:
422
423<pre>
424##########################################################################\n
425package Style\n
426##########################################################################\n
427\n
428
429&#095;collectionspecificstyle&#095; {\n
430&lt;link rel=\"stylesheet\" href=\"&#095;httpcimages&#095;/style.css\" type=\"text/css\" \n
431   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
432&lt;style&gt;\n
433body.bgimage \\\{ background-image: none; \\\}\n
434a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
435&lt;/style&gt;\n
436}\n
437\n
438&#095;pagebanner&#095; {\n
439&lt;div class=\"pageinfo\"&gt; \n
440&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
441&lt;/div&gt;\n
442}\n
443</pre>\n
444
445La macro de l'en-tête de la page de Greenstone, appelée <i>header</i> dans
446<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.
447<p>
448Pour 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
449<p>
450La 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
451
452<p>
453La 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:
454<pre>
455##########################################################################\n
456package about\n
457##########################################################################\n
458\n
459&#095;content&#095; {\n
460&#095;navigationbar&#095;\n
461\n
462&#095;textabout&#095;\n
463\n
464&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
465&#095;help:simplehelp&#095;\n
466}
467</pre>\n
468
469La 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 DLS <a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=p&p=about\">ici</a>)
470en ce sens que la barre de navigation n'est pas centrée et qu'il n'y a pas de boîte de recherche.
471
472<p>
473La 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>),
474qui est utilisé pour générer la <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">page de recherche</a>:
475<pre>
476##############################################################################\n
477package query\n
478##############################################################################\n
479
480&#095;content&#095; {\n
481&#095;navigationbar&#095;\n
482\n
483&lt;center&gt;\n
484&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
485&lt;/center&gt;\n
486&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
487&lt;center&gt;\n
488&#095;searchhistorylist&#095;\n
489&lt;/center&gt;)\n
490&#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
491&lt;br&gt;\n
492}\n
493</pre>\n
494
495La 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
496<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">ceci</a> Ã  <a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=q\">ceci</a>.
497
498<p>
499Le 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
500<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.
501
502<pre>
503##########################################################################\n
504package document\n
505##########################################################################\n
506\n
507&#095;textheader&#095; {\n
508&#095;cgihead&#095;\n
509&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
510}\n
511\n
512&#095;content&#095; {\n
513&#095;navigationbar&#095;\n
514\n
515&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
516&lt;p style=\"text-align: center;\"&gt;\n
517&#095;phindclassifier&#095;\n
518&#095;collageclassifier&#095;\n
519&lt;/p&gt;\n
520)\n
521\n
522&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
523&lt;ul id=\"searchresults\"&gt;\n
524&#095;prevsearchresult&#095;\n
525&#095;nextsearchresult&#095;\n
526&lt;/ul&gt;)\n
527\n
528&lt;div class=\"document\"&gt;\n
529}\n
530</pre>\n
531
532Greenstone 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.
533"
534
535
536# -- Spanish text ----------------
537collectionmeta  collectionextra [l=es] "
538Esta 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.
539<p>
540
541<h3>Cómo trabaja esta colección</h3>
542<p>
543La 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
544
545<p>
546Para 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=\"_httpprefix_/images/style.css\">greenstone/images/style.css</a> (está colocado en el directorio <i>images</i> porque los archivos macro puede sencillamente referir el directorio). Esta colección especifica una hojaestilo auxiliar, <a href=\"_httpcimages_/style.css\">greenstone/collect/_cgiargc_/images/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
547
548<p>
549
550El 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.
551<p>
552
553Las 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.
554<p>
555
556<pre>
557##########################################################################\n
558package Global\n
559##########################################################################\n
560\n
561&#095;starthighlight&#095; {&lt;b&gt;}\n
562&#095;endhighlight&#095;   {&lt;/b&gt;}\n
563\n
564&#095;navbarspacer&#095; { \n
565&lt;br/&gt;\n
566&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
567&lt;br/&gt;\n
568}\n
569</pre>\n
570
571<p>
572Los 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.
573<p>
574
575A 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.
576<p>
577
578<pre>
579&#095;navbarspacer&#095; {&lt;br\/&gt;} \n
580</pre>\n
581<p>
582
583La 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
584<p>
585
586Para 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:
587<p>
588
589<pre>
590&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
591   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
592</pre>\n
593<p>
594
595La variable <i>widthtspace</i> da el ancho del espacio entre los botones, lo cual es calculado por Greenstone.
596<p>
597
598La 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:
599
600<p>
601
602<pre>
603##########################################################################\n
604package Style\n
605##########################################################################\n
606\n
607
608&#095;collectionspecificstyle&#095; {\n
609&lt;link rel=\"stylesheet\" href=\"&#095;httpcimages&#095;/style.css\" type=\"text/css\" \n
610   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
611&lt;style&gt;\n
612body.bgimage \\\{ background-image: none; \\\}\n
613a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
614&lt;/style&gt;\n
615}\n
616\n
617&#095;pagebanner&#095; {\n
618&lt;div class=\"pageinfo\"&gt; \n
619&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
620&lt;/div&gt;\n
621}\n
622</pre>\n
623
624<p>
625
626La 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.
627
628<p>
629Para 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.
630<p>
631La 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.
632<p>
633
634La 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.
635<p>
636
637<pre>
638##########################################################################\n
639package about\n
640##########################################################################\n
641\n
642&#095;content&#095; {\n
643&#095;navigationbar&#095;\n
644\n
645&#095;textabout&#095;\n
646\n
647&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
648&#095;help:simplehelp&#095;\n
649}
650</pre>\n
651<p>
652
653La 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 DLS que se puede ver <a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=p&p=about\">aquí</a>) en que la barra de navegación no está centrada y no hay cuadro de búsqueda.
654<p>
655
656La 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>.
657<p>
658
659<pre>
660##############################################################################\n
661package query\n
662##############################################################################\n
663
664&#095;content&#095; {\n
665&#095;navigationbar&#095;\n
666\n
667&lt;center&gt;\n
668&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
669&lt;/center&gt;\n
670&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
671&lt;center&gt;\n
672&#095;searchhistorylist&#095;\n
673&lt;/center&gt;)\n
674&#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
675&lt;br&gt;\n
676}\n
677</pre>\n
678<p>
679
680La 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=dls-e&a=q\">ésta</a>.
681<p>
682
683El 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.
684<p>
685
686<pre>
687##########################################################################\n
688package document\n
689##########################################################################\n
690\n
691&#095;textheader&#095; {\n
692&#095;cgihead&#095;\n
693&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
694}\n
695\n
696&#095;content&#095; {\n
697&#095;navigationbar&#095;\n
698\n
699&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
700&lt;p style=\"text-align: center;\"&gt;\n
701&#095;phindclassifier&#095;\n
702&#095;collageclassifier&#095;\n
703&lt;/p&gt;\n
704)\n
705\n
706&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
707&lt;ul id=\"searchresults\"&gt;\n
708&#095;prevsearchresult&#095;\n
709&#095;nextsearchresult&#095;\n
710&lt;/ul&gt;)\n
711\n
712&lt;div class=\"document\"&gt;\n
713}\n
714</pre>\n
715<p>
716
717Greenstone 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.
718"
719
720
721# -- Russian text ----------------
722collectionmeta  collectionextra [l=ru] "
723Эта ЎеЌПМстрацОПММая кПллекцОя сПЎержОт тПт же ЌатерОал, чтП О ПрОгОМальМая ЎеЌПМстрацОПММая кПллекцОя Greenstone, МП её вОЎ был ОзЌеМеМ., чтПбы улучшОть резкПсть.
724<p>
725
726<h3>Как рабПтает кПллекцОя</h3>
727<p>
728ВОЎ кПллекцОй ГрОМстПуМ заЎается «ЌакрПфайлаЌО» в ЎОректПрОО ЌакрПса (<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
729<p>
730
731Для ПтЎелеМОя МекПтПрых ÐŽÐµÑ‚алей презеМтацОО Пт ЌакрПфайлПв ГрОМстПуМ ОспПльзует  <i>Cascading Style Sheets</i> (сЌ. ЎПпПлМОтельМую ОМфПрЌацОя Ма <a href=\"http://www.w3.org/Style/CSS/\">http://www.w3.org/Style/CSS/</a>), кПтПрые пПзвПляют ВаЌ устаМавлОвать шрОфты, цвета, ОМтервалы О ЎругОе элеЌеМты Ўля страМОц HTML. Ѐайл сП стаМЎартМыЌ МабПрПЌ стОлей в ГрОМстПуМ пПЌещеМ зЎесь: <a href=\"_httpprefix_/images/style.css\">greenstone/images/style.css</a> (ПМ пПЌещеМ в ЎОректПрОО <i>images</i>, пПтПЌу чтП ЌакрП файлы ЌПгут сПЎержать уЎПбМые ссылкО к этПй ЎОректПрОО.) Эта кПллекцОя ОЌеет вспПЌПгательМый стОлевПй файл, <a href=\"_httpcimages_/style.css\">greenstone/collect/_cgiargc_/images/style.css</a>, кПтПрый сПЎержОт МескПлькП кПЌЌеМтарОев Ўля тех, ктП Ме разбОрается с CSS. НекПтПрые ЌакрПсы в <i>extra.dm</i> ОЌеют ссылкО к ОзПбражеМОяЌ пПЌещеММыЌ в <i>greenstone/collect/_cgiargc_/images</i>.\n
732
733<p>
734
735МакрПфайл <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> Птвергает часть ЌакрПсПв, кПтПрые ОспПльзуются в Greenstone пП уЌПлчаМОю. В ЌакрПфайлах \"\#\" ПпПвещает П стрПке кПЌЌеМтарОев (<i>extra.dm</i> сПЎержОт кПЌЌеМтарОО, чтПбы пПЌПчь ПбъясМОть, чтП ПМ Ўелает). СаЌО ЌакрПсы сППбщаются путеЌ пПЎчеркОваМОя, О ПМО ЌПгут Пбращаться к ЎругОЌ ЌакрПсаЌ. ЭтП ПзМачает, чтП сПЎержаМОе страМОцы ЌПжет быть разбОтП Ма ЌМПгОе ЌалеМькОе кускО, О ЌПгут вПзМОкать труЎМПстО прО рабПте пП цепО, кПтПрую ЌакрПс вызывает. К счастью, ОзЌеМеМОя в ЌакрПсах, пПЎПбМП ОзЌеМеМОяЌ в фПрЌатМых ÑÑ‚рПках, вступают в сОлу МеЌеЎлеММП, еслО Вы Ме ОспПльзуете сервер лПкальМПй бОблОПтекО Greenstone, в случае чегП сервер МужЎается в перезагрузке. ЭтП Пблегчает эксперОЌеМтОрПваМОе путеЌ реЎактОрПваМОя ЌакрПфайлПв.
736<p>
737
738
739МакрПсы сгруппОрПваМы в «пакеты». НП кажЎый пакет Ме ПбязательМП разЌещается в ПтЎельМПЌ файле. <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>.
740
741<pre>
742##########################################################################\n
743package Global\n
744##########################################################################\n
745\n
746&#095;starthighlight&#095; {&lt;b&gt;}\n
747&#095;endhighlight&#095;   {&lt;/b&gt;}\n
748\n
749&#095;navbarspacer&#095; { \n
750&lt;br/&gt;\n
751&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
752&lt;br/&gt;\n
753}\n
754</pre>\n
755
756кПтПрая ПпреЎеляет глПбальМые ЌакрПсы, зМачеМОя <i>starthighlight</i> О <i>endhighlight</i> ОспПльзуются Ўля пПЎсвечОваМОя терЌОМПв запрПса прО преЎставлеМОО ЎПкуЌеМта. ПП уЌПлчаМОю ЎПлжеМ быть устаМПвлеМ желтый фПМ. Первая спецОфОкацОя вЌестП этПгП выЎеляет запрПс пПлужОрМыЌ шрОфтПЌ.
757<p>
758
759СлеЎующОй ЌакрПс <i>navbarspacer</i> служОт Ўля тПгП, чтПбы ПтЎелОть кМПпку пПОска О кМПпкО классОфОкатПрПв в МавОгацОПММПй лОМейке. ОбычМП этП хПрПшП зМакПЌая в Greenstone гПрОзПМтальМая зелеМая лОМейка. СлеЎущее ПпреЎелеМОе ОЌеет эффект вертОкальМПгП распПлПжеМОя кМПпПк, ПЎМа МаЎ ЎругПй.
760<p>
761<pre>
762&#095;navbarspacer&#095; {&lt;br\/&gt;}
763</pre>\n
764<p>
765
766ОпреЎелеМОе <i>navbarspacer</i>, ЎаММПе раМее ОспПльзует рОсуМПк <i>horzline.gif</i> в качестве разЎелОтеля (этПт рОсуМПк сПЎержОтся в папке кПллекцОО пПЎ МазваМОеЌ <i>images</i>). Эффект вОЎеМ в Мачале этПй страМОцы.\n
767
768<p>
769
770РазЌещеМОе кМПпПк гПрОзПМтальМП, все ещё ОспПльзуя <i>horzline.gif</i>, вЌестП зелеМПй лОМейкО как разЎелОтеля, уЎаляя тэгО <i>br</i> О ПпреЎеляет телП ЌакрПса (часть в фОгурМых ÑÐºÐŸÐ±ÐºÐ°Ñ…), как:
771
772<p>
773<pre>
774&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
775   width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
776</pre>\n
777
778<p>
779ПереЌеММая <i>widthtspace</i> заЎаёт шОрОМу прПЌежутка ЌежЎу кМПпкаЌО, кПтПрую вычОсляет Greenstone.
780<p>
781
782
783Часть <i>extra.dm</i>, вПспрПОзвеЎеММая МОже, переПпреЎеляет ЌакрПсы в пакете <i>Style</i>, кПтПрый Птвечает за сПзЎаМОе загПлПвка О МОжМей сМПскО Ма кажЎПй страМОце:\n
784
785<p>
786
787<pre>
788##########################################################################\n
789package Style\n
790##########################################################################\n
791\n
792
793&#095;collectionspecificstyle&#095; {\n
794&lt;link rel=\"stylesheet\" href=\"&#095;httpcimages&#095;/style.css\" type=\"text/css\" \n
795   title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
796&lt;style&gt;\n
797body.bgimage \\\{ background-image: none; \\\}\n
798a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
799&lt;/style&gt;\n
800}\n
801\n
802&#095;pagebanner&#095; {\n
803&lt;div class=\"pageinfo\"&gt; \n
804&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
805&lt;/div&gt;\n
806}\n
807</pre>\n
808
809<p>
810
811ЌакрПс загПлПвка страМОцы 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>, кПтПрый пПзвПляет ЎПбавОть к кПллекцОО стОлОстОческОе элеЌеМты к МабПру пП уЌПлчаМОю.
812
813<p>
814ЧтПбы ОспПльзПвать сПвершеММП ЎругПй стОль в кПллекцОО, выберОте ЌакрП <i>cssheader</i> в <i>extra.dm</i>. ЧтПбы всегП лОшь ЎПбавОть МескПлькП МПвых ÑÑ‚Олевых ÐŸÐ¿Ñ€ÐµÐŽÐµÐ»ÐµÐœÐžÐ¹ к стОлю пП уЌПлчаМОю, выберОте <i>collectionspecificstyle</i> в <i>extra.dm</i>. ЭтП былП сЎелаМП в этПй кПллекцОО. ВышеуказаМый ЌакрП <i>collectionspecificstyle</i> сПЎержОт таблОцу стОлей кПллекцОО, О переПпреЎеляет пару стОлей Ўля ОзПбражеМОй: ЗелеМая фПМПвая плаМка с завОткаЌО Осчезла, а фПМ МавОгацОПММПй паМелО теперь сОМОй.\n
815
816<p>
817МакрПс загПлПвкО страМОцы также вызывает <i>pagebanner</i>, чтПбы включОть эЌблеЌу кПллекцОО, кМПпкО home/help/preferences О ОзПбражеМОе слева вверху, кПтПрПе ОЎеМтОфОцОрует страМОцу (П страМОце, пПОскПвая страМОца О т.ÐŽ.). ПрПграЌЌа, указаММая выше, ПпреЎеляет баММер, чтПбы пПЎавОть этО ОзПбражеМОя. Как Вы ЌПжете вОЎеть, ПМО Ме пПявляются Маверху этПй страМОцы.\n
818
819<p>
820СлеЎующая часть <i>extra.dm</i> переПпреЎеляет ЌакрПс Ўля ПпОсаМОя О <i>пакете</i>, сПЎержащОйся в <a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>, кПтПрый геМерОрует страМОцу <i>«Об этПй кПллекцОО»</i>, кПтПрую Вы вОЎОте сейчас.
821
822<pre>
823##########################################################################\n
824package about\n
825##########################################################################\n
826\n
827&#095;content&#095; {\n
828&#095;navigationbar&#095;\n
829\n
830&#095;textabout&#095;\n
831\n
832&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
833&#095;help:simplehelp&#095;\n
834}
835</pre>\n
836
837МакрПсПЎержаМОе Ўля текста <i>О страМОце</i> ПбычМП сПЎержОт МавОгацОПММую лОМейку (сП ссылкаЌО к ППОску О любыЌ классОфОкатПраЌ), сПпрПвПжЎаеЌую ПпОсаМОеЌ «Об этПй кПллекцОО» О текстПЌ «Как МайтО ОМфПрЌацОю». ППскПльку ПМО ОзЌеМяются Пт ПЎМПй кПллекцОО к ЎругПй, ЌакрПc <i>navigationbar</i> ПпреЎелеМ вМутрО Greenstone О ОспПльзует ЌакрПс <i>navbarspacer</i>, кПтПрый был ПбсужЎеМ выше. МакрПс <i>content</i> Ўля ПпОсаМОя <i>О страМОце</i>, преЎставлеММый выше, ПтлОчается Пт ПбычМПгП (такПгП, как кПллекцОО <a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=p&p=about\">DLS</a>) теЌ, чтП МавОгацОПММая лОМейка Ме ПтцеМтрОрПваМа О зЎесь Мет МОкакПгП пПля пПОска.
838<p>
839
840СлеЎующая часть <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>.
841
842<pre>
843##############################################################################\n
844package query\n
845##############################################################################\n
846
847&#095;content&#095; {\n
848&#095;navigationbar&#095;\n
849\n
850&lt;center&gt;\n
851&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
852&lt;/center&gt;\n
853&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
854&lt;center&gt;\n
855&#095;searchhistorylist&#095;\n
856&lt;/center&gt;)\n
857&#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
858&lt;br&gt;\n
859}\n
860</pre>\n
861
862ОпреЎелеМОе <i>сПЎержаМОя</i> в стаМЎартМПЌ пакете <i>запрПса</i> пПЎПбМП версОО, ЎаММПй выше, за ОсключеМОеЌ тПгП, чтП ПМП пПЌещает в цеМтре ЌакрПс <i>navigationbar</i>, тПгЎа как вышеупПЌяМутая версОя Ме Ўелает этПгП О включает ЎПпПлМОтельМую зелеМую лОМейку. СравМОте <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">тП</a> О <a href=\"_gwcgi_?l=_cgiargl_&c=dls-e&a=q\">этП</a>.
863<p>
864
865
866Ѐайл <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>). ЀактОческО страМОцы, геМерОруеЌые классОфОкатПраЌО (МапрОЌер, спОскПЌ МаОЌеМПваМОй) также управляются О этОЌО ЌакрПсаЌО.
867
868<pre>
869##########################################################################\n
870package document\n
871##########################################################################\n
872\n
873&#095;textheader&#095; {\n
874&#095;cgihead&#095;\n
875&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
876}\n
877\n
878&#095;content&#095; {\n
879&#095;navigationbar&#095;\n
880\n
881&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
882&lt;p style=\"text-align: center;\"&gt;\n
883&#095;phindclassifier&#095;\n
884&#095;collageclassifier&#095;\n
885&lt;/p&gt;\n
886)\n
887\n
888&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
889&lt;ul id=\"searchresults\"&gt;\n
890&#095;prevsearchresult&#095;\n
891&#095;nextsearchresult&#095;\n
892&lt;/ul&gt;)\n
893\n
894&lt;div class=\"document\"&gt;\n
895}
896</pre>\n
897
898ГрОМстПуМ аММулОрует ЌакрП <i>header</i>, еслО ОзПбражеМ ЎПкуЌеМт (а Ме классОфОкатПр). ПреЎпПлПжОЌ, Ќы Ме хПтОЌ этПгП. ВышестПящОй кПЎ переПпреЎеляет ЌакрП <i>textheader</i> (ПбычМП ПпреЎелеММПЌ в <i>document.dm</i>) в качестве первПМачальМПгП сПЎержаМОя ЌакрП <i>header</i>. ВышестПящее ПпреЎелеМОе  <i>content</i> аММулОрует зМачеМОе пП-уЌПлчаМОю, так чтП МавОгацОПММПе ЌеМю Ме цеМтрОруется.
899"
Note: See TracBrowser for help on using the browser.