Skip to main content
Help us improve Python packaging – donate today!

a theme for Pinax based on Twitter's Bootstrap

Project Description

Twitter Bootstrap Theme, for Pinax
==================================

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.


Navigation
----------

To modify your site's navigation bar, implement the "nav" block in
your site_base.html using the following pattern: ::

<ul class="nav navbar-nav">
<li id="tab_first">
<a href="#">First Link</a>
</li>
<li id="tab_second">
<a href="#">Second Link</a>
</li>
<li id="tab_third" class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">
Some Dropdown Menu
<b class="caret"></b>
</a>
<ul class="dropdown-menu">
<li><a href="#">Some Link</a></li>
<li><a href="#">Another Link</a></li>
</ul>
</li>
</ul>


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 <http://glyphicons.com/>`_, licensed
under `CC BY 3.0 <http://creativecommons.org/licenses/by/3.0/>`_.

Includes icons from
`Font Awesome <http://fortawesome.github.io/Font-Awesome/>`_.


.. _django-bootstrap-form: https://github.com/tzangms/django-bootstrap-form
.. _official migration guide: http://getbootstrap.com/getting-started/#migration
.. _PaginationTemplate: https://github.com/pinax/pinax-theme-bootstrap/blob/master/pinax_theme_bootstrap/templates/pagination/pagination.html
.. _django-pagination: https://github.com/ericflo/django-pagination

Release history Release notifications

History Node

8.0.1

History Node

8.0.0

History Node

7.11.0

History Node

7.10.2

History Node

7.10.1

History Node

7.10.0

History Node

7.9.0

History Node

7.8.0

History Node

7.7.0

History Node

7.6.0

History Node

7.5.0

History Node

7.4.0

History Node

7.3.0

History Node

7.2.0

History Node

7.1.1

History Node

7.1.0

History Node

7.0.0

History Node

6.2.0

History Node

6.1.1

History Node

6.1.0

History Node

6.0.0

History Node

5.7.6

History Node

5.7.5

History Node

5.7.4

History Node

5.7.3

History Node

5.7.2

History Node

5.7.1

History Node

5.7.0

History Node

5.6.0

History Node

5.5.1

History Node

5.5.0

History Node

5.4.0

History Node

5.3.0

History Node

5.2.1

History Node

5.2.0

History Node

5.1.0

This version
History Node

5.0.3

History Node

5.0.2

History Node

5.0.1

History Node

5.0.0

History Node

4.0.1

History Node

4.0

History Node

3.0

History Node

3.0a12

History Node

3.0a11

History Node

3.0a10

History Node

3.0a9

History Node

3.0a8

History Node

3.0a7

History Node

3.0a6

History Node

3.0a5

History Node

3.0a4

History Node

3.0a3

History Node

3.0a2

History Node

3.0a1

History Node

2.2.2

History Node

2.2.1

History Node

2.2.0

History Node

2.0.4

History Node

2.0.3

History Node

2.0.2.post3

History Node

2.0.2.post2

History Node

2.0.2.post1

History Node

2.0.2

History Node

2.0.1.1

History Node

2.0.1

History Node

2.0.1b1

History Node

0.2.1

History Node

0.2

History Node

0.2b2

History Node

0.2b1

History Node

0.2a2

History Node

0.1.7

History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1

History Node

0.1.dev2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pinax-theme-bootstrap-5.0.3.tar.gz (515.4 kB) Copy SHA256 hash SHA256 Source None Jan 17, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page