相关文章：Pelican插件

相关文章是一个Pelican插件，通过向文章上下文添加一个related_posts变量，在文章中添加相关文章列表。

安装

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

python -m pip install pelican-related-posts

用法

默认情况下，最多列出五篇相关文章。您可以通过在设置文件中定义RELATED_POSTS_MAX来自定义此值

RELATED_POSTS_MAX = 10

然后您可以在模板中使用article.related_posts变量。例如

{% if article.related_posts %}
    <ul>
    {% for related_post in article.related_posts %}
        <li><a href="{{ SITEURL }}/{{ related_post.url }}">{{ related_post.title }}</a></li>
    {% endfor %}
    </ul>
{% endif %}

您相关的文章应该共享一个共同标签。您也可以在文章的元数据中使用related_posts:。该related_posts:元数据与您现有的slug一起工作

related_posts: slug1, slug2, slug3, ... slugN

N代表RELATED_POSTS_MAX值。

此外，您可以在设置文件中指定以下内容

RELATED_POSTS_SKIP_SAME_CATEGORY = True

使用此设置，article.related_posts将只包含除原始文章类别之外的相关文章。

贡献

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

要开始为此插件贡献，请查看为Pelican贡献文档，从《贡献代码》部分开始。