customize.html 11.1 KB
Newer Older
Mark Otto's avatar
Mark Otto committed
1
---
2
layout: default
Mark Otto's avatar
Mark Otto committed
3
title: Customize and download
Mark Otto's avatar
Mark Otto committed
4
slug: customize
Quy Ton's avatar
Quy Ton committed
5
lead: Customize Bootstrap's components, Less variables, and jQuery plugins to get your very own version.
Mark Otto's avatar
Mark Otto committed
6
7
---

Mark Otto's avatar
Mark Otto committed
8
<!-- Customizer form -->
9
<form class="bs-customizer" role="form">
10
  <div class="bs-docs-section" id="less-section">
11
    <button class="btn btn-default toggle" type="button">Toggle all</button>
Quy Ton's avatar
Quy Ton committed
12
    <h1 id="less" class="page-header">Less files</h1>
13

Quy Ton's avatar
Quy Ton committed
14
    <p class="lead">Choose which Less files to compile into your custom build of Bootstrap. Not sure which files to use? Read through the <a href="../css/">CSS</a> and <a href="../components/">Components</a> pages in the docs.</p>
Mark Otto's avatar
Mark Otto committed
15

Mark Otto's avatar
Mark Otto committed
16
    <div class="row">
Mark Otto's avatar
Mark Otto committed
17
      <div class="col-xs-6 col-sm-4">
18
        <h3>Common CSS</h3>
Mark Otto's avatar
Mark Otto committed
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="print.less">
            Print media styles
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="type.less">
            Typography
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="code.less">
            Code
          </label>
        </div>
37
38
39
40
41
42
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="grid.less">
            Grid system
          </label>
        </div>
Mark Otto's avatar
Mark Otto committed
43
44
45
46
47
48
49
50
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="tables.less">
            Tables
          </label>
        </div>
        <div class="checkbox">
          <label>
51
            <input type="checkbox" checked value="forms.less" data-dependents="navbar.less,input-groups.less">
Mark Otto's avatar
Mark Otto committed
52
53
54
55
56
            Forms
          </label>
        </div>
        <div class="checkbox">
          <label>
57
            <input type="checkbox" checked value="buttons.less" data-dependents="button-groups.less">
Mark Otto's avatar
Mark Otto committed
58
59
60
            Buttons
          </label>
        </div>
61
62
      </div><!-- .col-xs-6 .col-sm-4 -->

Mark Otto's avatar
Mark Otto committed
63
      <div class="col-xs-6 col-sm-4">
64
        <h3>Components</h3>
Mark Otto's avatar
Mark Otto committed
65
66
        <div class="checkbox">
          <label>
67
68
            <input type="checkbox" checked value="glyphicons.less">
            Glyphicons
Mark Otto's avatar
Mark Otto committed
69
          </label>
70
        </div>
Mark Otto's avatar
Mark Otto committed
71
72
        <div class="checkbox">
          <label>
73
            <input type="checkbox" checked value="button-groups.less" data-dependencies="buttons.less">
74
            Button groups
Mark Otto's avatar
Mark Otto committed
75
76
77
78
          </label>
        </div>
        <div class="checkbox">
          <label>
79
            <input type="checkbox" checked value="input-groups.less" data-dependencies="forms.less">
80
            Input groups
Mark Otto's avatar
Mark Otto committed
81
82
83
84
          </label>
        </div>
        <div class="checkbox">
          <label>
85
            <input type="checkbox" checked value="navs.less" data-dependents="navbar.less">
Mark Otto's avatar
Mark Otto committed
86
87
88
89
90
            Navs
          </label>
        </div>
        <div class="checkbox">
          <label>
91
            <input type="checkbox" checked value="navbar.less" data-dependencies="forms.less,utilities.less,navs.less">
Mark Otto's avatar
Mark Otto committed
92
93
94
            Navbar
          </label>
        </div>
95
96
97
98
99
100
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="breadcrumbs.less">
            Breadcrumbs
          </label>
        </div>
Mark Otto's avatar
Mark Otto committed
101
102
103
104
105
106
107
108
109
110
111
112
113
114
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="pagination.less">
            Pagination
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="pager.less">
            Pager
          </label>
        </div>
        <div class="checkbox">
          <label>
115
116
            <input type="checkbox" checked value="labels.less">
            Labels
Mark Otto's avatar
Mark Otto committed
117
118
119
120
          </label>
        </div>
        <div class="checkbox">
          <label>
121
122
            <input type="checkbox" checked value="badges.less">
            Badges
Mark Otto's avatar
Mark Otto committed
123
124
125
126
          </label>
        </div>
        <div class="checkbox">
          <label>
127
128
            <input type="checkbox" checked value="jumbotron.less">
            Jumbotron
Mark Otto's avatar
Mark Otto committed
129
130
131
132
          </label>
        </div>
        <div class="checkbox">
          <label>
133
134
            <input type="checkbox" checked value="thumbnails.less">
            Thumbnails
Mark Otto's avatar
Mark Otto committed
135
          </label>
136
        </div>
Mark Otto's avatar
Mark Otto committed
137
138
139
140
141
142
143
144
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="alerts.less">
            Alerts
          </label>
        </div>
        <div class="checkbox">
          <label>
145
146
            <input type="checkbox" checked value="progress-bars.less">
            Progress bars
Mark Otto's avatar
Mark Otto committed
147
148
149
150
          </label>
        </div>
        <div class="checkbox">
          <label>
151
152
            <input type="checkbox" checked value="media.less">
            Media items
Mark Otto's avatar
Mark Otto committed
153
154
155
156
          </label>
        </div>
        <div class="checkbox">
          <label>
157
158
            <input type="checkbox" checked value="list-group.less">
            List groups
Mark Otto's avatar
Mark Otto committed
159
160
161
162
          </label>
        </div>
        <div class="checkbox">
          <label>
163
164
            <input type="checkbox" checked value="panels.less">
            Panels
Mark Otto's avatar
Mark Otto committed
165
166
167
168
          </label>
        </div>
        <div class="checkbox">
          <label>
169
170
            <input type="checkbox" checked value="wells.less">
            Wells
Mark Otto's avatar
Mark Otto committed
171
172
173
174
          </label>
        </div>
        <div class="checkbox">
          <label>
175
176
            <input type="checkbox" checked value="close.less">
            Close icon
Mark Otto's avatar
Mark Otto committed
177
178
          </label>
        </div>
179
180
181
182
      </div><!-- .col-xs-6 .col-sm-4 -->

      <div class="col-xs-6 col-sm-4">
        <h3>JavaScript components</h3>
183
184
185
186
187
188
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="component-animations.less">
            Component animations (for JS)
          </label>
        </div>
Mark Otto's avatar
Mark Otto committed
189
190
        <div class="checkbox">
          <label>
191
192
            <input type="checkbox" checked value="dropdowns.less">
            Dropdowns
Mark Otto's avatar
Mark Otto committed
193
194
195
196
          </label>
        </div>
        <div class="checkbox">
          <label>
197
198
            <input type="checkbox" checked value="tooltip.less">
            Tooltips
Mark Otto's avatar
Mark Otto committed
199
200
          </label>
        </div>
Mark Otto's avatar
Mark Otto committed
201
202
        <div class="checkbox">
          <label>
203
204
            <input type="checkbox" checked value="popovers.less">
            Popovers
Mark Otto's avatar
Mark Otto committed
205
206
          </label>
        </div>
Mark Otto's avatar
Mark Otto committed
207
208
        <div class="checkbox">
          <label>
209
210
            <input type="checkbox" checked value="modals.less">
            Modals
Mark Otto's avatar
Mark Otto committed
211
212
213
214
          </label>
        </div>
        <div class="checkbox">
          <label>
215
216
            <input type="checkbox" checked value="carousel.less">
            Carousel
Mark Otto's avatar
Mark Otto committed
217
          </label>
218
        </div>
219
220

        <h3>Utilities</h3>
Mark Otto's avatar
Mark Otto committed
221
222
        <div class="checkbox">
          <label>
223
224
            <input type="checkbox" checked value="utilities.less" data-dependents="navbar.less">
            Basic utilities
Mark Otto's avatar
Mark Otto committed
225
226
227
228
          </label>
        </div>
        <div class="checkbox">
          <label>
229
230
            <input type="checkbox" checked value="responsive-utilities.less">
            Responsive utilities
Mark Otto's avatar
Mark Otto committed
231
232
          </label>
        </div>
233
234
      </div><!-- .col-xs-6 .col-sm-4 -->
    </div><!-- /.row -->
Mark Otto's avatar
Mark Otto committed
235
  </div>
236

Mark Otto's avatar
Mark Otto committed
237
238


239
  <div class="bs-docs-section" id="plugin-section">
240
241
242
    <button class="btn btn-default toggle" type="button">Toggle all</button>
    <h1 id="plugins" class="page-header">jQuery plugins</h1>

243
    <p class="lead">Choose which jQuery plugins should be included in your custom JavaScript files. Unsure what to include? Read the <a href="../javascript/">JavaScript</a> page in the docs.</p>
Mark Otto's avatar
Mark Otto committed
244
245
246
247
248
249
250
251
    <div class="row">
      <div class="col-lg-6">
        <h4>Linked to components</h4>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="alert.js">
            Alert dismissal
          </label>
syed's avatar
syed committed
252
        </div>
Mark Otto's avatar
Mark Otto committed
253
254
255
256
257
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="button.js">
            Advanced buttons
          </label>
258
        </div>
Mark Otto's avatar
Mark Otto committed
259
260
261
262
263
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="carousel.js">
            Carousel functionality
          </label>
syed's avatar
syed committed
264
        </div>
Mark Otto's avatar
Mark Otto committed
265
266
267
268
269
270
271
272
273
274
275
276
277
278
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="dropdown.js">
            Dropdowns
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="modal.js">
            Modals
          </label>
        </div>
        <div class="checkbox">
          <label>
Mark Otto's avatar
Mark Otto committed
279
            <input type="checkbox" checked value="tooltip.js">
Mark Otto's avatar
Mark Otto committed
280
281
282
283
284
            Tooltips
          </label>
        </div>
        <div class="checkbox">
          <label>
285
            <input type="checkbox" checked value="popover.js" data-dependencies="tooltip.js">
Mark Otto's avatar
Mark Otto committed
286
287
288
289
290
291
            Popovers <small>(requires Tooltips)</small>
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="tab.js">
Chris Rebert's avatar
Chris Rebert committed
292
            Togglable tabs
Mark Otto's avatar
Mark Otto committed
293
          </label>
syed's avatar
syed committed
294
        </div>
Mark Otto's avatar
Mark Otto committed
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
      </div>
      <div class="col-lg-6">
        <h4>Magic</h4>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="affix.js">
            Affix
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="collapse.js">
            Collapse
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="scrollspy.js">
            Scrollspy
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="transition.js">
            Transitions <small>(required for any kind of animation)</small>
          </label>
        </div>
      </div>
Mark Otto's avatar
Mark Otto committed
323
    </div>
324

Mark Otto's avatar
Mark Otto committed
325
326
327
328
    <div class="bs-callout bs-callout-info">
      <h4>Produces two files</h4>
      <p>All checked plugins will be compiled into a readable <code>bootstrap.js</code> and a minified <code>bootstrap.min.js</code>. We recommend you use the minified version in production.</p>
    </div>
329

Mark Otto's avatar
Mark Otto committed
330
331
332
333
334
    <div class="bs-callout bs-callout-danger">
      <h4>jQuery required</h4>
      <p>All plugins require the latest version of <a href="http://jquery.com/" target="_blank">jQuery</a> to be included.</p>
    </div>
  </div>
Mark Otto's avatar
Mark Otto committed
335
336
337



338
  <div class="bs-docs-section" id="less-variables-section">
339
    <button class="btn btn-default toggle" type="button">Reset to defaults</button>
Quy Ton's avatar
Quy Ton committed
340
    <h1 id="less-variables" class="page-header">Less variables</h1>
341

Quy Ton's avatar
Quy Ton committed
342
    <p class="lead">Customize Less variables to define colors, sizes and more inside your custom CSS stylesheets.</p>
343
    {% include customizer-variables.html %}
Mark Otto's avatar
Mark Otto committed
344
  </div>
Mark Otto's avatar
Mark Otto committed
345

346
347


Mark Otto's avatar
Mark Otto committed
348
  <div class="bs-docs-section">
349
350
    <h1 id="download" class="page-header">Download</h1>

Mark Otto's avatar
Mark Otto committed
351
352
    <p class="lead">Hooray! Your custom version of Bootstrap is now ready to be compiled. Just click the button below to finish the process.</p>
    <div class="bs-customize-download">
353
      <button type="submit" id="btn-compile" class="btn btn-block btn-lg btn-outline" onclick="_gaq.push(['_trackEvent', 'Customize', 'Download', 'Customize and Download']);">Compile and Download</button>
Mark Otto's avatar
Mark Otto committed
354
355
    </div>
  </div><!-- /download -->
356
</form>