{"id":13696157,"url":"https://github.com/pelican-plugins/related-posts","last_synced_at":"2025-07-15T04:37:27.340Z","repository":{"id":52247185,"uuid":"291232251","full_name":"pelican-plugins/related-posts","owner":"pelican-plugins","description":"Related Posts is a Pelican plugin that adds a list of related posts to an article.","archived":false,"fork":false,"pushed_at":"2024-07-07T18:47:55.000Z","size":16,"stargazers_count":6,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-19T01:39:23.354Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pelican-plugins.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":"https://donate.getpelican.com","liberapay":"pelican"}},"created_at":"2020-08-29T08:28:56.000Z","updated_at":"2023-12-23T17:40:22.000Z","dependencies_parsed_at":"2024-04-13T00:41:26.277Z","dependency_job_id":"7034412c-1327-4922-b8f8-4077eaafb9a5","html_url":"https://github.com/pelican-plugins/related-posts","commit_stats":{"total_commits":17,"total_committers":8,"mean_commits":2.125,"dds":0.4117647058823529,"last_synced_commit":"b115faf27b8c6a053f04c769e9339234e670a00f"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/pelican-plugins/related-posts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Frelated-posts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Frelated-posts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Frelated-posts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Frelated-posts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pelican-plugins","download_url":"https://codeload.github.com/pelican-plugins/related-posts/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Frelated-posts/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265402833,"owners_count":23759237,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-02T18:00:36.748Z","updated_at":"2025-07-15T04:37:27.163Z","avatar_url":"https://github.com/pelican-plugins.png","language":"Python","funding_links":["https://donate.getpelican.com","https://liberapay.com/pelican"],"categories":["Plugins"],"sub_categories":["Migrated to new architecture"],"readme":"Related Posts: A Plugin for Pelican\n===================================\n\n[![Build Status](https://img.shields.io/github/actions/workflow/status/pelican-plugins/related-posts/main.yml?branch=main)](https://github.com/pelican-plugins/related-posts/actions) [![PyPI Version](https://img.shields.io/pypi/v/pelican-related-posts)](https://pypi.org/project/pelican-related-posts/)\n\nRelated Posts is a Pelican plugin that adds a list of related posts to an article by adding a `related_posts` variable to the article’s context.\n\n\nInstallation\n------------\n\nThis plugin can be installed via:\n\n    python -m pip install pelican-related-posts\n\n\nUsage\n-----\n\nBy default, up to five related articles are listed. You can customize this value by defining `RELATED_POSTS_MAX` in your settings file:\n\n    RELATED_POSTS_MAX = 10\n\nYou can then use the `article.related_posts` variable in your templates. For example:\n\n    {% if article.related_posts %}\n        \u003cul\u003e\n        {% for related_post in article.related_posts %}\n            \u003cli\u003e\u003ca href=\"{{ SITEURL }}/{{ related_post.url }}\"\u003e{{ related_post.title }}\u003c/a\u003e\u003c/li\u003e\n        {% endfor %}\n        \u003c/ul\u003e\n    {% endif %}\n\nYour related posts should share a common tag. You can also use `related_posts:` in your post’s meta-data. The `related_posts:` meta-data works together with your existing slugs:\n\n    related_posts: slug1, slug2, slug3, ... slugN\n\n`N` represents the `RELATED_POSTS_MAX` value.\n\nAdditionally, you can specify the following in your settings file:\n\n    RELATED_POSTS_SKIP_SAME_CATEGORY = True\n\nWith this setting, `article.related_posts` will contain only related posts from categories other than the original article's.\n\n\nContributing\n------------\n\nContributions are welcome and much appreciated. Every little bit helps. You can contribute by improving the documentation, adding missing features, and fixing bugs. You can also help out by reviewing and commenting on [existing issues][].\n\nTo start contributing to this plugin, review the [Contributing to Pelican][] documentation, beginning with the **Contributing Code** section.\n\n[existing issues]: https://github.com/pelican-plugins/related-posts/issues\n[Contributing to Pelican]: https://docs.getpelican.com/en/latest/contribute.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpelican-plugins%2Frelated-posts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpelican-plugins%2Frelated-posts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpelican-plugins%2Frelated-posts/lists"}