Skip to content
GitLab
Commit 4b8b8d2e authored by Mark Otto's avatar Mark Otto
Browse files

holy crap new docs layout separate from home, no more top navbar

parent 081c0612
12 merge requests!8635ignore Gruntfile.js in jekyll,!8339Fix broken links to navbar component in docs examples,!7674Clear float on all when navbar is collapsed - v3,!7775added some tests for tooltip title setter,!8157Close Me: Docs "Customize and Download" button fix,!7964commit fixes #7792,!8656Added rel="stylesheet" to CDN-Examples,!8527Inner properties move 1,!8245Interactive color picker - Closed: request against wrong branch,!7865Patch 2,!7651Drop the sizzle dependency to allow smaller builds targeting mobile devices,!7408BS3: New nav and docs organization
Expand all Hide whitespace changes
Inline Side-by-side
Showing
with 6520 additions and 4554 deletions
+6520 -4554
_config.yml
+ 1
- 1
View file @ 4b8b8d2e
......@@ -9,4 +9,4 @@ permalink: pretty
source: ./docs
destination: ./_gh_pages
url: http://bootstrap.dev:9001
server_port: 9001
server_port: 9001
\ No newline at end of file
docs/_includes/header.html
+ 1
- 1
View file @ 4b8b8d2e
......@@ -14,7 +14,7 @@
<!-- Bootstrap core CSS -->
<link href="/assets/css/bootstrap.css" rel="stylesheet">
{% if page.layout == "default" %}
{% if page.layout != "example" %}
<!-- Documentation extras -->
<link href="/assets/css/docs.css" rel="stylesheet">
<link href="/assets/css/pygments-manni.css" rel="stylesheet">
......
docs/_layouts/default.html
+ 1
- 4
View file @ 4b8b8d2e
......@@ -5,10 +5,7 @@
{% include header.html %}
<!-- Place anything custom after this. -->
</head>
<body class="bs-docs-body" data-spy="scroll" data-target=".bs-docs-sidebar">
<!-- Main navbar for all docs pages. -->
{% include navbar.html %}
<body class="bs-docs-docs" data-spy="scroll" data-target=".bs-docs-sidebar">
<!-- Page content of course! -->
{{ content }}
......
docs/_layouts/home.html 0 → 100644
+ 20
- 0
View file @ 4b8b8d2e
<!DOCTYPE html>
<html lang="en">
<head>
<!-- Meta, title, CSS, favicons, etc. -->
{% include header.html %}
<!-- Place anything custom after this. -->
</head>
<body class="bs-docs-home">
<!-- Page content of course! -->
{{ content }}
<!-- Main docs footer (social buttons, copyright, etc). -->
{% include colophon.html %}
<!-- JS and analytics only. -->
{% include footer.html %}
</body>
</html>
docs/assets/css/docs.css
+ 40
- 110
View file @ 4b8b8d2e
......@@ -9,16 +9,18 @@
-------------------------------------------------- */
body {
padding-top: 54px;
position: relative; /* For scrollyspy */
/* We add the padding to the body for >768px only */
}
.bs-docs-container {
max-width: 860px;
.bs-docs-container,
.bs-home-container {
padding-left: 15px;
padding-right: 15px;
}
.bs-docs-container {
max-width: 860px;
}
/* */
.bs-docs-footer {
......@@ -47,36 +49,6 @@ section > ul li {
/* Navbar
-------------------------------------------------- */
.bs-docs-navbar {
background-color: #333;
}
.bs-docs-navbar .navbar-brand {
padding: 15px;
font-size: 30px;
margin-left: 0;
}
.bs-docs-navbar .nav {
border-top: 1px solid #222;
border-bottom: 1px solid #444;
}
.bs-docs-navbar .nav > li > a {
width: 60px;
text-align: center;
border-top: 1px solid #444;
border-bottom: 1px solid #222;
}
.bs-docs-navbar .glyphicon {
display: block;
font-size: 20px;
}
.bs-docs-navbar .nav .tooltip {
white-space: nowrap;
}
/* Jumbotrons
-------------------------------------------------- */
......@@ -195,23 +167,33 @@ section > ul li {
-------------------------------------------------- */
.bs-docs-sidebar {
display: none;
position: fixed;
top: 0;
left: 60px;
left: 0;
bottom: 0;
width: 240px;
background-color: #f5f5f5;
border-right: 1px solid #e5e5e5;
overflow-y: scroll;
text-shadow: 0 1px 0 #fff;
box-shadow: inset -1px 0 0 #e5e5e5;
}
.bs-docs-sidenav {
margin: 0 0 25px;
}
.bs-docs-sidenav > li > a {
color: #555;
padding: 8px 20px;
color: #666;
padding: 4px 20px;
}
.bs-docs-sidenav > li > a:hover {
border-right: 1px solid #d5d5d5;
}
.bs-docs-sidenav > .active > a,
.bs-docs-sidenav > .active:hover > a,
.bs-docs-sidenav > .active:focus > a {
color: #fff;
background-color: #428bca;
font-weight: 500;
color: #428bca;
border-right: 1px solid #428bca;
}
.bs-docs-sidenav-heading {
......@@ -222,54 +204,15 @@ section > ul li {
box-shadow: 0 1px 0 #fff;
}
.bs-docs-navbar:after,
.bs-docs-sidebar:after {
position: absolute;
top: -20px;
right: 0;
bottom: -20px;
left: -10px;
z-index: 10;
display: block;
content: " ";
box-shadow: inset -5px 0 25px rgba(0,0,0,.05);
}
.bs-docs-navbar .container,
.bs-docs-sidenav {
position: relative;
z-index: 15;
}
/* Base styles are not affixable given mobile-first */
.bs-docs-sidenav {
margin: 0;
-webkit-box-sizing: border-box;
-moz-box-sizing: border-box;
box-sizing: border-box;
}
/*.bs-docs-sidenav.affix {
position: static;
top: 0;
}*/
/* Chevrons within each link */
/*.bs-docs-sidenav .glyphicon-chevron-right {
float: right;
margin-top: 1px;
margin-right: -6px;
opacity: .25;
color: #000;
}
.bs-docs-sidenav a:hover .glyphicon-chevron-right {
opacity: .5;
.bs-docs-sidenav .nav-header {
padding: 25px 20px 5px;
font-size: 14px;
font-weight: 500;
color: #333;
}
.bs-docs-sidenav .active .glyphicon-chevron-right,
.bs-docs-sidenav .active a:hover .glyphicon-chevron-right {
color: #fff;
opacity: 1;
.bs-docs-sidenav > li + .nav-header {
margin-top: 0;
}
*/
/* Bootstrap code examples
......@@ -674,18 +617,23 @@ input.focused {
@media screen and (min-width: 768px) {
/* Account for fixed navbar (which is static to start) */
body {
/*padding-top: 50px;*/ /* Default height of navbar */
padding-top: 0;
padding-left: 300px;
.bs-docs-docs {
padding-left: 260px;
padding-right: 20px;
}
/* Undo custom padding */
.bs-docs-container {
.bs-docs-container,
.bs-home-container {
padding-left: 0;
padding-right: 0;
}
/* Show the docs nav */
.bs-docs-sidebar {
display: block;
}
/* Tweak display of docs jumbotrons */
.masthead {
padding-top: 100px;
......@@ -705,19 +653,6 @@ input.focused {
text-align: left;
}
/* From here, start to affix the nav because we keep columns here */
.bs-docs-sidenav.affix {
position: fixed;
top: 20px;
}
.bs-docs-sidenav {
width: 170px;
}
.bs-docs-sidenav.affix-bottom {
position: absolute;
top: auto;
bottom: 270px;
}
}
/* Tablets/desktops and up */
......@@ -728,14 +663,9 @@ input.focused {
width: 12.5%;
}
.bs-docs-sidenav {
width: 240px;
}
}
/* Large desktops and up */
@media screen and (min-width: 1200px) {
/* .bs-docs-sidenav {
width: 240px;
}
*/}
}
docs/components.html deleted 100644 → 0
+ 0
- 1961
View file @ 081c0612
This diff is collapsed.
docs/customize.html deleted 100644 → 0
+ 0
- 358
View file @ 081c0612
---
layout: default
title: Customize and download
---
<div class="bs-docs-sidebar">
<h5 class="bs-docs-sidenav-heading">Customize and download</h5>
<ul class="nav bs-docs-sidenav">
<li><a href="#components">1. Choose components</a></li>
<li><a href="#plugins">2. Select jQuery plugins</a></li>
<li><a href="#variables">3. Customize variables</a></li>
<li><a href="#download">4. Download</a></li>
</ul>
</div>
<div class="container bs-docs-container">
<!-- Customize form
================================================== -->
<form>
<section class="download" id="components">
<div class="page-header">
<a class="btn btn-small pull-right toggle-all" href="#">Toggle all</a>
<h1>
1. Choose components
</h1>
</div>
<div class="row download-builder">
<div class="col-span-3">
<h3>Scaffolding</h3>
<label class="checkbox"><input checked="checked" type="checkbox" value="reset.less"> Normalize and reset</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="print.less"> Print</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="scaffolding.less"> Body type and links</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="grid.less"> Grid system</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="layouts.less"> Layouts</label>
<h3>Base CSS</h3>
<label class="checkbox"><input checked="checked" type="checkbox" value="type.less"> Headings, body, etc</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="code.less"> Code and pre</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="labels-badges.less"> Labels and badges</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="tables.less"> Tables</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="forms.less"> Forms</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="buttons.less"> Buttons</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="sprites.less"> Icons</label>
</div><!-- /span -->
<div class="col-span-3">
<h3>Components</h3>
<label class="checkbox"><input checked="checked" type="checkbox" value="button-groups.less"> Button groups and dropdowns</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="navs.less"> Navs, tabs, and pills</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="navbar.less"> Navbar</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="breadcrumbs.less"> Breadcrumbs</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="pagination.less"> Pagination</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="pager.less"> Pager</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="thumbnails.less"> Thumbnails</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="alerts.less"> Alerts</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="progress-bars.less"> Progress bars</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="hero-unit.less"> Hero unit</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="media.less"> Media component</label>
<h3>JS Components</h3>
<label class="checkbox"><input checked="checked" type="checkbox" value="tooltip.less"> Tooltips</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="popovers.less"> Popovers</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="modals.less"> Modals</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="dropdowns.less"> Dropdowns</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="accordion.less"> Collapse</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="carousel.less"> Carousel</label>
</div><!-- /span -->
<div class="col-span-3">
<h3>Miscellaneous</h3>
<label class="checkbox"><input checked="checked" type="checkbox" value="wells.less"> Wells</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="close.less"> Close icon</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="utilities.less"> Utilities</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="component-animations.less"> Component animations</label>
<h3>Responsive</h3>
<label class="checkbox"><input checked="checked" type="checkbox" value="responsive-utilities.less"> Visible/hidden classes</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="responsive-767px-max.less"> Narrow tablets and below (<767px)</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="responsive-768px-979px.less"> Tablets to desktops (767-979px)</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="responsive-1200px-min.less"> Large desktops (>1200px)</label>
<label class="checkbox"><input checked="checked" type="checkbox" value="responsive-navbar.less"> Responsive navbar</label>
</div><!-- /span -->
</div><!-- /row -->
</section>
<section class="download" id="plugins">
<div class="page-header">
<a class="btn btn-small pull-right toggle-all" href="#">Toggle all</a>
<h1>
2. Select jQuery plugins
</h1>
</div>
<div class="row download-builder">
<div class="col-span-3">
<label class="checkbox">
<input type="checkbox" checked="true" value="bootstrap-transition.js">
Transitions <small>(required for any animation)</small>
</label>
<label class="checkbox">
<input type="checkbox" checked="true" value="bootstrap-modal.js">
Modals
</label>
<label class="checkbox">
<input type="checkbox" checked="true" value="bootstrap-dropdown.js">
Dropdowns
</label>
<label class="checkbox">
<input type="checkbox" checked="true" value="bootstrap-scrollspy.js">
Scrollspy
</label>
<label class="checkbox">
<input type="checkbox" checked="true" value="bootstrap-tab.js">
Togglable tabs
</label>
<label class="checkbox">
<input type="checkbox" checked="true" value="bootstrap-tooltip.js">
Tooltips
</label>
<label class="checkbox">
<input type="checkbox" checked="true" value="bootstrap-popover.js">
Popovers <small>(requires Tooltips)</small>
</label>
</div><!-- /span -->
<div class="col-span-3">
<label class="checkbox">
<input type="checkbox" checked="true" value="bootstrap-affix.js">
Affix
</label>
<label class="checkbox">
<input type="checkbox" checked="true" value="bootstrap-alert.js">
Alert messages
</label>
<label class="checkbox">
<input type="checkbox" checked="true" value="bootstrap-button.js">
Buttons
</label>
<label class="checkbox">
<input type="checkbox" checked="true" value="bootstrap-collapse.js">
Collapse
</label>
<label class="checkbox">
<input type="checkbox" checked="true" value="bootstrap-carousel.js">
Carousel
</label>
<label class="checkbox">
<input type="checkbox" checked="true" value="bootstrap-typeahead.js">
Typeahead
</label>
</div><!-- /span -->
<div class="col-span-3">
<h4 class="muted">Heads up!</h4>
<p class="muted">All checked plugins will be compiled into a single file, bootstrap.js. All plugins require the latest version of <a href="http://jquery.com/" target="_blank">jQuery</a> to be included.</p>
</div><!-- /span -->
</div><!-- /row -->
</section>
<section class="download" id="variables">
<div class="page-header">
<a class="btn btn-small pull-right toggle-all" href="#">Reset to defaults</a>
<h1>
3. Customize variables
</h1>
</div>
<div class="row download-builder">
<div class="col-span-3">
<h3>Scaffolding</h3>
<label>@body-background</label>
<input type="text" placeholder="#fff">
<label>@text-color</label>
<input type="text" placeholder="@grayDark">
<h3>Links</h3>
<label>@link-color</label>
<input type="text" placeholder="#08c">
<label>@link-color-hover</label>
<input type="text" placeholder="darken(@link-color, 15%)">
<h3>Grid system</h3>
<label>@grid-columns</label>
<input type="text" placeholder="12">
<label>@grid-column-width</label>
<input type="text" placeholder="60px">
<label>@grid-gutter-width</label>
<input type="text" placeholder="20px">
<label>@grid-column-width-1200</label>
<input type="text" placeholder="70px">
<label>@grid-gutter-width-1200</label>
<input type="text" placeholder="30px">
<label>@grid-column-width-768</label>
<input type="text" placeholder="42px">
<label>@grid-gutter-width-768</label>
<input type="text" placeholder="20px">
</div><!-- /span -->
<div class="col-span-3">
<h3>Typography</h3>
<label>@font-family-sans-serif</label>
<input type="text" placeholder="'Helvetica Neue', Helvetica, Arial, sans-serif">
<label>@font-family-serif</label>
<input type="text" placeholder="Georgia, 'Times New Roman', Times, serif">
<label>@font-family-monospace</label>
<input type="text" placeholder="Menlo, Monaco, 'Courier New', monospace">
<label>@font-size-base</label>
<input type="text" placeholder="14px">
<label>@font-family-base</label>
<input type="text" placeholder="@font-family-sans-serif">
<label>@line-height-base</label>
<input type="text" placeholder="20px">
<label>@headings-font-family</label>
<input type="text" placeholder="inherit">
<label>@headings-font-weight</label>
<input type="text" placeholder="bold">
<label>@headingsColor</label>
<input type="text" placeholder="inherit">
<label>@font-size-large</label>
<input type="text" placeholder="@font-size-base * 1.25">
<label>@font-size-small</label>
<input type="text" placeholder="@font-size-base * 0.85">
<label>@font-size-mini</label>
<input type="text" placeholder="@font-size-base * 0.75">
<label>@padding-large</label>
<input type="text" placeholder="11px 19px">
<label>@padding-small</label>
<input type="text" placeholder="2px 10px">
<label>@padding-mini</label>
<input type="text" placeholder="1px 6px">
<label>@border-radius-base</label>
<input type="text" placeholder="4px">
<label>@border-radius-large</label>
<input type="text" placeholder="6px">
<label>@border-radius-small</label>
<input type="text" placeholder="3px">
<label>@hero-background</label>
<input type="text" placeholder="@grayLighter">
<label>@hero-heading-color</label>
<input type="text" placeholder="inherit">
<label>@hero-lead-color</label>
<input type="text" placeholder="inherit">
<h3>Tables</h3>
<label>@table-background</label>
<input type="text" placeholder="transparent">
<label>@table-background-accent</label>
<input type="text" placeholder="#f9f9f9">
<label>@table-background-hover</label>
<input type="text" placeholder="#f5f5f5">
<label>@table-border</label>
<input type="text" placeholder="#ddd">
<h3>Forms</h3>
<label>@input-color-placeholder</label>
<input type="text" placeholder="@grayLight">
<label>@input-background</label>
<input type="text" placeholder="#fff">
<label>@input-border</label>
<input type="text" placeholder="#ccc">
<label>@input-border-radius</label>
<input type="text" placeholder="3px">
<label>@input-background-disabled</label>
<input type="text" placeholder="@grayLighter">
<label>@form-actions-background</label>
<input type="text" placeholder="#f5f5f5">
<label>@btn-backround-primary</label>
<input type="text" placeholder="@link-color">
<label>@btn-backround-primary-highlight</label>
<input type="text" placeholder="darken(#fff, 10%)">
</div><!-- /span -->
<div class="col-span-3">
<h3>Form states &amp; alerts</h3>
<label>@state-warning-text</label>
<input type="text" placeholder="#c09853">
<label>@state-warning-background</label>
<input type="text" placeholder="#fcf8e3">
<label>@state-error-text</label>
<input type="text" placeholder="#b94a48">
<label>@state-error-background</label>
<input type="text" placeholder="#f2dede">
<label>@state-success-text</label>
<input type="text" placeholder="#468847">
<label>@state-success-background</label>
<input type="text" placeholder="#dff0d8">
<label>@state-info-text</label>
<input type="text" placeholder="#3a87ad">
<label>@state-info-background</label>
<input type="text" placeholder="#d9edf7">
<h3>Navbar</h3>
<label>@navbar-height</label>
<input type="text" placeholder="40px">
<label>@navbar-background</label>
<input type="text" placeholder="@grayDarker">
<label>@navbar-background-highlight</label>
<input type="text" placeholder="@grayDark">
<label>@navbar-text</label>
<input type="text" placeholder="@grayLight">
<label>@navbar-brand-color</label>
<input type="text" placeholder="@navbar-link-color">
<label>@navbar-link-color</label>
<input type="text" placeholder="@grayLight">
<label>@navbar-link-color-hover</label>
<input type="text" placeholder="#fff">
<label>@navbar-link-color-active</label>
<input type="text" placeholder="@navbar-link-color-hover">
<label>@navbar-link-background-hover</label>
<input type="text" placeholder="transparent">
<label>@navbar-link-background-active</label>
<input type="text" placeholder="@navbar-background">
<label>@navbarSearchBackground</label>
<input type="text" placeholder="lighten(@navbar-background, 25%)">
<label>@navbarSearchBackgroundFocus</label>
<input type="text" placeholder="#fff">
<label>@navbarSearchBorder</label>
<input type="text" placeholder="darken(@navbarSearchBackground, 30%)">
<label>@navbarSearchPlaceholderColor</label>
<input type="text" placeholder="#ccc">
<label>@navbar-collapse-width</label>
<input type="text" placeholder="979px">
<label>@navbar-collapse-width-desktop</label>
<input type="text" placeholder="@navbar-collapse-width + 1">
<h3>Dropdowns</h3>
<label>@dropdown-background</label>
<input type="text" placeholder="#fff">
<label>@dropdown-border</label>
<input type="text" placeholder="rgba(0,0,0,.2)">
<label>@dropdown-link-color</label>
<input type="text" placeholder="@grayDark">
<label>@dropdown-link-color-hover</label>
<input type="text" placeholder="#fff">
<label>@dropdown-link-background-hover</label>
<input type="text" placeholder="@link-color">
</div><!-- /span -->
</div><!-- /row -->
</section>
<section class="download" id="download">
<div class="page-header">
<h1>
4. Download
</h1>
</div>
<div class="download-btn">
<a class="btn btn-primary" href="#" onclick="_gaq.push(['_trackEvent', 'Customize', 'Download', 'Customize and Download']);">Customize and Download</a>
<h4>What's included?</h4>
<p>Downloads include compiled CSS, compiled and minified CSS, and compiled jQuery plugins, all nicely packed up into a zipball for your convenience.</p>
</div>
</section><!-- /download -->
</form>
</div><!-- /.container -->
docs/css.html → docs/docs.html
+ 6454
- 0
View file @ 4b8b8d2e
This diff is collapsed.
docs/getting-started.html deleted 100644 → 0
+ 0
- 270
View file @ 081c0612
---
layout: default
title: Getting started
description: Overview of the project, its contents, and how to get started with a simple template.
---
<div class="bs-docs-sidebar">
<h5 class="bs-docs-sidenav-heading">Getting started</h5>
<ul class="nav bs-docs-sidenav">
<li><a href="#download-bootstrap">Download</a></li>
<li><a href="#file-structure">File structure</a></li>
<li><a href="#contents">What's included</a></li>
<li><a href="#html-template">HTML template</a></li>
<li><a href="#examples">Examples</a></li>
<li><a href="#what-next">What next?</a></li>
</ul>
</div>
<div class="container bs-docs-container">
<!-- Download
================================================== -->
<section id="download-bootstrap">
<div class="page-header">
<h1>1. Download</h1>
</div>
<p class="lead">Before downloading, be sure to have a code editor (we recommend <a href="http://sublimetext.com/2">Sublime Text 2</a>) and some working knowledge of HTML and CSS. We won't walk through the source files here, but they are available for download. We'll focus on getting started with the compiled Bootstrap files.</p>
<div class="row">
<div class="col-span-6">
<h2>Compiled</h2>
<p><strong>Fastest way to get started:</strong> get the compiled and minified versions of our CSS, JS, and images. No docs or original source files.</p>
<p><a class="btn btn-large btn-primary" href="assets/bootstrap.zip" onclick="_gaq.push(['_trackEvent', 'Getting started', 'Download', 'Download compiled']);">Download Bootstrap</a></p>
</div>
<div class="col-span-6">
<h2>Source</h2>
<p>Get the original files for all CSS and JavaScript, along with a local copy of the docs by downloading the latest version directly from GitHub.</p>
<p><a class="btn btn-large" href="https://github.com/twitter/bootstrap/zipball/master" onclick="_gaq.push(['_trackEvent', 'Getting started', 'Download', 'Download source']);">Download Bootstrap source</a></p>
</div>
<div class="col-span-6">
<h2>Bower</h2>
<p>Install and manage the original files for all CSS and JavaScript, along with a local copy of the docs, using <a href="http://twitter.github.com/bower">Bower</a>.</p>
{% highlight bash %}bower install bootstrap{% endhighlight %}
</div>
</div>
</section>
<!-- File structure
================================================== -->
<section id="file-structure">
<div class="page-header">
<h1>2. File structure</h1>
</div>
<p class="lead">Within the download you'll find the following file structure and contents, logically grouping common assets and providing both compiled and minified variations.</p>
<p>Once downloaded, unzip the compressed folder to see the structure of (the compiled) Bootstrap. You'll see something like this:</p>
{% highlight bash %}
bootstrap/
├── css/
│ ├── bootstrap.css
│ ├── bootstrap.min.css
├── js/
│ ├── bootstrap.js
│ ├── bootstrap.min.js
└── fonts/
├── glyphiconshalflings-regular.eot
├── glyphiconshalflings-regular.otf
├── glyphiconshalflings-regular.svg
├── glyphiconshalflings-regular.ttf
└── glyphiconshalflings-regular.woff
{% endhighlight %}
<p>This is the most basic form of Bootstrap: compiled files for quick drop-in usage in nearly any web project. We provide compiled CSS and JS (<code>bootstrap.*</code>), as well as compiled and minified CSS and JS (<code>bootstrap.min.*</code>). The image files are compressed using <a href="http://imageoptim.com/">ImageOptim</a>, a Mac app for compressing PNGs.</p>
<p>Please note that <strong>all JavaScript plugins require jQuery</strong> to be included.</p>
</section>
<!-- Contents
================================================== -->
<section id="contents">
<div class="page-header">
<h1>3. What's included</h1>
</div>
<p class="lead">Bootstrap comes equipped with HTML, CSS, and JS for all sorts of things, but they can be summarized with a handful of categories visible at the top of the <a href="http://getbootstrap.com">Bootstrap documentation</a>.</p>
<h2>Docs sections</h2>
<p>In addition to the getting started documentation you're reading now, the Bootstrap docs are broken into a few key pages.</p>
<h4><a href="http://twitter.github.com/bootstrap/css.html">Core CSS</a></h4>
<p>Global styles for the body, Normalize, links, grid system, tables, forms, buttons, icons, and more.</p>
<h4><a href="http://twitter.github.com/bootstrap/components.html">Components</a></h4>
<p>Basic styles for common interface components like tabs and pills, navbar, alerts, page headers, and more. Head here to see what kind of custom components Bootstrap has to offer beyond basic HTML elements.</p>
<h4><a href="http://twitter.github.com/bootstrap/javascript.html">JavaScript plugins</a></h4>
<p>Similar to Components, these JavaScript plugins are interactive components for things like tooltips, popovers, modals, and more.</p>
</section>
<!-- HTML template
================================================== -->
<section id="html-template">
<div class="page-header">
<h1>4. Basic HTML template</h1>
</div>
<p class="lead">With a brief intro into the contents out of the way, we can focus on putting Bootstrap to use. To do that, we'll utilize a basic HTML template that includes everything we mentioned in the <a href="./getting-started.html#file-structure">File structure</a>.</p>
<p>Now, here's a look at a <strong>typical HTML file</strong>:</p>
{% highlight html linenos %}
<!DOCTYPE html>
<html>
<head>
<title>Bootstrap 101 Template</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
</head>
<body>
<h1>Hello, world!</h1>
<script src="http://code.jquery.com/jquery.js"></script>
</body>
</html>
{% endhighlight %}
<p>To make this <strong>a Bootstrapped template</strong>, just include the appropriate CSS and JS files:</p>
{% highlight html linenos %}
<!DOCTYPE html>
<html>
<head>
<title>Bootstrap 101 Template</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- Bootstrap -->
<link href="css/bootstrap.min.css" rel="stylesheet" media="screen">
</head>
<body>
<h1>Hello, world!</h1>
<script src="http://code.jquery.com/jquery.js"></script>
<script src="js/bootstrap.min.js"></script>
</body>
</html>
{% endhighlight %}
<p><strong>And you're set!</strong> With those two files added, you can begin to develop any site or application with Bootstrap.</p>
<hr>
<h4>Responsive features in IE8</h4>
<p>Internet Explorer 8 lacks support for media queries, the method by which we deliver responsive CSS to folks. To enable that, you need to include a third party tool (which we include in the project repository) called <a href="https://github.com/scottjehl/Respond">Respond.js</a>.</p>
<pre class="prettyprint linenums">
&lt;!--[if lt IE 9]&gt;
&lt;script src="/assets/js/respond/respond.js"&gt;&lt;/script&gt;
&lt;![endif]--&gt;
</pre>
</section>
<!-- Examples
================================================== -->
<section id="examples">
<div class="page-header">
<h1>5. Examples</h1>
</div>
<p class="lead">Move beyond the base template with a few example layouts. We encourage folks to iterate on these examples and not simply use them as an end result.</p>
<div class="row bs-docs-examples">
<div class="col-span-4">
<a class="thumbnail" href="/examples/starter-template/" target="_blank">
<img src="/assets/img/examples/bootstrap-example-starter.png" alt="">
</a>
<h4>Starter template</h4>
<p>A barebones HTML document with all the Bootstrap CSS and JavaScript included.</p>
</div>
<div class="col-span-4">
<a class="thumbnail" href="/examples/jumbotron/" target="_blank">
<img src="/assets/img/examples/bootstrap-example-marketing.png" alt="">
</a>
<h4>Basic marketing site</h4>
<p>Featuring a hero unit for a primary message and three supporting elements.</p>
</div>
<div class="col-span-4">
<a class="thumbnail" href="/examples/jumbotron-narrow/" target="_blank">
<img src="/assets/img/examples/bootstrap-example-jumbotron-narrow.png" alt="">
</a>
<h4>Narrow marketing</h4>
<p>Slim, lightweight marketing template for small projects or teams.</p>
</div>
<div class="col-span-4">
<a class="thumbnail" href="/examples/justified-nav/" target="_blank">
<img src="/assets/img/examples/bootstrap-example-justified-nav.png" alt="">
</a>
<h4>Justified nav</h4>
<p>Marketing page with equal-width navigation links in a modified navbar.</p>
</div>
<div class="col-span-4">
<a class="thumbnail" href="/examples/signin/" target="_blank">
<img src="/assets/img/examples/bootstrap-example-signin.png" alt="">
</a>
<h4>Sign in</h4>
<p>Barebones sign in form with custom, larger form controls and a flexible layout.</p>
</div>
<div class="col-span-4">
<a class="thumbnail" href="/examples/sticky-footer/" target="_blank">
<img src="/assets/img/examples/bootstrap-example-sticky-footer.png" alt="">
</a>
<h4>Sticky footer</h4>
<p>Pin a fixed-height footer to the bottom of the user's viewport.</p>
</div>
<div class="col-span-4">
<a class="thumbnail" href="/examples/sticky-footer-navbar/" target="_blank">
<img src="/assets/img/examples/bootstrap-example-sticky-footer-navbar.png" alt="">
</a>
<h4>Sticky footer w/ navbar</h4>
<p>Add a fixed navbar to the default sticky footer template.</p>
</div>
<div class="col-span-4">
<a class="thumbnail" href="/examples/carousel/" target="_blank">
<img src="/assets/img/examples/bootstrap-example-carousel.png" alt="">
</a>
<h4>Carousel jumbotron</h4>
<p>An interactive riff on the basic marketing site featuring a prominent carousel.</p>
</div>
<div class="col-span-4">
<a class="thumbnail" href="/examples/navbar/" target="_blank">
<img src="/assets/img/examples/bootstrap-example-navbar.png" alt="">
</a>
<h4>Navbar</h4>
<p>Basic template for showcasing how the navbar works.</p>
</div>
<div class="col-span-4">
<a class="thumbnail" href="/examples/navbar-static-top/" target="_blank">
<img src="/assets/img/examples/bootstrap-example-navbar-static-top.png" alt="">
</a>
<h4>Static top navbar</h4>
<p>Basic template for showcasing the static navbar variation.</p>
</div>
<div class="col-span-4">
<a class="thumbnail" href="/examples/navbar-fixed-top/" target="_blank">
<img src="/assets/img/examples/bootstrap-example-navbar-fixed-top.png" alt="">
</a>
<h4>Fixed top navbar</h4>
<p>Basic template for showcasing the fixed navbar variation.</p>
</div>
<div class="col-span-4">
<a class="thumbnail" href="/examples/grid/" target="_blank">
<img src="/assets/img/examples/bootstrap-example-.png" alt="">
</a>
<h4>Grid examples</h4>
<p></p>
</div>
</div>
</section>
<!-- Next
================================================== -->
<section id="what-next">
<div class="page-header">
<h1>What next?</h1>
</div>
<p class="lead">Head to the docs for information, examples, and code snippets, or take the next leap and customize Bootstrap for any upcoming project.</p>
<a class="btn btn-large btn-primary" href="./css.html" onclick="_gaq.push(['_trackEvent', 'Getting started', 'Next steps', 'Visit docs']);">Visit the Bootstrap docs</a>
<a class="btn btn-large" href="./customize.html" style="margin-left: 5px;" onclick="_gaq.push(['_trackEvent', 'Getting started', 'Next steps', 'Customize']);">Customize Bootstrap</a>
</section>
</div><!-- /.container -->
docs/index.html
+ 3
- 2
View file @ 4b8b8d2e
---
layout: default
layout: home
title: Bootstrap
---
......@@ -9,6 +9,7 @@ title: Bootstrap
<p class="lead">Sleek, intuitive, and powerful mobile-first front-end framework for faster and easier web development.</p>
<p>
<a href="assets/bootstrap.zip" class="btn btn-large" onclick="_gaq.push(['_trackEvent', 'Jumbotron actions', 'Download', 'Download 3.0.0']);">Download Bootstrap</a>
<a href="./docs/" class="btn btn-large" onclick="_gaq.push(['_trackEvent', 'Jumbotron actions', 'Docs', 'View docs']);">View docs</a>
</p>
<ul class="masthead-links">
<li>
......@@ -22,7 +23,7 @@ title: Bootstrap
</div>
</div>
<div class="container bs-docs-container">
<div class="container bs-home-container">
<div class="bs-docs-marketing">
......
docs/javascript.html deleted 100644 → 0
+ 0
- 1847
View file @ 081c0612
This diff is collapsed.
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment