Skip to main content

a theme for Pinax based on Twitter's Bootstrap

Project description

A theme for Pinax based on Twitter’s open source Bootstrap framework.

Quick Start

Include “pinax-theme-bootstrap” in your requirements file and include “pinax_theme_bootstrap” and “bootstrapform” (which is installed alongside this theme) in your INSTALLED APPS.

Make sure both template loaders and staticfiles finders includes app directories.

Site name comes from Sites fixture.

Your “site_base.html” should extend “theme_bootstrap/base.html” and should provide “footer” and “nav” blocks (the latter should just be a ul of li of a links).

Your pages should have blocks “head_title” and “body” and should extend “site_base.html”.

The url name “home” should be defined as the homepage.

Upgrade Notes

  • To upgrade an existing site running on the prior version of this theme, it is recommended that you read through the official migration guide.

  • Forms Rendering: Versions prior to 4.0 used django-forms-bootstrap. We have switched this app to django-bootstrap-form so you’ll need to make the necessary updates to your templates and INSTALLED_APPS.

Requirements

This theme is officially supported when used in conjunction with Pinax starter projects. If using the theme with Django < 1.4, you will need to install a recent version of django-staticfiles as we use the {% render %} template tag.

Pagination

This theme supports both django-pagination and Django builtin pagination. See PaginationTemplate for information how to switch between them.

Roadmap

The 2.x line of pinax-theme-bootstrap with support for Pinax 0.9 will soon be phased out of major updates. We will be releasing a 3.x line that will break backwards compatibility but fully support Pinax 1.0 projects. This is a change towards a more semantic versioning strategy in lieu of merely indicating which version of Bootstrap media is included. The 4.x line now supports Bootstrap 3.0, while the 3.x line supports Bootstrap 2.x.

License & Attribution

The Pinax Bootstrap theme is released under the MIT license.

This theme includes styles and scripts from the Twitter Bootstrap project, which is released under the Apache License, Version 2.0.

For copies of both licenses, see LICENSE.

Includes icons from Glyphicons Free, licensed under CC BY 3.0.

Includes icons from Font Awesome.

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

pinax-theme-bootstrap-5.0.3.tar.gz (515.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page