跳转到主要内容

CubicWeb框架的标签组件

项目描述

摘要

标签立方体允许以简单而强大的方式为实体添加标签,以便对内容进行分类。标签可用于使用分面细化搜索。

它是CubicWeb组件。CubicWeb是语义网应用程序框架,请参阅 http://www.cubicweb.org

安装

建议使用 pip/Distribute 从源自动安装

pip install cubicweb-tag

如果遇到问题,请使用 easy_install/setuptools 和egg

easy_install cubicweb-tag

您可以从解压缩的 存档 手动安装包

python setup.py install # auto-install dependencies

如果您不想自动安装依赖项,可以强制设置使用标准库 distutils

NO_SETUPTOOLS=1 python setup.py install

更多详情请参阅 http://www.cubicweb.org/doc/en/admin/setup

使用

要允许实体类型使用标签,必须允许 Tag 与您的实体类型之间的 tags 关系。

例如,要激活Person、Company和Division实体类型上的标签功能,应将其模式添加到其中

from yams.buildobjs import RelationDefinition
class tags(RelationDefinition):
    subject = 'Tag'
    object = ('Person', 'Company', 'Division')

然后,您应该在那些类型的实体的主要视图中看到标签框出现。`TagsBox`显示应用于实体的标签,但还提供了一个易于添加/删除标签的方法,如果您有权限这样做。

更多视图

  • SimilarEntitiesBox 显示一些共享最多标签的实体

  • TagsCloudView,一种经典视图,根据标记实体的数量显示大小不一的标签集。它用于 TagsCloudBox,默认情况下不可见(用户可以通过其首选项激活它),但您可以使用以下代码片段默认激活它

    from cubicweb_tag.views import TagsCloudBox
    # make the tags cloud box visible by default
    TagsCloudBox.visible = True
  • 标签的主要视图为网站管理员提供了一个标签合并界面,这对于管理人们倾向于用不同词语或拼写表达相同内容的网站上的标签非常有用。

文档

doc/ 子目录中查找或阅读 http://www.cubicweb.org/doc/en/

支持者: