inki/bootunstrap

maintainable Bootstrap integration made easy

Bootunstrap

Information:

Bootstrap based project that keeps Bootstrap as a separate submodule., _(*1)

Basically, this allows you to modify the local versions of variables.less, bootstrap.less and responsive.less (or even override other bootstrap .less files) while keeping the original bootstrap repository isolated and easily updateable (without crazy merges and such)., _(*2)

Once you make changes to your own variables.less file, simply run $ ./build.sh bootstrap, _(*3)

If there's an update to bootstrap, run $ ./build.sh update and re-build $ ./build.sh bootstrap, _(*4)

Your changes remain intact, as long as no major architectural changes have happened in bootstrap., _(*5)

Dependancies:

You'll need to have Git and NodeJS installed along with the following Node Packages:, _(*6)

Recess - A simple and attractive code quality tool for CSS built on top of LESS, _(*7)

UglifyJS - JavaScript parser / mangler / compressor / beautifier library for NodeJS, _(*8)

ShellJS - Portable Unix shell commands for Node.js, _(*9)

$ sudo npm install recess uglify-js shelljs -g

*The build script that currently does all the build magic is written as a shell script so it may only work in *NIX sytems (should work with cygwin but haven't fully tested this.), _(*10)

You'll want to make sure your NODE_PATH environment variable is set up, _(*11)

$ echo 'export NODE_PATH="'$(npm root -g)'"' >> ~/.bashrc && . ~/.bashrc

In my case, I use ~/.profile so I actually use..., _(*12)

$ echo 'export NODE_PATH="'$(npm root -g)'"' >> ~/.profile && . ~/.profile

QUICK-START

Checkout the Bootunstrap project and build, _(*13)

$ git clone https://github.com/inkidotcom/bootunstrap.git bootunstrap
$ cd bootunstrap
$ git submodule update --init
$ ./build.sh bootstrap

open index.html in your browser, _(*14)

Build Script

You can run the build script without any options and you will be presented with the currently available options clean, bootstrap, update or quit, _(*15)

$ ./build.sh

Or, you can run a command directly by passing it as an argument, _(*16)

$ ./build.sh bootstrap

Commands:

clean

removes local Bootstrap files (css/bootstrap, img/bootstrap, js/bootstrap), _(*17)

$ ./build.sh clean, _(*18)

bootstrap

compiles Bootstrap css and js and copies over Bootstrap img assets, _(*19)

$ ./build.sh bootstrap, _(*20)

update

updates Bootstrap to master or branch as specified by second parameter, _(*21)

$ ./build.sh update $ ./build.sh update 2.2.2-wip, _(*22)

Authors:

Manny Ramirez, _(*23)

• twiter
• github

Copyright and license

Copyright 2012 Manny Ramirez., _(*24)

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at, _(*25)

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License., _(*26)