{"id":13696070,"url":"https://github.com/pelican-plugins/tag-cloud","last_synced_at":"2025-04-10T04:32:47.677Z","repository":{"id":44664552,"uuid":"339011250","full_name":"pelican-plugins/tag-cloud","owner":"pelican-plugins","description":"Pelican plugin that generates a tag cloud from post tags","archived":false,"fork":false,"pushed_at":"2024-07-02T01:08:36.000Z","size":30,"stargazers_count":5,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-24T16:23:08.271Z","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},"funding":{"github":"justinmayer","custom":"https://donate.getpelican.com","liberapay":"pelican"}},"created_at":"2021-02-15T08:28:48.000Z","updated_at":"2025-02-18T02:40:35.000Z","dependencies_parsed_at":"2024-04-08T02:51:07.866Z","dependency_job_id":"5f285392-a9a4-4e27-9ebf-4c35824e797b","html_url":"https://github.com/pelican-plugins/tag-cloud","commit_stats":{"total_commits":31,"total_committers":9,"mean_commits":"3.4444444444444446","dds":0.4193548387096774,"last_synced_commit":"44d884858f7fc5a3b9488d06c7ba2204e91b59b0"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Ftag-cloud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Ftag-cloud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Ftag-cloud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelican-plugins%2Ftag-cloud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pelican-plugins","download_url":"https://codeload.github.com/pelican-plugins/tag-cloud/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247994106,"owners_count":21030049,"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.028Z","updated_at":"2025-04-10T04:32:47.274Z","avatar_url":"https://github.com/pelican-plugins.png","language":"Python","funding_links":["https://github.com/sponsors/justinmayer","https://donate.getpelican.com","https://liberapay.com/pelican"],"categories":["Plugins"],"sub_categories":["Migrated to new architecture"],"readme":"Tag Cloud: A Plugin for Pelican\n===============================\n\n[![Build Status](https://img.shields.io/github/actions/workflow/status/pelican-plugins/tag-cloud/main.yml?branch=main)](https://github.com/pelican-plugins/tag-cloud/actions)\n[![PyPI Version](https://img.shields.io/pypi/v/pelican-tag-cloud)](https://pypi.org/project/pelican-tag-cloud/)\n![License](https://img.shields.io/pypi/l/pelican-tag-cloud?color=blue)\n\nThis Pelican plugin generates a tag cloud from post tags.\n\nInstallation\n------------\n\nThis plugin can be installed via:\n\n    python -m pip install pelican-tag-cloud\n\nFor more detailed plugin installation instructions, please refer to the [Pelican Plugin Documentation](https://docs.getpelican.com/en/latest/plugins.html).\n\nIn order to use to use this plugin, you must edit your theme’s base template and style-sheet. You should change **base.html** to apply formats (and sizes) defined in **style.css**, as specified in _Settings_ below.\n\nSettings\n--------\n\n| Settings and their default values  |                   What does it do?                    |\n| ---------------------------------- | ----------------------------------------------------- |\n| `TAG_CLOUD_STEPS = 4`              |  Count of different font sizes in the tag cloud       |\n| `TAG_CLOUD_MAX_ITEMS = 100`        |  Maximum number of tags in the cloud                  |\n| `TAG_CLOUD_SORTING = \"random\"`     |  Tag cloud ordering scheme. Valid values: random, alphabetically, alphabetically-rev, size, and size-rev |\n| `TAG_CLOUD_BADGE = True`           |  Optional setting: turn on **badges**, displaying the number of articles using each tag |\n\nUsage\n-----\n\nThe default theme does not include a tag cloud, but it is fairly easy to add one:\n\n```jinja2\n\u003cul class=\"tagcloud\"\u003e\n    {% for tag in tag_cloud %}\n        \u003cli class=\"tag-{{ tag.1 }}\"\u003e\n            \u003ca href=\"{{ SITEURL }}/{{ tag.0.url }}\"\u003e\n            {{ tag.0 }}\n                {% if TAG_CLOUD_BADGE %}\n                    \u003cspan class=\"badge\"\u003e{{ tag.2 }}\u003c/span\u003e\n                {% endif %}\n            \u003c/a\u003e\n        \u003c/li\u003e\n    {% endfor %}\n\u003c/ul\u003e\n```\n\nYou should then also define CSS styles with appropriate classes (tag-1 to tag-N, where N matches `TAG_CLOUD_STEPS`), tag-1 being the most frequent, and define a `ul.tagcloud` class with appropriate list-style to create the cloud. You should copy+paste this **badge** CSS rule `ul.tagcloud .list-group-item \u003cspan\u003e.badge` if you are using the `TAG_CLOUD_BADGE` setting. (This rule, potentially long, is suggested to avoid conflicts with CSS frameworks such as Twitter Bootstrap.)\n\nFor example:\n\n```css\nul.tagcloud {\n    list-style: none;\n    padding: 0;\n}\n\nul.tagcloud li {\n    display: inline-block;\n}\n\nli.tag-1 {\n    font-size: 150%;\n}\n\nli.tag-2 {\n    font-size: 120%;\n}\n\n/* ... add li.tag-3 etc, as much as needed */\n\nul.tagcloud .list-group-item span.badge {\n    background-color: grey;\n    color: white;\n}\n```\n\nBy default, the tags in the cloud are sorted randomly, but if you prefer to have them sorted alphabetically, use `alphabetically` (ascending) and `alphabetically-rev` (descending). Also, it is possible to sort the tags by frequency (number of articles with this specific tag) using the values `size` (ascending) and `size-rev` (descending).\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/tag-cloud/issues\n[Contributing to Pelican]: https://docs.getpelican.com/en/latest/contribute.html\n\nLicense\n-------\n\nThis project is licensed under the AGPL-3.0 license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpelican-plugins%2Ftag-cloud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpelican-plugins%2Ftag-cloud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpelican-plugins%2Ftag-cloud/lists"}