Los editores de esta colección son la ONG Human Info, HumanityCD Ltd y demás organizaciones participantes. Contáctenos en\: Proyecto de Bibliotecas sobre Aspectos Humanitarios y de Desarrollo , Oosterveldiaan 196, B-2610 Antwerp, Bélgica, Tel 32-3-448.05.54, Fax 32-3-449.75.74, correo electrónico humanity@humaninfo.org.
description1=La colección DLS es bastante compleja. Si apenas está empezando a familiarizarse con su uso quizá fuera mejor que se fijara primero en alguna otra colección (como la Demostración en Word y PDF, los Archivos Greenstone o la colección sencilla de imágenes).
description2=Al igual que todos los archivos de configuración de colecciones, el archivo de configuración de esta colección, empieza con una línea ("creator") que proporciona la dirección de correo electrónico del creador de la colección y otra linea ("public") que determina si la colección aparecerá en la página principal del programa Greenstone. Note que configurando la opción "public" como "false" solo la quita de la página home, pero permanecerá accesible en la biblioteca para cualquiera que conozca la URL (a=p&sa=about&c=coll-shortname).
description3=Plugins. Las líneas "plugin" en el archivo de configuración indican los plugins usados en la colección. Los documentos en la colección DLS están en HTML, por lo que se deberá incluir HTMLPlugin. La opción description_tags procesa las etiquetas en el texto que definen secciones y títulos de secciones tal como se describe a continuación.
description4=Los otros plugins, GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin, y DirectoryPlugin, son empleados por Greenstone con fines particulares y son estándar en casi todas las colecciones.
description5=Índices de búsqueda. El bloque de líneas que empieza con indexes especifica los índices de búsqueda que están disponibles. En esta colección hay tres, los cuales se pueden ver al momento de desplegar el menú "Buscar" en la página de búsqueda. El primer índice se llama "capítulos", el segundo "títulos de sección" y el tercero "documentos enteros". Los nombres de estos tres índices están dados por tres sentencias collectionmeta.
description6=El contenido de los índices -- es decir, la especificación de lo que se va a buscar -- se define por medio de la línea indexes que se encuentra al principio de este bloque. Esta especifica tres índices, dos a nivel de sección (los cuales empiezan con section\:) y uno a nivel de documento (el cual empieza con document\:). La diferencia está en que una consulta de varias palabras únicamente encontrará una correspondencia en un índice a nivel de sección si todos los términos de la consulta aparecen en la misma sección, mientras que encontrará la correspondencia en un índice a nivel de documento si los términos aparecen en cualquier parte del documento (el cual consiste normalmente de varias secciones). El primero y tercer índices son section\:text y document\:text, donde \:text significa que se buscará en todo el texto de la sección o el documento, respectivamente. El segundo es section\:Title, el cual indica que se buscarán metadatos de Título, en este caso títulos de secciones (más que títulos de documentos). Los tres índices aparecerán en el orden en que se especificaron en la línea de índices.
description7=Clasificadores. El bloque de líneas con la etiqueta classifiers define los índices de exploración, llamados "clasificadores" en Greenstone. Hay cuatro de ellos correspondientes a los cuatro botones en la barra de navegación que se encuentra en la parte superior de cada página de la colección (p. ej. la página de búsqueda)\: temas, títulos, organización y cómo. El botón de búsqueda aparece primero y a continuación los cuatro clasificadores en orden.
description8=El primer clasificador le da acceso al asunto. Es un clasificador Hierarchy, el cual se define en el archivo dls.Subject.txt (el argumento hfile); este archivo se describe más adelante. El clasificador se basa en el metadato dls.Subject y cuando varios libros aparecen en una hoja de la jerarquía se ordenan por medio del metadato dls.Title (como se puede ver aquí). El segundo clasificador provee acceso por título. Es un clasificador Hierarchy también, pero esta vez basado en el metadato dls.AZList, cuya jerarquía está definida en dls.AZList.txt. Este archivo se describe abajo. El tercero le da acceso a la organización. Es un clasificador List basado en el metadato dls.Organization. La opción -bookshelf_type always crea un estante para cada organización, aún cuando un solo documento pertenezca a esa categoría. El cuarto provee acceso por el texto "Howto"\: es un clasificador List basado en el metadato dls.Keyword. La opción -bookshelf_type never previene la creación del estante aún cuando dos documentos compartan las mismas keywords.
description9=Imágenes de Portada. Greenstone busca una imagen de portada para cada documento cuyo nombre sea igual al documento pero con una extensión .jpg. Esta imagen está asociada con el documento, y puede ser mostrada en la página del documento (ver aqui abajo). Las imágenes de portada pueden ser deshabilitadas con la opción -no_cover_image en cada plugin. Enunciados de formato. La líneas que comienzan con format, llamadas "cadenas de formateo", determinan la forma en la que deben mostrarse muchas de las partes de la colección. La sentencia de formato de VList se aplica a las listas de items mostrados verticalmente, como por ejemplo listas de títulos, temas y organizaciones y la tabla de contenidos de los documentos. Es omitida para la lista de resultados mediante la sentencia SearchVList, y también para el clasificador Howto a través de la sentencia CL4VList (CL4 especifica el cuarto clasificador).
description10=[PENDING]La sentencia DocumentText determina el modo en el que se formatea el texto, con el metadato Title ([Title]) en formato HTML <h3> seguido por el texto del documento [Text]. Configurando la sentencia DocumentImages como true aseguramos que las imágenes de portada se visualicen en cada documento. DocumentButtons indica cuales botones se muestran en cada documento. Las opciones son\: ExpandText, Expand Contents, Detach y Highlight.
description11=[PENDING]La mayoría de las cadenas de formateo contienen código HTML. Los nombres de los metadatos entre corchetes (p. ej. [Title], [Creator]) dan el valor de dicho metadato. [Text] da el texto del documento. También se puede establecer un hipervínculo con el documento por medio de [link] ...[/link]. Un icono apropiado es producido por [icon]. Las cadenas de formato pueden incluir {If}{... , ...} y {Or}{... , ...}. Los primeros dos contienen ejemplos. Estos dos son enunciados de formato demasiado complejos, por lo que no los explicaremos aquí. En Greenstone los cambios en las cadenas de formato tienen efecto inmediatamente a menos que se esté usando el servidor local, en cuyo caso el servidor necesitará reiniciarse. Esto hace que sea fácil experimentar con diferentes versiones de un enunciado de formato y ver qué pasa.
description12=[PENDING]Metadatos a nivel de colección. Las líneas de collectionmeta en el archivo de configuración también son estándar en todas las colecciones Greenstone. Contienen información general acerca de la colección definiendo su nombre, y una descripción que aparece en su página inicial. La descripción (en collectionextra) se puede ver en la página inicial de la colección DLS (este texto es parte de él).
description13=[PENDING]Traducción de idioma. La última parte del archivo de configuración de la colección proporciona los metadatos a nivel de colección en francés y español, respectivamente. Estos idiomas se indican por medio de corchetes\: [fr] y [es]. Si no hay ninguna especificación del idioma, entonces el inglés se asume por omisión. El archivo de configuración muestra los caracteres que se acentúan (p. ej. é francesa). Este archivo está en UTF-8 y los caracteres se representan por medio de secuencias de varios bytes (<C3><A9> en este caso). De forma alternativa se pueden representar por medio de nombres de entidades HTML (como & eacute ;). No hay ninguna diferencia y se ven igual en la pantalla. Sin embargo, esto sí representaría una diferencia en el caso de que el texto se buscara. Greenstone utiliza Unicode internamente para asegurarse que las búsquedas trabajen tal como se espera con idiomas diferentes al inglés.
description14=[PENDING]Etiquetas de descripción. Las etiquetas de descripción reconocidas por HTMLPlugin se insertan en el texto fuente HTML de los documentos para definir el lugar en el que las secciones empiezan y terminan y para especificar los títulos de sección. Se ven de la siguiente manera\:
<!-- <Section> <Description> <Metadata name="Title"> Haciendo realidad los derechos humanos para la gente pobre\: Estrategias para lograr los objetivos de desarrollo mundial </Metadata> </Description> --> (el texto de la sección va aquí) <!-- </Section> -->description15=
Los marcadores <!-- ... --> se utilizan para asegurarse que estas etiquetas estén marcadas como comentarios en HTML y por lo tanto que no afecten el formato del documento. En la parte de Description se pueden especificar otros tipos de metadatos, pero esto no se hace para el estilo de colección que estamos describiendo aquí. Exactamente la misma especificación (incluyendo los marcadores <!-- ... -->) se puede usar también en los documentos Word.
description16=Archivos de metadatos. Los metadatos para todos los documentos de la colección DLS se asignan en archivos llamados metadata.xml, un documento por carpeta. El documento metadata.xml para el libro--Income generation and money management\: training women as entrepreneurs -- es un bloque de alrededor diez lineas encerradas en las etiquetas <FileSet> ... </FileSet>. El cual define los metadatos dls.Title, dls.Language, dls.Subject y dls.AZList. Se puede especificar más de un valor para cualquier ítem del metadato. Por ejemplo, este libro tiene dos clasificaciones dls.Subject. Ambos se almacenan como valores del metadato para este documento en particular (ya que se especifica mode=accumulate; la alternativa y el valor por omisión es mode=override).
description17=Archivos de jerarquía. Los archivos de Hierarchy contienen una sucesión de líneas, cada una de las cuales tiene tres items. El primer item es una cadena de texto que es confrontada con el metadato que aparece en el archivo metadata.xml descripto arriba. El segundo item es un número que define la posición en la jerarquía. El tercer item es una cadena de texto que describe al nodo de la jerarquía de la página web que genera Greenstone.
description18=Por ejemplo, las siguientes tres líneas pertenecen al archivo de jerarquia dls.Subject.txt.
"Animal Husbandry and Animal Product Processing" 7 "Animal Husbandry and Animal Product Processing" "Animal Husbandry and Animal Product Processing|Cattle" 7.1 "Cattle" "Animal Husbandry and Animal Product Processing|Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)" 7.2 "Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)"description19=
Estas tres líneas definen un estante de nivel superior (en la posición 7), titulado "Animal Husbandry and Animal Product Processing", con dos estantes bajo él, "Cattle" y "Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)" respectivamente.
description20=En este caso, las primeras cadenas de texto (y por consiguiente las entradas en el archivo metadata.xml) contienen todos los valores de la jerarquía. Los niveles en una jerarquía se separan con "|". Estos niveles pueden usarse directamente con el clasificador Hierarchy sin tener que usar el archivo de jerarquía. Sin embargo, de esta manera las entradas serían ordenadas alfabéticamente, y no en el orden particular definido en el archivo.
description21=El archivo de jerarquía dls.AZList.txt usado por el clasificador por títulos contiene una estructura similar. Ordinariamente, un navegador por títulos usaría un clasificador List (o AZList). En este caso, queremos predefinir el agrupamiento A-Z, e incluye una entrada separada para periódicos, como puede verse aquí.