106 For many entities, link IDs, once specified, are immutable, since |
106 For many entities, link IDs, once specified, are immutable, since |
107 changing them can break bookmarked URLs. Changing the link IDs of |
107 changing them can break bookmarked URLs. Changing the link IDs of |
108 "leaf" entities (such as the Document in the example above) could |
108 "leaf" entities (such as the Document in the example above) could |
109 be allowed. |
109 be allowed. |
110 """ |
110 """ |
111 #: Required field storing "ID" used in URL links. Lower ASCII characters, |
111 #: Required field storing "ID" used in URL links. ASCII characters, |
112 #: digits and underscores only. Valid link IDs successfully match |
112 #: digits and underscores only. Valid link IDs successfully match |
113 #: the LINK_ID_REGEX. |
113 #: the LINK_ID_REGEX. |
114 link_id = db.StringProperty(required=True, |
114 link_id = db.StringProperty(required=True, |
115 verbose_name=ugettext('Link ID')) |
115 verbose_name=ugettext('Link ID')) |
116 link_id.help_text = ugettext( |
116 link_id.help_text = ugettext( |
117 'Link ID is used as part of various URL links throughout the site.' |
117 'Link ID is used as part of various URL links throughout the site.' |
118 ' Lowercase ASCII characters, digits, and underscores only.' |
118 ' <a href="http://en.wikipedia.org/wiki/ASCII">ASCII</a> ' |
|
119 ' characters, digits, and underscores only.' |
119 ' The regexp used to validate is "%s".') % LINK_ID_PATTERN_CORE |
120 ' The regexp used to validate is "%s".') % LINK_ID_PATTERN_CORE |
120 |
121 |
121 #: Optional Self Reference property to another Linkable entity which defines |
122 #: Optional Self Reference property to another Linkable entity which defines |
122 #: the "scope" of this Linkable entity. The back-reference in the Linkable |
123 #: the "scope" of this Linkable entity. The back-reference in the Linkable |
123 #: model is a Query named 'links'. |
124 #: model is a Query named 'links'. |