diff --git a/docs/extend.html b/docs/extend.html deleted file mode 100644 index ca482feecc07b067acef911dfdb4752c46034f73..0000000000000000000000000000000000000000 --- a/docs/extend.html +++ /dev/null @@ -1,306 +0,0 @@ -<!DOCTYPE html> -<html lang="en"> - <head> - <meta charset="utf-8"> - <title>Extend · Bootstrap</title> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta name="description" content=""> - <meta name="author" content=""> - - <!-- Le styles --> - <link href="assets/css/bootstrap.css" rel="stylesheet"> - <link href="assets/css/docs.css" rel="stylesheet"> - <link href="assets/js/google-code-prettify/prettify.css" rel="stylesheet"> - - <!-- Le HTML5 shim, for IE6-8 support of HTML5 elements --> - <!--[if lt IE 9]> - <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script> - <![endif]--> - - <!-- Le fav and touch icons --> - <link rel="apple-touch-icon-precomposed" sizes="144x144" href="assets/ico/apple-touch-icon-144-precomposed.png"> - <link rel="apple-touch-icon-precomposed" sizes="114x114" href="assets/ico/apple-touch-icon-114-precomposed.png"> - <link rel="apple-touch-icon-precomposed" sizes="72x72" href="assets/ico/apple-touch-icon-72-precomposed.png"> - <link rel="apple-touch-icon-precomposed" href="assets/ico/apple-touch-icon-57-precomposed.png"> - <link rel="shortcut icon" href="assets/ico/favicon.png"> - - </head> - - <body data-spy="scroll" data-target=".bs-docs-sidebar"> - - <!-- Navbar - ================================================== --> - <div class="navbar navbar-inverse navbar-fixed-top"> - <div class="container"> - <button type="button" class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse"> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - </button> - <a class="brand" href="./index.html">Bootstrap</a> - <div class="nav-collapse collapse"> - <ul class="nav"> - <li class=""> - <a href="./index.html">Home</a> - </li> - <li class=""> - <a href="./getting-started.html">Get started</a> - </li> - <li class=""> - <a href="./css.html">Core CSS</a> - </li> - <li class=""> - <a href="./components.html">Components</a> - </li> - <li class=""> - <a href="./javascript.html">JavaScript</a> - </li> - <li class=""> - <a href="./customize.html">Customize</a> - </li> - <li class=""> - <a href="./gallery.html">Gallery</a> - </li> - </ul> - </div> - </div> - </div> - -<!-- Subhead -================================================== --> -<header class="bs-docs-jumbotron subhead"> - <div class="container"> - <h1>Extending Bootstrap</h1> - <p class="lead">Extend Bootstrap to take advantage of included styles and components, as well as LESS variables and mixins.</p> - <div> -</header> - - <div class="container"> - - <!-- Docs nav - ================================================== --> - <div class="row"> - <div class="span3 bs-docs-sidebar"> - <ul class="nav nav-list bs-docs-sidenav"> - <li><a href="#built-with-less"><i class="glyphicon-chevron-right"></i> Built with LESS</a></li> - <li><a href="#compiling"><i class="glyphicon-chevron-right"></i> Compiling Bootstrap</a></li> - <li><a href="#static-assets"><i class="glyphicon-chevron-right"></i> Use as static assets</a></li> - </ul> - </div> - <div class="span9"> - - - - <!-- BUILT WITH LESS - ================================================== --> - <section id="built-with-less"> - <div class="page-header"> - <h1>Built with LESS</h1> - </div> - - <img style="float: right; height: 36px; margin: 10px 20px 20px" src="assets/img/less-logo-large.png" alt="LESS CSS"> - <p class="lead">Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, <a href="http://cloudhead.io">Alexis Sellier</a>. It makes developing systems-based CSS faster, easier, and more fun.</p> - - <h3>Why LESS?</h3> - <p>One of Bootstrap's creators wrote a quick <a href="http://www.wordsbyf.at/2012/03/08/why-less/">blog post about this</a>, summarized here:</p> - <ul> - <li>Bootstrap compiles faster ~6x faster with Less compared to Sass</li> - <li>Less is written in JavaScript, making it easier to us to dive in and patch compared to Ruby with Sass.</li> - <li>Less is more; we want to feel like we're writing CSS and making Bootstrap approachable to all.</li> - </ul> - - <h3>What's included?</h3> - <p>As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.</p> - - <h3>Learn more</h3> - <p>Visit the official website at <a href="http://lesscss.org">http://lesscss.org</a> to learn more.</p> - </section> - - - - <!-- COMPILING LESS AND BOOTSTRAP - ================================================== --> - <section id="compiling"> - <div class="page-header"> - <h1>Compiling Bootstrap with Less</h1> - </div> - - <p class="lead">Since our CSS is written with Less and utilizes variables and mixins, it needs to be compiled for final production implementation. Here's how.</p> - - <div class="alert alert-info"> - <strong>Note:</strong> If you're submitting a pull request to GitHub with modified CSS, you <strong>must</strong> recompile the CSS via any of these methods. - </div> - - <h2>Tools for compiling</h2> - - <h3>Node with makefile</h3> - <p>Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:</p> - <pre>$ npm install -g less jshint recess uglify-js</pre> - <p>Once installed just run <code>make</code> from the root of your bootstrap directory and you're all set.</p> - <p>Additionally, if you have <a href="https://github.com/mynyml/watchr">watchr</a> installed, you may run <code>make watch</code> to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).</p> - - <h3>Command line</h3> - <p>Install the LESS command line tool via Node and run the following command:</p> - <pre>$ lessc ./less/bootstrap.less > bootstrap.css</pre> - <p>Be sure to include <code>--compress</code> in that command if you're trying to save some bytes!</p> - - <h3>JavaScript</h3> - <p><a href="http://lesscss.org/">Download the latest Less.js</a> and include the path to it (and Bootstrap) in the <code><head></code>.</p> -<pre class="prettyprint"> -<link rel="stylesheet/less" href="/path/to/bootstrap.less"> -<script src="/path/to/less.js"></script> -</pre> - <p>To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.</p> - - <h3>Unofficial Mac app</h3> - <p><a href="http://incident57.com/less/">The unofficial Mac app</a> watches directories of .less files and compiles the code to local files after every save of a watched .less file. If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.</p> - - <h3>More apps</h3> - <h4><a href="http://crunchapp.net/" target="_blank">Crunch</a></h4> - <p>Crunch is a great looking LESS editor and compiler built on Adobe Air.</p> - <h4><a href="http://incident57.com/codekit/" target="_blank">CodeKit</a></h4> - <p>Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.</p> - <h4><a href="http://wearekiss.com/simpless" target="_blank">Simpless</a></h4> - <p>Mac, Linux, and Windows app for drag and drop compiling of LESS files. Plus, the <a href="https://github.com/Paratron/SimpLESS" target="_blank">source code is on GitHub</a>.</p> - - </section> - - - - <!-- Static assets - ================================================== --> - <section id="static-assets"> - <div class="page-header"> - <h1>Use as static assets</h1> - </div> - <p class="lead"><a href="./getting-started.html">Quickly start</a> any web project by dropping in the compiled or minified CSS and JS. Layer on custom styles separately for easy upgrades and maintenance moving forward.</p> - - <h3>Setup file structure</h3> - <p>Download the latest compiled Bootstrap and place into your project. For example, you might have something like this:</p> -<pre> - <span class="icon-folder-open"></span> app/ - <span class="icon-folder-open"></span> layouts/ - <span class="icon-folder-open"></span> templates/ - <span class="icon-folder-open"></span> public/ - <span class="icon-folder-open"></span> css/ - <span class="icon-file"></span> bootstrap.min.css - <span class="icon-folder-open"></span> js/ - <span class="icon-file"></span> bootstrap.min.js - <span class="icon-folder-open"></span> img/ - <span class="icon-file"></span> glyphicons-halflings.png - <span class="icon-file"></span> glyphicons-halflings-white.png -</pre> - - <h3>Utilize starter template</h3> - <p>Copy the following base HTML to get started.</p> -<pre class="prettyprint linenums"> -<html> - <head> - <title>Bootstrap 101 Template</title> - <!-- Bootstrap --> - <link href="public/css/bootstrap.min.css" rel="stylesheet"> - </head> - <body> - <h1>Hello, world!</h1> - <!-- Bootstrap --> - <script src="public/js/bootstrap.min.js"></script> - </body> -</html> -</pre> - - <h3>Layer on custom code</h3> - <p>Work in your custom CSS, JS, and more as necessary to make Bootstrap your own with your own separate CSS and JS files.</p> -<pre class="prettyprint linenums"> -<html> - <head> - <title>Bootstrap 101 Template</title> - <!-- Bootstrap --> - <link href="public/css/bootstrap.min.css" rel="stylesheet"> - <!-- Project --> - <link href="public/css/application.css" rel="stylesheet"> - </head> - <body> - <h1>Hello, world!</h1> - <!-- Bootstrap --> - <script src="public/js/bootstrap.min.js"></script> - <!-- Project --> - <script src="public/js/application.js"></script> - </body> -</html> -</pre> - - </section> - - </div> - </div> - - </div> - - - - <!-- Footer - ================================================== --> - <footer class="footer"> - <div class="container"> - - <div class="bs-docs-social"> - <ul class="bs-docs-social-buttons"> - <li> - <iframe class="github-btn" src="http://ghbtns.com/github-btn.html?user=twitter&repo=bootstrap&type=watch&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="100px" height="20px"></iframe> - </li> - <li> - <iframe class="github-btn" src="http://ghbtns.com/github-btn.html?user=twitter&repo=bootstrap&type=fork&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="102px" height="20px"></iframe> - </li> - <li class="follow-btn"> - <a href="https://twitter.com/twbootstrap" class="twitter-follow-button" data-link-color="#0069D6" data-show-count="true">Follow @twbootstrap</a> - </li> - <li class="tweet-btn"> - <a href="https://twitter.com/share" class="twitter-share-button" data-url="http://twitter.github.com/bootstrap/" data-count="horizontal" data-via="twbootstrap" data-related="mdo:Creator of Twitter Bootstrap">Tweet</a> - </li> - </ul> - </div> - - - <p>Designed and built with all the love in the world by <a href="http://twitter.com/mdo" target="_blank">@mdo</a> and <a href="http://twitter.com/fat" target="_blank">@fat</a>.</p> - <p>Code licensed under <a href="http://www.apache.org/licenses/LICENSE-2.0" target="_blank">Apache License v2.0</a>, documentation under <a href="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>.</p> - <p><a href="http://glyphicons.com">Glyphicons Free</a> licensed under <a href="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>.</p> - <ul class="footer-links"> - <li><a href="http://blog.getbootstrap.com">Blog</a></li> - <li class="muted">·</li> - <li><a href="https://github.com/twitter/bootstrap/issues?state=open">Issues</a></li> - <li class="muted">·</li> - <li><a href="https://github.com/twitter/bootstrap/wiki">Roadmap and changelog</a></li> - </ul> - </div> - </footer> - - - - <!-- Le javascript - ================================================== --> - <!-- Placed at the end of the document so the pages load faster --> - <script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> - <script src="assets/js/jquery.js"></script> - <script src="assets/js/bootstrap-transition.js"></script> - <script src="assets/js/bootstrap-alert.js"></script> - <script src="assets/js/bootstrap-modal.js"></script> - <script src="assets/js/bootstrap-dropdown.js"></script> - <script src="assets/js/bootstrap-scrollspy.js"></script> - <script src="assets/js/bootstrap-tab.js"></script> - <script src="assets/js/bootstrap-tooltip.js"></script> - <script src="assets/js/bootstrap-popover.js"></script> - <script src="assets/js/bootstrap-button.js"></script> - <script src="assets/js/bootstrap-collapse.js"></script> - <script src="assets/js/bootstrap-carousel.js"></script> - <script src="assets/js/bootstrap-typeahead.js"></script> - <script src="assets/js/bootstrap-affix.js"></script> - - <script src="assets/js/holder/holder.js"></script> - <script src="assets/js/google-code-prettify/prettify.js"></script> - - <script src="assets/js/application.js"></script> - - - - </body> -</html> diff --git a/docs/templates/pages/extend.mustache b/docs/templates/pages/extend.mustache deleted file mode 100644 index 7747fff3eef3cd6dbaeb43d090566b075b77c771..0000000000000000000000000000000000000000 --- a/docs/templates/pages/extend.mustache +++ /dev/null @@ -1,169 +0,0 @@ -<!-- Subhead -================================================== --> -<header class="bs-docs-jumbotron subhead"> - <div class="container"> - <h1>Extending Bootstrap</h1> - <p class="lead">Extend Bootstrap to take advantage of included styles and components, as well as LESS variables and mixins.</p> - <div> -</header> - - <div class="container"> - - <!-- Docs nav - ================================================== --> - <div class="row"> - <div class="span3 bs-docs-sidebar"> - <ul class="nav nav-list bs-docs-sidenav"> - <li><a href="#built-with-less"><i class="glyphicon-chevron-right"></i> Built with LESS</a></li> - <li><a href="#compiling"><i class="glyphicon-chevron-right"></i> Compiling Bootstrap</a></li> - <li><a href="#static-assets"><i class="glyphicon-chevron-right"></i> Use as static assets</a></li> - </ul> - </div> - <div class="span9"> - - - - <!-- BUILT WITH LESS - ================================================== --> - <section id="built-with-less"> - <div class="page-header"> - <h1>Built with LESS</h1> - </div> - - <img style="float: right; height: 36px; margin: 10px 20px 20px" src="assets/img/less-logo-large.png" alt="LESS CSS"> - <p class="lead">Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, <a href="http://cloudhead.io">Alexis Sellier</a>. It makes developing systems-based CSS faster, easier, and more fun.</p> - - <h3>Why LESS?</h3> - <p>One of Bootstrap's creators wrote a quick <a href="http://www.wordsbyf.at/2012/03/08/why-less/">blog post about this</a>, summarized here:</p> - <ul> - <li>Bootstrap compiles faster ~6x faster with Less compared to Sass</li> - <li>Less is written in JavaScript, making it easier to us to dive in and patch compared to Ruby with Sass.</li> - <li>Less is more; we want to feel like we're writing CSS and making Bootstrap approachable to all.</li> - </ul> - - <h3>What's included?</h3> - <p>As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.</p> - - <h3>Learn more</h3> - <p>Visit the official website at <a href="http://lesscss.org">http://lesscss.org</a> to learn more.</p> - </section> - - - - <!-- COMPILING LESS AND BOOTSTRAP - ================================================== --> - <section id="compiling"> - <div class="page-header"> - <h1>Compiling Bootstrap with Less</h1> - </div> - - <p class="lead">Since our CSS is written with Less and utilizes variables and mixins, it needs to be compiled for final production implementation. Here's how.</p> - - <div class="alert alert-info"> - <strong>Note:</strong> If you're submitting a pull request to GitHub with modified CSS, you <strong>must</strong> recompile the CSS via any of these methods. - </div> - - <h2>Tools for compiling</h2> - - <h3>Node with makefile</h3> - <p>Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:</p> - <pre>$ npm install -g less jshint recess uglify-js</pre> - <p>Once installed just run <code>make</code> from the root of your bootstrap directory and you're all set.</p> - <p>Additionally, if you have <a href="https://github.com/mynyml/watchr">watchr</a> installed, you may run <code>make watch</code> to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).</p> - - <h3>Command line</h3> - <p>Install the LESS command line tool via Node and run the following command:</p> - <pre>$ lessc ./less/bootstrap.less > bootstrap.css</pre> - <p>Be sure to include <code>--compress</code> in that command if you're trying to save some bytes!</p> - - <h3>JavaScript</h3> - <p><a href="http://lesscss.org/">Download the latest Less.js</a> and include the path to it (and Bootstrap) in the <code><head></code>.</p> -<pre class="prettyprint"> -<link rel="stylesheet/less" href="/path/to/bootstrap.less"> -<script src="/path/to/less.js"></script> -</pre> - <p>To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.</p> - - <h3>Unofficial Mac app</h3> - <p><a href="http://incident57.com/less/">The unofficial Mac app</a> watches directories of .less files and compiles the code to local files after every save of a watched .less file. If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.</p> - - <h3>More apps</h3> - <h4><a href="http://crunchapp.net/" target="_blank">Crunch</a></h4> - <p>Crunch is a great looking LESS editor and compiler built on Adobe Air.</p> - <h4><a href="http://incident57.com/codekit/" target="_blank">CodeKit</a></h4> - <p>Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.</p> - <h4><a href="http://wearekiss.com/simpless" target="_blank">Simpless</a></h4> - <p>Mac, Linux, and Windows app for drag and drop compiling of LESS files. Plus, the <a href="https://github.com/Paratron/SimpLESS" target="_blank">source code is on GitHub</a>.</p> - - </section> - - - - <!-- Static assets - ================================================== --> - <section id="static-assets"> - <div class="page-header"> - <h1>Use as static assets</h1> - </div> - <p class="lead"><a href="./getting-started.html">Quickly start</a> any web project by dropping in the compiled or minified CSS and JS. Layer on custom styles separately for easy upgrades and maintenance moving forward.</p> - - <h3>Setup file structure</h3> - <p>Download the latest compiled Bootstrap and place into your project. For example, you might have something like this:</p> -<pre> - <span class="icon-folder-open"></span> app/ - <span class="icon-folder-open"></span> layouts/ - <span class="icon-folder-open"></span> templates/ - <span class="icon-folder-open"></span> public/ - <span class="icon-folder-open"></span> css/ - <span class="icon-file"></span> bootstrap.min.css - <span class="icon-folder-open"></span> js/ - <span class="icon-file"></span> bootstrap.min.js - <span class="icon-folder-open"></span> img/ - <span class="icon-file"></span> glyphicons-halflings.png - <span class="icon-file"></span> glyphicons-halflings-white.png -</pre> - - <h3>Utilize starter template</h3> - <p>Copy the following base HTML to get started.</p> -<pre class="prettyprint linenums"> -<html> - <head> - <title>Bootstrap 101 Template</title> - <!-- Bootstrap --> - <link href="public/css/bootstrap.min.css" rel="stylesheet"> - </head> - <body> - <h1>Hello, world!</h1> - <!-- Bootstrap --> - <script src="public/js/bootstrap.min.js"></script> - </body> -</html> -</pre> - - <h3>Layer on custom code</h3> - <p>Work in your custom CSS, JS, and more as necessary to make Bootstrap your own with your own separate CSS and JS files.</p> -<pre class="prettyprint linenums"> -<html> - <head> - <title>Bootstrap 101 Template</title> - <!-- Bootstrap --> - <link href="public/css/bootstrap.min.css" rel="stylesheet"> - <!-- Project --> - <link href="public/css/application.css" rel="stylesheet"> - </head> - <body> - <h1>Hello, world!</h1> - <!-- Bootstrap --> - <script src="public/js/bootstrap.min.js"></script> - <!-- Project --> - <script src="public/js/application.js"></script> - </body> -</html> -</pre> - - </section> - - </div>{{! /span9 }} - </div>{{! row}} - - </div>{{! /.container }}