give more information on link objects, thus preparing a move to the new 'cybertools.link' package

git-svn-id: svn://svn.cy55.de/Zope3/src/cybertools/trunk@3677 fd906abe-77d9-0310-91a1-e0d9ade77398
This commit is contained in:
helmutm 2010-01-13 13:59:54 +00:00
parent 172a0d1913
commit e82034c31e

View file

@ -1,5 +1,5 @@
# #
# Copyright (c) 2009 Helmut Merz helmutm@cy55.de # Copyright (c) 2010 Helmut Merz helmutm@cy55.de
# #
# This program is free software; you can redistribute it and/or modify # This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by # it under the terms of the GNU General Public License as published by
@ -247,29 +247,38 @@ class ILink(Interface):
There may be more than one link records with the same name There may be more than one link records with the same name
that represent the real link at different times or under that represent the real link at different times or under
different conditions. different conditions (really?).
""" """
identifier = Attribute('An internal identifier of the link record, ' identifier = Attribute('An internal identifier of the link record, '
'unique within the link manager.') 'unique within the link manager.')
name = Attribute('The external identifier for the link, i.e. the ' name = Attribute('The external identifier for the link, i.e. the '
'string used in the source text to address the link.') 'string used in the source text to address the link.')
title = Attribute('A short text, may be used as the default text for '
'the link or for the alt tag of an image. Could also serve '
'for identifying a new link.')
description = Attribute('Optional: some text, may be used as a title attribute.')
state = Attribute('A short string denoting the state of the link entry.')
source = Attribute('Identifier of the link\'s source object.') source = Attribute('Identifier of the link\'s source object.')
target = Attribute('Identifier of the link\'s target object or - ' target = Attribute('Identifier of the link\'s target object or - '
'for external links - the target URI.') 'for external links - the target URI.')
linkType = Attribute('Optional: A short string specifying the type of the '
'link, a sort of predicate; default: "link".')
title = Attribute('Optional: A short text, may be used as the default text for '
'the link or for the alt tag of an image.')
description = Attribute('Optional: some text, may be used as a title attribute.')
state = Attribute('Optional: A short string denoting the state of the link '
'entry; default: "valid"')
relevance = Attribute('Optional: A float number between 0.0 and 1.0 denoting '
'the relevance of the connection between source and target; '
'default: 1.0.')
order = Attribute('Optional: An integer that may be used when providing an '
'ordered listing of links; default: 0.')
targetFragment = Attribute('Optional: an address part leading to a ' targetFragment = Attribute('Optional: an address part leading to a '
'text anchor or the part of an image.') 'text anchor or the part of an image.')
targetParameters = Attribute('Optional: a dictionary of URI parameters ' targetParameters = Attribute('Optional: a dictionary of URI parameters '
'that will have to be appended to the link to the target object.') 'that will have to be appended to the link to the target object.')
refuri = Attribute('The URI linking to the target object.') refuri = Attribute('The URI linking to the target object. '
user = Attribute('Optional: a string denoting the creator of the record.') '(Obsolete: has to be generated dynamically.)')
user = Attribute('Optional: a string denoting the creator of the record. '
'(Should be renamed to "creator".)')
run = Attribute('Optional: May be used to group the links from a certain ' run = Attribute('Optional: May be used to group the links from a certain '
'source at different times.') 'source at different times. (Probably obsolete)')
def getManager(): def getManager():
""" Return the link manager this link is managed by. """ Return the link manager this link is managed by.