twitter bootstrap make from source

Question

So I am trying to \"build\" twitter bootstrap from source git://github.com/twitter/bootstrap.git and I git clone it to my local machine.

Obviously, on my local machi

Answer 1

You should download some node packages first

Try

sudo npm install recess

and then

sudo npm install jshint

Then use

make bootstrap

in the directory of the MakeFile

Answer 2

This might be handy for some of you. See Readme for usage/options. Its a simple batch to compile up bootstrap from source on Windows. https://github.com/chazelton/bootstrap. You can also just grab "make.bat" if you like and drop it in your downloaded source. It is forked here for convenience. Basic usage below

C:\projects\bootstrap>make (would create sub dir "build" with css, js, img dirs)
C:\projects\bootstrap>make -c (combines bootstrap/responsive to one file)
C:\projects\bootstrap>make -l (outputs source less files under css dir)

See additional options in readme on GitHub...

NOTE: requires UglifyJs and Less to be installed via npm globally so => npm install less -g. The batch will prompt you if these are missing. However you'll need to install them manually.

Answer 3

If anyone is looking for an alternative to make for building Bootstrap (especially since make is not Windows friendly), there's a build system for Bootstrap with Grunt.js

For the most part it produces the same results as the makefile. The grunt-contrib-qunit task will add better support for qunit/phantomjs when grunt 0.4.0 is released (found here: https://github.com/gruntjs/grunt-contrib-qunit) . Until then you can still work with the built in Grunt tasks for testing.

Answer 4

Not an expert on this by any stretch of the imagination (just started to play around with Twitter bootstrap as well), but I get a similar output as you when I just run make. However, if you run make bootstrap it generates a folder entitled bootstrap that contains the compiled css as far as I can tell:

make bootstrap
mkdir -p bootstrap/img
mkdir -p bootstrap/css
mkdir -p bootstrap/js
cp img/* bootstrap/img/
lessc ./less/bootstrap.less > bootstrap/css/bootstrap.css
lessc --compress ./less/bootstrap.less > bootstrap/css/bootstrap.min.css
lessc ./less/responsive.less > bootstrap/css/bootstrap-responsive.css
lessc --compress ./less/responsive.less > bootstrap/css/bootstrap-responsive.min.css
cat js/bootstrap-transition.js js/bootstrap-alert.js js/bootstrap-button.js js/bootstrap-carousel.js js/bootstrap-collapse.js js/bootstrap-dropdown.js js/bootstrap-modal.js js/bootstrap-tooltip.js js/bootstrap-popover.js js/bootstrap-scrollspy.js js/bootstrap-tab.js js/bootstrap-typeahead.js > bootstrap/js/bootstrap.js
uglifyjs -nc bootstrap/js/bootstrap.js > bootstrap/js/bootstrap.min.js

The new bootstrap directory (bootstrap/bootstrap) contains the following:

bootstrap/css:
- bootstrap-responsive.css
- bootstrap-responsive.min.css
- bootstrap.css
- bootstrap.min.css

bootstrap/img:
- glyphicons-halflings-white.png
- glyphicons-halflings.png

bootstrap/js:
- bootstrap.js
- bootstrap.min.js

This might be an issue with the documentation, leaving out the correct command, but I'm not sure. My memory of how a Makefile works is if you issue make without a target, it defaults to the first target in the makefile. In this case, that target is docs instead of bootstrap.

I think you can then just copy the contents of the new bootstrap directory to wherever you would normally put the css/js assets for your project.

Answer 5

I have gnuwin32 installed and on my path, and I've npm install-ed uglifyjs, recess, and jshint. I then made the following additions to the top of the Makefile:

SHELL=c:/windows/system32/cmd.exe
MKDIR=mkdir.exe -p
UGLIFYJS=uglifyjs
RECESS=recess
JSHINT=jshint

The first line (SHELL=) fixes this problem:

w:\github\bootstrap>make bootstrap
mkdir.exe -p bootstrap/js
make: Interrupt/Exception caught (code = 0xc00000fd, addr = 0x4227d3)

the second line (MKDIR=) is to prevent the dos mkdir command being used (which doesn't understand the -p flag).

Then a global search/replace on all the executable references:

-       mkdir -p bootstrap/js
+       $(MKDIR) bootstrap/js
        cat js/bootstrap-transition.js js..
-       ./node_modules/.bin/uglifyjs -nc...
+       $(UGLIFYJS) -nc bootstrap/js/boot..
etc.

Now make bootstrap finishes without any problems.