Policy 1707 commit to LF
[policy/engine.git] / POLICY-SDK-APP / src / main / webapp / app / policyApp / CSS / bootstrap / docs / _includes / css / overview.html
1 <div class="bs-docs-section">
2   <h1 id="overview" class="page-header">Overview</h1>
3
4   <p class="lead">Get the lowdown on the key pieces of Bootstrap's infrastructure, including our approach to better, faster, stronger web development.</p>
5
6   <h2 id="overview-doctype">HTML5 doctype</h2>
7   <p>Bootstrap makes use of certain HTML elements and CSS properties that require the use of the HTML5 doctype. Include it at the beginning of all your projects.</p>
8 {% highlight html %}
9 <!DOCTYPE html>
10 <html lang="en">
11   ...
12 </html>
13 {% endhighlight %}
14
15   <h2 id="overview-mobile">Mobile first</h2>
16   <p>With Bootstrap 2, we added optional mobile friendly styles for key aspects of the framework. With Bootstrap 3, we've rewritten the project to be mobile friendly from the start. Instead of adding on optional mobile styles, they're baked right into the core. In fact, <strong>Bootstrap is mobile first</strong>. Mobile first styles can be found throughout the entire library instead of in separate files.</p>
17   <p>To ensure proper rendering and touch zooming, <strong>add the viewport meta tag</strong> to your <code>&lt;head&gt;</code>.</p>
18 {% highlight html %}
19 <meta name="viewport" content="width=device-width, initial-scale=1">
20 {% endhighlight %}
21   <p>You can disable zooming capabilities on mobile devices by adding <code>user-scalable=no</code> to the viewport meta tag. This disables zooming, meaning users are only able to scroll, and results in your site feeling a bit more like a native application. Overall, we don't recommend this on every site, so use caution!</p>
22 {% highlight html %}
23 <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">
24 {% endhighlight %}
25
26   <h2 id="overview-type-links">Typography and links</h2>
27   <p>Bootstrap sets basic global display, typography, and link styles. Specifically, we:</p>
28   <ul>
29     <li>Set <code>background-color: #fff;</code> on the <code>body</code></li>
30     <li>Use the <code>@font-family-base</code>, <code>@font-size-base</code>, and <code>@line-height-base</code> attributes as our typographic base</li>
31     <li>Set the global link color via <code>@link-color</code> and apply link underlines only on <code>:hover</code></li>
32   </ul>
33   <p>These styles can be found within <code>scaffolding.less</code>.</p>
34
35   <h2 id="overview-normalize">Normalize.css</h2>
36   <p>For improved cross-browser rendering, we use <a href="http://necolas.github.io/normalize.css/" target="_blank">Normalize.css</a>, a project by <a href="https://twitter.com/necolas" target="_blank">Nicolas Gallagher</a> and <a href="https://twitter.com/jon_neal" target="_blank">Jonathan Neal</a>.</p>
37
38   <h2 id="overview-container">Containers</h2>
39   <p>Bootstrap requires a containing element to wrap site contents and house our grid system. You may choose one of two containers to use in your projects. Note that, due to <code>padding</code> and more, neither container is nestable.</p>
40   <p>Use <code>.container</code> for a responsive fixed width container.</p>
41 {% highlight html %}
42 <div class="container">
43   ...
44 </div>
45 {% endhighlight %}
46   <p>Use <code>.container-fluid</code> for a full width container, spanning the entire width of your viewport.</p>
47 {% highlight html %}
48 <div class="container-fluid">
49   ...
50 </div>
51 {% endhighlight %}
52 </div>