source: collections/documented-examples/trunk/garish-e/etc/collect.cfg@ 20507

Last change on this file since 20507 was 20507, checked in by anna, 13 years ago

Improved Spanish translations of the documented example collections. Many thanks to Diego Spano.

  • Property svn:executable set to *
File size: 66.4 KB
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 -metadata dls.Organization -sort_leaf_nodes_using dls.Title -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 colorida de la colección de muestra"
70
71collectionmeta .text [l=es] "texto"
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] "الم
95وضوعات"
96collectionmeta .dls.Organization [l=ar] "الم
97ن؞م
98ات"
99collectionmeta .dls.Keyword [l=ar] "إر؎اد"
100collectionmeta .document [l=ar] "كتاؚ"
101collectionmeta .section [l=ar] "فصل"
102
103# -- Brazilian Portuguese strings ----------------
104
105collectionmeta .text [l=pt-br] "texto"
106collectionmeta .dls.Title,Title [l=pt-br] "títulos"
107collectionmeta .dls.Subject [l=pt-br] "assuntos"
108collectionmeta .dls.Organization [l=pt-br] "organizações"
109collectionmeta .dls.Keyword [l=pt-br] "como fazer"
110collectionmeta .document [l=pt-br] "livro"
111collectionmeta .section [l=pt-br] "capítulo"
112
113# -- Thai strings ----------------
114collectionmeta .text [l=th] "àž‚à¹‰àž­àž„àž§àž²àž¡"
115collectionmeta .dls.Title,Title [l=th] "àžŠàž·à¹ˆàž­à¹€àž£àž·à¹ˆàž­àž‡"
116collectionmeta .dls.Subject [l=th] "àž«àž±àž§à¹€àž£àž·à¹ˆàž­àž‡"
117collectionmeta .dls.Organization [l=th] "àž«àž™à¹ˆàž§àž¢àž‡àž²àž™"
118collectionmeta .dls.Keyword [l=th] "àž§àžŽàž˜àžµà¹ƒàžŠà¹‰"
119
120collectionmeta .document [l=th] "àž«àž™àž±àž‡àžªàž·àž­"
121collectionmeta .section [l=th] "àžšàž—"
122
123# -- Simplified Chinese strings ----------------
124collectionmeta collectionname [l=zh] "Garish版本的挔瀺銆藏"
125
126collectionmeta .text [l=zh] "文本"
127collectionmeta .dls.Title,Title [l=zh] "题名"
128collectionmeta .dls.Subject [l=zh] "䞻题"
129collectionmeta .dls.Organization [l=zh] "机构"
130collectionmeta .dls.Keyword [l=zh] "劂䜕"
131
132collectionmeta .document [l=zh] "乊"
133collectionmeta .section [l=zh] "ç« "
134
135# -- English text ----------------
136collectionmeta 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
137
138<h3>How the collection works</h3>\n
139
140<p>
141The appearance of Greenstone collections is defined by \"macro files\" in the
142<i>greenstone/macros</i> directory, and can be completely altered by changing the contents of these files.
143Editing 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
144<p>
145To separate presentation details from the macro files,
146Greenstone uses <i>Cascading Style Sheets</i>
147(see <a href=\"http://www.w3.org/Style/CSS/\">http://www.w3.org/Style/CSS/</a> for
148more information), which allow you to specify fonts, colours, spacings, and
149other 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
150for those unfamiliar with cascading style sheets. Some of the
151macros in <i>extra.dm</i> reference images that have been placed in
152<i>greenstone/collect/_cgiargc_/images</i>.\n
153<p>
154The
155<a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
156macro file overrides some of the macros that Greenstone
157uses by default. In macro files, the \"\#\" character signals a comment line
158(<i>extra.dm</i> is commented to help explain what it does).
159Macros themselves are signalled by
160underscores, and they can reference other macros. This means that the
161content of a page can be split into many small chunks, and it can be
162difficult to work through the chain of which macro calls what. Fortunately,
163changes in macros (like changes in format strings) take effect immediately
164unless you are using the Greenstone local library server, in which case the
165server needs to be restarted. This makes it easy to experiment by editing
166the macro files.\n
167
168<p>
169Macros are grouped into \"packages\". But each package does not necessarily reside in
170a single file. The <i>Global</i> package, most of which is in file
171<a href=\"_httpprefix_/macros/base.dm\" target=macro>base.dm</a>
172(parts of it are also in the language-specific macro files such as
173<a href=\"_httpprefix_/macros/english.dm\" target=macro>english.dm</a> and
174<a href=\"_httpprefix_/macros/french.dm\" target=macro>french.dm</a>),
175contains default macros that can be overridden by macros in other packages. Here is the part
176of <i>extra.dm</i> that redefines global macros.
177<pre>
178##########################################################################\n
179package Global\n
180##########################################################################\n
181\n
182&#095;starthighlight&#095; {&lt;b&gt;}\n
183&#095;endhighlight&#095; {&lt;/b&gt;}\n
184\n
185&#095;navbarspacer&#095; { \n
186&lt;br/&gt;\n
187&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
188&lt;br/&gt;\n
189}\n
190</pre>\n
191The values of <i>starthighlight</i> and <i>endhighlight</i> are used to
192highlight query terms when displaying a document. The default is to set the
193background to yellow. The first specification above places query terms in
194bold instead.\n
195
196<p>
197Next, the <i>navbarspacer</i> macro is what separates the search button and
198classifier buttons in the navigation bar. It is normally Greenstone\'s
199familiar horizontal green bar. The following definition has the effect of
200stacking the buttons vertically, one above the other.
201<pre>
202&#095;navbarspacer&#095; {&lt;br\/&gt;}
203</pre>\n
204
205The definition of <i>navbarspacer</i> given earlier uses the image
206<i>horzline.gif</i> as a separator (this image appears in the
207<i>images</i> directory of the collection). The effect can be seen at the top of this page.\n
208
209<p>
210To arrange the buttons horizontally, still using
211<i>horzline.gif</i> instead of the green bar as separator,
212remove the <i>br</i> tags and define the body of the macro
213(the part in curly brackets) to be:
214<pre>
215&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
216width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
217</pre>\n
218
219The <i>widthtspace</i> variable gives the width of the gap between the
220buttons, which Greenstone calculates.\n
221
222<p>
223The part of <i>extra.dm</i> reproduced below redefines macros in the
224<i>Style</i> package, which is responsible for creating the header and
225footer of every page, and defining common style information:
226<pre>
227##########################################################################\n
228package Style\n
229##########################################################################\n
230\n
231
232&#095;collectionspecificstyle&#095; {\n
233&lt;link rel=\"stylesheet\" href=\"&#095;httpcstyle&#095;/style.css\" type=\"text/css\" \n
234title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
235&lt;style&gt;\n
236body.bgimage \\\{ background-image: none; \\\}\n
237a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
238&lt;/style&gt;\n
239}\n
240\n
241&#095;pagebanner&#095; {\n
242&lt;div class=\"pageinfo\"&gt; \n
243&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
244&lt;/div&gt;\n
245}\n
246</pre>\n
247
248Greenstone\'s page header macro, which is called <i>header</i> in
249<a href=\"_httpprefix_/macros/style.dm\" target=macro>style.dm</a>,
250prints the collection\'s name or logo, and links to the
251home, help, and preferences pages. It calls the macro <i>htmlhead</i> which
252outputs 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.
253
254<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.
255
256<p>
257The page header macro also calls <i>pagebanner</i> to include the collection\'s logo,
258home/help/preferences buttons, and the image at the top left that
259identifies the page (about page, search page, etc). The code above
260redefines the banner to suppress all these images except for the home page button -- as you can see, they don\'t appear
261at the top of this page.\n
262
263<p>
264The next part of <i>extra.dm</i> redefines macros in the <i>about</i>
265package (contained in
266<a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>), which generates the
267\"About this collection\" page that you are looking at now:
268<pre>
269##########################################################################\n
270package about\n
271##########################################################################\n
272\n
273&#095;content&#095; {\n
274&#095;navigationbar&#095;\n
275\n
276&#095;textabout&#095;\n
277\n
278&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
279&#095;help:simplehelp&#095;\n
280}
281</pre>\n
282
283The macro <i>content</i> for the <i>About</i> page normally contains the
284navigation bar (with links to <i>Search</i> and any classifiers),
285followed by \"About this collection\" and \"how to find information\"
286text. Because it changes from one collection to another, the
287<i>navigationbar</i> macro is defined internally by Greenstone, and uses
288the <i>navbarspacer</i> macro discussed above. The <i>content</i> macro for
289the <i>About</i> page, given above, differs from the regular one
290(such as the one for the demo collection <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=p&p=about\">here</a>)
291in that the navigation bar is not centered, and there is no search box.\n
292
293<p>
294The next part of <i>extra.dm</i> redefines macros in the <i>query</i> package (in
295<a href=\"_httpprefix_/macros/query.dm\" target=macro>query.dm</a>),
296which is used to generate the
297<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">search page</a>:
298<pre>
299##############################################################################\n
300package query\n
301##############################################################################\n
302
303&#095;content&#095; {\n
304&#095;navigationbar&#095;\n
305\n
306&lt;center&gt;\n
307&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
308&lt;/center&gt;\n
309&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
310&lt;center&gt;\n
311&#095;searchhistorylist&#095;\n
312&lt;/center&gt;)\n
313&#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
314&lt;br&gt;\n
315}\n
316</pre>\n
317
318The definition of <i>content</i> in the standard <i>query</i> package is
319similar to the version given above, except that it centers the
320<i>navigationbar</i> macro, whereas the above version does not, and it
321includes an additional green bar. Compare
322<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">this</a>
323and
324<a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=q\">this</a>.\n
325
326<p>
327The file
328<a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
329also redefines macros in the <i>document</i> package,
330which is used to display documents (see
331<a href=\"_httpprefix_/macros/document.dm\" target=macro>document.dm</a>). In fact, pages
332generated by classifiers (e.g. lists of titles) are also governed by these macros.
333<pre>
334##########################################################################\n
335package document\n
336##########################################################################\n
337\n
338&#095;textheader&#095; {\n
339&#095;cgihead&#095;\n
340&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
341}\n
342\n
343&#095;content&#095; {\n
344&#095;navigationbar&#095;\n
345\n
346&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
347&lt;p style=\"text-align: center;\"&gt;\n
348&#095;phindclassifier&#095;\n
349&#095;collageclassifier&#095;\n
350&lt;/p&gt;\n
351)\n
352\n
353&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
354&lt;ul id=\"searchresults\"&gt;\n
355&#095;prevsearchresult&#095;\n
356&#095;nextsearchresult&#095;\n
357&lt;/ul&gt;)\n
358\n
359&lt;div class=\"document\"&gt;\n
360}\n
361</pre>\n
362
363Greenstone overrides the <i>header</i> macro if a document (and not a
364classifier) is being displayed. Suppose we don\'t want it to. The code
365above redefines the <i>textheader</i> macro (normally defined in
366<i>document.dm</i>) to be the content of the original <i>header</i> macro. The definition of <i>content</i> above overrides the
367default so that the navigation bar is not centered.
368"
369
370# -- French text ----------------
371collectionmeta collectionextra [l=fr] "
372Cette 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.
373
374<h3>Comment la collection marche</h3>
375
376<p>
377L\'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
378<p>
379Pour 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
380<p>
381Le fichier de macros <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>
382l\'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.
383
384<p>
385Les 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
386<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>),
387contient 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.
388
389<pre>
390##########################################################################\n
391package Global\n
392##########################################################################\n
393\n
394&#095;starthighlight&#095; {&lt;b&gt;}\n
395&#095;endhighlight&#095; {&lt;/b&gt;}\n
396\n
397&#095;navbarspacer&#095; { \n
398&lt;br/&gt;\n
399&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
400&lt;br/&gt;\n
401}\n
402</pre>\n
403
404Les 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.
405
406<p>
407Ensuite, 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.
408<pre>
409&#095;navbarspacer&#095; {&lt;br\/&gt; }
410</pre>\n
411
412La 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
413
414<p>
415Pour 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:
416<pre>
417&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
418width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
419</pre>\n
420
421La variable <i>widthtspace</i> donne la largeur de l\'espace entre les boutons que Greenstone calcule.
422
423<p>
424La 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:
425
426<pre>
427##########################################################################\n
428package Style\n
429##########################################################################\n
430\n
431
432&#095;collectionspecificstyle&#095; {\n
433&lt;link rel=\"stylesheet\" href=\"&#095;httpcstyle&#095;/style.css\" type=\"text/css\" \n
434title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
435&lt;style&gt;\n
436body.bgimage \\\{ background-image: none; \\\}\n
437a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
438&lt;/style&gt;\n
439}\n
440\n
441&#095;pagebanner&#095; {\n
442&lt;div class=\"pageinfo\"&gt; \n
443&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
444&lt;/div&gt;\n
445}\n
446</pre>\n
447
448La macro de l\'en-tête de la page de Greenstone, appelée <i>header</i> dans
449<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.
450<p>
451Pour 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
452<p>
453La 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
454
455<p>
456La 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:
457<pre>
458##########################################################################\n
459package about\n
460##########################################################################\n
461\n
462&#095;content&#095; {\n
463&#095;navigationbar&#095;\n
464\n
465&#095;textabout&#095;\n
466\n
467&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
468&#095;help:simplehelp&#095;\n
469}
470</pre>\n
471
472La 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>)
473en ce sens que la barre de navigation n\'est pas centrée et qu\'il n\'y a pas de boîte de recherche.
474
475<p>
476La 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>),
477qui est utilisé pour générer la <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">page de recherche</a>:
478<pre>
479##############################################################################\n
480package query\n
481##############################################################################\n
482
483&#095;content&#095; {\n
484&#095;navigationbar&#095;\n
485\n
486&lt;center&gt;\n
487&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
488&lt;/center&gt;\n
489&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
490&lt;center&gt;\n
491&#095;searchhistorylist&#095;\n
492&lt;/center&gt;)\n
493&#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
494&lt;br&gt;\n
495}\n
496</pre>\n
497
498La 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
499<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">ceci</a> à <a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=q\">ceci</a>.
500
501<p>
502Le 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
503<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.
504
505<pre>
506##########################################################################\n
507package document\n
508##########################################################################\n
509\n
510&#095;textheader&#095; {\n
511&#095;cgihead&#095;\n
512&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
513}\n
514\n
515&#095;content&#095; {\n
516&#095;navigationbar&#095;\n
517\n
518&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
519&lt;p style=\"text-align: center;\"&gt;\n
520&#095;phindclassifier&#095;\n
521&#095;collageclassifier&#095;\n
522&lt;/p&gt;\n
523)\n
524\n
525&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
526&lt;ul id=\"searchresults\"&gt;\n
527&#095;prevsearchresult&#095;\n
528&#095;nextsearchresult&#095;\n
529&lt;/ul&gt;)\n
530\n
531&lt;div class=\"document\"&gt;\n
532}\n
533</pre>\n
534
535Greenstone 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.
536"
537
538# -- Spanish text ----------------
539collectionmeta collectionextra [l=es] "
540Esta 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.
541<p>
542
543<h3>Cómo trabaja esta colección</h3>
544<p>
545La apariencia de las colecciones Greenstone se define por medio de los \"archivos de macros\" que se encuentran en el directorio de <i>greenstone/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 las macros modificadas en un archivo llamado <i>extra.dm</i> en el directorio <i>macros</i> de la colección. Por ejemplo, este directorio utiliza un archivo llamado <a href=\"_httpcollection_/macros/extra.dm\">greenstone/collect/_cgiargc_/macros/extra.dm</a>. \n
546
547
548<p>
549Para 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 hoja de estilos Greenstone estándar está guardada en <a href=\"_httpstyle_/style.css\">greenstone/web/style/style.css</a>. Esta colección especifica una hoja de estilo auxiliar, <a href=\"_httpcstyle_/style.css\">greenstone/collect/_cgiargc_/style/style.css</a>, a ser usada en adición a la default. Esto incluye algunos comentarios para aquellos que no están familiarizados con hojas de estilo. Algunas de las macros en <i>extra.dm</i> refieren a imágenes que han sido colocadas en <i>greenstone/collect/_cgiargc_/images</i>.\n
550
551
552<p>
553
554El 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 \"_\" 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.
555<p>
556
557
558Las 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:
559<p>
560
561<pre>
562##########################################################################\n
563package Global\n
564##########################################################################\n
565\n
566&#095;starthighlight&#095; {&lt;b&gt;}\n
567&#095;endhighlight&#095; {&lt;/b&gt;}\n
568\n
569&#095;navbarspacer&#095; { \n
570&lt;br/&gt;\n
571&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
572&lt;br/&gt;\n
573}\n
574</pre>\n
575
576<p>
577Los 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.
578<p>
579
580A 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.
581<p>
582
583<pre>
584&#095;navbarspacer&#095; {&lt;br\/&gt;} \n
585</pre>\n
586<p>
587
588La definición de <i>navbarspacer</i> dada anteriormente usa la imagen <i>horzline.gif</i> como un separador (esta imagen 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
589<p>
590
591Para 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:
592<p>
593
594<pre>
595&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
596width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
597</pre>\n
598<p>
599
600La variable <i>widthtspace</i> da el ancho del espacio entre los botones, lo cual es calculado por Greenstone.
601<p>
602
603La 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 estilo común:
604
605<p>
606
607<pre>
608##########################################################################\n
609package Style\n
610##########################################################################\n
611\n
612
613&#095;collectionspecificstyle&#095; {\n
614&lt;link rel=\"stylesheet\" href=\"&#095;httpcstyle&#095;/style.css\" type=\"text/css\" \n
615title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
616&lt;style&gt;\n
617body.bgimage \\\{ background-image: none; \\\}\n
618a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
619&lt;/style&gt;\n
620}\n
621\n
622&#095;pagebanner&#095; {\n
623&lt;div class=\"pageinfo\"&gt; \n
624&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
625&lt;/div&gt;\n
626}\n
627</pre>\n
628
629<p>
630
631La macro de encabezado de página de Greenstone, llamada <i>header</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. Esta llama a la macro <i>cssheader</i> la cual le imprime el formato a la página. Esta macro incluye a <i>collectionspecificstyle</i> la cual permite a la colección sumar algunos elementos de estilo al default.
632
633<p>
634Para utilizar enteramente el nuevo estilo para la colección, especifique la macro <i>cssheader</i> en <i>extra.dm</i>. Para simplemente agregar un par de declaraciones de estilos al estilo por defecto, especifique <i>collectionspecificstyle</i> en <i>extra.dm</i>. Eso es lo que la colección ha hecho. La macro mencionada arriba, <i>collectionspecificstyle</i> incluye el \'stylesheet\' propio de la colección, y a la vez anula un par de declaraciones de imagen, 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.
635<p>
636La 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 banner con el fin de suprimir estas imágenes, a excepción del botón de la página de inicio-- como se puede ver aquí, no aparecen en la parte superior de esta página.
637<p>
638
639La 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.
640<p>
641
642<pre>
643##########################################################################\n
644package about\n
645##########################################################################\n
646\n
647&#095;content&#095; {\n
648&#095;navigationbar&#095;\n
649\n
650&#095;textabout&#095;\n
651\n
652&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
653&#095;help:simplehelp&#095;\n
654}
655</pre>\n
656<p>
657
658La macro <i>content</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 ésta cambia de una colección a otra, la macro <i>navigationbar</i> es definida internamente por Greenstone y utiliza la macro <i>navbarspacer</i> descripta 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.
659<p>
660
661La siguiente parte de <i>extra.dm</i> redefine las macros del paquete <i>query</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>.
662<p>
663
664<pre>
665##############################################################################\n
666package query\n
667##############################################################################\n
668
669&#095;content&#095; {\n
670&#095;navigationbar&#095;\n
671\n
672&lt;center&gt;\n
673&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
674&lt;/center&gt;\n
675&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
676&lt;center&gt;\n
677&#095;searchhistorylist&#095;\n
678&lt;/center&gt;)\n
679&#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
680&lt;br&gt;\n
681}\n
682</pre>\n
683<p>
684
685La definición de <i>content</i> en el paquete de <i>query</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>.
686<p>
687
688El archivo <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> también redefine las macros del paquete <i>document</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.
689<p>
690
691<pre>
692##########################################################################\n
693package document\n
694##########################################################################\n
695\n
696&#095;textheader&#095; {\n
697&#095;cgihead&#095;\n
698&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
699}\n
700\n
701&#095;content&#095; {\n
702&#095;navigationbar&#095;\n
703\n
704&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
705&lt;p style=\"text-align: center;\"&gt;\n
706&#095;phindclassifier&#095;\n
707&#095;collageclassifier&#095;\n
708&lt;/p&gt;\n
709)\n
710\n
711&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
712&lt;ul id=\"searchresults\"&gt;\n
713&#095;prevsearchresult&#095;\n
714&#095;nextsearchresult&#095;\n
715&lt;/ul&gt;)\n
716\n
717&lt;div class=\"document\"&gt;\n
718}\n
719</pre>\n
720<p>
721
722Greenstone anula la 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 la macro <i>textheader</i> (normalmente definida 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 navegación no esté centrada.
723"
724
725# -- Russian text ----------------
726collectionmeta collectionextra [l=ru] "
727Эта ЎеЌПМстрацОПММая кПллекцОя сПЎержОт тПт же ЌатерОал, чтП О ПрОгОМальМая ЎеЌПМстрацОПММая кПллекцОя Greenstone, МП её вОЎ был ОзЌеМеМ., чтПбы улучшОть резкПсть.
728<p>
729
730<h3>Как рабПтает кПллекцОя</h3>
731<p>
732ВОЎ кПллекцОй ГрОМстПуМ заЎается «ЌакрПфайлаЌО» в ЎОректПрОО ЌакрПса (<i>greenstone/macros</i>>) О ЌПжет быть пПлМПстью ОзЌеМеМП с пПЌПщью ЌПЎОфОкацОй в файлах
733 ЌакрПсПв. ЭтО ЌПЎОфОкацОО ОзЌеМят вОЎ всех
734 кПллекцОй. ЧтПбы ОзЌеМОть вОЎ всегП лОшь ПЎМПй кПллекцОО, пПЌестОте сППтветствующОй ЌПЎОфОцОрПваММый ЌакрПс в файл МазваММый <i>extra.dm</i> в папке <i>macros</i> этПй кПллекцОО. НапрОЌер, эта кПллекцОя ОспПльзует файл <a href=\"_httpcollection_/macros/extra.dm\">greenstone/collect/_cgiargc_/macros/extra.dm</a>.\n
735<p>
736
737Для ПтЎелеМОя МекПтПрых
738 Ўеталей презеМтацОО Пт ЌакрПфайлПв ГрОМстПуМ ОспПльзует <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>, кПтПрый сПЎержОт МескПлькП кПЌЌеМтарОев Ўля тех
739, ктП Ме разбОрается с CSS. НекПтПрые ЌакрПсы в <i>extra.dm</i> ОЌеют ссылкО к ОзПбражеМОяЌ пПЌещеММыЌ в <i>greenstone/collect/_cgiargc_/images</i>.\n
740
741<p>
742
743МакрПфайл <a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a> Птвергает часть ЌакрПсПв, кПтПрые ОспПльзуются в Greenstone пП уЌПлчаМОю. В ЌакрПфайлах
744 \"\#\" ПпПвещает П стрПке кПЌЌеМтарОев (<i>extra.dm</i> сПЎержОт кПЌЌеМтарОО, чтПбы пПЌПчь ПбъясМОть, чтП ПМ Ўелает). СаЌО ЌакрПсы сППбщаются путеЌ пПЎчеркОваМОя, О ПМО ЌПгут Пбращаться к ЎругОЌ ЌакрПсаЌ. ЭтП ПзМачает, чтП сПЎержаМОе страМОцы ЌПжет быть разбОтП Ма ЌМПгОе ЌалеМькОе кускО, О ЌПгут вПзМОкать труЎМПстО прО рабПте пП цепО, кПтПрую ЌакрПс вызывает. К счастью, ОзЌеМеМОя в ЌакрПсах
745, пПЎПбМП ОзЌеМеМОяЌ в фПрЌатМых
746 стрПках
747, вступают в сОлу МеЌеЎлеММП, еслО Вы Ме ОспПльзуете сервер лПкальМПй бОблОПтекО Greenstone, в случае чегП сервер МужЎается в перезагрузке. ЭтП Пблегчает эксперОЌеМтОрПваМОе путеЌ реЎактОрПваМОя ЌакрПфайлПв.
748<p>
749
750
751МакрПсы сгруппОрПваМы в «пакеты». НП кажЎый пакет Ме ПбязательМП разЌещается в ПтЎельМПЌ файле. <i>ГлПбальМый</i> пакет, бПльшая часть кПтПрПгП Мах
752ПЎОтся в файле <a href=\"_httpprefix_/macros/base.dm\" target=macro>base.dm</a> (часть егП Мах
753ПЎОтся также в спецОфОческОх
754 языкПвых
755 ЌакрПфайлах
756 тОпа <a href=\"_httpprefix_/macros/english.dm\" target=macro>english.dm</a> О <a href=\"_httpprefix_/macros/french.dm\" target=macro>french.dm</a>), сПЎержОт ЌакрПсы пП уЌПлчаМОю, кПтПрые ЌПгут быть ПтвергМутыЌО ЌакрПсаЌО в ЎругОх
757 пакетах
758. ЗЎесь ОЌеется часть <i>extra.dm</i>.
759
760<pre>
761##########################################################################\n
762package Global\n
763##########################################################################\n
764\n
765&#095;starthighlight&#095; {&lt;b&gt;}\n
766&#095;endhighlight&#095; {&lt;/b&gt;}\n
767\n
768&#095;navbarspacer&#095; { \n
769&lt;br/&gt;\n
770&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
771&lt;br/&gt;\n
772}\n
773</pre>\n
774
775кПтПрая ПпреЎеляет глПбальМые ЌакрПсы, зМачеМОя <i>starthighlight</i> О <i>endhighlight</i> ОспПльзуются Ўля пПЎсвечОваМОя терЌОМПв запрПса прО преЎставлеМОО ЎПкуЌеМта. ПП уЌПлчаМОю ЎПлжеМ быть устаМПвлеМ желтый фПМ. Первая спецОфОкацОя вЌестП этПгП выЎеляет запрПс пПлужОрМыЌ шрОфтПЌ.
776<p>
777
778СлеЎующОй ЌакрПс <i>navbarspacer</i> служОт Ўля тПгП, чтПбы ПтЎелОть кМПпку пПОска О кМПпкО классОфОкатПрПв в МавОгацОПММПй лОМейке. ОбычМП этП х
779ПрПшП зМакПЌая в Greenstone гПрОзПМтальМая зелеМая лОМейка. СлеЎущее ПпреЎелеМОе ОЌеет эффект вертОкальМПгП распПлПжеМОя кМПпПк, ПЎМа МаЎ ЎругПй.
780<p>
781<pre>
782&#095;navbarspacer&#095; {&lt;br\/&gt;}
783</pre>\n
784<p>
785
786ОпреЎелеМОе <i>navbarspacer</i>, ЎаММПе раМее ОспПльзует рОсуМПк <i>horzline.gif</i> в качестве разЎелОтеля (этПт рОсуМПк сПЎержОтся в папке кПллекцОО пПЎ МазваМОеЌ <i>images</i>). Эффект вОЎеМ в Мачале этПй страМОцы.\n
787
788<p>
789
790РазЌещеМОе кМПпПк гПрОзПМтальМП, все ещё ОспПльзуя <i>horzline.gif</i>, вЌестП зелеМПй лОМейкО как разЎелОтеля, уЎаляя тэгО <i>br</i> О ПпреЎеляет телП ЌакрПса (часть в фОгурМых
791 скПбках
792), как:
793
794<p>
795<pre>
796&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
797width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
798</pre>\n
799
800<p>
801ПереЌеММая <i>widthtspace</i> заЎаёт шОрОМу прПЌежутка ЌежЎу кМПпкаЌО, кПтПрую вычОсляет Greenstone.
802<p>
803
804
805Часть <i>extra.dm</i>, вПспрПОзвеЎеММая МОже, переПпреЎеляет ЌакрПсы в пакете <i>Style</i>, кПтПрый Птвечает за сПзЎаМОе загПлПвка О МОжМей сМПскО Ма кажЎПй страМОце:\n
806
807<p>
808
809<pre>
810##########################################################################\n
811package Style\n
812##########################################################################\n
813\n
814
815&#095;collectionspecificstyle&#095; {\n
816&lt;link rel=\"stylesheet\" href=\"&#095;httpcstyle&#095;/style.css\" type=\"text/css\" \n
817title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
818&lt;style&gt;\n
819body.bgimage \\\{ background-image: none; \\\}\n
820a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
821&lt;/style&gt;\n
822}\n
823\n
824&#095;pagebanner&#095; {\n
825&lt;div class=\"pageinfo\"&gt; \n
826&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
827&lt;/div&gt;\n
828}\n
829</pre>\n
830
831<p>
832
833ЌакрПс загПлПвка страМОцы 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>, кПтПрый пПзвПляет ЎПбавОть к кПллекцОО стОлОстОческОе элеЌеМты к МабПру пП уЌПлчаМОю.
834
835<p>
836ЧтПбы ОспПльзПвать сПвершеММП ЎругПй стОль в кПллекцОО, выберОте ЌакрП <i>cssheader</i> в <i>extra.dm</i>. ЧтПбы всегП лОшь ЎПбавОть МескПлькП МПвых
837 стОлевых
838 ПпреЎелеМОй к стОлю пП уЌПлчаМОю, выберОте <i>collectionspecificstyle</i> в <i>extra.dm</i>. ЭтП былП сЎелаМП в этПй кПллекцОО. ВышеуказаМый ЌакрП <i>collectionspecificstyle</i> сПЎержОт таблОцу стОлей кПллекцОО, О переПпреЎеляет пару стОлей Ўля ОзПбражеМОй: ЗелеМая фПМПвая плаМка с завОткаЌО Осчезла, а фПМ МавОгацОПММПй паМелО теперь сОМОй.\n
839
840<p>
841МакрПс загПлПвкО страМОцы также вызывает <i>pagebanner</i>, чтПбы включОть эЌблеЌу кПллекцОО, кМПпкО home/help/preferences О ОзПбражеМОе слева вверх
842у, кПтПрПе ОЎеМтОфОцОрует страМОцу (П страМОце, пПОскПвая страМОца О т.ÐŽ.). ПрПграЌЌа, указаММая выше, ПпреЎеляет баММер, чтПбы пПЎавОть этО ОзПбражеМОя. Как Вы ЌПжете вОЎеть, ПМО Ме пПявляются Маверх
843у этПй страМОцы.\n
844
845<p>
846СлеЎующая часть <i>extra.dm</i> переПпреЎеляет ЌакрПс Ўля ПпОсаМОя О <i>пакете</i>, сПЎержащОйся в <a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>, кПтПрый геМерОрует страМОцу <i>«Об этПй кПллекцОО»</i>, кПтПрую Вы вОЎОте сейчас.
847
848<pre>
849##########################################################################\n
850package about\n
851##########################################################################\n
852\n
853&#095;content&#095; {\n
854&#095;navigationbar&#095;\n
855\n
856&#095;textabout&#095;\n
857\n
858&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
859&#095;help:simplehelp&#095;\n
860}
861</pre>\n
862
863МакрПсПЎержаМОе Ўля текста <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>) теЌ, чтП МавОгацОПММая лОМейка Ме ПтцеМтрОрПваМа О зЎесь Мет МОкакПгП пПля пПОска.
864<p>
865
866СлеЎующая часть <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>.
867
868<pre>
869##############################################################################\n
870package query\n
871##############################################################################\n
872
873&#095;content&#095; {\n
874&#095;navigationbar&#095;\n
875\n
876&lt;center&gt;\n
877&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
878&lt;/center&gt;\n
879&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
880&lt;center&gt;\n
881&#095;searchhistorylist&#095;\n
882&lt;/center&gt;)\n
883&#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
884&lt;br&gt;\n
885}\n
886</pre>\n
887
888ОпреЎелеМОе <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>.
889<p>
890
891
892Ѐайл <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>). ЀактОческО страМОцы, геМерОруеЌые классОфОкатПраЌО (МапрОЌер, спОскПЌ МаОЌеМПваМОй) также управляются О этОЌО ЌакрПсаЌО.
893
894<pre>
895##########################################################################\n
896package document\n
897##########################################################################\n
898\n
899&#095;textheader&#095; {\n
900&#095;cgihead&#095;\n
901&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
902}\n
903\n
904&#095;content&#095; {\n
905&#095;navigationbar&#095;\n
906\n
907&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
908&lt;p style=\"text-align: center;\"&gt;\n
909&#095;phindclassifier&#095;\n
910&#095;collageclassifier&#095;\n
911&lt;/p&gt;\n
912)\n
913\n
914&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
915&lt;ul id=\"searchresults\"&gt;\n
916&#095;prevsearchresult&#095;\n
917&#095;nextsearchresult&#095;\n
918&lt;/ul&gt;)\n
919\n
920&lt;div class=\"document\"&gt;\n
921}
922</pre>\n
923
924ГрОМстПуМ аММулОрует ЌакрП <i>header</i>, еслО ОзПбражеМ ЎПкуЌеМт (а Ме классОфОкатПр). ПреЎпПлПжОЌ, Ќы Ме х
925ПтОЌ этПгП. ВышестПящОй кПЎ переПпреЎеляет ЌакрП <i>textheader</i> (ПбычМП ПпреЎелеММПЌ в <i>document.dm</i>) в качестве первПМачальМПгП сПЎержаМОя ЌакрП <i>header</i>. ВышестПящее ПпреЎелеМОе <i>content</i> аММулОрует зМачеМОе пП-уЌПлчаМОю, так чтП МавОгацОПММПе ЌеМю Ме цеМтрОруется.
926"
927
928# -- Simplified Chinese text ----------------
929collectionmeta collectionextra [l=zh] "
930本銆藏所包
931含的文档䞎Greenstone挔瀺銆藏䞭的䞀样䜆å…
932¶å€–观被曎改䞺garish风栌。\n
933
934<h3>本銆藏劂䜕工䜜</h3>\n
935
936<p>Greenstone銆藏的倖观由<i>greenstone/macros</i>目圕䞋的\"宏文件\"定义修改这些文件的内
937容将曎改所有銆藏的倖观。
938劂果只修改䞀䞪銆藏的倖观将修改后的宏攟å…
939¥è¯¥éŠ†è—<i>macros</i>目圕䞋的<i>extra.dm</i>文件䞭。䟋劂这䞪銆藏䜿甚这䞪文件
940<a href=\"_httpcollection_/macros/extra.dm\">greenstone/collect/_cgiargc_/macros/extra.dm</a>。\n
941
942<p>䞺了将呈现细节从宏文件䞭分犻出来Greenstone䜿甚<i>层级样匏衚</i>曎倚信息请参见<a href=\"http://www.w3.org/Style/CSS/\">
943http://www.w3.org/Style/CSS/</a>这å…
944è®žæŒ‡å®šHTML页面的字䜓、颜色、闎隔以及å…
945¶ä»–å…
946ƒçŽ ã€‚标准的Greenstone样匏衚䜍于
947<a href=\"_httpstyle_/style.css\">greenstone/web/style/style.css</a>。本銆藏䜿甚䞀䞪附属的样匏衚
948<a href=\"_httpcstyle_/style.css\">greenstone/collect/_cgiargc_/style/style.css</a>䞎猺省样匏衚䞀起䜿甚。该样匏衚包
949括䞀些泚释信息以
950䟿䞍熟悉层级样匏衚的人理解。<i>extra.dm</i>文件䞭的䞀些宏匕甚了䜍于<i>greenstone/collect/_cgiargc_/images</i>䞭的囟片。\n
951
952<p><a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>宏文件将芆写Greenstone的猺省宏。圚宏文件䞭
953\"\#\"笊号衚瀺䞀䞪泚释行<i>extra.dm</i>䞭已添加泚释以䟿诎明å…
954¶åŠŸèƒœïŒ‰ã€‚宏本身由䞋划线匀始而䞔可以匕甚å…
955¶ä»–宏。这意味着䞀䞪页面的内
956容
957可以被分割成埈倚小块而䞔埈隟察看敎䞪匕甚铟来匄枅
958楚哪䞪宏调甚了哪䞪宏。幞运的是宏圓䞭的曎改劂同栌匏参数䞭的曎改胜立即见效陀非圓
959前䜿甚的是Greenstone本地服务噚暡匏圚这种情
960况䞋需芁重启服务噚。这䜿埗调试宏文件变埗埈容易。
961
962<p>这些宏按\"packages\"包
963分组。䜆是并䞍每䞪包
964郜䞍需芁䞀䞪单独的文件。<i>Global</i>å…
965šå±€ïŒ‰åŒ…
966倧郚分存圚于
967<a href=\"_httpprefix_/macros/base.dm\" target=macro>base.dm</a>文件䞭也有䞀郚分保存圚语蚀盞å…
968³çš„宏文件䞭比劂
969<a href=\"_httpprefix_/macros/english.dm\" target=macro>english.dm</a>侎<a href=\"_httpprefix_/macros/french.dm\" target=macro>french.dm</a>
970包
971含了猺省的宏䞔可被å…
972¶ä»–包
973䞭的宏芆写。这里是<i>extra.dm</i>文件䞭重定义了å…
974šå±€å®å˜é‡çš„郚分。
975
976<pre>
977##########################################################################\n
978package Global\n
979##########################################################################\n
980\n
981&#095;starthighlight&#095; {&lt;b&gt;}\n
982&#095;endhighlight&#095; {&lt;/b&gt;}\n
983\n
984&#095;navbarspacer&#095; { \n
985&lt;br/&gt;\n
986&lt;img src=\"&#095;httpcimages&#095;/horzline.gif\" width=\"87\" height=\"17\"&gt;\n
987&lt;br/&gt;\n
988}\n
989</pre>\n
990
991<i>starthighlight</i>侎<i>endhighlight</i>的倌被甚于圚星瀺文档时高亮星瀺查询词。猺省情
992况时将背景讟眮成黄色。䞊面的第䞀䞪讟眮即将查询词的高亮讟眮䞺黑䜓。\n
993
994<p>接䞋来<i>navbarspacer</i>宏莟莣将浏览条䞭的搜玢按钮䞎分类按钮分匀。通垞情
995况䞋Greenstone有䞀䞪氎平的绿色的浏览条。接䞋来的定义将垂盎眗列这些按钮
996䞀䞪圚及䞀䞪之䞊。
997<pre>
998&#095;navbarspacer&#095; {&lt;br\/&gt;}
999</pre>\n
1000
1001前面给出的<i>navbarspacer</i>定义甚到了<i>horzline.gif</i>囟片䜜䞺分隔笊这䞪囟片圚銆藏的<i>images</i>目圕䞭。圚这䞪页面的顶端即可看到效果。\n
1002
1003<p>若芁按氎平方匏排列这些按钮并仍䜿甚<i>horzline.gif</i>而䞍是绿色条䜜䞺分隔笊删陀<i>br</i>标记并定义宏的䞻䜓圚倧括号䞭的郚分䞺
1004<pre>
1005&lt;img src=\"&#095;httpcimages&#095;\/horzline.gif\"\n
1006 width=\"&#095;widthtspace&#095;\" height=\"17\"&gt;
1007</pre>\n
1008
1009<i>widthtspace</i>变量定义了按钮闎的宜床Greenstone将计算这䞪宜床。\n
1010
1011<p>䞋面所列的<i>extra.dm</i>郚分重定义了<i>Style</i>包
1012䞭的宏这䞪宏将莟莣创建每䞪页面的页倎和页尟并定义垞甚的样匏信息
1013
1014<pre>
1015##########################################################################\n
1016package Style\n
1017##########################################################################\n
1018\n
1019
1020&#095;collectionspecificstyle&#095; {\n
1021&lt;link rel=\"stylesheet\" href=\"&#095;httpcstyle&#095;/style.css\" type=\"text/css\" \n
1022 title=\"Greenstone Style\" charset=\"UTF-8\"&gt;\n
1023&lt;style&gt;\n
1024body.bgimage \\\{ background-image: none; \\\}\n
1025a.navlink:hover \\\{ background-image: url(\"&#095;httpcimages&#095;/bg&#095;blue.gif\"); \\\}\n
1026&lt;/style&gt;\n
1027}\n
1028\n
1029&#095;pagebanner&#095; {\n
1030&lt;div class=\"pageinfo\"&gt; \n
1031&lt;p class=\"bannerlinks\"&gt;&#095;homelink&#095;&lt;/p&gt;\n
1032&lt;/div&gt;\n
1033}\n
1034</pre>\n
1035
1036Greenstone的片倎宏即<a href=\"_httpprefix_/macros/style.dm\" target=macro>style.dm</a>侭的<i>header</i>将星瀺该銆藏的名称或者
1037标志
1038并铟接到䞻页、垮助页面䞎偏奜页面。它将调甚<i>htmlhead</i>宏这䞪宏将星瀺HTML文件的匀倎郚分。这里调甚<i>cssheader</i>宏
1039这䞪宏星瀺页面的样匏信息。这里包
1040括了<i>collectionspecificstyle</i>宏这䞪宏å…
1041è®žéŠ†è—åœšçŒºçœæ ·åŒçš„基础䞊添加å…
1042¶ä»–样匏å…
1043ƒçŽ ã€‚
1044
1045<p>若芁圚该銆藏䞭䜿甚å…
1046šæ–°çš„样匏圚<i>extra.dm</i>䞭定义<i>cssheader</i>宏。若只是圚猺省样匏䞭添加几䞪样匏定义圚<i>extra.dm</i>䞭定义
1047<i>collectionspecificstyle</i>。这就是銆藏的圢成方匏。䞊面的<i>collectionspecificstyle</i>宏包
1048含了该銆藏自己的样匏衚同时也芆写了䞀些囟片的定义
1049去掉了绿色旋蜬条纹的背景囟片并将浏览条的悬停背景变䞺蓝色。
1050
1051<p>页面倎宏也调甚<i>pagebanner</i>来包
1052含该銆藏的标志䞻页/垮助/偏奜按钮以及巊䞊方指瀺圓前页面的囟片诎明页面搜玢页面等等。䞊面的代码重
1053定义的标志陀去了所有囟片陀了䞻页按钮之倖——这些囟片没有出现圚这䞪页面的顶端。\n
1054
1055<p><i>extra.dm</i>接䞋来的䞀郚分重新定义了<i>about</i>包
1056䞭的宏包
1057含圚<a href=\"_httpprefix_/macros/about.dm\" target=macro>about.dm</a>䞭
1058这䞪宏将产生\"å…
1059³äºŽæœ¬éŠ†è—\"页面劂䞋所瀺
1060
1061<pre>
1062##########################################################################\n
1063package about\n
1064##########################################################################\n
1065\n
1066&#095;content&#095; {\n
1067&#095;navigationbar&#095;\n
1068\n
1069&#095;textabout&#095;\n
1070\n
1071&lt;h3&gt;&#095;help:textsimplehelpheading&#095;&lt;/h3&gt;\n
1072&#095;help:simplehelp&#095;\n
1073}
1074</pre>\n
1075
1076<i>About</i>页面的<i>content</i>宏通垞包
1077含了浏览条铟接到<i>搜玢</i>䞎任意䞀䞪分类噚接䞋来是\"å…
1078³äºŽæœ¬éŠ†è—\"侎\"劂䜕扟到盞å…
1079³ä¿¡æ¯\"的文本。因䞺这䞪
1080宏是随銆藏的䞍同而䞍同<i>navigationbar</i>宏是由Greenstone内
1081郚定义的而䞔䜿甚前面定义的<i>navbarspacer</i>宏。<i>å…
1082³äºŽ</i>页面的<i>content</i>宏
1083劂䞊面所瀺䞍同于垞规的宏比劂挔瀺銆藏的宏见<a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=p&p=about\">这里</a>䞍同之倄圚于浏览条并䞍是居
1084䞭星瀺的
1085而䞔没有搜玢框。\n
1086
1087<p><i>extra.dm</i>的䞋䞀郚分重新定义了<i>query</i>包
1088䞭的宏劂<a href=\"_httpprefix_/macros/query.dm\" target=macro>query.dm</a>䞭所瀺这䞪宏
1089甚于生成<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">搜玢页</a>
1090
1091<pre>
1092##############################################################################\n
1093package query\n
1094##############################################################################\n
1095
1096&#095;content&#095; {\n
1097&#095;navigationbar&#095;\n
1098\n
1099&lt;center&gt;\n
1100&#095;If&#095;(&#095;cgiargct&#095;,&#095;selectqueryform&#095;,&#095;queryform&#095;)\n
1101&lt;/center&gt;\n
1102&#095;If&#095;(&#095;searchhistorylist&#095;,&lt;center&gt;&#095;iconsearchhistorybar&#095;&lt;/center&gt;&lt;br&gt;\n
1103&lt;center&gt;\n
1104&#095;searchhistorylist&#095;\n
1105&lt;/center&gt;)\n
1106&#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
1107&lt;br&gt;\n
1108}\n
1109</pre>\n
1110
1111标准<i>query</i>䞭定义的<i>content</i>宏䞎䞊述定义类䌌陀了标准定义䌚居
1112䞭星瀺<i>navigationbar</i>宏而䞊述定义䞍居
1113䞭星瀺而䞔它还额倖包
1114含了䞀䞪绿色条。
1115比蟃<a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=q\">这䞪</a>和<a href=\"_gwcgi_?l=_cgiargl_&c=demo&a=q\">这䞪</a>.\n
1116
1117<p><a href=\"_httpcollection_/macros/extra.dm\" target=macro>extra.dm</a>文件也重新定义了<i>document</i>包
1118䞭的宏这些宏被甚于星瀺文档参见
1119<a href=\"_httpprefix_/macros/document.dm\" target=macro>document.dm</a>。事实䞊分类噚所创建的页面䟋劂题名列衚也是被这些宏所定义。
1120
1121##########################################################################\n
1122package document\n
1123##########################################################################\n
1124\n
1125&#095;textheader&#095; {\n
1126&#095;cgihead&#095;\n
1127&#095;htmlhead&#095;(class=\"bgimage\")&#095;startspacer&#095;&#095;pagebanner&#095; \n
1128}\n
1129\n
1130&#095;content&#095; {\n
1131&#095;navigationbar&#095;\n
1132\n
1133&#095;If&#095;(&#095;phindclassifier&#095;&#095;collageclassifier&#095;,\n
1134&lt;p style=\"text-align: center;\"&gt;\n
1135&#095;phindclassifier&#095;\n
1136&#095;collageclassifier&#095;\n
1137&lt;/p&gt;\n
1138)\n
1139\n
1140&#095;If&#095;(\"&#095;cgiargcl&#095;\" eq \"search\",\n
1141&lt;ul id=\"searchresults\"&gt;\n
1142&#095;prevsearchresult&#095;\n
1143&#095;nextsearchresult&#095;\n
1144&lt;/ul&gt;)\n
1145\n
1146&lt;div class=\"document\"&gt;\n
1147}\n
1148</pre>\n
1149
1150劂果星瀺的是文档而䞍是分类噚Greenstone将芆写<i>header</i>宏。假讟我们䞍想让Greenstone芆写这䞪宏则䞊面的代码将重新定义<i>textheader</i>宏
1151通垞圚<i>document.dm</i>䞭定义并䜜䞺原始的<i>header</i>宏的内
1152容。䞊述<i>content</i>的定义芆写了猺省的倌因歀浏览条也䞍䌚居
1153䞭星瀺。
1154"
Note: See TracBrowser for help on using the repository browser.