Logo Search packages:      
Sourcecode: zope-cmf1.5 version File versions  Download package

DublinCore.py

##############################################################################
#
# Copyright (c) 2001 Zope Corporation and Contributors. All Rights Reserved.
#
# This software is subject to the provisions of the Zope Public License,
# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
# FOR A PARTICULAR PURPOSE.
#
##############################################################################
""" Dublin Core interface.

$Id: DublinCore.py 36613 2004-10-12 09:22:52Z yuppie $
"""

from Interface import Interface


00021 class DublinCore(Interface):
    """ Dublin Core metadata elements supported by CMF and their semantics.
    """

00025     def Title():
        """ Dublin Core Title element - resource name.

        Permission -- View

        Returns -- String
        """

00033     def listCreators():
        """ List Dublin Core Creator elements - resource authors.

        Depending on the implementation, this returns the full name(s) of the
        author(s) of the content object or their ids.

        Permission -- View

        Returns -- Sequence of strings
        """

00044     def Creator():
        """ Dublin Core Creator element - resource author.

        The first Dublin Core Creator element or an empty string.

        Permission -- View

        Returns -- String
        """

00054     def Subject():
        """ Dublin Core Subject element - resource keywords.

        Return zero or more keywords associated with the content object.

        Permission -- View

        Returns -- Sequence of strings
        """

00064     def Description():
        """ Dublin Core Description element - resource summary.

        Return a natural language description of this object.

        Permission -- View

        Returns -- String
        """

00074     def Publisher():
        """ Dublin Core Publisher element - resource publisher.

        Return full formal name of the entity or person responsible for
        publishing the resource.

        Permission -- View

        Returns -- String
        """

00085     def listContributors():
        """ Dublin Core Contributor elements - resource collaborators.

        Return zero or additional collaborators.

        Permission -- View

        Returns -- Sequence of strings
        """

00095     def Contributors():
        """ Deprecated alias of listContributors.

        'initial caps' names are reserved for strings.
        """

00101     def Date():
        """ Dublin Core Date element - default date.

        Permission -- View

        Returns -- String, formatted 'YYYY-MM-DD H24:MN:SS TZ'
        """

00109     def CreationDate():
        """ Dublin Core Date element - date resource created.

        Permission -- View

        Returns -- String, formatted 'YYYY-MM-DD H24:MN:SS TZ'
        """

00117     def EffectiveDate():
        """ Dublin Core Date element - date resource becomes effective.

        Permission -- View

        Returns -- String, formatted 'YYYY-MM-DD H24:MN:SS TZ'
        """

00125     def ExpirationDate():
        """ Dublin Core Date element - date resource expires.

        Permission -- View

        Returns -- String, formatted 'YYYY-MM-DD H24:MN:SS TZ'
        """

00133     def ModificationDate():
        """ Dublin Core Date element - date resource last modified.

        Permission -- View

        Returns -- String, formatted 'YYYY-MM-DD H24:MN:SS TZ'
        """

00141     def Type():
        """ Dublin Core Type element - resource type.

        Return a human-readable type name for the resource (perhaps mapped
        from its Zope meta_type).

        Permission -- View

        Returns -- String
        """

00152     def Format():
        """ Dublin Core Format element - resource format.

        Return the resource's MIME type (e.g. 'text/html', 'image/png', etc.).

        Permission -- View

        Returns -- String
        """

00162     def Identifier():
        """ Dublin Core Identifier element - resource ID.

        Returns unique ID (a URL) for the resource.

        Permission -- View

        Returns -- String
        """

00172     def Language():
        """ Dublin Core Language element - resource language.

        Return the RFC language code (e.g. 'en-US', 'pt-BR') for the resource.

        Permission -- View

        Returns -- String
        """

00182     def Rights():
        """ Dublin Core Rights element - resource copyright.

        Return a string describing the intellectual property status, if any,
        of the resource.

        Permission -- View

        Returns -- String
        """


00194 class CatalogableDublinCore(Interface):
    """ Provide Zope-internal date objects for cataloging purposes.
    """

00198     def created():
        """ Dublin Core Date element - date resource created.

        Permission -- View

        Returns -- DateTime
        """

00206     def effective():
        """ Dublin Core Date element - date resource becomes effective.

        Permission -- View

        Returns -- DateTime
        """

00214     def expires():
        """ Dublin Core Date element - date resource expires.

        Permission -- View

        Returns -- DateTime
        """

00222     def modified():
        """ Dublin Core Date element - date resource last modified.

        Permission -- View

        Returns -- DateTime
        """


00231 class MutableDublinCore(Interface):
    """ Update interface for mutable metadata.
    """

00235     def setTitle(title):
        """ Set Dublin Core Title element - resource name.

        Permission -- Modify portal content
        """

00241     def setCreators(creators):
        """ Set Dublin Core Creator elements - resource authors.

        Permission -- Modify portal content
        """

00247     def setSubject(subject):
        """ Set Dublin Core Subject element - resource keywords.

        Permission -- Modify portal content
        """

00253     def setDescription(description):
        """ Set Dublin Core Description element - resource summary.

        Permission -- Modify portal content
        """

00259     def setContributors(contributors):
        """ Set Dublin Core Contributor elements - resource collaborators.

        Permission -- Modify portal content
        """

00265     def setEffectiveDate(effective_date):
        """ Set Dublin Core Date element - date resource becomes effective.

        Permission -- Modify portal content
        """

00271     def setExpirationDate(expiration_date):
        """ Set Dublin Core Date element - date resource expires.

        Permission -- Modify portal content
        """

00277     def setFormat(format):
        """ Set Dublin Core Format element - resource format.

        Permission -- Modify portal content
        """

00283     def setLanguage(language):
        """ Set Dublin Core Language element - resource language.

        Permission -- Modify portal content
        """

00289     def setRights(rights):
        """ Set Dublin Core Rights element - resource copyright.

        Permission -- Modify portal content
        """

Generated by  Doxygen 1.6.0   Back to index