Changeset 36554


Ignore:
Timestamp:
2022-09-03T21:36:37+12:00 (4 weeks ago)
Author:
anupama
Message:

Related to previous commit. That seems to have worked in marking all DEC collectiond description property strings for authen-e as requiring updating. Now putting the collection descriptions back, so that the strings are actually correct again. Next, after ensuring all Spanish, Russian and Chinese translations for DEC are formatted to be GTI friendly, I shall recommit them and finally repeat the temporary modification of all English language strings for *all* DEC collection and undo the same, and hopefully the GTI gs3deccolcfgs module should be ready for translators at last.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • documented-examples/trunk/authen-e/resources/collectionConfig.properties

    r36553 r36554  
    1 name=QQQQAuthentication demo
    2 textdate=QQQQpublication date\:
    3 textnumpages=QQQQno. of pages\:
    4 textsource=QQQQsource ref\:
    5 section_chapter=QQQQchapter
    6 document_book=QQQQbook
     1name=Authentication demo
     2textdate=publication date\:
     3textnumpages=no. of pages\:
     4textsource=source ref\:
     5section_chapter=chapter
     6document_book=book
    77
    8 dls.Organization=QQQQOrganizations
    9 dls.Subject=QQQQSubjects
    10 index_text=QQQQText
    11 index_document=QQQQBook
    12 index_section=QQQQChapter
    13 dls.Titles=QQQQTitles
    14 dls.Keyword=QQQQHow to
     8dls.Organization=Organizations
     9dls.Subject=Subjects
     10index_text=Text
     11index_document=Book
     12index_section=Chapter
     13dls.Titles=Titles
     14dls.Keyword=How to
    1515
    16 shortDescription=QQQQCollection demonstrating document-level collection authentication in Greenstone 3.
     16shortDescription=Collection demonstrating document-level collection authentication in Greenstone 3.
    1717
    18 description1=QQQQ<p>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 &amp; 2), while the others require logging in to view.</p> <p><center><b> To access this collection try user\:</b> <i>demo</i> <b>and password\:</b> <i>demo</i></center></p>
     18description1=<p>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 &amp; 2), while the others require logging in to view.</p> <p><center><b> To access this collection try user\:</b> <i>demo</i> <b>and password\:</b> <i>demo</i></center></p>
    1919
    20 description2=QQQQ<h3>How the collection works</h3><p> 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).</p>
     20description2=<h3>How the collection works</h3><p> 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).</p>
    2121
    22 description3=QQQQ<p>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.</p>
     22description3=<p>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.</p>
    2323
    24 description4=QQQQ<p>Authentication is activated using the <i>&lt;security&gt;</i> XML element in the collectionConfig.xml file. In the example of the authen-e collection, all <i>document</i>s are set to <i>private</i> access by default, with the <i>exception</i> that they are accessible to logged in members of a <i>group</i> called <i>"demo"</i>. The <i>security</i> element further defines a set of documents (<i>documentSet</i>) called "always-public" which contains 2 documents denoted by their document identifiers/OIDs (fb33fe and fb34fe). This documentSet specifies an exceptional case\: the documents in the documentSet are <i>not</i> private access like other documents in the collection are by default, but can instead be accessed by anyone in <i>any</i> group, as no group is specified for their access. \n\
    25    <pre>&lt;security default_access=QQQQ"private" scope="document"&gt; \n\
     24description4=<p>Authentication is activated using the <i>&lt;security&gt;</i> XML element in the collectionConfig.xml file. In the example of the authen-e collection, all <i>document</i>s are set to <i>private</i> access by default, with the <i>exception</i> that they are accessible to logged in members of a <i>group</i> called <i>"demo"</i>. The <i>security</i> element further defines a set of documents (<i>documentSet</i>) called "always-public" which contains 2 documents denoted by their document identifiers/OIDs (fb33fe and fb34fe). This documentSet specifies an exceptional case\: the documents in the documentSet are <i>not</i> private access like other documents in the collection are by default, but can instead be accessed by anyone in <i>any</i> group, as no group is specified for their access. \n\
     25   <pre>&lt;security default_access="private" scope="document"&gt; \n\
    2626        &lt;exception&gt; \n\
    27             &lt;group name=QQQQ"demo"/&gt; \n\
     27            &lt;group name="demo"/&gt; \n\
    2828        &lt;/exception&gt; \n\
    2929        &lt;exception&gt; \n\
    30             &lt;documentSet name=QQQQ"always-public"/&gt; \n\
    31             &lt;group name=QQQQ""/&gt; \n\
     30            &lt;documentSet name="always-public"/&gt; \n\
     31            &lt;group name=""/&gt; \n\
    3232        &lt;/exception&gt; \n\
    33         &lt;documentSet name=QQQQ"always-public"&gt; \n\
     33        &lt;documentSet name="always-public"&gt; \n\
    3434            &lt;match&gt;fb33fe&lt;/match&gt; \n\
    3535            &lt;match&gt;fb34fe&lt;/match&gt; \n\
     
    3838</p>
    3939
    40 description5=QQQQ<p>In this case, we have used the <i>-OIDtype dirname</i> 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 <i>documentSet</i>s controlling exceptions to the default access granted (or withheld) by the <i>security</i> element.</p>
     40description5=<p>In this case, we have used the <i>-OIDtype dirname</i> 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 <i>documentSet</i>s controlling exceptions to the default access granted (or withheld) by the <i>security</i> element.</p>
    4141
    42 description6=QQQQ<p>The <i>security</i> directive element specifies the Greenstone <i>group</i>s for to which access will be permitted, if the document (or collection) is one of those that requires authentication. The security element is to contain <i>exception</i> and <i>documentSet</i> elements to define one or more group names that will override the <i>default_access</i> set on the security element (whether all documents are private by default, for example, in which case <i>exception</i> elements define which groups <i>do</i> have access to the collection materials). The Greenstone <i>admin</i> pages allow you to define groups and add members to them.</p>
     42description6=<p>The <i>security</i> directive element specifies the Greenstone <i>group</i>s for to which access will be permitted, if the document (or collection) is one of those that requires authentication. The security element is to contain <i>exception</i> and <i>documentSet</i> elements to define one or more group names that will override the <i>default_access</i> set on the security element (whether all documents are private by default, for example, in which case <i>exception</i> elements define which groups <i>do</i> have access to the collection materials). The Greenstone <i>admin</i> pages allow you to define groups and add members to them.</p>
    4343
    44 description7=QQQQ<p>For more information on authentication in GS3, the different possibilities when using the <i>security</i> element in a GS3 collectionConfig file, and creating new users and adding them to groups, refer to the following pages on the Greenstone wiki \n\
     44description7=<p>For more information on authentication in GS3, the different possibilities when using the <i>security</i> element in a GS3 collectionConfig file, and creating new users and adding them to groups, refer to the following pages on the Greenstone wiki \n\
    4545<ul> \n\
    46 <li><a href=QQQQ"http\://wiki.greenstone.org/doku.php?id=en\:user\:authentication">Authentication in Greenstone</a></li> \n\
    47 <li><a href=QQQQ"http\://wiki.greenstone.org/doku.php?id=en\:user_advanced\:security">Security in Greenstone Collections</a></li> \n\
    48 <li><a href=QQQQ"http\://wiki.greenstone.org/doku.php?id=en\:user_advanced\:gs3_user_management">Greenstone 3 User Management</a></li> \n\
     46<li><a href="http\://wiki.greenstone.org/doku.php?id=en\:user\:authentication">Authentication in Greenstone</a></li> \n\
     47<li><a href="http\://wiki.greenstone.org/doku.php?id=en\:user_advanced\:security">Security in Greenstone Collections</a></li> \n\
     48<li><a href="http\://wiki.greenstone.org/doku.php?id=en\:user_advanced\:gs3_user_management">Greenstone 3 User Management</a></li> \n\
    4949</ul> \n\
    5050</p>
Note: See TracChangeset for help on using the changeset viewer.