{"id":7176,"library":"django-sekizai","title":"Django Sekizai","description":"Django Sekizai (meaning \"blocks\" in Japanese) is a Django application that provides enhanced template block functionality. It allows developers to define placeholders where content blocks are rendered and, from various places in sub-templates, append unique content to those blocks. This is particularly useful for managing CSS and JavaScript dependencies across complex template structures, ensuring that media files are placed correctly (e.g., CSS in the head, JS at the bottom) and duplicates are automatically ignored. The library is currently at version 4.1.0 and is actively maintained by the django CMS Association, with regular releases aligning with Django's own release cycle.","status":"active","version":"4.1.0","language":"en","source_language":"en","source_url":"https://github.com/django-cms/django-sekizai","tags":["django","templates","frontend","css","javascript","blocks","media management","cms"],"install":[{"cmd":"pip install django-sekizai","lang":"bash","label":"Install stable version"}],"dependencies":[{"reason":"Core framework dependency, Sekizai is a Django application.","package":"Django","optional":false}],"imports":[{"note":"Used directly in Django templates to enable Sekizai functionality.","symbol":"sekizai_tags","correct":"{% load sekizai_tags %}"},{"note":"Required for custom views or unit tests that render templates, especially in newer Django versions (1.8+) or when `sekizai.context_processors.sekizai` is not in TEMPLATES settings. Using `RequestContext` or not providing SekizaiContext will result in template errors [6, 14].","wrong":"from django.template import RequestContext","symbol":"SekizaiContext","correct":"from sekizai.context import SekizaiContext"},{"note":"The Sekizai application itself needs to be registered in Django's INSTALLED_APPS.","symbol":"sekizai","correct":"INSTALLED_APPS = [\n # ...\n 'sekizai',\n]"},{"note":"Add this context processor to your TEMPLATES setting to make Sekizai functionality available in all templates rendered with a RequestContext [1, 3, 10].","symbol":"sekizai.context_processors.sekizai","correct":"TEMPLATES = [\n {\n 'BACKEND': 'django.template.backends.django.DjangoTemplates',\n 'APP_DIRS': True,\n 'OPTIONS': {\n 'context_processors': [\n # ...\n 'sekizai.context_processors.sekizai',\n ],\n },\n },\n]"}],"quickstart":{"code":"# settings.py\nINSTALLED_APPS = [\n # ...\n 'sekizai',\n]\n\nTEMPLATES = [\n {\n 'BACKEND': 'django.template.backends.django.DjangoTemplates',\n 'APP_DIRS': True,\n 'OPTIONS': {\n 'context_processors': [\n 'django.template.context_processors.debug',\n 'django.template.context_processors.request',\n 'django.contrib.auth.context_processors.auth',\n 'django.contrib.messages.context_processors.messages',\n 'sekizai.context_processors.sekizai', # Add Sekizai context processor\n ],\n },\n },\n]\n\n# base.html (or your main template)\n{% load sekizai_tags %}\n\n\n\n My App\n {% render_block \"css\" %}\n\n\n

\n {% block content %}{% endblock %}\n \n\n\n\n# my_app/templates/my_app/detail.html\n{% extends 'base.html' %}\n{% load sekizai_tags %}\n\n{% block content %}\n

Welcome

This is my content.

\n\n {% addtoblock \"css\" %}\n \n {% endaddtoblock %}\n\n {% addtoblock \"js\" %}\n \n \n {% endaddtoblock %}\n{% endblock %}","lang":"python","description":"To get started with django-sekizai, first add 'sekizai' to your `INSTALLED_APPS` and include `'sekizai.context_processors.sekizai'` in your `TEMPLATES` context processors. In your base template, define where your CSS and JavaScript blocks should be rendered using `{% render_block \"css\" %}` and `{% render_block \"js\" %}`. Then, in any extending or included templates, use `{% addtoblock \"css\" %}` and `{% addtoblock \"js\" %}` to inject content into these defined blocks. Sekizai will ensure unique entries and proper placement."},"warnings":[{"fix":"This is intended behavior for deduplication. If you need content to render multiple times, consider dynamic generation or different namespaces.","message":"Sekizai enforces uniqueness of content within a block namespace. If you add the same content (e.g., a `