Index: openacs-4/packages/acs-content-repository/www/doc/guide/keywords.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-content-repository/www/doc/guide/keywords.html,v diff -u -r1.3.14.1 -r1.3.14.2 --- openacs-4/packages/acs-content-repository/www/doc/guide/keywords.html 9 Jun 2016 08:21:01 -0000 1.3.14.1 +++ openacs-4/packages/acs-content-repository/www/doc/guide/keywords.html 22 Jun 2016 07:40:41 -0000 1.3.14.2 @@ -4,8 +4,8 @@
The content_keyword object type is used to represent -Subject Keywords (see content_keyword.sql) The -content_keyword type inherits from acs_object: +
The content_keyword object type is used to represent +Subject Keywords (see content_keyword.sql) The +content_keyword type inherits from acs_object:
acs_object_type.create_type ( supertype => 'acs_object', object_type @@ -39,7 +39,7 @@ id_column => 'keyword_id', name_method => 'acs_object.default_name' );-In addition, the cr_keywords table (see content-create.sql) +In addition, the cr_keywords table (see content-create.sql) contains extended attributes of Subject Keywords:
@@ -54,7 +54,7 @@ );-In content-keyword.sql: +In content-keyword.sql:
attr_id := acs_attribute.create_attribute ( @@ -74,10 +74,10 @@ );-
Thus, each Subject Keyword has a heading, which is a -user-readable heading for the keyword, and a description, +
Thus, each Subject Keyword has a heading, which is a +user-readable heading for the keyword, and a description, which is a somewhat longer description of the keyword.
The -cr_item_keyword_map table (see content-create.sql) +cr_item_keyword_map table (see content-create.sql) is used to relate content items to keywords:
@@ -115,7 +115,7 @@ newCreate a new Subject Keyword -This is a standard new function, used to create a new + This is a standard new function, used to create a new Subject Keyword. If the parent id is specified, the new keword becomes a child of the parent keyword (which may now be called a Subject Category) @@ -125,7 +125,7 @@ deleteDelete a Subject Keyword -This is a standard delete function, used to delete a Subject Keyword +This is a standard delete function, used to delete a Subject Keyword @@ -155,22 +155,22 @@ Assign Keywords to Items These functions should be used to assign Subject Keywords to content items, to unassign keywords from items, and to determine whether a particular keyword is assigned to an - item. The is_assigned function can be used to determine if a keyword matches - a content item, based on the recurse parameter: + item.
The is_assigned function can be used to determine if a keyword matches + a content item, based on the recurse parameter:
-
- If recurse is set to 'none', is_assigned will return - 't' if and only if there is an exact assignment of the keyword to the item. +
- If recurse is set to 'none', is_assigned will return + 't' if and only if there is an exact assignment of the keyword to the item.
-- If recurse is set to 'down', is_assigned will return - 't' if there is an exact assignment of the keyword to the item, or if +
- If recurse is set to 'down', is_assigned will return + 't' if there is an exact assignment of the keyword to the item, or if a narrower keyword is assigned to the item. For example, a query whether - "Potstickers" is assigned the category "My Favorite Foods" will return 't' + "Potstickers" is assigned the category "My Favorite Foods" will return 't' even if "Potstickers" is only assigned the category "Healthy".
-- If recurse is set to 'up', is_assigned will return - 't' if there is an exact assignment of the keyword to the item, or if +
- If recurse is set to 'up', is_assigned will return + 't' if there is an exact assignment of the keyword to the item, or if a broader Subject Category is assigned to the item. For example, a query whether - "Potstickers" is assigned the category "Healthy" will return 't' + "Potstickers" is assigned the category "Healthy" will return 't' even if "Potstickers" is assigned the broader category "My Favorite Foods".