a theme for Pinax based on Twitter's Bootstrap
Project description
A theme for Pinax 0.9 based on Twitter’s open source Bootstrap framework.
Quick Start
Include “pinax-theme-bootstrap” in your requirements file and “pinax_theme_bootstrap” 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_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.
Requirements
This theme is officially supported when used in conjuction with Pinax 0.9. 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.
Forms
This theme ships with a basic template tag for rendering forms that match the markup expected by Bootstrap.
To style forms, add the following to the top of your template
{% load bootstrap_tags %}
and include your form using the following markup:
<form>
<fieldset>
<legend>My Form</legend>
{% csrf_token %}
{{ form|as_bootstrap }}
<div class="form-actions">
<button type="submit" class="btn btn-primary">Save changes</button>
</div>
</fieldset>
</form>
Bootstrap includes styles for four types of forms. To change the display of your form, add one of the following class attributes to your form tag:
Name |
Class |
Description |
|---|---|---|
Vertical (default) |
.form-vertical |
Stacked, left-aligned labels over controls |
Horizontal |
.form-horizontal |
Float left, right-aligned labels on same line as controls |
Inline |
.form-inline |
Left-aligned label and inline-block controls for compact style |
Search |
.form-search |
Extra-rounded text input for a typical search aesthetic |
Upgrading from Bootstrap 1.x
Previous versions of this theme were based off of Bootstrap 1.x. The following is a list of changes that you need to be aware of when upgrading existing sites:
The default grid has changed from 16 columns to 12 columns.
Bootstrap 2 provides a responsive grid, which we’ve enabled by default.
Forms markup has changed slightly, see the example above.
Navigation bar markup now requires a class=”nav” on the ul.
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.
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
File details
Details for the file pinax-theme-bootstrap-2.0.2.post1.tar.gz.
File metadata
- Download URL: pinax-theme-bootstrap-2.0.2.post1.tar.gz
- Upload date:
- Size: 135.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | af01478e11f9a0af097ef967facc872a50175eb837fe9397c0acb55146268d80 |
|
| MD5 | e474e16401a5ec30f3eb0e55f0f4289b |
|
| BLAKE2b-256 | f71bf65eedd7807f6423ced330145222e47fd050cfb75b3e690ad93a2642724b |
