Logo Search packages:      
Sourcecode: zope-cmf1.4 version File versions

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.0 (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,v 1.4.14.2 2004/04/23 21:11:34 sidnei Exp $
"""

try:
    from Interface import Interface
except ImportError:
    # for Zope versions before 2.6.0
    from Interface import Base as Interface


00025 class DublinCore(Interface):
    """
        Define which Dublin Core metadata elements are supported by the CMF,
        and the semantics therof.
    """

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

            Return type: string
            Permissions: View
        """
        
00039     def Creator():
        """
            Dublin Core element - resource creator

            Return the full name(s) of the author(s) of the content object.

            Return type: string
            Permission: View
        """

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

            Return zero or more keywords associated with the content object.

            Return type: sequence of strings
            Permission: View
        """

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

            Return a natural language description of this object.

            Return type: string
            Permissions: View
        """

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

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

            Return type: string
            Permission: View
        """

00080     def Contributors():
        """
            Dublin Core element - resource collaborators

            Return zero or additional collaborators.

            Return type: sequence of strings
            Permission: View
        """
    
00090     def Date():
        """
            Dublin Core element - default date

            Return type: string, formatted 'YYYY-MM-DD H24:MN:SS TZ'
            Permissions: View
        """
    
00098     def CreationDate():
        """
            Dublin Core element - date resource created.

            Return type: string, formatted 'YYYY-MM-DD H24:MN:SS TZ'
            Permissions: View
        """
    
00106     def EffectiveDate():
        """
            Dublin Core element - date resource becomes effective.

            Return type: string, formatted 'YYYY-MM-DD H24:MN:SS TZ'
            Permissions: View
        """
    
00114     def ExpirationDate():
        """
            Dublin Core element - date resource expires.

            Return type: string, formatted 'YYYY-MM-DD H24:MN:SS TZ'
            Permissions: View
        """
    
00122     def ModificationDate():
        """
            Dublin Core element - date resource last modified.

            Return type: string, formatted 'YYYY-MM-DD H24:MN:SS TZ'
            Permissions: View
        """

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

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

            Return type: string
            Permissions: View
        """

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

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

            Return type: string
            Permissions: View
        """

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

            Returns unique ID (a URL) for the resource.

            Return type: string
            Permissions: View
        """

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

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

            Return type: string
            Permissions: View
        """

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

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

            Return type: string
            Permissions: View
        """

00185 class CatalogableDublinCore(Interface):
    """
        Provide Zope-internal date objects for cataloging purposes.
    """
00189     def created():
        """
            Dublin Core element - date resource created,

            Return type: DateTime
            Permissions: View
        """
    
00197     def effective():
        """
            Dublin Core element - date resource becomes effective,

            Return type: DateBound
            Permissions: View
        """
    
00205     def expires():
        """
            Dublin Core element - date resource expires,

            Return type: DateBound
            Permissions: View
        """
    
00213     def modified():
        """
            Dublin Core element - date resource last modified,

            Return type: DateTime
            Permissions: View
        """

00221 class MutableDublinCore(Interface):
    """
        Update interface for mutable metadata.
    """
    def setTitle(title):
        "Dublin Core element - update resource name"

    def setSubject(subject):
        "Dublin Core element - update resource keywords"

    def setDescription(description):
        "Dublin Core element - update resource summary"

    def setContributors(contributors):
        "Dublin Core element - update additional contributors to resource"

00237     def setEffectiveDate(effective_date):
        """ Dublin Core element - update date resource becomes effective.  """
    
00240     def setExpirationDate(expiration_date):
        """ Dublin Core element - update date resource expires.  """
    
00243     def setFormat(format):
        """ Dublin Core element - update resource format """

00246     def setLanguage(language):
        """ Dublin Core element - update resource language """

00249     def setRights(rights):
        """ Dublin Core element - update resource copyright """


Generated by  Doxygen 1.6.0   Back to index