{"id":15295938,"url":"https://github.com/paulino/django-bootstrap-sidebar","last_synced_at":"2025-06-30T06:03:53.204Z","repository":{"id":41329324,"uuid":"452835897","full_name":"paulino/django-bootstrap-sidebar","owner":"paulino","description":"Collapsible Sidebar using Bootstrap for Django","archived":false,"fork":false,"pushed_at":"2024-09-07T14:09:04.000Z","size":476,"stargazers_count":16,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-09T13:42:35.879Z","etag":null,"topics":["bootstrap","bootstrap5","django-template","theme"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paulino.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2022-01-27T20:36:05.000Z","updated_at":"2025-04-09T10:20:30.000Z","dependencies_parsed_at":"2024-04-01T18:52:10.517Z","dependency_job_id":null,"html_url":"https://github.com/paulino/django-bootstrap-sidebar","commit_stats":{"total_commits":6,"total_committers":2,"mean_commits":3.0,"dds":"0.16666666666666663","last_synced_commit":"e95e307bc7bdeda659b9bdf8bdd9ea05114d21e2"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulino%2Fdjango-bootstrap-sidebar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulino%2Fdjango-bootstrap-sidebar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulino%2Fdjango-bootstrap-sidebar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulino%2Fdjango-bootstrap-sidebar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paulino","download_url":"https://codeload.github.com/paulino/django-bootstrap-sidebar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248760784,"owners_count":21157429,"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":["bootstrap","bootstrap5","django-template","theme"],"created_at":"2024-09-30T18:08:39.803Z","updated_at":"2025-04-13T18:34:15.430Z","avatar_url":"https://github.com/paulino.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Collapsible Sidebar Using Bootstrap for Django\n\n*Collapsible Sidebar Using Bootstrap* is a base template with a bootstrap simple\ncustomization in self-hosted mode (non-CDN).\n\nFeatures:\n\n- Bootstrap 5.3\n- Django 4\n- Included demo at [example folder](example)\n- Templates included:\n  - bootstrap_base.html\n  - snippets/show_err.html\n  - snippets/show_messages.html\n- Templates overridden:\n  - registration/login.html\n  - registration/password_change_form.html\n  - 403.html\n  - 404.html\n  - 500.html\n- Bootstrap customization available at bootstrap-theme directory.\n- Custom font from google-fonts in local static files.\n\nBootstrap theme and fonts are customizable using scripts included. See details\n[bellow](#customize-bootstrap-theme).\n\n## Testing templates with example/demo\n\nAn example is included in the [example folder](example) with a Makefile to\ninitialize the project and preview the templates. More details in \n[example/README](example/README.md)\n\n## Template preview\n\n![Frontpage preview](doc/front-page.png)\n\n![Secondary page preview](doc/secondary-page.png)\n\n\n## Installation\n\nThe preferred way to install is via pip\n\n    pip3 install django-bootstrap-sidebar\n\nbut you can install in develop mode cloning this repo but static files are not\nincluded in the repo. See *Customize bootstrap theme section* for details.\n\nAfter installing your Django instance in `settings.py`, add `bootstrapsidebar`\nbefore `django.contrib.auth` since some auth templates are overridden.\n\n```python\nINSTALLED_APPS = [\n    'bootstrapsidebar'\n    'django.contrib.auth',\n    ...\n]\n```\n\n## Blocks available in page layout\n\nThe base template (`bootstrap_base.html`) includes the following hierarchical\nblocks:\n\n- *block custom-css*\n- *block head*\n- *block page-wrapper*: to override full page, included sidebar.\n  - *block sidebar*\n  - *block navbar*: to override top navbar\n    - *navbar-links*: only to add links in default template navbar.\n  - *block messages*: by default this block uses `snippets/show_messages.html`\n  - *block content*\n  - *block footer*\n- *block after-bootstrap-js*: used to run extra javascript like to enable\n   Bootstrap Popovers. [See below details](#enable-bootstrap-popovers)\n\nThe `registration/login.html` is an example of page using base-template without\nsidebar.\n\n## Customize bootstrap theme\n\nInstall the package in dev mode is recommended if you want to customize the\nBootstrap Theme. First clone this repo and install in dev mode:\n\n    pip install -e ./django-bootstrap-sidebar\n\nBootstrap static files and fonts are not included in the repo. They are\ngenerated/downloaded with the commands of makefile but the *node* environment\nand `npm` are required.\n\nBootstrap can be customized at file `bootstrap-theme/custom.scss`. An easy way\nto create a new customization is some online theme builder\nlike \u003chttps://bootstrap.build/\u003e and download the *custom.scss*.\n\nTo generate/upgrade static files makefile automates the process, run make:\n\n    make\n\n## Enable Bootstrap Popovers\n\nDue performance reasons popovers are not default enabled. One way is to enable\npopovers everywhere, which requires an extra javascript after the Bootstrap\njavascript. The last solution is not optimal, but it is a simple way, a detailed\ninstructions are available at [Bootstrap\nPopovers](https://getbootstrap.com/docs/5.2/components/popovers/)\n\nThe block `after-bootstrap-js` is intended  to enable popovers and\nthe following code snippet from Bootstrap can be used:\n\n```html\n{% block after-bootstrap-js %}\n\u003cscript\u003e\nconst popoverTriggerList = document.querySelectorAll('[data-bs-toggle=\"popover\"]')\nconst popoverList = [...popoverTriggerList].map(popoverTriggerEl =\u003e new bootstrap.Popover(popoverTriggerEl))\n\u003c/script\u003e\n{% endblock %}\n```\n\nA full example is included in the example folder in page  \n[popovers.html](example/app/templates/popovers.html)\n\n## License\n\nThe project is licensed under the Apache 2.0 license.\n\n## Author\n\nDeveloped and maintained by Paulino Ruiz de Clavijo Vázquez \u003cpruiz@us.es\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulino%2Fdjango-bootstrap-sidebar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaulino%2Fdjango-bootstrap-sidebar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulino%2Fdjango-bootstrap-sidebar/lists"}