Index: documented-examples/trunk/dls-e/etc/collectionConfig.xml
===================================================================
--- documented-examples/trunk/dls-e/etc/collectionConfig.xml	(revision 36290)
+++ documented-examples/trunk/dls-e/etc/collectionConfig.xml	(revision 36290)
@@ -0,0 +1,281 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CollectionConfig xmlns:gsf="http://www.greenstone.org/greenstone3/schema/ConfigFormat" xmlns:gslib="http://www.greenstone.org/skinning" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+	<metadataList>
+		<metadata lang="en" name="creator">greenstone@cs.waikato.ac.nz</metadata>
+		<metadata lang="en" name="maintainer"/>
+		<metadata lang="en" name="public">true</metadata>
+	</metadataList>
+	<displayItemList>
+		<displayItem assigned="true" dictionary="collectionConfig" key="name" name="name"/>
+		<displayItem assigned="true" lang="en" name="name">Development Library Subset collection</displayItem>
+		<displayItem assigned="true" dictionary="collectionConfig" key="shortDescription" name="shortDescription"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description0" name="description0"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description1" name="description1"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description2" name="description2"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description3" name="description3"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description4" name="description4"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description5" name="description5"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description6" name="description6"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description7" name="description7"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description8" name="description8"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description9" name="description9"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description10" name="description10"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description11" name="description11"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description12" name="description12"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description13" name="description13"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description14" name="description14"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description15" name="description15"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description16" name="description16"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description17" name="description17"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description18" name="description18"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description19" name="description19"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description20" name="description20"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key="description21" name="description21"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key=".section_Title" name=".section_Title"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key=".section_text" name=".section_text"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key=".document_text" name=".document_text"/>
+		<displayItem assigned="true" dictionary="collectionConfig" key=".document" name=".document"/>
+	</displayItemList>
+	<format/>
+	<search type="mg">
+		<index name="section:text">
+			<displayItem lang="es" name="name">section:text</displayItem>
+			<displayItem lang="fr" name="name">section:text</displayItem>
+			<displayItem lang="ru" name="name">section:text</displayItem>
+			<displayItem lang="en" name="name">section:text</displayItem>
+			<displayItem lang="zh" name="name">section:text</displayItem>
+		</index>
+		<index name="section:Title">
+			<displayItem lang="es" name="name">section:Title</displayItem>
+			<displayItem lang="fr" name="name">section:Title</displayItem>
+			<displayItem lang="ru" name="name">section:Title</displayItem>
+			<displayItem lang="en" name="name">section:Title</displayItem>
+			<displayItem lang="zh" name="name">section:Title</displayItem>
+		</index>
+		<index name="document:text">
+			<displayItem lang="es" name="name">document:text</displayItem>
+			<displayItem lang="fr" name="name">document:text</displayItem>
+			<displayItem lang="ru" name="name">document:text</displayItem>
+			<displayItem lang="en" name="name">document:text</displayItem>
+			<displayItem lang="zh" name="name">document:text</displayItem>
+		</index>
+		<defaultIndex name="section:text"/>
+		<indexOption name="casefold"/>
+		<indexOption name="stem"/>
+		<searchType name="plain"/>
+		<searchType name="simpleform"/>
+		<searchType name="advancedform"/>
+		<format>
+			<gsf:template match="documentNode">
+				<gsf:format-gs2><![CDATA[<td valign=top>[link][icon][/link]</td> <td>{If}{[parent(All': '):Title], [parent(All': '):Title]:} [link][Title][/link]</td>]]></gsf:format-gs2>
+				<td valign="top">
+					<gsf:link type="document">
+						<gsf:icon type="document"/>
+					</gsf:link>
+				</td>
+				<td>
+					<gsf:switch>
+						<gsf:metadata name="Title"/>
+						<gsf:when test="exists"><gsf:metadata name="Title"/>:</gsf:when>
+					</gsf:switch>
+					<gsf:link type="document">
+						<gsf:metadata name="Title"/>
+					</gsf:link>
+				</td>
+			</gsf:template>
+		</format>
+	</search>
+	<infodb type="gdbm"/>
+	<import>
+		<pluginList>
+			<plugin name="HTMLPlugin">
+				<option name="-input_encoding" value="iso_8859_1"/>
+				<option name="-description_tags"/>
+				<option name="-OIDtype" value="dirname"/>
+			</plugin>
+			<plugin name="GreenstoneXMLPlugin"/>
+			<plugin name="MetadataXMLPlugin"/>
+			<plugin name="ArchivesInfPlugin"/>
+			<plugin name="DirectoryPlugin"/>
+		</pluginList>
+	</import>
+	<browse>
+		<classifier name="Hierarchy">
+			<option name="-metadata" value="dls.Subject"/>
+			<option name="-buttonname" value="Subject"/>
+			<option name="-hfile" value="dls.Subject.txt"/>
+			<option name="-sort" value="dls.Title"/>
+		</classifier>
+		<classifier name="Hierarchy">
+			<option name="-metadata" value="dls.AZList"/>
+			<option name="-buttonname" value="Title"/>
+			<option name="-hfile" value="dls.AZList.txt"/>
+			<option name="-hlist_at_top"/>
+			<option name="-sort" value="dls.Title"/>
+		</classifier>
+		<classifier name="List">
+			<option name="-metadata" value="dls.Organization"/>
+			<option name="-sort_leaf_nodes_using" value="dls.Title"/>
+			<option name="-buttonname" value="Organization"/>
+			<option name="-partition_type_within_level" value="constant_size"/>
+			<option name="-bookshelf_type" value="always"/>
+		</classifier>
+		<classifier name="List">
+			<option name="-metadata" value="dls.Keyword"/>
+			<option name="-buttonname" value="Howto"/>
+			<option name="-bookshelf_type" value="never"/>
+			<option name="-partition_type_within_level" value="constant_size"/>
+			<format>
+			<gsf:template match="documentNode">
+				<gsf:format-gs2><![CDATA[<td valign=top>[link][dls.Keyword][/link]</td>]]></gsf:format-gs2>
+				<td valign="top">
+					<gsf:link type="document">
+						<gsf:metadata name="dls.Keyword"/>
+					</gsf:link>
+				</td>
+			</gsf:template>
+			<gsf:template match="classifierNode">
+				<gsf:format-gs2><![CDATA[<td valign=top>[link][dls.Keyword][/link]</td>]]></gsf:format-gs2>
+				<td valign="top">
+					<gsf:link type="classifier">
+						<gsf:metadata name="dls.Keyword"/>
+					</gsf:link>
+				</td>
+			</gsf:template>
+		</format>
+		</classifier>
+		<format>
+			<gsf:template match="documentNode">
+				<gsf:format-gs2><![CDATA[<td valign=top>[link][icon][/link]</td> <td valign=top>[highlight]{Or}{[dls.Title],[Title],Untitled}[/highlight] <i><small>{If}{[Date],<br>_textdate_[Date]}{If}{[NumPages], <br>_textnumpages_[NumPages]}{If}{[Source],<br>_textsource_[Source]}</small></i> </td>]]></gsf:format-gs2>
+				<td valign="top">
+					<gsf:link type="document">
+						<gsf:icon type="document"/>
+					</gsf:link>
+				</td>
+				<td valign="top">
+					<span class="highlight">
+						<gsf:choose-metadata><gsf:metadata name="dls.Title"/><gsf:metadata name="Title"/>Untitled</gsf:choose-metadata>
+					</span>
+					<i>
+						<small>
+							<gsf:switch>
+								<gsf:metadata name="Date"/>
+								<gsf:when test="exists"><br/>_textdate_<gsf:metadata name="Date"/></gsf:when>
+							</gsf:switch>
+							<gsf:switch>
+								<gsf:metadata name="NumPages"/>
+								<gsf:when test="exists"><br/>_textnumpages_<gsf:metadata name="NumPages"/></gsf:when>
+							</gsf:switch>
+							<gsf:switch>
+								<gsf:metadata name="Source"/>
+								<gsf:when test="exists"><br/>_textsource_<gsf:metadata name="Source"/></gsf:when>
+							</gsf:switch>
+						</small>
+					</i>
+				</td>
+			</gsf:template>
+			<gsf:template match="classifierNode">
+				<gsf:format-gs2><![CDATA[<td valign=top>[link][icon][/link]</td> <td valign=top>[highlight]{Or}{[dls.Title],[Title],Untitled}[/highlight] <i><small>{If}{[Date],<br>_textdate_[Date]}{If}{[NumPages], <br>_textnumpages_[NumPages]}{If}{[Source],<br>_textsource_[Source]}</small></i> </td>]]></gsf:format-gs2>
+				<td valign="top">
+					<gsf:link type="classifier">
+						<gsf:icon type="classifier"/>
+					</gsf:link>
+				</td>
+				<td valign="top">
+					<span class="highlight">
+						<gsf:choose-metadata><gsf:metadata name="dls.Title"/><gsf:metadata name="Title"/>Untitled</gsf:choose-metadata>
+					</span>
+					<i>
+						<small>
+							<gsf:switch>
+								<gsf:metadata name="Date"/>
+								<gsf:when test="exists"><br/>_textdate_<gsf:metadata name="Date"/></gsf:when>
+							</gsf:switch>
+							<gsf:switch>
+								<gsf:metadata name="NumPages"/>
+								<gsf:when test="exists"><br/>_textnumpages_<gsf:metadata name="NumPages"/></gsf:when>
+							</gsf:switch>
+							<gsf:switch>
+								<gsf:metadata name="Source"/>
+								<gsf:when test="exists"><br/>_textsource_<gsf:metadata name="Source"/></gsf:when>
+							</gsf:switch>
+						</small>
+					</i>
+				</td>
+			</gsf:template>
+			<gsf:template match="classifierNode" mode="horizontal">
+				<gsf:format-gs2><![CDATA[[link][highlight][ex.Title][/highlight][/link]]]></gsf:format-gs2>
+				<gsf:link type="classifier">
+					<span class="highlight">
+						<gsf:metadata name="Title"/>
+					</span>
+				</gsf:link>
+			</gsf:template>
+		</format>
+	</browse>
+	<display>
+		<format>
+			<gsf:option name="TOC" value="true"/>
+			<gsf:option name="AllowUserComments" value="false"/>
+<!--
+Overwriting this template allows you to change the heading of the document.
+-->
+<!--
+<gsf:template name="documentHeading"><span style="font-weight:bold; font-size: 120%;"><xsl:call-template name="choose-title"/></span></gsf:template>
+-->
+<!--
+Overwriting this template can be used to redefine the content of the whole document.This is useful for simple documents, but not recommended for more complex documents(e.g. hierachical and paged documents) as it can prevent any sub-sections from showing.
+-->
+<!--
+<gsf:template name="documentContent"><div id="gs-document"><xsl:call-template name="documentPre"/><xsl:call-template name="wrappedSectionImage"/><div id="gs-document-text"><xsl:call-template name="documentNodeText"/></div></gsf:template>
+-->
+<!--
+Overwriting this template can be used to change the content of section headings.
+-->
+<!--
+<gsf:template name="sectionHeading"><xsl:call-template name="choose-title"/></gsf:template>
+-->
+<!--
+Overwriting this template can be used to change the content of the top-level section.
+-->
+<!--
+<gsf:template name="topLevelSectionContent"><xsl:call-template name="wrappedSectionImage"/><xsl:call-template name="wrappedSectionText"/></gsf:template>
+-->
+<!--
+Overwriting this template can be used to change the content of sections.
+-->
+<!--
+<gsf:template name="sectionContent"><xsl:call-template name="wrappedSectionImage"/><xsl:call-template name="wrappedSectionText"/></gsf:template>
+-->
+		</format>
+	</display>
+	<replaceListRef id="gs2-standard"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="name" name="name"/>
+	<displayItem assigned="true" lang="en" name="name">Development Library Subset collection</displayItem>
+	<displayItem assigned="true" dictionary="collectionConfig" key="shortDescription" name="shortDescription"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description1" name="description1"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description2" name="description2"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description3" name="description3"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description1" name="description4"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description2" name="description5"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description3" name="description6"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description1" name="description7"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description2" name="description8"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description3" name="description9"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description3" name="description10"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description1" name="description11"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description2" name="description12"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description3" name="description13"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description1" name="description14"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description2" name="description15"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description3" name="description16"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description1" name="description17"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description2" name="description18"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description3" name="description19"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description3" name="description20"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key="description1" name="description21"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key=".section:Title" name=".section:Title"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key=".section:text" name=".section:text"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key=".document:text" name=".document:text"/>
+	<displayItem assigned="true" dictionary="collectionConfig" key=".document" name=".document"/>
+</CollectionConfig>
Index: documented-examples/trunk/dls-e/resources/collectionConfig.properties
===================================================================
--- documented-examples/trunk/dls-e/resources/collectionConfig.properties	(revision 36290)
+++ documented-examples/trunk/dls-e/resources/collectionConfig.properties	(revision 36290)
@@ -0,0 +1,51 @@
+name=Development Library Subset collection
+.section_Title=section titles
+.section_text=chapters
+.document_text=entire documents
+.document=_textdocument_
+		
+shortDescription=<p>The Humanitarian Development Libraries represent a large collection of practical information aimed at helping reduce poverty, increasing human potential, and providing a practical and useful education for all. This subset contains about 25 publications--documents, reports, and periodical articles--in various areas of human development, from agricultural practice to economic policies, from water and sanitation to society and culture, from education to manufacturing, from disaster mitigation to micro-enterprises.</p>
+
+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:humanity@humaninfo.org>humanity@humaninfo.org</a>.
+
+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="?c=documented-examples/wrdpdf-e&a=p&sa=about">Word and PDF demonstration</a>, or the <a href="?c=documented-examples/gsarch-e&a=p&sa=about">Greenstone Archives</a>, or the <a href="?c=documented-examples/image-e&a=p&sa=about">Simple Image collection</a>).</p>
+
+description2=<p>The <a href="_httpcollection_/etc/collect.cfg" target="collect.cfg">collection configuration file</a>, like all collection configuration files, begins with a line ("creator") that gives the email address of the collection's creator, and another ("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 (a=p&sa=about&c=coll-shortname).</p>
+
+description3=<p><b>Plugins</b>. The "plugin" lines in the <a href="_httpcollection_/etc/collect.cfg" target="collect.cfg">configuration file</a> 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>
+
+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>
+
+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 <a href="?a=q">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 <i>collectionmeta</i> statements.</p>
+
+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>
+
+description7=<p><b>Classifiers</b>. The block of lines labeled <i>classify</i> define the browsing indexes, called "classifiers" in Greenstone. There are four of them, corresponding to four buttons on the navigation bar at the top of each page in the collection (e.g. the <a href="?a=q">search page</a>): <i>subjects</i>, <i>titles</i>, <i>organisations</i>, and <i>howto</i> The <i>search</i> button comes first, then come the four classifiers, in order.</p>
+
+description8=<p>The first classifier provides access by subject. It is a <i>Hierarchy</i> classifier whose hierarchy is defined in the file <a href="_httpcollection_/etc/dls.Subject.txt" target="text">dls.Subject.txt</a> (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 <a href="?a=d&cl=CL1.4.1">here</a>).  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 <a href="_httpcollection_/etc/dls.Title.txt" target="text">dls.AZList.txt</a>. 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>
+
+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>
+
+description10=<p><b>Format statements</b>. The lines beginning with <i>format</i>, 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>
+
+description11=<p>The <i>DocumentText</i> statement governs how the document text is formatted, with <i>Title</i> metadata ([<i>Title</i>]) in HTML &lt;<i>h3</i>&gt; format followed by the text of the document [<i>Text</i>]. Setting the <i>DocumentImages</i> format statement to <i>true</i> ensures that cover images are shown with each document. The <i>DocumentButtons</i> statement calls for the <i>Expand Text, Expand Contents, Detach</i> and <i>Highlight</i> buttons to be shown with each document.</p>
+
+description12=<p>Most format statements contain a string specified in an augmented form of HTML. Metadata names in square brackets (e.g. [<i>Title</i>], [<i>Creator</i>]) give the value of that metadata; [<i>Text</i>] gives the document text. A hyperlink to the document can be made using [<i>link</i>] ...[<i>/link</i>]; an appropriate icon is produced by [<i>icon</i>]. Format strings can include {<i>If</i>}{... , ...} and {<i>Or</i>}{... , ...}; the first two give examples. These two are fairly complex format statements; we will not explain them here. In Greenstone, changes in format strings take effect immediately unless you are using the local library server, in which case the server needs to be restarted. This makes it easy to experiment with different versions of a format statement and see what happens.</p>
+
+description13=<p><b>Collection-level metadata</b>. The <i>collectionmeta</i> lines 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 (in <i>collectionextra</i>) can be seen on the DLS collection's home page (this text is part of it).</p>
+
+description14=<p><b>Language translations</b>. The last part of the <a href="_httpcollection_/etc/collect.cfg" target="collect.cfg">collection configuration file</a> gives the collection-level metadata in French and Spanish respectively. The languages are indicated by square brackets: [<i>fr</i>] and [<i>es</i>]. If there is no language specification, English is assumed by default. The configuration file shows accented characters (e.g. French <i>Ã©</i>). This file is in UTF-8, and these characters are represented by multi-byte sequences (&lt;C3&gt;&lt;A9&gt; in this case). Alternatively they could be represented by their HTML entity names (like <i>&amp;eacute</i>). It makes no difference: they look the same on the screen. However, if the text were <i>searchable</i> it would make a difference; Greenstone uses Unicode internally to ensure that searching works as expected for non-English languages.</p>
+
+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> &lt;!-- &lt;Section&gt; &lt;Description&gt; &lt;Metadata name="Title"&gt; Realizing human rights for poor people: Strategies for achieving the international development targets &lt;/Metadata&gt; &lt;/Description&gt; --&gt; (text of section goes here) &lt;!-- &lt;/Section&gt; --> </pre> The &lt;!-- ... --&gt; 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 &lt;!-- ... --&gt markers) can be used in Word documents too.</p>
+
+description16=<p><b>Metadata Files</b>. Metadata for all documents in the DLS collection is provided in metadata.xml files, one per document folder. The <a href="_httpcollection_/import/r0087e/metadata.xml" target="text">metadata.xml</a> file for one book -- <i>Income generation and money management: training women as entrepreneurs</i> -- is a block of about ten lines encased in &lt;<i>FileSet</i>&gt; ... &lt;<i>/FileSet</i>&gt; 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>
+
+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>
+
+description18=<p>For example, the following shows three lines from the subject hierarchy file <a href="_httpcollection_/etc/dls.Subject.txt" target="text">dls.Subject.txt</a>.  <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>
+
+description19=<p>These three lines define one top level bookshelf (at position 7), titled "Animal Husbandry and Animal Product Processing", with two bookshelves underneath it, titled "Cattle" and "Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)" respectively.</p>
+
+description20=<p>In this case, the first strings (and therefore the entries in metadata.xml files) contain the entire hierarchy values. Levels in the hierarchy are separated by "|". They could be used directly by a <i>Hierarchy</i> classifier without the use of the hierarchy file. However, then the entries would be ordered alphabetically, not in the special order defined by the file.</p>
+
+description21=<p>The <a href="_httpcollection_/etc/dls.AZList.txt" target="text">dls.AZList.txt</a> hierarchy file used by the titles classifier contains a similar structure. Ordinarily, a titles browser would use a <i>List</i> (or <i>AZList</i>) classifier. In this case, we want to predefine the A-Z groupings, and include a separate entry for periodicals, as can be seen <a href="?a=d&cl=CL2.7">here</a>.</p>
Index: documented-examples/trunk/dls-e/resources/collectionConfig_es.properties
===================================================================
--- documented-examples/trunk/dls-e/resources/collectionConfig_es.properties	(revision 36290)
+++ documented-examples/trunk/dls-e/resources/collectionConfig_es.properties	(revision 36290)
@@ -0,0 +1,50 @@
+name=Subconjunto de la Biblioteca para el Desarrollo
+.section_Title=tÃ­tulos de las secciones
+.section_text=capÃ­tulos
+.document_text=documentos completos
+
+shortDescription=<p>Las Bibliotecas sobre Desarrollo Humanitario representan una extensa colecciÃ³n de informaciÃ³n prÃ¡ctica cuyo propÃ³sito es ayudar a reducir la pobreza, acrecentar el potencial humano y proveer una educaciÃ³n prÃ¡ctica y Ãºtil para todos. Este subconjunto comprende unas 25 publicaciones - documentos, informes tÃ©cnicos y artÃ­culos de publicaciones periÃ³dicas - en varias Ã¡reas del desarrollo humano, desde prÃ¡cticas agrÃ­colas a polÃ­ticas econÃ³micas, desde agua y saneamiento a sociedad y cultura, desde educaciÃ³n a manufactura, desde mitigaciÃ³n de desastres a microemprendimientos.</p>
+
+description0=<p>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 <a href=mailto:humanity@humaninfo.org>humanity@humaninfo.org</a>.</p>
+
+description1=<h3>CÃ³mo trabaja esta colecciÃ³n</h3><p>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 <a href="?c=documented-examples/wrdpdf-e&a=p&sa=about">DemostraciÃ³n en Word y PDF</a>, los <a href="?c=documented-examples/gsarch-e&a=p&sa=about">Archivos Greenstone</a> o la <a href="?c=documented-examples/image-e&a=p&sa=about">colecciÃ³n sencilla de imÃ¡genes</a>).</p>
+
+description2=<p>Al igual que todos los archivos de configuraciÃ³n de colecciones, el <a href="_httpcollection_/etc/collect.cfg" target="collect.cfg">archivo de configuraciÃ³n de esta colecciÃ³n</a>, 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).</p>
+
+description3=<p><b>Plugins</b>. Las lÃ­neas "plugin" en el <a href="_httpcollection_/etc/collect.cfg" target="collect.cfg">archivo de configuraciÃ³n</a> 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 <i>HTMLPlugin</i>. La opciÃ³n <i>description_tags</i> procesa las etiquetas en el texto que definen secciones y tÃ­tulos de secciones tal como se describe a continuaciÃ³n.</p>
+
+description4=<p>Los otros plugins, GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin, y DirectoryPlugin, son empleados por Greenstone con fines particulares y son estÃ¡ndar en casi todas las colecciones.</p>
+
+description5=<p><b>Ãndices de bÃºsqueda</b>. El bloque de lÃ­neas que empieza con <i>indexes</i> 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 <a href="?a=q">pÃ¡gina de bÃºsqueda</a>. 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 <i>collectionmeta</i>.</p>
+
+description6=<p>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 <i>indexes</i> que se encuentra al principio de este bloque. Esta especifica tres Ã­ndices, dos a nivel de secciÃ³n (los cuales empiezan con <i>section:</i>) y uno a nivel de documento (el cual empieza con <i>document:</i>). 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 <i>section:text</i> y <i>document:text</i>, donde <i>:text</i> significa que se buscarÃ¡ en todo el texto de la secciÃ³n o el documento, respectivamente. El segundo es <i>section:Title</i>, el cual indica que se buscarÃ¡n metadatos de <i>TÃ­tulo</i>, 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 <i>Ã­ndices</i>.</p>
+
+description7=<p><b>Clasificadores</b>. El bloque de lÃ­neas con la etiqueta <i>classifiers</i> 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 <a href="?a=q">pÃ¡gina de bÃºsqueda</a>): <i>temas, tÃ­tulos, organizaciÃ³n</i> y <i>cÃ³mo</i>. El botÃ³n de <i>bÃºsqueda</i> aparece primero y a continuaciÃ³n los cuatro clasificadores en orden.</p>
+
+description8=<p>El primer clasificador le da acceso al asunto. Es un clasificador <i>Hierarchy</i>, el cual se define en el archivo <a href="_httpcollection_/etc/dls.Subject.txt" target="text">dls.Subject.txt</a> (el argumento <i>hfile</i>); este archivo se describe mÃ¡s adelante. El clasificador se basa en el metadato <i>dls.Subject</i> y cuando varios libros aparecen en una hoja de la jerarquÃ­a se ordenan por medio del metadato <i>dls.Title</i> (como se puede ver <a href="?a=d&cl=CL1.4.1">aquÃ­</a>).  El segundo clasificador provee acceso por tÃ­tulo. Es un clasificador <i>Hierarchy</i> tambiÃ©n, pero esta vez basado en el metadato <i>dls.AZList</i>, cuya jerarquÃ­a estÃ¡ definida en <a href="_httpcollection_/etc/dls.Title.txt" target="text">dls.AZList.txt</a>. Este archivo se describe abajo.  El tercero le da acceso a la organizaciÃ³n. Es un clasificador <i>List</i> basado en el metadato <i>dls.Organization</i>. La opciÃ³n <i>-bookshelf_type always</i> 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 <i>List</i> basado en el metadato <i>dls.Keyword</i>. La opciÃ³n <i>-bookshelf_type never</i> previene la creaciÃ³n del estante aÃºn cuando dos documentos compartan las mismas keywords.</p>
+
+description9=<p><p> <b>ImÃ¡genes de Portada</b>. Greenstone busca una imagen de portada para cada documento cuyo nombre sea igual al documento pero con una extensiÃ³n <i>.jpg</i>. 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.   <b>Enunciados de formato</b>. La lÃ­neas que comienzan con <i>format</i>, 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 <i>VList</i> 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 <i>SearchVList</i>, y tambiÃ©n para el clasificador <i>Howto</i> a travÃ©s de la sentencia <i>CL4VList</i> (CL4 especifica el cuarto clasificador).</p>
+
+description10=<p>La sentencia <i>DocumentText</i> determina el modo en el que se formatea el texto, con el metadato <i>Title</i> ([<i>Title</i>]) en formato HTML &lt;<i>h3</i>&gt; seguido por el texto del documento [<i>Text</i>]. Configurando la sentencia <i>DocumentImages</i> como <i>true</i> aseguramos que las imÃ¡genes de portada se visualicen en cada documento. <i>DocumentButtons</i> indica cuales botones se muestran en cada documento. Las opciones son: <i>ExpandText, Expand Contents, Detach</i> y <i>Highlight</i>.</p>
+
+description11=<p>La mayorÃ­a de las cadenas de formateo contienen cÃ³digo HTML. Los nombres de los metadatos entre corchetes (p. ej. [<i>Title</i>], [<i>Creator</i>]) dan el valor de dicho metadato. [<i>Text</i>] 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 [<i>icon</i>]. Las cadenas de formato pueden incluir {<i>If</i>}{... , ...} y {<i>Or</i>}{... , ...}. 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.</p>
+
+description12=<p><b>Metadatos a nivel de colecciÃ³n</b>. Las lÃ­neas de <i>collectionmeta</i> 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 <i>collectionextra</i>) se puede ver en la pÃ¡gina inicial de la colecciÃ³n DLS (este texto es parte de Ã©l).</p>
+
+description13=<p><b>TraducciÃ³n de idioma</b>. La Ãºltima parte del <a href="_httpcollection_/etc/collect.cfg" target="collect.cfg">archivo de configuraciÃ³n de la colecciÃ³n</a> proporciona los metadatos a nivel de colecciÃ³n en francÃ©s y espaÃ±ol, respectivamente. Estos idiomas se indican por medio de corchetes: [<i>fr</i>] y [<i>es</i>]. 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. <i>Ã©</i> francesa). Este archivo estÃ¡ en UTF-8 y los caracteres se representan por medio de secuencias de varios bytes (&lt;C3&gt;&lt;A9&gt; en este caso). De forma alternativa se pueden representar por medio de nombres de entidades HTML (como <i>&eacute</i>). 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.</p>
+
+description14=<p><b>Etiquetas de descripciÃ³n</b>. Las etiquetas de descripciÃ³n reconocidas por <i>HTMLPlugin</i> 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:<pre> &lt;!-- &lt;Section&gt; &lt;Description&gt; &lt;Metadata name="Title"&gt; Haciendo realidad los derechos humanos para la gente pobre: Estrategias para lograr los objetivos de desarrollo mundial &lt;/Metadata&gt; &lt;/Description&gt; --&gt; (el texto de la secciÃ³n va aquÃ­) &lt;!-- &lt;/Section&gt; --> </pre></p>
+
+description15=<p>Los marcadores &lt;!-- ... --> 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 <i>Description</i> 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 &lt;!-- ... -->) se puede usar tambiÃ©n en los documentos Word.</p>
+
+description16=<p><b>Archivos de metadatos</b>. Los metadatos para todos los documentos de la colecciÃ³n DLS se asignan en archivos llamados metadata.xml, un documento por carpeta. El documento <a href="_httpcollection_/import/r0087e/metadata.xml" target="text">metadata.xml</a> para el libro--<i>Income generation and money management: training women as entrepreneurs</i> -- es un bloque de alrededor diez lineas encerradas en las etiquetas &lt;<i>FileSet</i>&gt; ... &lt;<i>/FileSet</i>&gt;. El cual define los metadatos <i>dls.Title, dls.Language, dls.Subject</i> y <i>dls.AZList</i>. 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 <i>mode=accumulate</i>; la alternativa y el valor por omisiÃ³n es <i>mode=override</i>).</p>
+
+description17=<p><b>Archivos de jerarquÃ­a</b>. 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 <i>metadata.xml</i> 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.</p>
+
+description18=<p>Por ejemplo, las siguientes tres lÃ­neas pertenecen al archivo de jerarquia <a href="_httpcollection_/etc/dls.Subject.txt" target="text">dls.Subject.txt</a>.  <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>
+
+description19=<p>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.</p>
+
+description20=<p>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 <i>Hierarchy</i> 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.</p>
+
+description21=<p>El archivo de jerarquÃ­a <a href="_httpcollection_/etc/dls.AZList.txt" target="text">dls.AZList.txt</a> usado por el clasificador por tÃ­tulos contiene una estructura similar. Ordinariamente, un navegador por tÃ­tulos usarÃ­a un clasificador <i>List</i> (o <i>AZList</i>). En este caso, queremos predefinir el agrupamiento A-Z, e incluye una entrada separada para periÃ³dicos, como puede verse <a href="?a=d&cl=CL2.7">aquÃ­</a>.</p>
Index: documented-examples/trunk/dls-e/resources/collectionConfig_fr.properties
===================================================================
--- documented-examples/trunk/dls-e/resources/collectionConfig_fr.properties	(revision 36290)
+++ documented-examples/trunk/dls-e/resources/collectionConfig_fr.properties	(revision 36290)
@@ -0,0 +1,50 @@
+name=Sous-ensemble de la collection BibliothÃšque de DÃ©veloppement
+.section_Title=titres des sections
+.section_text=chapitres
+.document_text=documents entiers
+		
+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>
+
+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:humanity@humaninfo.org>humanity@humaninfo.org</a>.</p>
+
+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>
+
+description2=<p>Le <a href="_httpcollection_/etc/collect.cfg" target="collect.cfg">fichier de configuration</a> 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>
+
+description3=<p><b>Plugins</b>. Le troisiÃšme bloc de lignes dans le <a href="_httpcollection_/etc/collect.cfg" target="collect.cfg">fichier de configuration</a> 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>
+
+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>
+
+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>
+
+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>
+
+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>
+
+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>
+
+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>
+
+description10=<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>
+
+description11=<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 &lt;<i>h3</i>&gt; 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>
+
+description12=<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>
+
+description13=<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>
+
+description14=<p><b>Traduction de langues</b>. La derniÃšre partie du <a href="_httpcollection_/etc/collect.cfg" target="collect.cfg">fichier de configuration de la collection</a> 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 (&lt;C3&gt;&lt;A9&gt) dans ce cas). Autrement, elles pourraient Ãªtre reprÃ©sentÃ©es par leurs noms d'entitÃ© (comme <i>&amp;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>
+
+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> &lt;!-- &lt;Section&gt; &lt;Description&gt; &lt;Metadata name="Title"&gt; Realizing human rights for poor people: Strategies for achieving the international development targets &lt;/Metadata&gt; &lt;/Description&gt; --&gt; (text of section goes here) &lt;!-- &lt;/Section&gt; --> </pre> Les marqueurs &lt;!-- ... --&gt; 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 &lt;!-- ... --&gt;) peut Ãªtre utilisÃ©e de faÃ§on tout Ã  fait identique dans les documents Word.</p>
+
+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 &lt;<i>FileSet</i>&gt; ... &lt;<i>/FileSet</i>&gt;. 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>
+
+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>
+
+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>
+
+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>
+
+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>
+
+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>
Index: documented-examples/trunk/dls-e/resources/collectionConfig_zh.properties
===================================================================
--- documented-examples/trunk/dls-e/resources/collectionConfig_zh.properties	(revision 36290)
+++ documented-examples/trunk/dls-e/resources/collectionConfig_zh.properties	(revision 36290)
@@ -0,0 +1,119 @@
+name=åå±åŸä¹ŠéŠå­éŠè
+.section_Title=èæ é¢
+.section_text=ç« 
+.document_text=æŽäžªææ¡£
+
+		
+shortDescription=<p>äººç±»åå±åŸä¹ŠéŠæ¯äžäžªæå€§éå®çšä¿¡æ¯çå€§åéŠèïŒæšåšåž®å©åå°èŽ«å°ïŒæåäººç±»æœèœïŒä»¥åäžºæä»¥äººæäŸäžäžªå®é
+äžæçšçæè²ã è¿äžªå­éå
+å«25äžªåºçç©ââææ¡£ãæ¥åä»¥åå®æåè¡šçæç« ââèŠçäºäººç±»åå±çå€äžªé¢åïŒä»åäžè¡äžºå°ç»æµæ¿ç­ïŒä»æ°Žäž å«çå°ç€ŸäŒäžæåïŒä»æè²å°å¶é ïŒä»çŸéŸæ¢å€å°åŸ®è§äŒäžã</p>
+
+description0=<p>æ¬éŠèççŒèŸè
+æ¯Human Info NGOïŒHumanityCD LtdïŒä»¥ååäžçç»ç»ãæä»¬çèç³»æ¹åŒæ¯ïŒäººç±»äžåå±åŸä¹ŠéŠé¡¹ç® ïŒHumanitarian and Development Libraries ProjectïŒïŒOosterveldiaan 196ïŒB-2610 AntwerpïŒBelgiumã çµè¯ 32-3-448.05.54ïŒäŒ ç 32-3-449.75.74ïŒçµé® <a href=mailto:humanity@humaninfo.org>humanity@humaninfo.org</a>.<p>
+
+description1=<h3>æ¬éŠèåŠäœå·¥äœ</h3><p>DLSéŠèæ¯èŸå€æãåŠæäœ ååŒå§æ¥è§ŠéŠèïŒå
+¶ä»äžäºéŠèå¯èœæŽéåäœ  ïŒæ¯åŠ<a href="?c=documented-examples/wrdpdf-e&a=p&sa=about">WordäžPDFæŒç€º</a>ïŒæè
+ <a href="?c=documented-examples/gsarch-e&a=p&sa=about">Greenstoneå­æ¡£</a>ïŒæè
+ <a href="?c=documented-examples/image-e&a=p&sa=about">ç®ååŸåéŠè</a>ïŒã</p>
+
+description2=<p>æ¬éŠèç<a href="_httpcollection_/etc/collect.cfg" target="collect.cfg">é
+çœ®æä»¶</a>è·å
+¶ä»é
+çœ®æä»¶äžæ ·ïŒåŒå§æ¯ç»åºéŠèåå»ºè
+emailå°åçè¡ ïŒ"creator"ïŒïŒåŠå€äžè¡ïŒ"public"ïŒå³å®æ¯åŠåšGreenstoneäž»é¡µäžæŸç€ºæ¬éŠèã è¯·æ³šæå°"public"è®Ÿçœ®æ"false"åªäŒå°éŠèä»äž»é¡µæŸç€ºäžå é€ïŒ ä»»äœç¥éURLïŒa=p&sa=about&c=coll-shortnameïŒçäººä»å°èœè®¿é®è¯¥éŠèã</p>
+
+description3=<p><b>æä»¶</b>ã<a href="_httpcollection_/etc/collect.cfg" target="collect.cfg">é
+çœ®æä»¶</a>äž­ç"plugin"ïŒæä»¶ïŒè¡ç»åºäºæ¬éŠèçšå°çæä»¶ã DLSéŠèéçææ¡£æ¯HTMLïŒæä»¥<i>HTMLPlugin</i>ïŒHTML æä»¶ïŒå¿
+é¡»å
+æ¬åšå
+ã<i>description_tags</i>éé¡¹å€çææ¬äž­å®ä¹ç« èäžç« èæ é¢çæ ç­ŸïŒåŠäžæè¿°ã</p>
+
+description4=<p>åŠå€çæä»¶ïŒ<i>GreenstoneXMLPluginãMetadataXMLPluginãArchivesInfPluginäžDirectoryPlugin</i>ïŒ åšGreenstoneäž­è¢«çšäºå
+éšå€çïŒå¹¶äžåšå ä¹ææéŠèäž­éœæ¯æ åæä»¶ã</p>
+
+description5=<p><b>å¯æ£çŽ¢ççŽ¢åŒ</b>ãè¿äžæ®µå§äº<i>indexes</i>é
+çœ®ïŒè¿äžè¡æå®äºå¯æ£çŽ¢ççŽ¢åŒãåšæ¬éŠèäž­æäžäžªå¯æ£çŽ¢ççŽ¢åŒïŒ äœ å¯åš<a href="?a=q">æçŽ¢é¡µé¢</a>äž­æåŒâæçŽ¢âäžæåè¡šèåæ¶çå°ã ç¬¬äžäžªçŽ¢åŒç§°äžº"ç« "ïŒç¬¬äºäžª"èæ é¢"ïŒç¬¬äžäžªæ¯"æŽäžªææ¡£"ãè¿äžäžªçŽ¢åŒçåå­ç±äžäžª <i>collectionmeta</i>å®ä¹ã</p>
+
+description6=<p>çŽ¢åŒçå
+å®¹ââå³å¯¹å¯æ£çŽ¢å
+å®¹çæå®ââæ¯ç±è¿æ®µæåŒå§ç<i>indexes</i>ïŒçŽ¢åŒïŒè¡å®ä¹çã è¿è¡å®ä¹äºäžäžªçŽ¢åŒïŒäž€äžªåšèçº§ïŒä»¥<i>section:</i>åŒå§ïŒïŒåŠäžäžªåšææ¡£çº§ïŒä»¥ <i>document:</i>åŒå§ïŒãåºå«åšäºåœæ¥è¯¢åŒæå€äžªè¯æ¶ïŒè¥æææ¥è¯¢è¯éœåºç°åšåäžèäž­ïŒ è¿å°åªå¹é
+èçº§å«ççŽ¢åŒïŒèè¥ææè¯åºç°åšææ¡£çä»»äœéšåïŒéåžžéœç±è¥å¹²èç»æïŒïŒå°å¹é
+ äžäžªææ¡£çº§ççŽ¢åŒãç¬¬äžäžªåç¬¬äžäžªçŽ¢åŒæ¯<i>section:text</i>äž<i>document:text</i>ïŒ<i>:text</i> æå³çèäžææ¡£çå
+šæå°è¢«æçŽ¢ãç¬¬äºäžªçŽ¢åŒæ¯<i>section:Title</i>ïŒæå³ç<i>Title</i>ïŒæ é¢ïŒ å
+æ°æ®å°è¢«æ£çŽ¢ââåšè¿ç§æ
+åµäžæ£çŽ¢çæ¯èæ é¢ïŒèäžæ¯ææ¡£æ é¢ïŒãè¿äžäžªçŽ¢åŒå°æç
+§<i>indexes</i>è¡äž­å®ä¹çé¡ºåºåºç°ã</p>
+
+description7=<p><b>åç±»åš</b>ã<i>classify</i>è¡å®ä¹äºæµè§ççŽ¢åŒïŒåšGreenstoneäž­ç§°äžº"åç±»åš"ãæ¬éŠèæåäžªåç±»åšïŒ è¿äžéŠèäž­æ¯é¡µæé¡¶ç«¯æµè§æ¡äž­çåäžªæé®å¯¹åºïŒæ¯åŠïŒ<a href="?a=q">æ£çŽ¢é¡µé¢</a>ïŒïŒ <i>äž»é¢</i>ïŒ<i>æ é¢</i>ïŒ<i>ç»ç»</i>äž<i>æå</i>ã<i>æçŽ¢</i>æé®æåšæåé¢ïŒç¶åæé¡ºåºæŸç€ºè¿åäžªåç±»åšã</p>
+
+description8=<p>ç¬¬äžäžªåç±»åšæäŸæäž»é¢çè®¿é®ãè¿æ¯äžäžª<i>å±çº§</i>åç±»åšïŒ<a href="_httpcollection_/etc/dls.Subject.txt" target="text">dls.Subject.txt</a> æä»¶ïŒ<i>hfile</i>åæ°ïŒå®ä¹äºè¿äºå±çº§ïŒäžé¢å°è®šè®ºè¿äžªæä»¶ãè¿äžªåç±»åšåºäº<i>dls.Subject</i>å
+æ°æ®ïŒ èåœå€æ¬ä¹Šåºç°åšå±çº§äž­çäžäžªå¶å­èç¹äž­æ¶ïŒå®ä»¬å°æ<i>dls.Title</i>å
+æ°æ®æåºïŒæ­£åŠ<a href="?a=d&cl=CL1.4.1">è¿é</a>æç€ºïŒã  ç¬¬äºäžªåç±»åšæäŸæé¢åçè®¿é®ãè¿ä¹æ¯äžäžª<i>å±çº§</i>åç±»åšïŒæ¯åºäº<i>dls.AZList</i>å
+æ°æ®ïŒå
+¶å±çº§å®ä¹åš <a href="_httpcollection_/etc/dls.Title.txt" target="text">dls.AZList.txt</a>æä»¶äž­ãäžé¢äŒè®šè®ºè¿äžªæä»¶ã  ç¬¬äžäžªåç±»åšæäŸæç»ç»çè®¿é®ïŒå®æ¯åºäº<i>dls.Organization</i>å
+æ°æ®æå»ºç<i>List</i>åç±»åšã<i>-bookshelf_type always</i>éé¡¹ äžºæ¯äžªç»ç»åå»ºäžäžªæ°çä¹Šæ¶ïŒå³äœ¿åœåªæäžäžªææ¡£å±äºé£äžªç®åœæ¶ã  ç¬¬åäžªåç±»åšæ"æå"æäŸè®¿é®ïŒå®æ¯åºäº<i>dls.Keyword</i>å
+æ°æ®ç<i>List</i>åç±»åšã <i>-bookshelf_type never</i>éé¡¹è¡šæå³äœ¿åœäž€äžªææ¡£æ¥æåæ ·çå
+³é®è¯æ¶ïŒä¹äžäŒäžºå
+¶åå»ºä¹Šæ¶ã</p>
+
+description9=<p><b>å°é¢åŸç</b>ãGreenstoneæ£æ¥æ¯äžªææ¡£çå°é¢åŸçïŒè¯¥å°é¢åŸçäžè¯¥ææ¡£ååïŒäœæ¯æ¯<i>.jpg</i>æä»¶ç±»åãè¿äžªåŸçå°è¢«éŸæ¥å°è¯¥ææ¡£ïŒ èäžå¯åšææ¡£é¡µé¢ïŒåŠäžæç€ºïŒäž­æŸç€ºãéè¿è®Ÿçœ®æ¯äžªæä»¶ç-no_cover_imageæ è¯å¯åæ¶æŸç€ºå°é¢åŸçã</p>
+
+description10=<p><b>æ ŒåŒåé</b>ãè¿äºè¡ä»¥<i>format</i>åŒå€ŽïŒç§°äžº"æ ŒåŒåé"ïŒæ§å¶éŠèçåäžªéšååºåŠäœæŸç€ºã<i>VList</i>æ ŒåŒåéäœçšäºææç«åæŸç€ºæ¡ç® çåè¡šïŒæ¯åŠé¢ååè¡šãäž»é¢åè¡šåç»ç»åè¡šïŒä»¥åç®æ ææ¡£çå
+å®¹å€§çº²ãå¯¹äºæçŽ¢ç»æåè¡šèèšïŒè¿äžªæ ŒåŒåéè¢«<i>SearchVList</i>æ ŒåŒåéæéåïŒ åæ ·ç<i>æå</i>åç±»åšçæ ŒåŒç±<i>CL4VList</i>åééåïŒCL4æç¬¬åäžªåç±»åšïŒã</p>
+
+description11=<p><i>DocumentText</i>ïŒææ¡£ææ¬ïŒæ ŒåŒåéæ§å¶ææ¡£ææ¬çæ ŒåŒïŒå³HTMLäž­&lt;<i>h3</i>&gt;äž­ç<i>é¢å</i>å
+æ°æ®ïŒ[<i>Title</i>]ïŒïŒæ¥äžæ¥æŸç€º ææ¡£ææ¬[<i>Text</i>]ãå°<i>DocumentImages</i>æ ŒåŒåéè®Ÿäžº<i>true</i>ç¡®ä¿åšæ¯äžªææ¡£äž­éœæŸç€ºå°é¢åŸçã<i>DocumentButtons</i>åéç¡®å®åšæ¯äžªææ¡£äž­æŸç€º<i>æŸç€ºææææ¬ã æ©å±ç®åœè¡šãåšæ°çªå£æŸç€ºæ¬é¡µ</i>ä»¥å<i>çªåºæŸç€ºæ¥è¯¢é¡¹</i>æé®ã</p>
+
+description12=<p>å€æ°æ ŒåŒåéæ¬èº«å
+å«ä¿®æ¹åçHTMLä»£ç ãæ¹æ¬å·æ¬èµ·æ¥çå
+æ°æ®åïŒæ¯åŠ[<i>Title</i>]ïŒ[<i>Creator</i>]ïŒ ç»åºäºè¯¥å
+æ°æ®çåŒã[<i>Text</i>]ïŒææ¬ïŒä»£è¡šææ¡£ææ¬ãææ¡£çéŸæ¥å¯çš[<i>link</i>]âŠâŠ[<i>/link</i>]æå®ïŒ [<i>icon</i>]ä»£è¡šäžäžªåéçåŸæ ãæ ŒåŒå­äž²å¯å
+å«{<i>If</i>}{... , ...}äž{<i>Or</i>}{... , ...}ïŒæåé¢çäž€äžªç»åºäºç€ºäŸã è¿äž€äžªæ ŒåŒåéçžå¯¹æ¯èŸå€æïŒåšè¿éæä»¬å°±äžæŽå€è§£éäºãåšGreenstoneäž­ïŒæ ŒåŒå­äž²äž­çæŽæ¹å¯ä»¥ç«å³èµ·æïŒé€é åœåäœ¿çšçæ¯æ¬å°æå¡åšïŒèåšè¿ç§æ
+åµäžéèŠéå¯æå¡åšãè¿äœ¿åŸè°è¯æ ŒåŒåéä»¥åå®ä»¬çææååŸçžå¯¹æ¯èŸå®¹æã</p>
+
+description13=<p><b>éŠèçº§çå
+æ°æ®</b>ãé
+çœ®æä»¶äž­ç<i>collectionmeta</i>è¡åæ ·ä¹æ¯ææGreenstoneéŠèäž­çæ ååè®Ÿçœ®ãå®ä»¬ æè¿°äºéŠèçäžè¬æ§ä¿¡æ¯ïŒå®ä¹äºéŠèçåå­ïŒä»¥ååšè¯¥éŠèäž»é¡µäžæŸç€ºçæè¿°ãè¿éçæè¿°ä¿¡æ¯ïŒå®ä¹åš<i>collectionextra</i>äž­ïŒ å¯åšDLSéŠèçäž»é¡µäžçå°ïŒè¿éçææ¬æ¯å
+¶äž­çäžéšåïŒã<p></p>
+
+description14=<p><b>è¯­èšç¿»è¯</b>ã<a href="_httpcollection_/etc/collect.cfg" target="collect.cfg">éŠèé
+çœ®æä»¶</a>çæåéšå åå«ç»åºäºæ³è¯­åè¥¿ç­çè¯­çéŠèçº§å
+æ°æ®ãæ¹æ¬å·äž­çå
+å®¹æå®è¯­ç§ïŒ[<i>fr</i>]å[<i>es</i>]ãåŠææ²¡ææå®è¯­ç§ïŒ åçŒºçåè®Ÿæ¯è±è¯­ãé
+çœ®æä»¶äž­æåžŠæ²é³å­ç¬ŠïŒæ¯åŠæ³è¯­äž­ç<i>Ã©</i>ïŒãè¿äžªæä»¶æ¯UTF-8çŒç çïŒå æ­€è¿äºå­ç¬Šç± å€å­èåºåè¡šç€ºïŒè¿éæ¯&lt;C3&gt;&lt;A9&gt;ïŒãæè
+å®ä»¬å¯ç±å
+¶HTMLå®äœåç§°æè¡šç€ºïŒæ¯åŠ<i>&amp;eacute</i>ïŒã è¿äž€è
+æ²¡æä»»äœå·®å«ïŒå®ä»¬åšå±å¹äžçæŸç€ºéœæ¯äžæ ·çãç¶èïŒåŠæææ¬æ¯<i>å¯æ£çŽ¢ç</i>ïŒé£ä¹è¿æ¯æäžç¹äžåïŒ Greenstoneå
+éšäœ¿çšUnicodeæ¥ä¿è¯ææéè±è¯­è¯­èšèèšæçŽ¢åèœéœèœæ­£åžžå·¥äœã</p>
+
+description15=<p><b>æè¿°æ ç­Ÿ</b>ã<i>HTMLPlugin</i>ïŒHTMLæä»¶ïŒè¯å«çæè¿°æ ç­Ÿæ¯è¢«æå
+¥å°ææ¡£çHTMLæºææ¬äž­ïŒ çšæ¥å®ä¹æ¯èçåŒå€Žäžç»å°ŸïŒä»¥åæ¯èçæ é¢ãæ¯åŠïŒ <pre> &lt;!-- &lt;Section&gt; &lt;Description&gt; &lt;Metadata name="Title"&gt; Realizing human rights for poor people: Strategies for achieving the international development targets &lt;/Metadata&gt; &lt;/Description&gt; --&gt; (text of section goes here) &lt;!-- &lt;/Section&gt; --> </pre> &lt;!-- ... --&gt;æ è®°çšæ¥ä¿è¯è¿äºæ ç­ŸåšHTMLäž­è¢«è®€äžºæ¯æ³šéïŒå æ­€äžäŒåœ±åå°ææ¡£çæ ŒåŒã åš<i>Description</i>ïŒæè¿°ïŒéšåå¯ä»¥è®Ÿçœ®å
+¶ä»ç±»åçå
+æ°æ®ïŒäœæ¯åšæä»¬è¿éææè¿°çéŠèäž­ å¹¶æ²¡æè¿æ ·çè®Ÿçœ®ãåæ ·çïŒè¿äºè®Ÿçœ®ïŒå
+æ¬&lt;!-- ... --&gtæ ç­ŸïŒä¹å¯çšåšWordææ¡£äž­ã</p>
+
+description16=<p><b>å
+æ°æ®æä»¶</b>ãDLSéŠèäž­ææææ¡£çå
+æ°æ®éœåšmetadata.xmlæä»¶äž­ïŒæ¯äžªæä»¶å¯¹åºäºäžäžªæä»¶å€¹ã è¿äžª<a href="_httpcollection_/import/r0087e/metadata.xml" target="text">metadata.xml</a>æä»¶æ¯éå±äºè¿æ¬ä¹Š ââ<i>Income generation and money management: training women as entrepreneurs</i> ïŒåæ¶äžéé±ç®¡çïŒå°åŠå¥³è®­ç»äžºäŒäžå®¶ïŒââå
+¶&lt;<i>FileSet</i>&gt;âŠâŠ&lt;<i>/FileSet</i>&gt;æ ç­Ÿäž­æå€§æŠåè¡ã å®å®ä¹äº<i>dls.Title</i>ã<i>dls.Language</i>ã<i>dls.Subject</i>å<i>dls.AZList</i>å
+æ°æ®ãæ¯äžªå
+æ°æ®æ¡ç®å¯ä»¥æå€äžªåŒãæ¯åŠïŒè¿æ¬ä¹Š å°±æäž€äžªdls.Subjectåç±»ãè¿äž€äžªéœå°çšäœè¿äžªææ¡£çå
+æ°æ®åŒïŒå äžºè®Ÿçœ®äº<i>mode=accumulate</i>ïŒ äžä¹å¯¹ç«çæ¯<i>mode=override</i>ïŒè¿ä¹æ¯çŒºçåŒïŒã</p>
+
+description17=<p><b>å±çº§æä»¶</b>ãå±çº§æä»¶æè¥å¹²è¡ïŒæ¯è¡ç±äžäžªæ¡ç®ç»æãç¬¬äžäžªæ¡ç®æ¯å­ç¬Šäž²ïŒå®å°å¹é
+åé¢ææè¿° ç<i>metadata.xml</i> æä»¶äž­çå
+æ°æ®ãç¬¬äºäžªæ¡ç®æ¯äžäžªæ°å­ïŒå®å®ä¹äºå±çº§äž­çäœçœ®ãç¬¬äžäžªæ¡ç®æ¯å­ç¬Šäž²ïŒ å®æè¿°äºæçæççœé¡µäž­è¯¥å±çº§èç¹çäœçœ®ã</p>
+
+description18=<p>æ¯åŠïŒäžé¢æŸç€ºäºäž»é¢å±çº§æä»¶<a href="_httpcollection_/etc/dls.Subject.txt" target="text">dls.Subject.txt</a>äž­çäžè¡ã  <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>
+
+description19=<p>è¿äžè¡å®ä¹äºäžäžªé¡¶å±ä¹Šæ¶ïŒäœçœ®7ïŒïŒé¢åäžº"Animal Husbandry and Animal Product Processing"ïŒ å
+¶äžæäž€äžªä¹Šæ¶ïŒé¢ååå«äžº"Cattle"å"Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)"ã</p>
+
+description20=<p>åšè¿äž­æ
+åµäžïŒç¬¬äžäžªå­ç¬Šäž²ïŒå³metadata.xmlæä»¶äž­çæ¡ç®ïŒå
+å«äºæŽäžªå±çº§åŒãå±çº§äž­çåäžªå±æ¬¡ç±"|"åéãå®ä»¬å¯ä»¥çŽæ¥äœ¿çšäžäžª <i>Hierarchy</i>åç±»åšèäžçšå±çº§æä»¶ãç¶èïŒæ­€æ¶æææ¡ç®å°æå­ç¬Šé¡ºåºæåºïŒèäžæ¯ä»¥é£äžªæä»¶äž­å®ä¹çç¹å«é¡ºåºã</p>
+
+description21=<p>è¿äºæ é¢åç±»åšäœ¿çšç<a href="_httpcollection_/etc/dls.AZList.txt" target="text">dls.AZList.txt</a>å±çº§æä»¶æçç±»äŒŒçç»æãéåžžæ
+åµäžïŒ é¢åæµè§åšäŒäœ¿çš<i>List</i>ïŒæ<i>AZList</i>ïŒåç±»åšãåšè¿ç§æ
+åµäžïŒæä»¬é¢å
+å®ä¹Aå°Zçåç»ïŒå¹¶äžºæåäžéšè®Ÿçœ®äžäžªç¬ç«çæ¡ç®ïŒåŠ <a href="?a=d&cl=CL2.7">è¿é</a>æç€ºã </p>
Index: documented-examples/trunk/dls-e/transform/pages/about.xsl
===================================================================
--- documented-examples/trunk/dls-e/transform/pages/about.xsl	(revision 36290)
+++ documented-examples/trunk/dls-e/transform/pages/about.xsl	(revision 36290)
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet version="1.0"
+	xmlns:xsl="http://www.w3.org/1999/XSL/Transform">	
+	
+	<xsl:template name="coll-description">
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='shortDescription']"/>
+	  
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description0']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description1']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description2']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description3']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description4']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description5']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description6']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description7']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description8']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description9']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description10']"/>	  
+	  
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description11']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description12']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description13']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description14']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description15']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description16']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description17']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description18']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description19']"/>
+	  
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description20']"/>
+	  <xsl:value-of disable-output-escaping="yes" select="/page/pageResponse/collection/displayItemList/displayItem[@name='description21']"/>
+	  
+	</xsl:template>
+
+</xsl:stylesheet>  
+
