标签云：Pelican插件

此Pelican插件可从文章标签生成标签云。

安装

可以通过以下方式安装此插件：

python -m pip install pelican-tag-cloud

有关更详细的插件安装说明，请参阅Pelican插件文档。

为了使用此插件，您必须编辑主题的基本模板和样式表。您应该将base.html更改为应用style.css中定义的格式（和大小），如以下“设置”中指定。

设置

用法

默认主题不包括标签云，但添加它相对简单

<ul class="tagcloud">
    {% for tag in tag_cloud %}
        <li class="tag-{{ tag.1 }}">
            <a href="{{ SITEURL }}/{{ tag.0.url }}">
            {{ tag.0 }}
                {% if TAG_CLOUD_BADGE %}
                    <span class="badge">{{ tag.2 }}</span>
                {% endif %}
            </a>
        </li>
    {% endfor %}
</ul>

然后您还应该定义带有适当类的CSS样式（tag-1到tag-N，其中N匹配TAG_CLOUD_STEPS），其中tag-1是最常用的，并定义一个具有适当列表样式的ul.tagcloud类来创建云。如果您使用TAG_CLOUD_BADGE设置，则应复制并粘贴此徽章 CSS规则ul.tagcloud .list-group-item <span>.badge。（此规则可能较长，建议避免与Twitter Bootstrap等CSS框架冲突。）

例如

ul.tagcloud {
    list-style: none;
    padding: 0;
}

ul.tagcloud li {
    display: inline-block;
}

li.tag-1 {
    font-size: 150%;
}

li.tag-2 {
    font-size: 120%;
}

/* ... add li.tag-3 etc, as much as needed */

ul.tagcloud .list-group-item span.badge {
    background-color: grey;
    color: white;
}

默认情况下，云中的标签是随机排序的，但如果您希望它们按字母顺序排序，请使用alphabetically（升序）和alphabetically-rev（降序）。此外，您还可以使用size（升序）和size-rev（降序）的值按频率（具有此特定标签的文章数量）对标签进行排序。

贡献

欢迎并非常感谢贡献。每一份努力都很重要。您可以通过改进文档、添加缺失功能以及修复错误来做出贡献。您还可以通过审查和评论现有问题来提供帮助。

要开始为此插件做出贡献，请查阅为Pelican做出贡献的文档，从贡献代码部分开始。

许可证

本项目采用AGPL-3.0许可证。