[Text]
" format DocumentImages true format DocumentButtons "Expand Text|Expand Contents|Highlight|Detach|Print" format DocumentSearchResultLinks true format HList "[link][highlight][Title][/highlight][/link]" format DocumentHeading "{Or}{[parent(Top):Title],[Title],untitled}The appearance of Greenstone collections is defined by \"macro files\" in the greenstone/macros directory, and can be completely altered by changing the contents of these files. Editing them will change the appearance of all collections. To change the appearance of just one collection, place appropriately modified macros in a file called extra.dm in the collection's macros directory. For example, this collection uses the file greenstone/collect/_cgiargc_/macros/extra.dm. \n
To separate presentation details from the macro files, Greenstone uses Cascading Style Sheets (see http://www.w3.org/Style/CSS/ for more information), which allow you to specify fonts, colours, spacings, and other elements for HTML pages. The standard Greenstone stylesheet is located in greenstone/web/style/style.css. This collection specifies an auxiliary stylesheet, greenstone/collect/_cgiargc_/style/style.css, to be used in addition to the default ones. It includes some comments for those unfamiliar with cascading style sheets. Some of the macros in extra.dm reference images that have been placed in greenstone/collect/_cgiargc_/images.\n
The extra.dm macro file overrides some of the macros that Greenstone uses by default. In macro files, the \"\#\" character signals a comment line (extra.dm is commented to help explain what it does). Macros themselves are signalled by underscores, and they can reference other macros. This means that the content of a page can be split into many small chunks, and it can be difficult to work through the chain of which macro calls what. Fortunately, changes in macros (like changes in format strings) take effect immediately unless you are using the Greenstone local library server, in which case the server needs to be restarted. This makes it easy to experiment by editing the macro files.\n
Macros are grouped into \"packages\". But each package does not necessarily reside in a single file. The Global package, most of which is in file base.dm (parts of it are also in the language-specific macro files such as english.dm and french.dm), contains default macros that can be overridden by macros in other packages. Here is the part of extra.dm that redefines global macros.
##########################################################################\n
package Global\n
##########################################################################\n
\n
_starthighlight_ {<b>}\n
_endhighlight_ {</b>}\n
\n
_navbarspacer_ { \n
<br/>\n
<img src=\"_httpcimages_/horzline.gif\" width=\"87\" height=\"17\">\n
<br/>\n
}\n
\n
The values of starthighlight and endhighlight are used to
highlight query terms when displaying a document. The default is to set the
background to yellow. The first specification above places query terms in
bold instead.\n
Next, the navbarspacer macro is what separates the search button and classifier buttons in the navigation bar. It is normally Greenstone\'s familiar horizontal green bar. The following definition has the effect of stacking the buttons vertically, one above the other.
_navbarspacer_ {<br\/>}
\n
The definition of navbarspacer given earlier uses the image
horzline.gif as a separator (this image appears in the
images directory of the collection). The effect can be seen at the top of this page.\n
To arrange the buttons horizontally, still using horzline.gif instead of the green bar as separator, remove the br tags and define the body of the macro (the part in curly brackets) to be:
<img src=\"_httpcimages_\/horzline.gif\"\n width=\"_widthtspace_\" height=\"17\">\n The widthtspace variable gives the width of the gap between the buttons, which Greenstone calculates.\n
The part of extra.dm reproduced below redefines macros in the Style package, which is responsible for creating the header and footer of every page, and defining common style information:
##########################################################################\n
package Style\n
##########################################################################\n
\n
_collectionspecificstyle_ {\n
<link rel=\"stylesheet\" href=\"_httpcstyle_/style.css\" type=\"text/css\" \n
title=\"Greenstone Style\" charset=\"UTF-8\">\n
<style>\n
body.bgimage \\\{ background-image: none; \\\}\n
a.navlink:hover \\\{ background-image: url(\"_httpcimages_/bg_blue.gif\"); \\\}\n
</style>\n
}\n
\n
_pagebanner_ {\n
<div class=\"pageinfo\"> \n
<p class=\"bannerlinks\">_homelink_</p>\n
</div>\n
}\n
\n
Greenstone\'s page header macro, which is called header in
style.dm,
prints the collection\'s name or logo, and links to the
home, help, and preferences pages. It calls the macro htmlhead which
outputs the beginning of an HTML file. This calls the macro cssheader which outputs style information for the page. This macro includes the collectionspecificstyle macro which allows a collection to add some style elements to the default.
To use an entirely new style for the collection, specify the cssheader macro in extra.dm. To just add just a few style declarations to the default style, specify collectionspecificstyle in extra.dm. That is what this collection has done. The above collectionspecificstyle 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.
The page header macro also calls pagebanner to include the collection\'s logo, home/help/preferences buttons, and the image at the top left that identifies the page (about page, search page, etc). The code above redefines the banner to suppress all these images except for the home page button -- as you can see, they don\'t appear at the top of this page.\n
The next part of extra.dm redefines macros in the about package (contained in about.dm), which generates the \"About this collection\" page that you are looking at now:
##########################################################################\n
package about\n
##########################################################################\n
\n
_content_ {\n
_navigationbar_\n
\n
_textabout_\n
\n
<h3>_help:textsimplehelpheading_</h3>\n
_help:simplehelp_\n
}
\n
The macro content for the About page normally contains the
navigation bar (with links to Search and any classifiers),
followed by \"About this collection\" and \"how to find information\"
text. Because it changes from one collection to another, the
navigationbar macro is defined internally by Greenstone, and uses
the navbarspacer macro discussed above. The content macro for
the About page, given above, differs from the regular one
(such as the one for the demo collection here)
in that the navigation bar is not centered, and there is no search box.\n
The next part of extra.dm redefines macros in the query package (in query.dm), which is used to generate the search page:
##############################################################################\n
package query\n
##############################################################################\n
_content_ {\n
_navigationbar_\n
\n
<center>\n
_If_(_cgiargct_,_selectqueryform_,_queryform_)\n
</center>\n
_If_(_searchhistorylist_,<center>_iconsearchhistorybar_</center><br>\n
<center>\n
_searchhistorylist_\n
</center>)\n
_If_(_cgiargq_,<small>_freqmsg_ _textpostprocess_</small><br>_resultline_,)\n
<br>\n
}\n
\n
The definition of content in the standard query package is
similar to the version given above, except that it centers the
navigationbar macro, whereas the above version does not, and it
includes an additional green bar. Compare
this
and
this.\n
The file extra.dm also redefines macros in the document package, which is used to display documents (see document.dm). In fact, pages generated by classifiers (e.g. lists of titles) are also governed by these macros.
##########################################################################\n
package document\n
##########################################################################\n
\n
_textheader_ {\n
_cgihead_\n
_htmlhead_(class=\"bgimage\")_startspacer__pagebanner_ \n
}\n
\n
_content_ {\n
_navigationbar_\n
\n
_If_(_phindclassifier__collageclassifier_,\n
<p style=\"text-align: center;\">\n
_phindclassifier_\n
_collageclassifier_\n
</p>\n
)\n
\n
_If_(\"_cgiargcl_\" eq \"search\",\n
<ul id=\"searchresults\">\n
_prevsearchresult_\n
_nextsearchresult_\n
</ul>)\n
\n
<div class=\"document\">\n
}\n
\n
Greenstone overrides the header macro if a document (and not a
classifier) is being displayed. Suppose we don\'t want it to. The code
above redefines the textheader macro (normally defined in
document.dm) to be the content of the original header macro. The definition of content above overrides the
default so that the navigation bar is not centered.
"
# -- French text ----------------
collectionmeta collectionextra [l=fr] "
Cette 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.
L'apparence des collections Greenstone est définie par des \"fichiers de macros\" dans le répertoire greenstone/macros 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é extra.dm dans le répertoirede la collection macros. Par exemple, cette collection utilise le fichier greenstone/collect/_cgiargc_/macros/extra.dm. \n
Pour séparer certains détails de présentation des fichiers de macros, Greenstone utilise Cascading Style Sheets(voir http://www.w3.org/Style/CSS/ 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 greenstone/web/style/style.css. Cette collection spécifie un 'stylesheet' auxiliaire, greenstone/collect/_cgiargc_/style/style.css, à être utilisé à part ceux du défaut. Ceci inclus quelques commentaires qui ont été placés dans greenstone/collect/_cgiargc_/images.\n
Le fichier de macros extra.dm l'emporte sur certaines des macros que Greenstone utilise par défaut. Dans des fichiers de macros, le caractère \"\#\" signale une ligne de commentaire(extra.dm 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.
Les macros sont regroupées en \"paquetages\". Mais chaque paquetage ne réside pas forcément dans un fichier unique. Le paquetage Global, dont la majeure partie réside dans le fichier base.dm (d'autres parties se trouvent aussi dans les fichiers de macros spécifiques aux langues, comme english.dm et french.dm), contient des macros par défaut qui peuvent être écrasées par des macros d'autres paquetages. Voici la partie de extra.dm qui redéfinit des macros globales.
##########################################################################\n
package Global\n
##########################################################################\n
\n
_starthighlight_ {<b>}\n
_endhighlight_ {</b>}\n
\n
_navbarspacer_ { \n
<br/>\n
<img src=\"_httpcimages_/horzline.gif\" width=\"87\" height=\"17\">\n
<br/>\n
}\n
\n
Les valeurs de starthighlight et endhighlight 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.
Ensuite, la macro navbarspacer 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.
_navbarspacer_ {<br\/> }
\n
La définition de navbarspace donnée auparavant utilise l' image horzline.gif comme un séparateur (cette image apparaît dans le répertoire images de la collection). L' effet peut être visualisé dans la partie suppérieure de cette page. \n
Pour ranger les boutons horizontalement, utilisez toujours horzline.gif comme séparateur au lieu de la barre verte, supprimez les étiquettes br et définissez le corps de la macro (la partie entre parenthèses) comme ceci:
<img src=\"_httpcimages_\/horzline.gif\"\n width=\"_widthtspace_\" height=\"17\">\n La variable widthtspace donne la largeur de l'espace entre les boutons que Greenstone calcule.
La partie de extra.dm reproduite ci-dessous redéfinit des macros dans le paquetage Style, 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:
##########################################################################\n
package Style\n
##########################################################################\n
\n
_collectionspecificstyle_ {\n
<link rel=\"stylesheet\" href=\"_httpcstyle_/style.css\" type=\"text/css\" \n
title=\"Greenstone Style\" charset=\"UTF-8\">\n
<style>\n
body.bgimage \\\{ background-image: none; \\\}\n
a.navlink:hover \\\{ background-image: url(\"_httpcimages_/bg_blue.gif\"); \\\}\n
</style>\n
}\n
\n
_pagebanner_ {\n
<div class=\"pageinfo\"> \n
<p class=\"bannerlinks\">_homelink_</p>\n
</div>\n
}\n
\n
La macro de l'en-tête de la page de Greenstone, appelée header dans
style.dm, 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 htmlhead qui affiche le début d'une page HTML. Ceci appelle le macro cssheader qui output le style d' information pour cette page. Ce macro comprend le macro collectionspecificstyle qui permet la collection d' additionner quelques éléments-style au défaut.
Pour utiliser entièrement un nouveau style pour la collection, spécifiez le macro cssheader dans extra.dm. Pour ajouter seulement quelques déclarations de style, spécifiez le collectionspecificstyle dans extra.dm. C' est ceci ce que la collection a fait. Le macro ci-dessus collectionspecificstyle 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
La macro d'entête de page appelle aussi pagebanner 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
La partie suivante de extra.dm redéfinit des macros dans la paquetage about (\"à propos\") (contenu dans about.dm), qui génère la page \"About this collection\" que vous voyez actuellement:
##########################################################################\n
package about\n
##########################################################################\n
\n
_content_ {\n
_navigationbar_\n
\n
_textabout_\n
\n
<h3>_help:textsimplehelpheading_</h3>\n
_help:simplehelp_\n
}
\n
La macro content pour la page About (\"A propos\") contient normallement la barre de navigation (avec des liens vers Search 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 barre de navigation est définie en interne par Greenstone, et utilise la macro navbarspacer traitéé ci-dessus. La macro content (\"contenu\") pour la page About (\"A propos\"), donnée ci-dessus, diffère de la macro habituelle (comme celle pour la collection Demo ici)
en ce sens que la barre de navigation n'est pas centrée et qu'il n'y a pas de boîte de recherche.
La partie suivante de extra.dm redéfinit des macros dans le paquetage query (\"requête\") (dans query.dm), qui est utilisé pour générer la page de recherche:
##############################################################################\n
package query\n
##############################################################################\n
_content_ {\n
_navigationbar_\n
\n
<center>\n
_If_(_cgiargct_,_selectqueryform_,_queryform_)\n
</center>\n
_If_(_searchhistorylist_,<center>_iconsearchhistorybar_</center><br>\n
<center>\n
_searchhistorylist_\n
</center>)\n
_If_(_cgiargq_,<small>_freqmsg_ _textpostprocess_</small><br>_resultline_,)\n
<br>\n
}\n
\n
La définition de content dans le paquetage de requête standard est similaire à la version donnée ci-dessus, excepté le fait qu'elle centre la macro barre de navigation, alors que la version ci-dessu ne le fait pas, et qu'elle inclut une barre verte supplémentaire. Comparez
ceci à ceci.
Le fichier extra.dm redéfinit aussi des macros dans le paquetage document qui est utilisé pour afficher des documents (voir document.dm). En fait, les pages générées par des classificateurs (par xemple listes de titres) sont aussi contrôlées par ces macros.
##########################################################################\n
package document\n
##########################################################################\n
\n
_textheader_ {\n
_cgihead_\n
_htmlhead_(class=\"bgimage\")_startspacer__pagebanner_ \n
}\n
\n
_content_ {\n
_navigationbar_\n
\n
_If_(_phindclassifier__collageclassifier_,\n
<p style=\"text-align: center;\">\n
_phindclassifier_\n
_collageclassifier_\n
</p>\n
)\n
\n
_If_(\"_cgiargcl_\" eq \"search\",\n
<ul id=\"searchresults\">\n
_prevsearchresult_\n
_nextsearchresult_\n
</ul>)\n
\n
<div class=\"document\">\n
}\n
\n
Greenstone neutralise le macro header 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 textheader (normalement définit dans document.dm,/i>) pour être le contenu du macro header originel. La définition de content ci-dessus neutralise le défault pour que la barre de navigation ne soit pas sentrée.
"
# -- Spanish text ----------------
collectionmeta collectionextra [l=es] "
Esta 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.
La apariencia de las colecciones Greenstone se define por medio de los \"archivos de macros\" que se encuentran en el directorio de macros 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 extra.dm en el directorio de la colección macros. Por ejemplo, este directorio utiliza un archivo llamado greenstone/collect/_cgiargc_/macros/extra.dm. \n
Para separar ciertos detalles de la presentación de los archivos de macros, Greenstone utiliza Cascading Style Sheets(ver http://www.w3.org/Style/CSS/ 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 greenstone/web/style/style.css. Esta colección especifica una hojaestilo auxiliar, greenstone/collect/_cgiargc_/style/style.css, 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 extra.dm refieren a imágenes que han sido colocadas en greenstone/collect/_cgiargc_/images.\n
El archivo extra.dm 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 (extra.dm 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.
Las macros se agrupan en \"paquetes\". Pero cada paquete no reside necesariamente en un solo archivo. El paquete Global, cuya mayor parte se encuentra en el archivo base.dm (partes de él también están en los archivos de macros específicas de cada idioma como english.dm y french.dm) contiene macros por omisión que se pueden sustituir por macros de otros paquetes. Esta es la parte de extra.dm que redefine las macros globales.
##########################################################################\n
package Global\n
##########################################################################\n
\n
_starthighlight_ {<b>}\n
_endhighlight_ {</b>}\n
\n
_navbarspacer_ { \n
<br/>\n
<img src=\"_httpcimages_/horzline.gif\" width=\"87\" height=\"17\">\n
<br/>\n
}\n
\n
Los valores de starthighlight y endhighlight 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.
A continuación la macro navbarspacer 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.
_navbarspacer_ {<br\/>} \n
\n
La definición de navbarspacer data anteriormente usa la imágen horzline.gif como un separador (esta imágen aparece en el directorio de la colección images). El efecto puede ser visto en la parte superior de esta página. \n
Para ordenar los botones horizontalmente y seguir usando horzline.gif en vez de la barra verde como separador, quite las etiquetas br y defina el cuerpo de la macro (la parte entre llaves {} ) de la siguiente manera:
<img src=\"_httpcimages_\/horzline.gif\"\n width=\"_widthtspace_\" height=\"17\">\n
La variable widthtspace da el ancho del espacio entre los botones, lo cual es calculado por Greenstone.
La parte de extra.dm que se reproduce a continuación redefine las macros que se encuentran en el paquete de Estilo, el cual es responsable de crear el encabezado y pie de cada página, y define información de estylo común:
##########################################################################\n
package Style\n
##########################################################################\n
\n
_collectionspecificstyle_ {\n
<link rel=\"stylesheet\" href=\"_httpcstyle_/style.css\" type=\"text/css\" \n
title=\"Greenstone Style\" charset=\"UTF-8\">\n
<style>\n
body.bgimage \\\{ background-image: none; \\\}\n
a.navlink:hover \\\{ background-image: url(\"_httpcimages_/bg_blue.gif\"); \\\}\n
</style>\n
}\n
\n
_pagebanner_ {\n
<div class=\"pageinfo\"> \n
<p class=\"bannerlinks\">_homelink_</p>\n
</div>\n
}\n
\n
La macro de encabezado de página de Greenstone, llamado encabezado en style.dm, 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 htmlhead, que muestra el inicio de un archivo HTML. Esto llama al macro cssheader lo que hace que salga información para la página. Este macro incluye el macro collectionspecificstyle el cual permite a la colección sumar algunos elementos de estilo a la falla.
Para utilizar enteramente el nuevo estilo para la colección, especifique el macro cssheader en extra.dm. Para simplemente agregar un par de declaraciones de estilos al estilo de falla, especifique collectionspecificstyle en extra.dm. Eso es lo que la colección ha hecho. El macro arriba collectionspecificstyle 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.
La macro de encabezado de la página también remite a pagebanner 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.
La siguiente parte de extra.dm redefine las macros del paquete acerca de (que se encuentra en about.dm), el cual genera la página \"Acerca de esta colección\" que usted está viendo en este momento.
##########################################################################\n
package about\n
##########################################################################\n
\n
_content_ {\n
_navigationbar_\n
\n
_textabout_\n
\n
<h3>_help:textsimplehelpheading_</h3>\n
_help:simplehelp_\n
}
\n
La macro de contenido para la página Acerca de normalmente contiene la barra de navegación (con vínculos hacia Búsqueda 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 navigationbar es definida internamente por Greenstone y utiliza la macro navbarspacer descrita arriba. La macro de contenido para la página Acerca de que se menciona arriba difiere de la normal (como la de la colección Demo que se puede ver aquí) en que la barra de navegación no está centrada y no hay cuadro de búsqueda.
La siguiente parte de extra.dm redefine las macros del paquete de consulta (que se encuentra en query.dm), el cual se utiliza para generar la página de búsqueda.
##############################################################################\n
package query\n
##############################################################################\n
_content_ {\n
_navigationbar_\n
\n
<center>\n
_If_(_cgiargct_,_selectqueryform_,_queryform_)\n
</center>\n
_If_(_searchhistorylist_,<center>_iconsearchhistorybar_</center><br>\n
<center>\n
_searchhistorylist_\n
</center>)\n
_If_(_cgiargq_,<small>_freqmsg_ _textpostprocess_</small><br>_resultline_,)\n
<br>\n
}\n
\n
La definición de contenido en el paquete de consulta estándar es similar a la versión dada arriba, excepto que centra la macro navigationbar, mientras que la versión de arriba no lo hace, e incluye una barra verde adicional. Compárese ésta con ésta.
El archivo extra.dm también redefine las macros del paquete de documentos, el cual se utiliza para mostrar los documentos en pantalla (véase document.dm). De hecho, las páginas generadas por medio de clasificadores (p. ej. las listas de títulos) también se rigen por estas macros.
##########################################################################\n
package document\n
##########################################################################\n
\n
_textheader_ {\n
_cgihead_\n
_htmlhead_(class=\"bgimage\")_startspacer__pagebanner_ \n
}\n
\n
_content_ {\n
_navigationbar_\n
\n
_If_(_phindclassifier__collageclassifier_,\n
<p style=\"text-align: center;\">\n
_phindclassifier_\n
_collageclassifier_\n
</p>\n
)\n
\n
_If_(\"_cgiargcl_\" eq \"search\",\n
<ul id=\"searchresults\">\n
_prevsearchresult_\n
_nextsearchresult_\n
</ul>)\n
\n
<div class=\"document\">\n
}\n
\n
Greenstone anula el macro header 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 textheader (normalmente definido en document.dm) para ser el contenido del macro original header. La definición de content aqui arriba anula la omisión para que la barra de navidgación no esté centrada. " # -- Russian text ---------------- collectionmeta collectionextra [l=ru] " Эта демонстрационная коллекция содержит тот же материал, что и оригинальная демонстрационная коллекция Greenstone, но её вид был изменен., чтобы улучшить резкость.
Вид коллекций Гринстоун задается «макрофайлами» в директории макроса (greenstone/macros>) и может быть полностью изменено с помощью модификаций в файлах макросов. Эти модификации изменят вид всех коллекций. Чтобы изменить вид всего лишь одной коллекции, поместите соответствующий модифицированный макрос в файл названный extra.dm в папке macros этой коллекции. Например, эта коллекция использует файл greenstone/collect/_cgiargc_/macros/extra.dm.\n
Для отделения некоторых деталей презентации от макрофайлов Гринстоун использует Cascading Style Sheets (см. дополнительную информация на http://www.w3.org/Style/CSS/), которые позволяют Вам устанавливать шрифты, цвета, интервалы и другие элементы для страниц HTML. Файл со стандартным набором стилей в Гринстоун помещен здесь: greenstone/web/style/style.css (он помещен в директории images, потому что макро файлы могут содержать удобные ссылки к этой директории.) Эта коллекция имеет вспомогательный стилевой файл, greenstone/collect/_cgiargc_/style/style.css, который содержит несколько комментариев для тех, кто не разбирается с CSS. Некоторые макросы в extra.dm имеют ссылки к изображениям помещенным в greenstone/collect/_cgiargc_/images.\n
Макрофайл extra.dm отвергает часть макросов, которые используются в Greenstone по умолчанию. В макрофайлах \"\#\" оповещает о строке комментариев (extra.dm содержит комментарии, чтобы помочь объяснить, что он делает). Сами макросы сообщаются путем подчеркивания, и они могут обращаться к другим макросам. Это означает, что содержание страницы может быть разбито на многие маленькие куски, и могут возникать трудности при работе по цепи, которую макрос вызывает. К счастью, изменения в макросах, подобно изменениям в форматных строках, вступают в силу немедленно, если Вы не используете сервер локальной библиотеки Greenstone, в случае чего сервер нуждается в перезагрузке. Это облегчает экспериментирование путем редактирования макрофайлов.
Макросы сгруппированы в «пакеты». Но каждый пакет не обязательно размещается в отдельном файле. Глобальный пакет, большая часть которого находится в файле base.dm (часть его находится также в специфических языковых макрофайлах типа english.dm и french.dm), содержит макросы по умолчанию, которые могут быть отвергнутыми макросами в других пакетах. Здесь имеется часть extra.dm.
##########################################################################\n
package Global\n
##########################################################################\n
\n
_starthighlight_ {<b>}\n
_endhighlight_ {</b>}\n
\n
_navbarspacer_ { \n
<br/>\n
<img src=\"_httpcimages_/horzline.gif\" width=\"87\" height=\"17\">\n
<br/>\n
}\n
\n
которая определяет глобальные макросы, значения starthighlight и endhighlight используются для подсвечивания терминов запроса при представлении документа. По умолчанию должен быть установлен желтый фон. Первая спецификация вместо этого выделяет запрос полужирным шрифтом.
Следующий макрос navbarspacer служит для того, чтобы отделить кнопку поиска и кнопки классификаторов в навигационной линейке. Обычно это хорошо знакомая в Greenstone горизонтальная зеленая линейка. Следущее определение имеет эффект вертикального расположения кнопок, одна над другой.
_navbarspacer_ {<br\/>}
\n
Определение navbarspacer, данное ранее использует рисунок horzline.gif в качестве разделителя (этот рисунок содержится в папке коллекции под названием images). Эффект виден в начале этой страницы.\n
Размещение кнопок горизонтально, все ещё используя horzline.gif, вместо зеленой линейки как разделителя, удаляя тэги br и определяет тело макроса (часть в фигурных скобках), как:
<img src=\"_httpcimages_\/horzline.gif\"\n width=\"_widthtspace_\" height=\"17\">\n
Переменная widthtspace задаёт ширину промежутка между кнопками, которую вычисляет Greenstone.
Часть extra.dm, воспроизведенная ниже, переопределяет макросы в пакете Style, который отвечает за создание заголовка и нижней сноски на каждой странице:\n
##########################################################################\n
package Style\n
##########################################################################\n
\n
_collectionspecificstyle_ {\n
<link rel=\"stylesheet\" href=\"_httpcstyle_/style.css\" type=\"text/css\" \n
title=\"Greenstone Style\" charset=\"UTF-8\">\n
<style>\n
body.bgimage \\\{ background-image: none; \\\}\n
a.navlink:hover \\\{ background-image: url(\"_httpcimages_/bg_blue.gif\"); \\\}\n
</style>\n
}\n
\n
_pagebanner_ {\n
<div class=\"pageinfo\"> \n
<p class=\"bannerlinks\">_homelink_</p>\n
</div>\n
}\n
\n
макрос заголовка страницы Greenstone, который называется header в style.dm, печатает наименование коллекции и её эмблему и связывает её с домашней страницей, помощью и страницами предпочтений. Он вызывает макрос htmlhead, который определяет начало файла HTML. Это вызывает макро cssheader, который показывает информацию о стиле страницы. Этот макро включает макро collectionspecificstyle, который позволяет добавить к коллекции стилистические элементы к набору по умолчанию.
Чтобы использовать совершенно другой стиль в коллекции, выберите макро cssheader в extra.dm. Чтобы всего лишь добавить несколько новых стилевых определений к стилю по умолчанию, выберите collectionspecificstyle в extra.dm. Это было сделано в этой коллекции. Вышеуказаный макро collectionspecificstyle содержит таблицу стилей коллекции, и переопределяет пару стилей для изображений: Зеленая фоновая планка с завитками исчезла, а фон навигационной панели теперь синий.\n
Макрос заголовки страницы также вызывает pagebanner, чтобы включить эмблему коллекции, кнопки home/help/preferences и изображение слева вверху, которое идентифицирует страницу (о странице, поисковая страница и т.д.). Программа, указанная выше, определяет баннер, чтобы подавить эти изображения. Как Вы можете видеть, они не появляются наверху этой страницы.\n
Следующая часть extra.dm переопределяет макрос для описания О пакете, содержащийся в about.dm, который генерирует страницу «Об этой коллекции», которую Вы видите сейчас.
##########################################################################\n
package about\n
##########################################################################\n
\n
_content_ {\n
_navigationbar_\n
\n
_textabout_\n
\n
<h3>_help:textsimplehelpheading_</h3>\n
_help:simplehelp_\n
}
\n
Макросодержание для текста О странице обычно содержит навигационную линейку (со ссылками к Поиску и любым классификаторам), сопровождаемую описанием «Об этой коллекции» и текстом «Как найти информацию». Поскольку они изменяются от одной коллекции к другой, макроc navigationbar определен внутри Greenstone и использует макрос navbarspacer, который был обсужден выше. Макрос content для описания О странице, представленный выше, отличается от обычного (такого, как коллекции Demo) тем, что навигационная линейка не отцентрирована и здесь нет никакого поля поиска.
Следующая часть extra.dm переопределяет макрос в пакете запроса (query) в query.dm), который используется для генерации поисковой страницы.
##############################################################################\n
package query\n
##############################################################################\n
_content_ {\n
_navigationbar_\n
\n
<center>\n
_If_(_cgiargct_,_selectqueryform_,_queryform_)\n
</center>\n
_If_(_searchhistorylist_,<center>_iconsearchhistorybar_</center><br>\n
<center>\n
_searchhistorylist_\n
</center>)\n
_If_(_cgiargq_,<small>_freqmsg_ _textpostprocess_</small><br>_resultline_,)\n
<br>\n
}\n
\n
Определение содержания в стандартном пакете запроса подобно версии, данной выше, за исключением того, что оно помещает в центре макрос navigationbar, тогда как вышеупомянутая версия не делает этого и включает дополнительную зеленую линейку. Сравните то и это.
Файл extra.dm также переопределяет макрос в пакете документ (document), который используется для того, чтобы показать документы (см. document.dm). Фактически страницы, генерируемые классификаторами (например, списком наименований) также управляются и этими макросами.
##########################################################################\n
package document\n
##########################################################################\n
\n
_textheader_ {\n
_cgihead_\n
_htmlhead_(class=\"bgimage\")_startspacer__pagebanner_ \n
}\n
\n
_content_ {\n
_navigationbar_\n
\n
_If_(_phindclassifier__collageclassifier_,\n
<p style=\"text-align: center;\">\n
_phindclassifier_\n
_collageclassifier_\n
</p>\n
)\n
\n
_If_(\"_cgiargcl_\" eq \"search\",\n
<ul id=\"searchresults\">\n
_prevsearchresult_\n
_nextsearchresult_\n
</ul>)\n
\n
<div class=\"document\">\n
}
\n
Гринстоун аннулирует макро header, если изображен документ (а не классификатор). Предположим, мы не хотим этого. Вышестоящий код переопределяет макро textheader (обычно определенном в document.dm) в качестве первоначального содержания макро header. Вышестоящее определение content аннулирует значение по-умолчанию, так что навигационное меню не центрируется.
"