creator greenstone@cs.waikato.ac.nz maintainer greenstone@cs.waikato.ac.nz public true buildtype mgpp indexes text dls.Title,Title dls.Subject dls.Organization dls.Keyword levels section document plugin GreenstoneXMLPlugin plugin HTMLPlugin -description_tags -OIDtype dirname plugin MetadataXMLPlugin plugin ArchivesInfPlugin plugin DirectoryPlugin classify List -metadata dls.Title classify Hierarchy -metadata "dls.Subject" -sort dls.Title classify List -sort_leaf_nodes_using dls.Title -metadata dls.Organization -bookshelf_type always classify List -metadata dls.Keyword -buttonname Howto format CL4VList "[link][icon][/link][link][dls.Keyword][/link]" format SearchVList "[link][icon][/link]{If}{[parent(All\': \'):Title],[parent(All\': \'):Title]:}[link][Title][/link]" format VList "[link][icon][/link][highlight]{Or}{[Title],Untitled}[/highlight]{If}{[Date],
_textdate_[Date]}{If}{[NumPages],
_textnumpages_[NumPages]}{If}{[Source],
_textsource_[Source]}" format DocumentText "

[Title]

\\n\\n

[Text]" format DocumentImages true format DocumentButtons "Expand Text|Expand Contents|Highlight|Detach|Print" format DocumentSearchResultLinks true format HList "[link][highlight][Title][/highlight][/link]" format DocumentHeading "{Or}{[parent(Top):Title],[Title],untitled}
" format SearchTypes "plain,form" # Authentication directives authenticate document public_documents Jfb33fe Jfb34fe auth_group demo # -- English strings ---------------- collectionmeta collectionname [l=en] "Authentication demo" collectionmeta .text [l=en] "text" collectionmeta .dls.Title,Title [l=en] "titles" collectionmeta .dls.Subject [l=en] "subjects" collectionmeta .dls.Organization [l=en] "organizations" collectionmeta .dls.Keyword [l=en] "how to" collectionmeta .document [l=en] "book" collectionmeta .section [l=en] "chapter" collectionmeta depositormetadata [l=en] "{\"name\":\"dls.Title\",\"label\":\"Title\",\"tooltip\":\"dls.Title: The title of this resource.\",\"type\":\"text\"}, {\"name\":\"dls.Organization\",\"label\":\"Organization\",\"tooltip\":\"dls.Organization: The organization responsible for producing this resource.\",\"type\":\"text\"}, {\"name\":\"dls.Subject\",\"label\":\"Subject\",\"tooltip\":\"dls.Subject: The subject of this resource.\",\"type\":\"text\"}, {\"name\":\"dls.Keyword\",\"label\":\"Keyword\",\"tooltip\":\"dls.Keyword: A more specific indication of what the resource can be used for.\",\"type\":\"text\"}, {\"name\":\"dls.Language\",\"label\":\"Language\",\"tooltip\":\"dls.Language: The language of this resource.\",\"type\":\"text\"}" # -- French strings ---------------- collectionmeta collectionname [l=fr] "Démonstration d\'authentification" # -- Spanish strings ---------------- collectionmeta collectionname [l=es] "Demostración de autenticación" # -- Russian strings ---------------- collectionmeta collectionname [l=ru] "Демонстрация аутентификации" # -- Simplified Chinese strings ---------------- collectionmeta collectionname [l=zh] "认证演示馆藏" collectionmeta .text [l=zh] "文本" collectionmeta .dls.Title,Title [l=zh] "题名" collectionmeta .dls.Subject [l=zh] "主题" collectionmeta .dls.Organization [l=zh] "机构" collectionmeta .dls.Keyword [l=zh] "如何" collectionmeta .document [l=zh] "书" collectionmeta .section [l=zh] "章" # -- English text ---------------- collectionmeta collectionextra [l=en] "This demonstration collection contains the same material as the original Greenstone demo collection, but it includes some basic authentication commands. Two documents are publicly available (Farming snails 1 & 2), while the others require logging in to view.

To access this collection try user: demo and password: demo

How the collection works

\n

The collection configuration file is exactly the same as for the original demo collection apart from the authentication directives, one plugin option (and this description).

The authentication scheme controls access to the collection. It works in two steps. First it determines whether to restrict access to the collection as a whole or to individual documents in it, and in the latter case which documents those are (either by giving a list of private documents for which access is to be authenticated, or specifying that all documents are private except for a given list of public documents). Then for access-restricted documents it determines which user groups are to have access.\n

Authentication is activated by the authenticate directive with the value collection or document depending on whether authentication is to be performed on the full collection or on a per-document basis (the default value is collection). If authentication is on a document basis, then one can either specify a list of private documents (in which case all others are public) or a list of public documents (in which case all others are private) using directives private_documents or public_documents. The documents themselves are specified using Greenstone document identifiers (separated by spaces): the easiest way to determine these is to locate each document in the collection and look at the d argument in its Greenstone URL. \n

In this case, we have used the -OIDtype dirname option to HTMLPlugin, which specifies that directory names should be used as identifiers. This works for collections where each document is in a separate directory. We have used this option to ensure that identifiers remain the same across different platforms (which may not be the case for HASH identifiers), as we need to specify identifiers here for the authentication directives.\n

The auth_groups directive specifies the Greenstone groups for to which access will be permitted, if the document (or collection) is one of those that requires authentication. It is followed by a group name (or a list of group names separated by spaces). The Greenstone admin pages allow you to define groups and add members to them.\n " # -- French text ---------------- collectionmeta collectionextra [l=fr] " Cette collection de démonstration contient le même contenu que la collection de démonstration originale fournie avec Greenstone, mais elle inclue également quelques commandes d\'authentification basiques. Deux documents sont diffusés de manière publique (Farming snails 1 & 2), alors que le reste des documents requièrent une authentification afin de pouvoir les consulter.

Pour accéder à cette collection, essayez utilisateur : demo et mot de passe : demo.

Comment marche cette collection?

_text1_

Le schéma d\'authentification contrôle l\'accès à la collection. Il fonctionne en deux étapes. Dans un premier temps il détermine s\'il faut restreindre l\'accès à la collection dans son ensemble ou à des documents spécifiques qu\'elle contient, et dans ce dernier cas, de quels documents il s\'agit (soit en donnant une liste de documents privés dont l\'accès nécessite une authentification, soit en déclarant que tous les documents sont privés à l\'exeption d\'une liste de documents publics donnée). Ensuite, pour les documents à accès restreint, il détermine les utilisateurs qui y ont accès.

L\'authentification est activée par la directive authenticate avec la valeur collection ou document, suivant que la restriction d\'accès s\'applique à toute la collection ou sur des documents spécifiques (la valeur par défaut est collection). Si l\'authentification est effectuée sur la base document, on peut donc soit spécifier une liste de documents privés (dans ce cas tous les autres sont publiques), soit une liste de documents publics (dans ce cas tous les autres sont privés)en utilisant les directives private_documents ou public_documents. Ces documents eux-mêmes sont specifiés en utilisant les identificateurs de documents de Greenstone (séparés par des espaces) : la façon la plus facile de les determiner est de localiser chaque document dans la collection et de regarder son argument d dans son URL Greenstone.

_text2_\n

La directive auth-groups précise les groupes Greenstone pour lesquels l\'accès sera permis, si le document (ou la collection) est de ceux qui exigent une authentification. Il est suivi par un nom de groupe (ou une liste de noms de groupe séparés par des espaces). Les pages adminde Greenstone vous permettent de définir des groupes et d\'y ajouter des membres. " # -- Spanish text ---------------- collectionmeta collectionextra [l=es] " Esta colección de demostración de Greenstone contiene el mismo material que la colección de demo original, pero incluye además algunos comandos de autenticación básica. Solo dos documentos tienen libre acceso (Farming snails 1 & 2), mientras que los restantes requieren autenticación para poder visualizarse.

Para tener acceso a esta colección ingrese el nombre de usuario: demo y la contraseña: demo

Cómo trabaja esta colección

El archivo de configuración es exactamente el mismo que el de la demo original salvo las directivas para la autenticación (y su descripción).

El esquema de autenticación controla el acceso a la colección. Consiste de dos pasos. Primero determina si se va a restringir el acceso a toda la colección o sólo a documentos individuales dentro de la misma y, en este último caso, a qué documentos (ya sea dando una lista de los documentos confidenciales para los cuales el acceso está limitado a determinadas cuentas o especificando que todos los documentos son confidenciales, excepto por una lista dada de documentos del dominio público). A continuación para los documentos con acceso restringido determina qué usuarios tendrán acceso a ellos.

La función de autenticación se activa por medio de la directiva authenticate con el valor collection o document, dependiendo de si la autenticación se debe realizar para tener acceso a toda la colección o por cada documento (el valor por omisión es colección). Si la autenticación se va a realizar con base en cada documento, entonces se puede establecer una lista de documentos confidenciales (en cuyo caso todos los demás son del dominio público) o una lista de documentos de dominio público (en cuyo caso todos los demás documentos son confidenciales) usando las directivas private_documents o public_documents. Los documentos mismos se especifican por medio de los identificadores de documento de Greenstone (separados por espacios). La forma más fácil de determinarlos es localizar cada documento en la colección y ver el argumento d en su URL.\n

En este caso, hemos usado la opción -OIDtype dirname del HTMLPlugin, la cual especifica que deben usarse los nombres de las carpetas como identificadores. Esto funciona para cualquier colección en donde cada documento está en una carpeta separada. Hemos usado esta opción para asegurarnos de que los identificadores permanezcan inalterados en diferentes plataformas (lo cual no es el caso de los identificadores HASH), ya que aquí necesitamos especificar identificadores en las directivas de autenticación.\n La directiva auth_groups especifica los grupos a los cuales se permite el acceso, si el documento (o la colección) es uno de los que requieren autenticación. Está seguida por el nombre del grupo (o una lista de nombres de grupos separados por espacios). Las páginas admin de Greenstone le permiten definir los grupos y añadir miembros. " # -- Russian text ---------------- collectionmeta collectionextra [l=ru] " Данная демонстрационная коллекция содержит те же материалы что и оригинальная демонстрационная коллекция Гринстоун, но включает команды базовой аутентификации. Два документа доступны для открытого доступа (Разведение улиток 1 и 2), но другие документы требуют входа для просмотра.

Для доступа к этой коллекции необходимо ввести user: demo и password: demo

Как работает коллекция

\n

_text1_

Схема аутентификации управляет доступом к коллекции. Она является двухступенчатой. Сначала она решает, ограничить ли доступ к коллекции в целом или к отдельным документам. В последнем случае определяется, какие документы являются таковыми (или представляя список тех документов, к которым требуется разрешение на доступ, или же определяя, что все документы являются недоступными за исключением тех, что включены в список общедоступных документов). Тогда для документов ограниченного доступа определяется, каким пользователям разрешен к ним доступ.

_text3_ Специфику самих документов определяют, используя идентификаторы документа в Greenstone (распределенных по областям). Самый легкий способ их отнесения состоит в том, чтобы определить местонахождение каждого документа в коллекции и рассмотреть его d-аргумент в URL Greenstone.

_text2_\n

Директива auth_groups определяет группы Greenstone, к которым доступ будет разрешен, если документ (или коллекция) относится к тем, для которых требуется аутентификация. Это определяется названием группы (или списком названий групп определенных областей). Admin страницы Greenstone позволяет определять группы и добавлять к ним новые. " # -- Simplified Chinese text ---------------- collectionmeta collectionextra [l=zh] " 本演示馆藏所包含的文档与Greenstone演示馆藏中一样,但本馆藏还包括一些基本的认证功能。 其中两个文档是公共可见的(Farming snails 1 和 2),而其他的文档则要求先登录再浏览。

要访问本馆藏,用户名为: demo ,密码为: demo

本馆藏如何工作

\n

除了认证配置,一个插件参数(以及本馆藏描述)之外,本馆藏的 配置文件与演示馆藏的 配置文件一模一样。

认证模式控制本馆藏的访问权限。认证模式分两步。首先它确定是否对整个馆藏或者馆藏中的单 个文档进行访问限制,而在后者情况下,要么设定一个需要认证才能访问的私有文档列表,或者给定 一个公共文档列表,除该列表之外所有文档均为私有文档。然后对限制性访问的文档确定哪些用户组 拥有访问权限。\n

认证模式由设定authenticate参数的值为collection或者document 来激活,取哪个值取决于是否在整个馆藏或者单个文档的基础上进行认证(缺省值为collection)。 如果认证是基于document(文档)的,则要么设定一个私有文档的列表(此时所有其他 文档都将是公共文档),或者设定一个公共文档列表(此时所有其他文档都是私有文档),这通过使用 private_documents或者public_documents参数来设置。文档本身用Greenstone的 文档标识符(以空格间隔):确定这些文档的最简单方式是在馆藏中找到这些文档,然后查看它们 Greenstone URL的d参数值。\n

在这种情况下,我们已经设置了HTMLPlugin的-OIDtype dirname参数,该参数指明文件目录名 应被用作标识符。这种设置适用于每个文档都在一个单独的文件目录中。我们使用这个选项来确保在不同系统下 这些标识符都是一样的(而HASH标识符在不同系统中可能不同),因为我们需要在authenticate参数 中用到这些标识符。\n

auth_groups参数指定了允许访问的Greenstone用户组,如果该文档(或馆藏)是需要认证的。 在这个参数后面是一个组名(或者是一个用空格间隔的组名列表)。Greenstone admin页面提供了 定义用户组以及添加用户到用户组的功能。\n "