Base templates for Django that adhere to ASU Web Standards.
Project description
This project provides base templates for use in Django apps that need to conform to the ASU University Web Design Standards.
It relies on the assets created by the ASU Web Standards Bootstrap project provided by the Global Institute of Sustainability.
Installation & Usage
Install using pip (or easy_install):
pip install django-asutheme
Add 'asutheme' to your INSTALLED_APPS:
INSTALLED_APPS = ( ... 'django.contrib.admin', 'asutheme', )
Add 'asutheme.context_processors.container_style' to your list of context processors. By default the containers are fixed, if you would like them to be fluid add to your settings file. ASU_THEME_FLUID = True to your settings file.
You can now extend the base template and add to/override defined blocks:
{% extends 'asutheme/base.html' %} {% block asu_site_title_main %} <a href="https://lib.asu.edu" title="Arizona State University - Libraries">ASU Libraries</a> {% endblock %} {% block navbar_content %} <li><a href="/media">Media</a></li> {% endblock %} {% block super_footer_brand %} <img src="/static/images/libraries_logo_footer.png" alt="ASU Libraries Logo"> <address> ... </address> {% endblock %}
Blocks and Layout Order
The base template defines the followig blocks, listed in the order that the renderer applies them. Most blocks are empty unless otherwise noted. Child blocks names appear indented under their parent. Be careful when overriding parent blocks, as this effectively wipes out any customized content in child blocks.
html_attrs: interpolated inside the HTML opening tag.
title: appears under the TITLE element.
extratitle: appears under the TITLE element.
extrastyle: appears under the HTML>HEAD element.
extrahead: appears under the HTML>HEAD element.
body_attrs: interpolated under the BODY opening tag
asu_main_header: appears under HTML>HEAD, after the standard ASU header section
asu_login_link: (non-empty) ASU login/logout link inside the subhead navbar.
site_name: Section that identifies the name your site/web application. Not to be confused with a page title.
asu_site_title_main
asu_site_title_extra
navbar: The main navbar section. See Bootstrap v3 docs for more info: https://getbootstrap.com/components/#navbar
navbar_brand_link_text: brand text
navbar_content: appears under a navbar UL element. Customize by adding LI elements.
main_content: The page-specific body of the page. Appears under DIV#content.site-content element.
footer: top-level container for the “super footer” (for site-specific content) and the “global footer” (ASU standard content that appears on the bottom of every page).
super_footer:
super_footer_brand_col: Leftmost column of the super footer row. Column width is .col-md-4.col-sm-12.
super_footer_brand: brand text to appear in the left-most column of the site-specific footer.
super_footer_content: blank block that appears ender the super-footer after the brand column. Note: since this block appears in a .row you will want to put any custom content in a bootstrap “column”, e.g. <div class=".col-md-8">my footer content</div>
global_footer: (non-empty): the ASU Standard footer. You probably don’t want to override this.
extrajs: section for adding SCRIPT includes.
google_analytics: (non-empty) google analytics init script. Override with empty block to remove analytics gathering.
google_analytics_tracking_id: override w/ your google analytics API key
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_asutheme3-0.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d0f2b21f4b600c7dfca5e7b55499f6f770f964b67df02f4396cf83ac103e2efb |
|
MD5 | 18ded2f4bd6097485255158f5f603080 |
|
BLAKE2b-256 | c7e16d2a42ddfacdd58cab0a1f3c8d2c7c1d50e6a8e1d4aa332001f31c75a2e1 |