Ejercicio tutorial de Greenstone
Aprender acerca de formatos y de macros
Las instrucciones de formato y los macros de archivos le permiten personalizar la apariencia de las colecciones de Greenstone. Son muy poderosos, pero son complejos y difíciles de aprender. Esta tutoría ofrece una introducción a las facilidades que se suministran
Ensayos con instrucciones de formato
- Abra su colección tudor, vaya al panel Diseño (haciendo clic en el tabulador correspondiente) y escoja Aspectos de Formato de la lista de la izquierda. Deje los Controles de Edición en sus valores por defecto, de forma que Escoger Aspecto permanezca en blanco y VList se escoje como el Componente Afectado. El texto en la caja Cadena de Formata HTML dice lo siguiente:
<td valign=top>[link][icon][/link]</td>
<td valign=top>[ex.srclink]{Or}{[ex.thumbicon],[ex.srcicon]} [ex./srclink]</td>
<td valign=top>[highlight]
{Or}{[dls.Title],[dc.Title],[ex.Title],Untitled}
[/highlight]{If}{[ex.Source],<br><i>([ex.Source])</i>}</td>
muestra algo que se ve de esta manera:
 | A discussion of question five from Tudor Quiz: Henry VIII
(quizstuff.html) |
para un documento en particular cuyo título de metadatos es Título Una discusión de la pregunta cinco de la prueba sobre los Tudor: Enrique VIII y cuyos metadatos Fuente es quizstuff.html.Este formato aparece en la lista de resultados de la búsqueda, en la lista de títulos a-z, y también cuando usted va a documentos individuales en la jerarquía de temas. Esta es la instrucción de formato por defecto de Greenstone.
La instrucción de formato por defecto de Greenstone es compleja —incluso barroca porque se ha diseñado para producir algo razonable bajo cualesquiera condiciones y también porque, por razones prácticas, tiene que ser compatible hacia atrás con colecciones heredadas.
- Borre el contenido de la caja HTMLCadena de Formatoy reemplácelo con esta versión más sencilla:
<td>[link][icon][/link]</td>
<td>[ex.Title]<br>
<i>([ex.Source])</i>
</td>
Acuérdese de hacer clic en <Reemplazar formato>.
vista previa del resultado (no necesita construir la colección, porque los cambios a las instrucciones de formato tienen efecto inmediato). Mire algunos resultados de búsqueda en la lista detítulos a-z. Son los mismos que antes!! En la mayoría de las circunstancias, esta instrucción de formato mucho más simple es totalmente equivalente a la instrucción por defecto de Greenstone que es más compleja.
Pero hay un problema. Al lado de las estanterías de los libros en el explorador de jerarquías, debajo del tema aparece un misteriorso "()". Lo imprimido en estos nodos de estantería, lo gobierna la misma instrucción de formato y aunque lo nodos de jerarquía de la estantería, tienen asociado Título de metadatos—su título es el nombre de los metadatos asociados con esa estantería—no tienen metadatos ex.Fuente, entonces aparece en blanco.
- En la sección Aspectos de Formato en el panel Diseño, el menú Escoja Aspecto (encima del menú Componente Afectado) está en blanco. Eso implica que se usa el mismo formato para los resultados de la búsqueda, títulos, y todos los nodos en la jerarquía de temas—incluyendo nodos internos (esto es, estanterías). El menú Escoja Aspecto se puede usar para restringir una instrucción de formato a uno específico de los de estas listas; cuando está en blanco, la especificación VList se aplica completamente. Pasaremos por alto este formato para el clasificador jerárquico tema. En el menú Escoja Aspecto, deslícese hacia abajo, hacia el item que dice
CL2: Hierarchy -metadata dc.Subject and Keywords
y selecciónelo. Esta es la instrucción de formato que afecta al segundo clasificador (i.e. "CL2"), que es un clasificador de Jerarquía basado en metadatos de dc.Tema y Palabras claveKeywords.Edite la caja Cadena de Formato HTML abajo para leer
<td>[link][icon][/link]</td>
<td>[ex.Title]</td>
y haga clic en <Adicionar Formato>.
- Ahora vaya al panel Creare y haga clic en <Vista Previa>. Primero, ha desaparecido "()" de las estanterías. Segundo, cuando usted obtiene una lista de documentos con la jerarquía del tema, el nombre del archivo no aparece al lado del título, porque no se ha especificado ex.Fuente en la instrucción de formato y esta instrucción de formato se aplica a todos los nodos en el clasificador de tema. Note que los resultados de la búsqueda y los títulos de listas no han cambiado: todavía muestran el nombre de archivo debajo del título.
- Cambiemos los resultados del formato de de manera que los metadatos de dc.Tema y Palabras clave se muestren aquí en vez del nombre de archivo. En el menú Escoja Aspecto (bajo Aspectos de Formato en el panel Diseño ), haga scroll hacia abajo hacia el item Buscar y escójalo. Cambie la caja Cadena de Formato HTML abajo para leer
<td>[link][icon][/link]</td>
<td>[ex.Title]<br>
[dc.Subject]
</td>
y haga clic en <Adicionar Formato>.
- Para insertar el [dc.Tema], ubique el cursor en el punto apropiado e investigue el menú Variables abajo—el que dice [Texto]. Hágalo decir [dc.Tema] y haga clic en Insertar para insertarlo en la Cadena de Formato HTML. Este menú muestra todo lo que usted puede poner entre corchetes en la instrucción de formato. La única excepción es [Texto], que da el texto completo del documento y sólo se puede usar cuando Texto del Documento es el Componente Afectado.
- Ahora vaya al panel Crear y haga clic en <Vista Previa>. Los documentos en la lista del resultado de la búsqueda se mostraran así:
| A discussion of question five from Tudor Quiz: Henry VIII
Tudor period|Others |
La barra vertical aparece porque estos metadatos de dc.Tema y Palabras Clave son metadatos jerárquicos. Desafortunadamente no hay manera de llegar hasta los componentes individuales de la jerarquia. Para la mayoría de los metadatos, tales como título y autor, esto no es problema.
- Finalmente, regresemos a la jerarquía de subjects y aprendamos cómo hacer diferentes cosas en las estanterías y en los mismos documentos. En el menú Escoger Aspecto , seleccione el item
CL2: Hierarchy -metadata dc.Subject and Keywords
Edite la caja Cadena de Formato HTML abajo para leer
<td>[link][icon][/link]</td>
<td>{If}{[numleafdocs],<b>Bookshelf title:</b> [ex.Title],
<b>Title:</b> [ex.Title]}
</td>
y haga clic en Reemplazar Formato Nuevamente, puede insertar los items entre corchetes, seleccionándolos en la caja Variables (no olvide hacer clic en Insertar).
La instrucción If verifica el valor de la variable numleafdocs. Esta variable sólo se activa para nodos internos de la jerarquía, i.e. estanterías y suministra el número de documentos debajo de ese nodo. Si se activa, tomamos la primera rama, en caso contrario tomamos la segunda. Se usan comas para separar las ramas. Los corchetes sirven para indicar que If es especiall—de lo contrario, se obtiene la palabra "If" misma.
- Vaya al panel Crear, haga clic en <Vista Previa>y examine la jerarquía del tema otra vez para ver el efecto de los cambios.
Macros de especificación de colección
La apariencia de todas las páginas producidas por Greestone es gobernada por archivos de macros que se encuentran en la carpeta C:\Program Files\Greenstone\macros. El ejemplo de la colección garish es una versión de la colección demo con colorido y presentación raros. Ahora aplicamos el mismo colorido y presentación raros a la colección tudor
- Vaya a la carpeta C:\Program Files\Greenstone\macros. Copie el archivo extra.dm. Ahora vaya a su carpeta de colecciónC:\Program Files\Greenstone\collect\tudor y crée una nueva carpeta allí, llamada macros. Pegue extra.dm en esa nueva carpeta. El efecto total es que usted ha creado un nuevo archivo C:\Program Files\Greenstone\collect\ tudor\macros\extra.dm.
- Este archivo macro utiliza un estilo de archivo CSS y algunas de las imágenes que usted necesitará copiar de la colección 'garish'. Vaya al folder C:\Program Files\Greenstone\collect\garish\images. Seleccione los tres archivos style.css, horzline.gif y bg_blue.gif. Copie estos archivos y pégelos en el folder C:\Program Files\Greenstone\collect\tudor\images.
- Vaya al panel Crear y haga clic en <Vista Previa>. El contenido de su colección permanece igual pero su apariencia ha cambiado completamente—por ejemplo, todas las páginas son rosadas! Para aprender cómo controlar estos cambios, vaya al ejemplo de colección documentada, llamado Versión garish de colección demo, y lea.
Macros generales
También puede usar macros para cambiar completamene la apariencia de su sitio Greenstone. Igual que en el ejercicio anterior, lo que sigue es simplemente una guia para ilustrar lo que es posible hacer y mostrarle dónde buscar para lograr diferentes efectos.
- Salga de la Interfaz del Bibliotecario, como se trata de colecciones individuales y ahora estamos con el sitio como un todo
- Vaya a la carpeta C:\Program Files\Greenstone\etc y edite el archivo llamado main.cfg. Este es el archivo de la configuración principal de Greenstone, y contiene una lista de macros que se carga desde el comienzo. Uno de ellos, home.dm, indica cómo se verá la home page de Greenstone, que se especifica en el archivo C:\Program Files\Greenstone\macros\home.dm. Esta carpeta de macros contiene una versión alterna llamada yourhome.dm, que no se usa corrientemente. Para usarla, cambie en main.cfg la cadena home.dm a yourhome.dm.
- Ahora re-inicie Greenstone (La Biblioteca Digital Greenstone será suficiente, en vez de la Interfaz del Bibliotecario de Greenstone). Encontrará que la apariencia de la home page ha cambiado completamente.
- En vez de sustituir yourhome.dm por home.dm en el archivo main.cfg, simplemente usted puede editar home.dm y dejar main.cfg como está. Sin embargo, queremos preservar home.dm de manera que sea posible regresar a la home page original de Greenstone! Hágalo ahora editando main.cfg y cambiando la cadena yourhome.dm de regreso a home.dm. Se necesitará re-iniciar Greenstone para que el cambio tenga efecto.
Para aprender más sobre macros, lea Customizing the Greenstone User Interface, guia ilustrada para personalizar la interfaz del usuario, por Allison Zhang del Washington Research Library Consortium disponible en http://www.wrlc.org/dcpc/UserInterface/interface.htm.