Changeset 36623 for documented-examples/trunk/dls-e
- Timestamp:
- 2022-09-15T18:29:54+12:00 (20 months ago)
- Location:
- documented-examples/trunk/dls-e/resources
- Files:
-
- 2 edited
-
collectionConfig.properties (modified) (4 diffs)
-
collectionConfig_fr.properties (modified) (2 diffs)
Legend:
- Unmodified
- Added
- Removed
-
documented-examples/trunk/dls-e/resources/collectionConfig.properties
r36621 r36623 13 13 description0=<p>The editors of this collection are Human Info NGO, HumanityCD Ltd, and participating organizations. Contact us at Humanitarian and Development Libraries Project, Oosterveldiaan 196, B-2610 Antwerp, Belgium, Tel 32-3-448.05.54, Fax 32-3-449.75.74, email <a href=mailto\:[email protected]>[email protected]</a>. 14 14 15 description1=<h3>How the collection works</h3><p>The DLS collection is fairly complex. If you \'re just starting out you might prefer to look at some other collections first (e.g. <a href="library/collection/wrdpdf-e/page/about">Word and PDF demonstration</a>, or the <a href="library/collection/gsarch-e/page/about">Greenstone Archives</a>, or the <a href="library/collection/image-e/page/about">Simple Image collection</a>).</p>15 description1=<h3>How the collection works</h3><p>The DLS collection is fairly complex. If you're just starting out you might prefer to look at some other collections first (e.g. <a href="library/collection/wrdpdf-e/page/about">Word and PDF demonstration</a>, or the <a href="library/collection/gsarch-e/page/about">Greenstone Archives</a>, or the <a href="library/collection/image-e/page/about">Simple Image collection</a>).</p> 16 16 17 description2=<p>The collection configuration file, <tt>collectionConfig.xml</tt>, like all collection configuration files, begins with the <i>creator</i> metadata element that gives the email address of the collection \'s creator, and another metadata ("public") that determines whether the collection will appear on the home page of the Greenstone installation. Note that setting "public" to "false" only removes it from the home page; it will still be accessible in the library to anyone that knows the URL to the collection.</p>17 description2=<p>The collection configuration file, <tt>collectionConfig.xml</tt>, like all collection configuration files, begins with the <i>creator</i> metadata element that gives the email address of the collection's creator, and another metadata ("public") that determines whether the collection will appear on the home page of the Greenstone installation. Note that setting "public" to "false" only removes it from the home page; it will still be accessible in the library to anyone that knows the URL to the collection.</p> 18 18 19 19 description3=<p><b>Plugins</b>. The "plugin" lines in the collection configuration file give the plugins used by the collection. The documents in the DLS collection are in HTML, so <i>HTMLPlugin</i> must be included. The <i>description_tags</i> option processes tags in the text that define sections and section titles as described below.</p> … … 21 21 description4=<p>The other plugins, <i>GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin, and DirectoryPlugin</i>, are used by Greenstone for internal purposes and are standard in almost all collections.</p> 22 22 23 description5=<p><b>Searchable indexes</b>. The block of lines starting with <i>indexes</i> specifies what searchable indexes will be available. In this collection there are three\: you can see them when you pull down the "Search for" menu on the collection \'s <a href="library/collection/dls-e/search/TextQuery">search page</a>. The first index is called "chapters", the second "section titles", and the third "entire documents". The names of these three indexes are given by three properties (section_text, section_Title and document_text) in the translatable <tt>collectionConfig.properties</tt> file located in the collection\'s <tt>resources</tt> subfolder.</p>23 description5=<p><b>Searchable indexes</b>. The block of lines starting with <i>indexes</i> specifies what searchable indexes will be available. In this collection there are three\: you can see them when you pull down the "Search for" menu on the collection's <a href="library/collection/dls-e/search/TextQuery">search page</a>. The first index is called "chapters", the second "section titles", and the third "entire documents". The names of these three indexes are given by three properties (section_text, section_Title and document_text) in the translatable <tt>collectionConfig.properties</tt> file located in the collection's <tt>resources</tt> subfolder.</p> 24 24 25 25 description6=<p>The contents of the indexes -- that is, the specification of what it is that will be searched -- are defined by the <i>indexes</i> line at the beginning of this block. This specifies three indexes, two at the section level (beginning with <i>section\:</i>) and one at the document level (beginning with <i>document\:</i>). The difference is that a multi-word query will only match a section-level index if all query terms appear in the same section, whereas it will match a document-level index if the terms appear anywhere within the document (which typically comprises several sections). The first and third indexes are <i>section\:text</i> and <i>document\:text</i>, and the <i>\:text</i> means that the full text of sections and documents respectively will be searched. The second is <i>section\:Title</i>, which means that <i>Title</i> metadata will be searched -- in this case, section titles (rather than document titles). The three indexes appear in the order in which they are specified on the <i>indexes</i> line.</p> … … 29 29 description8=<p>The first classifier provides access by subject. It is a <i>Hierarchy</i> classifier whose hierarchy is defined in the file <tt>etc/dls.Subject.txt</tt> (the <i>hfile</i> argument); this file is discussed below. This classifier is based on <i>dls.Subject</i> metadata, and when several books appear at a leaf of the hierarchy they are sorted by <i>dls.Title</i> metadata (as you can see when you open classifier browser <tt>CL1.4.1</tt>). The second classifier provides access by title. It is also a <i>Hierarchy</i> classifier, this time based on <i>dls.AZList</i> metadata, whose hierarchy is defined in <tt>etc/dls.AZList.txt</tt>. This file is discussed below. The third provides access by organization\: it is a <i>List</i> classifier based on <i>dls.Organization</i> metadata. The <i>-bookshelf_type always</i> option creates a new bookshelf for each organization, even if only one document belongs to that category. The fourth provides access by "Howto" text\: it is a <i>List</i> classifier based on <i>dls.Keyword</i> metadata. The <i>-bookshelf_type never</i> option prevents bookshelves being created even if two documents share the same keywords.</p> 30 30 31 description9=<p><b>Cover images</b>. Greenstone looks for a cover image for each document, whose name is the same as the document \'s but with a <i>.jpg</i> extension. This image is associated with the document, and may be displayed on the document page (see below). Cover images can be switched off by setting the -no_cover_image flag for each plugin.</p>31 description9=<p><b>Cover images</b>. Greenstone looks for a cover image for each document, whose name is the same as the document's but with a <i>.jpg</i> extension. This image is associated with the document, and may be displayed on the document page (see below). Cover images can be switched off by setting the -no_cover_image flag for each plugin.</p> 32 32 33 33 description10=<p><b>Format statements</b>. The <i>format</i> elements (<format;>, <browse>, <search> and <display> XML elements), called "format statements", govern how various parts of the collection should be displayed. The <i>VList</i> format statement applies to lists of items displayed vertically, such as the lists of titles, subjects and organisations, and the table of contents for the target documents. It is overridden for the search results list by the <i>SearchVList</i> format statement, and also for the <i>Howto</i> classifier by the <i>CL4VList</i> statement (CL4 specifies the fourth classifier).</p> … … 37 37 description12=<p>Greenstone 3 uses XML for format statements, allowing librarians with XML experience to more easily understand and use format statements than Greenstone 2 which worked with a custom way of specifying format statements. For more information on understanding format statements and writing your own format statements for collections, refer to <a href="http\://wiki.greenstone.org/doku.php?id=en\:user\:gs3_format_statements">Greenstone 3 Format Statements</a> on the Greenstone wiki.</p> 38 38 39 description13=<p><b>Collection-level metadata</b>. The <i><displayItem></i> elements under the top-level <i><displayItemList></i> in the configuration file are also standard in all Greenstone collections. They give general information about the collection, defining its name, and a description that appears on its home page. The description text (defined in the translatable <tt>resources/collectionConfig.properties</tt> files) can be seen on the DLS collection \'s home page (this text is part of it).</p>39 description13=<p><b>Collection-level metadata</b>. The <i><displayItem></i> elements under the top-level <i><displayItemList></i> in the configuration file are also standard in all Greenstone collections. They give general information about the collection, defining its name, and a description that appears on its home page. The description text (defined in the translatable <tt>resources/collectionConfig.properties</tt> files) can be seen on the DLS collection's home page (this text is part of it).</p> 40 40 41 description14=<p><b>Language translations</b>. In the collection configuration file, lines that look like <tt><displayItem assigned="true" dictionary="collectionConfig" key="..." name="..."/></tt> allow for translatable collection-level metadata, that are defined in the <tt>resources/collectionConfig.properties</tt> text files and can be translated in the same location such as by creating French and Spanish versions (in <tt>resources/collectionConfig_fr.properties</tt> and <tt>resources/collectionConfig_es.properties</tt>, respectively). Note that we advise translators to go through the GTI (Greenstone Translation Interface) system if they want to contribute translations to Greenstone as used by everyone, such as translations to Greenstone \'s demo collections and these documented example collections. The properties files allow for accented characters (e.g. French <i>é</i>). The files are in UTF-8, and these characters are represented by multi-byte sequences (<C3><A9> in this case). Alternatively they could be represented by their HTML entity names (like <i>& eacute ;</i>). It makes no difference for how they appear on the screen.</p>41 description14=<p><b>Language translations</b>. In the collection configuration file, lines that look like <tt><displayItem assigned="true" dictionary="collectionConfig" key="..." name="..."/></tt> allow for translatable collection-level metadata, that are defined in the <tt>resources/collectionConfig.properties</tt> text files and can be translated in the same location such as by creating French and Spanish versions (in <tt>resources/collectionConfig_fr.properties</tt> and <tt>resources/collectionConfig_es.properties</tt>, respectively). Note that we advise translators to go through the GTI (Greenstone Translation Interface) system if they want to contribute translations to Greenstone as used by everyone, such as translations to Greenstone's demo collections and these documented example collections. The properties files allow for accented characters (e.g. French <i>é</i>). The files are in UTF-8, and these characters are represented by multi-byte sequences (<C3><A9> in this case). Alternatively they could be represented by their HTML entity names (like <i>& eacute ;</i>). It makes no difference for how they appear on the screen.</p> 42 42 43 43 description15=<p><b>Description tags</b>. The description tags recognized by <i>HTMLPlugin</i> are inserted into the HTML source text of the documents to define where sections begin and end, and to specify section titles. They look like this\: <pre> <!-- <Section> <Description> <Metadata name="Title"> Realizing human rights for poor people\: Strategies for achieving the international development targets </Metadata> </Description> --> (text of section goes here) <!-- </Section> --> </pre> The <!-- ... --> markers are used to ensure that these tags are marked as comments in HTML and therefore do not affect document formatting. In the <i>Description</i> part other kinds of metadata can be specified, but this is not done for the style of collection we are describing here. Exactly the same specification (including the <!-- ... --> markers) can be used in Word documents too.</p> 44 44 45 description16=<p><b>Metadata Files</b>. Metadata for all documents in the DLS collection is provided in metadata.xml files, one per document folder. In this collection \'s <tt>import/r0087e</tt> is the <tt>metadata.xml</tt> file for one book -- <i>Income generation and money management\: training women as entrepreneurs</i> -- which is a block of about ten lines encased in <<i>FileSet</i>> ... <<i>/FileSet</i>> tags. It defines <i>dls.Title</i>, <i>dls.Language</i>, <i>dls.Subject</i> and <i>dls.AZList</i> metadata. More than one value can be specified for any metadata item. For example, this book has two dls.Subject classifications. Both of these are stored as metadata values for this particular document (because <i>mode=accumulate</i> is specified; the alternative, and the default, is <i>mode=override</i>).</p>45 description16=<p><b>Metadata Files</b>. Metadata for all documents in the DLS collection is provided in metadata.xml files, one per document folder. In this collection's <tt>import/r0087e</tt> is the <tt>metadata.xml</tt> file for one book -- <i>Income generation and money management\: training women as entrepreneurs</i> -- which is a block of about ten lines encased in <<i>FileSet</i>> ... <<i>/FileSet</i>> tags. It defines <i>dls.Title</i>, <i>dls.Language</i>, <i>dls.Subject</i> and <i>dls.AZList</i> metadata. More than one value can be specified for any metadata item. For example, this book has two dls.Subject classifications. Both of these are stored as metadata values for this particular document (because <i>mode=accumulate</i> is specified; the alternative, and the default, is <i>mode=override</i>).</p> 46 46 47 47 description17=<p><b>Hierarchy files</b>. Hierarchy files contain a succession of lines each of which has three items. The first item is a text string which is matched against the metadata that occurs in the <i>metadata.xml</i> file described above. The second item is a number that defines the position in the hierarchy. The third item is a text string that describes the node of the hierarchy on the web pages that Greenstone generates.</p> -
documented-examples/trunk/dls-e/resources/collectionConfig_fr.properties
r36620 r36623 4 4 document_text=documents entiers 5 5 6 shortDescription=<p>Les BibliothÚques humanitaires pour le Développement constituent une collection importante dont les objectifs sont d \'aider à réduire la pauvreté, de promouvoir l\'accroissement du potentiel humain, et d\'offrir une éducation pratique et utile à tous. Cette collection contient environ 25 publications -- documents, rapports, et articles de périodiques -- qui traitent de différents sujets liés au développement humain. On y trouve des informations concernant les pratiques agricoles aussi bien que les politiques économiques; les mesures d\'hygiÚne pour l\'eau et la société et la culture; l\'éducation et la petite industrie; la prévention des désastres et les micro-entreprises.</p>6 shortDescription=<p>Les BibliothÚques humanitaires pour le Développement constituent une collection importante dont les objectifs sont d'aider à réduire la pauvreté, de promouvoir l'accroissement du potentiel humain, et d'offrir une éducation pratique et utile à tous. Cette collection contient environ 25 publications -- documents, rapports, et articles de périodiques -- qui traitent de différents sujets liés au développement humain. On y trouve des informations concernant les pratiques agricoles aussi bien que les politiques économiques; les mesures d'hygiÚne pour l'eau et la société et la culture; l'éducation et la petite industrie; la prévention des désastres et les micro-entreprises.</p> 7 7 8 8 description0=<p>Les éditeurs de cette collection sont Human Info NGO, HumanityCD Ltd, and organisations ayant contribué. Vous pouvez nous contacter à Humanitarian and Development Libraries Project, Oosterveldiaan 196, B-2610 Antwerp, Belgium, Tel 32-3-448.05.54, Fax 32-3-449.75.74, courriel <a href="mailto\:[email protected]">[email protected]</a>.</p> 9 9 10 description1=<h3>Comment, marche la collection</h3><p>La collection DLS est assez complexe. Pour un débutant, il serait préférable de consulter d \'abord d\'autres collections (par exemple <a href="?c=documented-examples/wrdpdf-e&a=p&sa=about">Démonstration Word et PDF</a> ou les <a href="?c=documented-examples/gsarch-e&a=p&sa=about">Greenstone Archives</a> ou la collection <a href="?c=documented-examples/image-e&a=p&sa=about">Simple Image</a>).</p>10 description1=<h3>Comment, marche la collection</h3><p>La collection DLS est assez complexe. Pour un débutant, il serait préférable de consulter d'abord d'autres collections (par exemple <a href="?c=documented-examples/wrdpdf-e&a=p&sa=about">Démonstration Word et PDF</a> ou les <a href="?c=documented-examples/gsarch-e&a=p&sa=about">Greenstone Archives</a> ou la collection <a href="?c=documented-examples/image-e&a=p&sa=about">Simple Image</a>).</p> 11 11 12 description2=<p>Le <tt>fichier de configuration</tt> de la collection, comme tous les fichiers de configuration de collection, commence avec une ligne ("creator") qui donne l \'adresse e-mail du créateur de la collection et une autre ligne ("public") qui détermine la maniÚre d\'apparition de la collection sur la page d\'accueil de Greenstone. Noter que paramétrer "public" à "false" ne supprime le lien vers la collection que sur la page d\'accueil; la collection reste accessible via la bibliothÚque numérique à toute personne qui en connaît l\'URL (a=p&sa=about&c=nom-abrégé-collection).</p>12 description2=<p>Le <tt>fichier de configuration</tt> de la collection, comme tous les fichiers de configuration de collection, commence avec une ligne ("creator") qui donne l'adresse e-mail du créateur de la collection et une autre ligne ("public") qui détermine la maniÚre d'apparition de la collection sur la page d'accueil de Greenstone. Noter que paramétrer "public" à "false" ne supprime le lien vers la collection que sur la page d'accueil; la collection reste accessible via la bibliothÚque numérique à toute personne qui en connaît l'URL (a=p&sa=about&c=nom-abrégé-collection).</p> 13 13 14 description3=<p><b>Plugins</b>. Le troisiÚme bloc de lignes dans le <tt>fichier de configuration</tt> donne la liste des plugins utilisés par cette collection. Les documents dans la collection DLS sont en HTML, ainsi <i>HTMLPlugin</i> doit être inclus. L \'option <i>description_tags</i> traite des onglets dans le texte qui définissent les sections et les titres de section comme décrit ci-dessous.</p>14 description3=<p><b>Plugins</b>. Le troisiÚme bloc de lignes dans le <tt>fichier de configuration</tt> donne la liste des plugins utilisés par cette collection. Les documents dans la collection DLS sont en HTML, ainsi <i>HTMLPlugin</i> doit être inclus. L'option <i>description_tags</i> traite des onglets dans le texte qui définissent les sections et les titres de section comme décrit ci-dessous.</p> 15 15 16 16 description4=<p>Les autres plugins, <i>GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin et DirectoryPlugin</i> sont utilisés par Greenstone pour des objectifs internes et sont des références dans presque toutes les collections.</p> 17 17 18 description5=<p><b>Index recherchables</b>. Le bloc de lignes qui commence avec <i>index</i> précise les type d \'index de recherche disponibles. Dans cette collection on en compte trois. Vous pouvez les voir en déroulant le menu "Rechercher des" sur la <a href="?a=q">page de recherche</a>. Le premier index est appelé "chapitre" , le second "titres de section" et le troisiÚme "documents entiers". Les noms de ces trois index sont donnés par les trois déclarations <i>collectionmeta</i>.</p>18 description5=<p><b>Index recherchables</b>. Le bloc de lignes qui commence avec <i>index</i> précise les type d'index de recherche disponibles. Dans cette collection on en compte trois. Vous pouvez les voir en déroulant le menu "Rechercher des" sur la <a href="?a=q">page de recherche</a>. Le premier index est appelé "chapitre" , le second "titres de section" et le troisiÚme "documents entiers". Les noms de ces trois index sont donnés par les trois déclarations <i>collectionmeta</i>.</p> 19 19 20 description6=<p>Les contenus des trois index, à savoir la spécification de ce qui sera recherché, sont définies par la ligne des <i>index</i> au début de ce bloc. Trois index sont spécifiés, deux au niveau section (commençant par <i>section\:</i>) et un autre au niveau document (commençant par <i>document\:</i>.) La différence est qu \'une requête à mots multiples ne conviendra qu\'à un index de niveau section si tous les termes recherchés se trouvent dans la même section, tandis qu\'elle conviendra à un index de niveau document si les termes apparaissent n\'importe où dans le document (qui typiquement, comprend plusieurs sections). Le premier et le troisiÚme index sont <i>section\:text</i> et <i>document\:text</i>, et <i>\:text</i> signifie que le texte complet des sections et celui des documents seront respectivement recherchés. Le second est <i>section\:Title</i>, qui signifie que la méta-donnée <i>Title</i> sera recherchée -- dans ce cas, les titres de section (plutÃŽt que les titres de document). Les trois index apparaissent dans l\'ordre dans lequel ils sont précisés sur la ligne <i>indexes</i>.</p>20 description6=<p>Les contenus des trois index, à savoir la spécification de ce qui sera recherché, sont définies par la ligne des <i>index</i> au début de ce bloc. Trois index sont spécifiés, deux au niveau section (commençant par <i>section\:</i>) et un autre au niveau document (commençant par <i>document\:</i>.) La différence est qu'une requête à mots multiples ne conviendra qu'à un index de niveau section si tous les termes recherchés se trouvent dans la même section, tandis qu'elle conviendra à un index de niveau document si les termes apparaissent n'importe où dans le document (qui typiquement, comprend plusieurs sections). Le premier et le troisiÚme index sont <i>section\:text</i> et <i>document\:text</i>, et <i>\:text</i> signifie que le texte complet des sections et celui des documents seront respectivement recherchés. Le second est <i>section\:Title</i>, qui signifie que la méta-donnée <i>Title</i> sera recherchée -- dans ce cas, les titres de section (plutÃŽt que les titres de document). Les trois index apparaissent dans l'ordre dans lequel ils sont précisés sur la ligne <i>indexes</i>.</p> 21 21 22 description7=<p><b>Classificateurs</b>. Le bloc de lignes libellé <i>classify</i> définit les index de navigation appelés "classifiers" dans Greenstone. Ils sont quatre, correspondant aux quatre boutons sur la barre de navigation en haut de chaque page dans la collection (c \'est à dire la <a href="?a=q">page de recherche</a>)\: <i>sujets</i>, <i>titres</i>, <i>organisations</i> et <i>comment</i>. Le bouton de <i>recherche</i> vient en premier, les quatre classificateurs.</p>22 description7=<p><b>Classificateurs</b>. Le bloc de lignes libellé <i>classify</i> définit les index de navigation appelés "classifiers" dans Greenstone. Ils sont quatre, correspondant aux quatre boutons sur la barre de navigation en haut de chaque page dans la collection (c'est à dire la <a href="?a=q">page de recherche</a>)\: <i>sujets</i>, <i>titres</i>, <i>organisations</i> et <i>comment</i>. Le bouton de <i>recherche</i> vient en premier, les quatre classificateurs.</p> 23 23 24 description8=<p>Le premier classificateur fournit un accÚs par sujet. C \'est un classificateur <i>Hierarchy</i> dont la hiérarchie est définie dans le fichier <a href="_httpcollection_/etc/dls.Subject.txt" target="text">dls.Subject.txt</a> (l\'argument "<i>hfile</i>"); ce fichier est présenté ci-dessous. Ce classificateur est basé sur la méta-donnée <i>dls.Subject</i> et quand plusieurs livres apparaissent sur une feuille de la hiérarchie, ils sont triés suivant la méta-donnée <i>dls.Title</i> (comme visible <a href="?a=d&cl=CL1.4.1">ici</a>). Le second classificateur fournit un accÚs par titre. C\'est aussi un classificateur de la <i>Hierarchy</i>, basé cette fois sur la métadonnée <i>dls.AZList</i>, dont la hiérarchie est définie dans le fichier <a href="_httpcollection_/etc/dls.Title.txt" target="text">dls.AZList.txt</a>. Ce fichier est décrit plus loin. Le troisiÚme fournit un accÚs par organisation\: c\'est un classificateur <i>List</i> basé sur les méta-données <i>Organization</i>. L\'option <i>-bookshelf_type always</i> crée une nouvelle étagÚre pour chaque organisation, même s\'il n\'existe qu\'un seul document appartenant à cette catégorie. Le quatriÚme fournit un accÚs par "Howto" \: c\'est un classificateur <i>List</i> basé sur les métadonnées <i>dls.Keyword</i>. L\'option <i>-bookshelf_type never</i> permet d\'éviter la création des étagÚres même si deux documents ont les mêmes mots-clés.</p>24 description8=<p>Le premier classificateur fournit un accÚs par sujet. C'est un classificateur <i>Hierarchy</i> dont la hiérarchie est définie dans le fichier <a href="_httpcollection_/etc/dls.Subject.txt" target="text">dls.Subject.txt</a> (l'argument "<i>hfile</i>"); ce fichier est présenté ci-dessous. Ce classificateur est basé sur la méta-donnée <i>dls.Subject</i> et quand plusieurs livres apparaissent sur une feuille de la hiérarchie, ils sont triés suivant la méta-donnée <i>dls.Title</i> (comme visible <a href="?a=d&cl=CL1.4.1">ici</a>). Le second classificateur fournit un accÚs par titre. C'est aussi un classificateur de la <i>Hierarchy</i>, basé cette fois sur la métadonnée <i>dls.AZList</i>, dont la hiérarchie est définie dans le fichier <a href="_httpcollection_/etc/dls.Title.txt" target="text">dls.AZList.txt</a>. Ce fichier est décrit plus loin. Le troisiÚme fournit un accÚs par organisation\: c'est un classificateur <i>List</i> basé sur les méta-données <i>Organization</i>. L'option <i>-bookshelf_type always</i> crée une nouvelle étagÚre pour chaque organisation, même s'il n'existe qu'un seul document appartenant à cette catégorie. Le quatriÚme fournit un accÚs par "Howto" \: c'est un classificateur <i>List</i> basé sur les métadonnées <i>dls.Keyword</i>. L'option <i>-bookshelf_type never</i> permet d'éviter la création des étagÚres même si deux documents ont les mêmes mots-clés.</p> 25 25 26 description9=<p><b>Images Couverture</b>. Greenstone cherche une image couverture pour chaque document, dont le nom est le même que le document \'s mais avec une extension <i>.jpg</i>. Cette image est associée avec le document et pourrais être visualisé sur la page du document (voir ce-dessous). Les images couverture peuvent-être éteintes en réglant le drapeau -no_cover_image pour chauqe plug-in.</p>26 description9=<p><b>Images Couverture</b>. Greenstone cherche une image couverture pour chaque document, dont le nom est le même que le document's mais avec une extension <i>.jpg</i>. Cette image est associée avec le document et pourrais être visualisé sur la page du document (voir ce-dessous). Les images couverture peuvent-être éteintes en réglant le drapeau -no_cover_image pour chauqe plug-in.</p> 27 27 28 description10=[PENDING]<p><b>Déclarations de format</b>. Les lignes commençant par <i>format</i>, appelées "format statements", déterminent la façon dont certaines parties de la collection seront affichées. Le format <i>VList</i> est appliqué aux listes d \'éléments présentés verticalement, comme les listes de titres, de sujets ou d\'organisations, et la table des matiÚres pour les documents cibles. Il est modifié pour les liste de résultats de recherche par le format <i>SearchVList</i>, ainsi que par le format <i>CL4VList</i> pour le classificateur <i>Howto</i> (CL4 détermine le quatriÚme classificateur).</p>28 description10=[PENDING]<p><b>Déclarations de format</b>. Les lignes commençant par <i>format</i>, appelées "format statements", déterminent la façon dont certaines parties de la collection seront affichées. Le format <i>VList</i> est appliqué aux listes d'éléments présentés verticalement, comme les listes de titres, de sujets ou d'organisations, et la table des matiÚres pour les documents cibles. Il est modifié pour les liste de résultats de recherche par le format <i>SearchVList</i>, ainsi que par le format <i>CL4VList</i> pour le classificateur <i>Howto</i> (CL4 détermine le quatriÚme classificateur).</p> 29 29 30 description11=[PENDING]<p>L \'enregistrement <i>DocumentText</i> détermine la façon de formater le document textuel, avec la métadonnée <i>Title</i> ([<i>Title</i>]) insérée dans la balise HTML <<i>h3</i>> suivie par le texte du document ([<i>Text</i>]). Positionner la variable <i>DocumentImages</i> sur <i>true</i> entraîne l\'affichage des images de couverture pour chaque document. La variable <i>DocumentButtons</i> permet l\'affichage des boutons <i>Expand Text, Expand Contents, Detach</i> et <i>Highlight</i> avec chaque document.</p>30 description11=[PENDING]<p>L'enregistrement <i>DocumentText</i> détermine la façon de formater le document textuel, avec la métadonnée <i>Title</i> ([<i>Title</i>]) insérée dans la balise HTML <<i>h3</i>> suivie par le texte du document ([<i>Text</i>]). Positionner la variable <i>DocumentImages</i> sur <i>true</i> entraîne l'affichage des images de couverture pour chaque document. La variable <i>DocumentButtons</i> permet l'affichage des boutons <i>Expand Text, Expand Contents, Detach</i> et <i>Highlight</i> avec chaque document.</p> 31 31 32 description12=[PENDING]<p>La plupart des déclarations de format contiennent une chaîne spécifiée en HTML mise en valeur. Les noms de méta-données entre crochets (c \'et à dire [<i>Title</i>], [<i>Creator</i>]), donne la valeur de ces méta-données; [<i>Text</i>] donne le document texte. Un hyperlien au document peut être obtenu en utilisant [<i>link</i>] ... [<i>/link</i>]; une icÃŽne appropriée est générée par [<i>icon</i>]. Des chaînes de format peuvent inclure {<i>If</i>} {...,...} et {<i>Or</i>} {...,...}; les deux premiÚres en donnent des exemples. Ces deux sont des déclarations de format assez complexes qui ne seront pas expliquées ici. Dans Greenstone, les changements dans les chaînes de format prennent effet immédiatement à moins que vous n\'utilisiez le serveur de la bibliothÚque locale, auquel cas, le serveur à besoin d\'être réinitialisé. Cela rend facile l\'expérimentation de versions différentes d\'une déclaration de format et de voir ce qui se passe.</p>32 description12=[PENDING]<p>La plupart des déclarations de format contiennent une chaîne spécifiée en HTML mise en valeur. Les noms de méta-données entre crochets (c'et à dire [<i>Title</i>], [<i>Creator</i>]), donne la valeur de ces méta-données; [<i>Text</i>] donne le document texte. Un hyperlien au document peut être obtenu en utilisant [<i>link</i>] ... [<i>/link</i>]; une icÃŽne appropriée est générée par [<i>icon</i>]. Des chaînes de format peuvent inclure {<i>If</i>} {...,...} et {<i>Or</i>} {...,...}; les deux premiÚres en donnent des exemples. Ces deux sont des déclarations de format assez complexes qui ne seront pas expliquées ici. Dans Greenstone, les changements dans les chaînes de format prennent effet immédiatement à moins que vous n'utilisiez le serveur de la bibliothÚque locale, auquel cas, le serveur à besoin d'être réinitialisé. Cela rend facile l'expérimentation de versions différentes d'une déclaration de format et de voir ce qui se passe.</p> 33 33 34 description13=[PENDING]<p><b>Méta-données de niveau collection</b>. Les lignes <i>collectionmeta </i> dans le fichier de configuration sont aussi standard dans toutes les collections Greenstone. Elles donnent une information générale sur la collection par la définition de son nom, et par une description qui apparaît sur la page d \'accueil. La description (dans <i>collectionextra</i>) peut être vue sur la page d\'accueil de la collection (ce texte en fait partie).</p>34 description13=[PENDING]<p><b>Méta-données de niveau collection</b>. Les lignes <i>collectionmeta </i> dans le fichier de configuration sont aussi standard dans toutes les collections Greenstone. Elles donnent une information générale sur la collection par la définition de son nom, et par une description qui apparaît sur la page d'accueil. La description (dans <i>collectionextra</i>) peut être vue sur la page d'accueil de la collection (ce texte en fait partie).</p> 35 35 36 description14=[PENDING]<p><b>Traduction de langues</b>. La derniÚre partie du <tt>fichier de configuration de la collection</tt> donne les méta-données de niveau collection en Français et en Espagnol respectivement. Les langues sont indiquées par des crochets\:[<i>fr</i>] et [<i>es</i>]. Si aucune langue n \'est spécifiée, l\'Anglais est supposé par défaut. Le fichier de configuration montre des caractÚres mis en valeur (par exemple le "<i>é</i>" français). Ce fichier est en UTF-8, et ces caractÚres sont représentés par des séquences multi-octets (<C3><A9>) dans ce cas). Autrement, elles pourraient être représentées par leurs noms d\'entité (comme <i>& eacute ;</i>). Cela ne présente aucune différence\: ils sont identiques à l\'écran. Cependant si les textes faisaient l\'objet d\'une recherche, une différence aurait été notée; Greenstone utilise Unicode de façon interne pour s\'assurer que le processus de recherche fonctionne comme prévu pour les langues autre que l\'anglais.</p>36 description14=[PENDING]<p><b>Traduction de langues</b>. La derniÚre partie du <tt>fichier de configuration de la collection</tt> donne les méta-données de niveau collection en Français et en Espagnol respectivement. Les langues sont indiquées par des crochets\:[<i>fr</i>] et [<i>es</i>]. Si aucune langue n'est spécifiée, l'Anglais est supposé par défaut. Le fichier de configuration montre des caractÚres mis en valeur (par exemple le "<i>é</i>" français). Ce fichier est en UTF-8, et ces caractÚres sont représentés par des séquences multi-octets (<C3><A9>) dans ce cas). Autrement, elles pourraient être représentées par leurs noms d'entité (comme <i>& eacute ;</i>). Cela ne présente aucune différence\: ils sont identiques à l'écran. Cependant si les textes faisaient l'objet d'une recherche, une différence aurait été notée; Greenstone utilise Unicode de façon interne pour s'assurer que le processus de recherche fonctionne comme prévu pour les langues autre que l'anglais.</p> 37 37 38 description15=<p><b>Etiquettes de description</b>. Les étiquettes de description identifiées par "HTMLPlugin" sont insÚrées dans le texte source HTML des documents pour délimiter le début et la fin des sections et pour spécifier les titres de section. Ils se présentent comme suit\: <pre> <!-- <Section> <Description> <Metadata name="Title"> Realizing human rights for poor people\: Strategies for achieving the international development targets </Metadata> </Description> --> (text of section goes here) <!-- </Section> --> </pre> Les marqueurs <!-- ... --> sont utilisés pour assurer que ces étiquettes sont indiquées comme commentaires dans HTML et par conséquent n \'ont aucun effet sur le formatage. Dans la partie <i>Description</i>, d\'autres types de méta-données peuvent être spécifiés mais ceci n\'est pas fait pour le style de collection décrit ici. La même spécification (y compris les marqueurs <!-- ... -->) peut être utilisée de façon tout à fait identique dans les documents Word.</p>38 description15=<p><b>Etiquettes de description</b>. Les étiquettes de description identifiées par "HTMLPlugin" sont insÚrées dans le texte source HTML des documents pour délimiter le début et la fin des sections et pour spécifier les titres de section. Ils se présentent comme suit\: <pre> <!-- <Section> <Description> <Metadata name="Title"> Realizing human rights for poor people\: Strategies for achieving the international development targets </Metadata> </Description> --> (text of section goes here) <!-- </Section> --> </pre> Les marqueurs <!-- ... --> sont utilisés pour assurer que ces étiquettes sont indiquées comme commentaires dans HTML et par conséquent n'ont aucun effet sur le formatage. Dans la partie <i>Description</i>, d'autres types de méta-données peuvent être spécifiés mais ceci n'est pas fait pour le style de collection décrit ici. La même spécification (y compris les marqueurs <!-- ... -->) peut être utilisée de façon tout à fait identique dans les documents Word.</p> 39 39 40 description16=<p><b>Fichiers de méta-données</b>. Les méta-données pour tous les documents de la collection DLS sont fournies dans le fichier metadata.xml. Le fichier <a href="_httpcollection_/import/r0087e/metadata.xml" target="text">metadata.xml</a> pour le livre--<i>Income generation and money management\: training women as entrepreneurs</i> --est un bloc de dix lignes comprises entre les étiquettes <<i>FileSet</i>> ... <<i>/FileSet</i>>. Elle définit les méta-données <i>dls.Title</i>, <i>dls.Language</i>, <i>dls.Subject</i> et <i>dls.AZList</i>. Plus d \'une valeur peut être spécifiée pour n\'importe quel élément de méta-donnée. Par exemple, ce livre a deux classifications dls.Subject. Toutes les deux sont enregistrées comme comme valeurs de méta-donnée pour ce document particulier (parce que <i>mode=accumulate</i> est spécifié; autrement, le défaut est <i>mode=override</i>).</p>40 description16=<p><b>Fichiers de méta-données</b>. Les méta-données pour tous les documents de la collection DLS sont fournies dans le fichier metadata.xml. Le fichier <a href="_httpcollection_/import/r0087e/metadata.xml" target="text">metadata.xml</a> pour le livre--<i>Income generation and money management\: training women as entrepreneurs</i> --est un bloc de dix lignes comprises entre les étiquettes <<i>FileSet</i>> ... <<i>/FileSet</i>>. Elle définit les méta-données <i>dls.Title</i>, <i>dls.Language</i>, <i>dls.Subject</i> et <i>dls.AZList</i>. Plus d'une valeur peut être spécifiée pour n'importe quel élément de méta-donnée. Par exemple, ce livre a deux classifications dls.Subject. Toutes les deux sont enregistrées comme comme valeurs de méta-donnée pour ce document particulier (parce que <i>mode=accumulate</i> est spécifié; autrement, le défaut est <i>mode=override</i>).</p> 41 41 42 description17=<p><b>Fichiers d \'hiérarchie</b>. Les fichiers de hiérarchie contiennent une succession de lignes qui comportent chacune trois éléments. Le premier élément est une chaîne de caractÚres pour laquelle une correspondance sera recherchée avec les métadonnées présentes dans le fichier <i>metadata.xml</i> décrit ci-dessus. Le second élément est un nombre qui détermine la position dans la hiérarchie. Le troisiÚme élément est une chaîne de caractÚres qui décrit le noeud de la hiérarchie sur les pages que Greenstone génÚre.</p>42 description17=<p><b>Fichiers d'hiérarchie</b>. Les fichiers de hiérarchie contiennent une succession de lignes qui comportent chacune trois éléments. Le premier élément est une chaîne de caractÚres pour laquelle une correspondance sera recherchée avec les métadonnées présentes dans le fichier <i>metadata.xml</i> décrit ci-dessus. Le second élément est un nombre qui détermine la position dans la hiérarchie. Le troisiÚme élément est une chaîne de caractÚres qui décrit le noeud de la hiérarchie sur les pages que Greenstone génÚre.</p> 43 43 44 44 description18=<p>Par exemple, ce qui suit représente trois lignes du fichier <a href="_httpcollection_/etc/dls.Subject.txt" target="text">dls.Subject.txt</a> qui organise la hiérarchie des sujets. <pre> "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.)" </pre></p> … … 46 46 description19=<p>Ces trois lignes définissent une étagÚre située au plus haut niveau (à la position 7), intitulée "Animal Husbandry and Animal Product Processing", contenant deux étagÚres, intitulées respectivement "Cattle" et "Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)".</p> 47 47 48 description20=<p>Dans ce cas, les premiÚres chaînes (et par conséquent les entrées dans le fichier metadata.xml) contiennent les valeurs de toute la hiérarchie. Les niveaux sont séparés dans la hiérarchie par "|". Elles peuvent être utilisées directement par un classificateur <i>Hierarchy</i>, sans passer par le fichier de hiérarchie. Cependant, les entrées seront ordonnées dans ce cas alphabétiquement, et non dans l \'ordre défini dans le fichier.</p>48 description20=<p>Dans ce cas, les premiÚres chaînes (et par conséquent les entrées dans le fichier metadata.xml) contiennent les valeurs de toute la hiérarchie. Les niveaux sont séparés dans la hiérarchie par "|". Elles peuvent être utilisées directement par un classificateur <i>Hierarchy</i>, sans passer par le fichier de hiérarchie. Cependant, les entrées seront ordonnées dans ce cas alphabétiquement, et non dans l'ordre défini dans le fichier.</p> 49 49 50 50 description21=<p>Le fichier de hiérarchie <a href="_httpcollection_/etc/dls.AZList.txt" target="text">dls.AZList.txt</a> utilisé par le classificateur de titres obéit à une structure similaire. Normalement, un feuilletage des titres devrait utiliser un classificateur de <i>List</i> (ou de <i>AZList</i>). Dans ce cas, nous voulons prédéfinir les regroupements A-Z et inclure une entrée séparée pour les périodiques, comme cela se voit <a href="?a=d&cl=CL2.7">ici</a>.</p>
Note:
See TracChangeset
for help on using the changeset viewer.
