This repository has been archived by the owner on Apr 17, 2020. It is now read-only.
-
-
Notifications
You must be signed in to change notification settings - Fork 14
/
index.html
48 lines (46 loc) · 3.58 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
<html>
<head>
<title>Bootstrap and npm</title>
<link rel="stylesheet" href="bootstrap-custom.css">
</head>
<body>
<div class="p-3 p-md-5 text-white bg-primary">
<div class="col-md-7 mx-auto py-md-5">
<h1>Custom CSS with Bootstrap via npm</h1>
<p>This demonstrates building a custom CSS file with Bootstrap's source Sass files, managed via npm. While not a complete solution, this demo highlights how to change default variables, create a custom stylesheet, and choose specific parts of CSS to include.</p>
<p class="text-white-50">Note: This demo doesn't include compiling Bootstrap's JavaScript.</p>
</div>
</div>
<div class="p-3 p-md-5 border-top border-bottom border-white">
<div class="col-md-7 mx-auto">
<h2>Included files</h2>
<p>In addition to our <code>package.json</code> and some support files, this demo includes two key files:</p>
<ul>
<li><code>index.html</code> — the page you're looking at</li>
<li><code>bootstrap-custom.scss</code> — a Sass stylesheet where we'll modify and compile our CSS</li>
</ul>
<p>Bootstrap's source Sass code is spread across dozens of smaller <code>.scss</code> files. By default, we include every one of these files in what we call our "import stack," a series of <code>@import</code> statements in the source <code>bootstrap.scss</code> files.</p>
<p>To demonstrate how to optionally include Bootstrap piece-by-piece, the full Bootstrap import stack has been commented out in our <code>custom.scss</code> file, save for a handful of components:</p>
<ul>
<li><code>functions</code>, <code>variables</code>, and <code>mixins</code> — useful tools for interacting with and customizing Bootstrap's default styles.</li>
<li><code>reboot</code> — our opinionated browser normalization styles.</li>
<li><code>type</code> — our default typography styles.</li>
<li><code>code</code> — our inline and block code styles.</li>
<li><code>grid</code> — our layout and grid system styles.</li>
<li><code>utilities</code> — all our utility classes for rapid prototyping.</li>
</ul>
<p>You may uncomment any of the additional imports, add new imports, or even write new styles.</p>
<h2>Compiling</h2>
<p>Built into npm is the ability to run scripts or tasks, like compiling CSS, via the command line. The <code>package.json</code> in any npm package typically includes scripts unique to that project. Here's how to use our this demo's npm scripts to compile a custom Bootstrap build.</p>
<ol>
<li>From the command line, navigate to this demo's root directory, <code>bootstrap-npm</code>.</li>
<li>When ready, enter <code>npm start</code>. This will compile the CSS for the first time.</li>
<li>Open the <code>index.html</code> file in any browser to see a styled page using your freshly compiled CSS.</li>
</ol>
<p>To watch the source <code>bootstrap-custom.scss</code> file for changes, enter <code>npm run watch</code> to automatically recompile as necessary.</p>
<p>When using <code>npm start</code>, any changes you make to your <code>custom.scss</code> will automatically cause the Sass file to recompile. Refresh your HTML page to see those changes in action.</p>
<p>Those just getting started with Bootstrap and npm may wish to build on this project's <code>package.json</code> by adding new dependencies and scripts. Please do!</p>
</div>
</div>
</body>
</html>