bootstrap-builder

Bootstrap Builder allows you to create override files in a subdirectory of bootstrap/less/ thus keeping the source files unchanges and easy to update from upstream.

Usage

java -jar bootstrap-builder-<version>-jar-with-dependencies.jar source_dir override_dir output_dir

Prerequisites

• JRE 8 is not required but is highly reccomended as JRE6 is EOL
• JRE 8: openjdk or oracle
• maven 3

Quick start

• Clone the repo: git clone git@github.com:kmulvey/bootstrap-builder.git.
• mvn install
• creating the binary jar: mvn clean compile assembly:single

Override file format

The format of this file looks similar to a diff file and tweaking an actual diff is a good way to get started.

• Remove a property: line begins with a '-': - margin-left: 20px;

• Add a property: line begins with a '+': + background: #333;

• Remove a block: selector line begins with a '-'. There is no need to give the contents of the block as we are simply going to find that selector and remove the whole thing.

It is important that there not be any space in front of the +/-, they cannot have space or tabs before them.

-.well-small {
}

• Add a block: selector line begins with a '+'.

+.well-large {
		padding: 24px;
		.border-radius(6px);
}

• When changing a nested selector be sure to correctly specify the parent selectors

.btn{
		&:focus {
-		.tab-focus();
+		outline: none;
		}
}

• A complete example

.well {
-	margin-bottom: 20px;
-	background-color: @wellBackground;
-	border: 1px solid darken(@well-bg, 7%);
+	border: 1px solid darken(@wellBackground, 70%);
		blockquote {
-		border-color: #ddd;
+		border-color: rgba(255, 255, 255);
		}
}
+.well-large {
	padding: 24px;
	.border-radius(6px);
}
-.well-small {
}

• Change a selector: The first selector is what you are looking for, the second is what you are replacing it with. You can still put properties in the block. Be sure to put the {} at the end of the new selector.

button
%
.btn {
+	padding: 24px;
-	.border-radius(6px);
}

input[type="checkbox"],
input[type="text"],
input[type="button"] 
%
input[type="submit"],
input[type="reset"],
input[type="button"] {}

note: do not put comments at the end of a line, put them on their own line. White space at the end of lines also breaks. These should both be fixed at somne point.

Running tests

• mvn test