SlickGrid BootStrap support
Support to make SlickGrid work with Twitter Bootstrap styles.
Please visit the live demo.
SlickGrid is an advanced JavaScript grid/spreadsheet component
To learn about SlickGrid, please check out the SlickGrid wiki.
Installation
The package can be installed easily with bower.
$ bower install slickgrid-bootstrap
Running the examples locally
You can now load
components/slickgrid-bootstrap/examples/example-bootstrap.html from your browser.
Alternate installation
If instead of bower, you would like to use an alternative installation method,
clone the repository from git, and further process it, according to your
specific needs.
$ git clone git://github.com/reebalazs/SlickGrid-bootstrap.git
Development
For development of the package itself, or for running the examples, you need to have NodeJS and npm (the Node Package Manager) already installed on your system.
Following this, the installation happens in two phases: first the NodeJS, then the front-end packages will be installed from their respective repositories.
Installing NodeJS modules
We will install the modules locally. First please make sure that you have not installed any packages locally to the current directory or any of the subdirectories. (Please also read the next section about the local package binaries.)
Then you can use npm to install both the sources and the necessary node tools, and change
your working directory to the place of the installation:
$ npm install git+https://github.com/reebalazs/SlickGrid-bootstrap.git
$ cd node_modules/slickgrid-bootstrap-dev
Alternately, if you have already checked out these sources from git, you can go to this directory and install it locally with npm:
$ git clone https://github.com/reebalazs/SlickGrid-bootstrap.git
$ cd slickgrid-bootstrap-dev
$ npm install .
Both methods ended up installing executables in the
node_modules/.bin directory. You can add this location to your path. (Note that this has an effect only on the current shell.)
$ export PATH=$PWD/node_modules/.bin:$PATH
Following this, you will be able to execute the installed commands grunt, bower, and
so on, without specifying their exact execution path each time.
Local package binaries
Due to the way npm works, this directory will only hold the executables from those
packages that were pulled in as a dependancy from our package, and have not been
previously installed. If you have previously installed some package, it will
be where you have installed it, and it will only be executable if you have
made it so (globally installed modules are in the global system path, locally installed
modules will be in their respective .bin directories, and should have been
added to the path previously.) This should not normally
be a concern for you, but may be the reason for not being to able to execute
binaries provided by some package that otherwise is installed correctly.
Installing front-end components
We will use bower for the installation. You can use your favourite front-end
package manager if you know what you are doing, and you update Gruntfile.js
appropriately.
In the following, install the front-end dependencies into the components directory:
$ bower install
Following this, build the resources needed for the examples.
$ grunt
If you want to develop, you can start grunt in watch mode:
$ grunt watch
This will rebuild the example resources each time any of their sources changes.
Running the example demo
You can now load examples/example-bootstrap.html from your browser.