############## Dojo Bootstrap ##############
Bootstrap theme for Dojo.
.. image:: https://raw.github.com/martinpengellyphillips/dbootstrap/master/resource/preview.png
For a live preview of the theme using Dojo's Theme Tester, see http://martinpengellyphillips.github.com/dbootstrap/
Download
Just want the theme for your project? Grab the latest built version from the
releases <https://github.com/martinpengellyphillips/dbootstrap/releases>
_ page:
project and ensure you notify Dojo about the location. One way to do this is through the Dojo config::
'packages': [
...,
{
location: '/path/to/dbootstrap',
name: 'dbootstrap'
}
]
Dijit widgets are loaded for the icons to work correctly::
require(['dbootstrap', ...], function(dbootstrap) {
// Start application.
});
<body>
element::<body class='dbootstrap'>
Get The Code
$ git clone --recursive git://github.com/martinpengellyphillips/dbootstrap.git
Building / Integration
To build the project locally you will need the following installed:
Python <http://www.python.org>
_ >= 2.6, <3Nodejs <http://www.nodejs.org>
_ >= 10.5Stylus <http://learnboost.github.io/stylus/>
_ >= 0.31Java <http://www.java.com>
_ >= 7.0 (aka 1.7.0)All other requirements are bundled as git submodules so make sure you have
initialised them (the default when using --recursive
with git clone
)
To build the demo locally:
$ cd /path/to/dbootstrap
$ python build.py demo
.. note::
If you like to see what is going on under the hood, run with a lower
logging level::
$ python build.py -v debug demo
$ cd build/demo
$ python -m SimpleHTTPServer 8000
Point your browser at http://localhost:8000/
Useful if you just want a quick play of the theme with your project. For a better solution see the integrated build below.
$ cd /path/to/dbootstrap
$ python build.py theme
.. note::
If you like to see what is going on under the hood, run with a lower
logging level::
$ python build.py -v debug theme
into the appropriate location in your project and ensure you notify Dojo about the location. One way to do this is through the Dojo config::
'packages': [
...,
{
location: '/path/to/dbootstrap',
name: 'dbootstrap'
}
]
before any Dijit widgets are loaded for the icons to work correctly::
require(['dbootstrap', ...], function(dbootstrap) {
// Start application.
});
<body class='dbootstrap'>
(typically so that it is a sibling to your Dojo and Dijit packages). You will also need to link the xstyle and nib packages if you don't already have them.
.. note::
Only tested with Dojo 1.8+
package and separate build layer::
packages: [
...
'dbootstrap',
'xstyle'
],
layers: {
...
'dbootstrap/main': {
include: [
'dbootstrap/main',
'xstyle/load-css'
],
}
}
.. note::
If you have placed your dbootstrap package somewhere that isn't
directly accessible as a child directory of your *basePath* then you
must use the fuller package syntax in the packages list::
{
location: '/path/to/dbootstrap',
name: 'dbootstrap'
}
package before any Dijit widgets are loaded::
require(['dbootstrap', ...], function(dbootstrap) {
// Start application.
});
<body class='dbootstrap'>
into one dbootstrap.css file::
$ stylus --include path/to/dbootstrap/nib/lib \
--include path/to/dbootstrap/theme/dbootstrap \
path/to/dbootstrap/theme/dbootstrap/index.styl
$ mv path/to/dbootstrap/theme/dbootstrap/index.css \
path/to/dbootstrap/theme/dbootstrap/dbootstrap.css
.. note::
The CSS build must happen before the Dojo build is performed as the
generated css file is required as part of the build. Therefore, the css
file is built in the source tree to be copied to the build directory
during the Dojo build step.
Community
Bugs or enhancements can be reported by opening an issue at https://github.com/martinpengellyphillips/dbootstrap/issues.
When reporting a bug, please try to provide the following information:
* Affected browsers and Dojo versions.
* A clear list of steps to reproduce the problem.
* If the problem cannot be easily reproduced then please include an example
reduced test case (for example, as a `Gist <https://gist.github.com>`_).
If you would like to propose a fix for a particular issue then you are welcome
to fork dbootstrap, create a branch and submit a pull request. Please note that
a Dojo CLA <http://www.dojofoundation.org/about/cla>
_ is required for any
non-trivial modifications.
Copyright and license
Copyright (c) 2012-2013 Martin Pengelly-Phillips
Available under either the terms of the modified BSD license or the Apache License, Version 2.0. As a recipient of dbootstrap, you may choose which license to receive this code under.
The text of the BSD and Apache License, Version 2.0 licenses is available in the LICENSE.txt file.
The icons are provided by the excellent Font-Awesome team at http://fortawesome.github.com/Font-Awesome/