{"id":15295693,"url":"https://github.com/marcanuy/django-dynamic-breadcrumbs","last_synced_at":"2025-04-13T18:22:55.927Z","repository":{"id":40466679,"uuid":"381823298","full_name":"marcanuy/django-dynamic-breadcrumbs","owner":"marcanuy","description":"Django app to generate HTML breadcrumbs from URL paths","archived":false,"fork":false,"pushed_at":"2023-09-20T20:26:22.000Z","size":60,"stargazers_count":10,"open_issues_count":2,"forks_count":2,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-04-25T04:02:19.447Z","etag":null,"topics":["breadcrumb","breadcrumb-navigation","breadcrumbs","breadcrumbs-dynamic","django"],"latest_commit_sha":null,"homepage":"https://django-dynamic-breadcrumbs.readthedocs.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marcanuy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2021-06-30T20:20:34.000Z","updated_at":"2023-12-30T10:31:16.000Z","dependencies_parsed_at":"2024-09-30T18:07:16.767Z","dependency_job_id":"0716cb64-258c-479e-8b98-06e8e872c82f","html_url":"https://github.com/marcanuy/django-dynamic-breadcrumbs","commit_stats":{"total_commits":47,"total_committers":3,"mean_commits":"15.666666666666666","dds":0.08510638297872342,"last_synced_commit":"11f1d2719f4be462a89461788389cd5b22d5fad5"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcanuy%2Fdjango-dynamic-breadcrumbs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcanuy%2Fdjango-dynamic-breadcrumbs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcanuy%2Fdjango-dynamic-breadcrumbs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcanuy%2Fdjango-dynamic-breadcrumbs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marcanuy","download_url":"https://codeload.github.com/marcanuy/django-dynamic-breadcrumbs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248759136,"owners_count":21157097,"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":["breadcrumb","breadcrumb-navigation","breadcrumbs","breadcrumbs-dynamic","django"],"created_at":"2024-09-30T18:07:12.817Z","updated_at":"2025-04-13T18:22:55.891Z","avatar_url":"https://github.com/marcanuy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"django-dynamic-breadcrumbs\n=====\n\n[![Django CI](https://github.com/marcanuy/django-dynamic-breadcrumbs/actions/workflows/django.yml/badge.svg)](https://github.com/marcanuy/django-dynamic-breadcrumbs/actions/workflows/django.yml)\n[![Coverage Status](https://coveralls.io/repos/github/marcanuy/django-dynamic-breadcrumbs/badge.svg?branch=main)](https://coveralls.io/github/marcanuy/django-dynamic-breadcrumbs?branch=main)\n[![PyPI version](https://img.shields.io/pypi/v/django-dynamic-breadcrumbs)](https://pypi.org/project/django-dynamic-breadcrumbs/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Downloads](https://static.pepy.tech/badge/django-dynamic-breadcrumbs)](https://pepy.tech/project/django-dynamic-breadcrumbs)\n[![Documentation Status](https://readthedocs.org/projects/django-dynamic-breadcrumbs/badge/?version=latest)](https://django-dynamic-breadcrumbs.readthedocs.io/en/latest/?badge=latest)\n\n`django-dynamic-breadcrumbs` is a Django app to generate HTML breadcrumbs\ndynamically from URL paths.\n\nAt `https://example.com/reference/instrument/guitar/`, shows:\n`Home \u003e Reference \u003e Instrument \u003e Guitar`.\n\n# Quick start\n\n## 1. Install\n\n~~~\npip install django-dynamic-breadcrumbs\n~~~\n\n## 2. Add to settings\n\nAdd \"dynamic_breadcrumbs\" label to your INSTALLED_APPS settings:\n\n    INSTALLED_APPS = [\n        ...\n        'dynamic_breadcrumbs',\n    ]\n\nAdd `dynamic_breadcrumbs.context_processors.breadcrumbs` to **context_processors**:\n\n~~~ python\nTEMPLATES = [\n    {\n        \"BACKEND\": \"django.template.backends.django.DjangoTemplates\",\n        \"DIRS\": [os.path.join(BASE_DIR, \"templates\")],\n        \"APP_DIRS\": True,\n        \"OPTIONS\": {\n            \"context_processors\": [\n\t\t\t\t#...\n                \"dynamic_breadcrumbs.context_processors.breadcrumbs\",\n            ],\n        },\n    },\n]\n~~~\n\n## 3. Add template\n\nInclude the `dynamic_breadcrumbs/breadcrumbs.html` in your base template.\n\n~~~\n{% if breadcrumbs %}\n\u003cdiv class=\"container\"\u003e\n    {% include \"dynamic_breadcrumbs/breadcrumbs.html\" with breadcrumbs=breadcrumbs%}\n\u003c/div\u003e\n{% endif %}\n~~~\n\nNow each time you visit a page which makes use of the above template,\nit will have the breadcrumbs generated from the URL path.\n\n## 4. (Optional) Customization\n\nTweak default [settings](https://django-dynamic-breadcrumbs.readthedocs.io/en/latest/ref/settings.html).\n\n# Example site\n\nThere is an example site to see how it works at [example_site](https://github.com/marcanuy/django-dynamic-breadcrumbs/tree/main/example_site). To\nrun it, in `example_site` directory: \n\n1. Create db: `python manage.py migrate`\n2. Load fixtures `python manage.py loaddata fixtures.json`\n3. Run the server `python manage.py runserver`\n\nNote: Fixtures were created with a sample database with `./manage.py  dumpdata --all --format json -o fixtures.json`.\n\n# Documentation\n\nFull docs at: https://django-dynamic-breadcrumbs.readthedocs.io/\n\n# License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcanuy%2Fdjango-dynamic-breadcrumbs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarcanuy%2Fdjango-dynamic-breadcrumbs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcanuy%2Fdjango-dynamic-breadcrumbs/lists"}