0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-01 13:24:25 +01:00

updated upgrading page

This commit is contained in:
Mark Otto 2012-01-28 01:34:07 -08:00
parent 81c128fd0b
commit d65ce1b64c
2 changed files with 367 additions and 168 deletions

View File

@ -1,86 +1,185 @@
<!-- Masthead <!-- Masthead
================================================== --> ================================================== -->
<header class="jumbotron subhead" id="overview"> <header class="jumbotron subhead" id="overview">
<h1>{{_i}}Upgrading to Bootstrap 2{{/i}}</h1> <h1>{{_i}}Upgrading to Bootstrap 2{{/i}}</h1>
<p class="lead">{{_i}}Learn about significant changes and additions since v1.4 with this handy guide.{{/i}}</p> <p class="lead">{{_i}}Learn about significant changes and additions since v1.4 with this handy guide.{{/i}}</p>
</header> </header>
<h2>Rough outline</h2>
<ul> <!-- Project
<li>{{_i}}Docs completely overhauled{{/i}} ================================================== -->
<ul> <section id="docs">
<li>{{_i}}Responsive thanks to new grid system{{/i}}</li> <div class="page-header">
<li>{{_i}}Now less marketing and more information{{/i}}</li> <h1>{{_i}}Project changes{{/i}}</h1>
<li>{{_i}}Extensive use of tables to share classes and elements of most components{{/i}}</li> </div>
<li>{{_i}}Broken down into several pages for easier consumption{{/i}}</li> <ul>
</ul> <li>{{_i}}Docs: major updates across the board to general structure, examples, and code snippets. Also made responsive with new media queries.{{/i}}</li>
</li> <li>{{_i}}Docs: all docs pages are now powered by Mustache templates and strings are wrapped in i18n tags for translation by the Twitter Translation Center. All changes to documentation must be done here and then compiled (similar to our CSS and LESS).{{/i}}</li>
<li>{{_i}}Updated grid system, now only 12 columns{{/i}} <li>{{_i}}Repo directory structure: removed the compiled CSS from the root in favor of a large direct download link on the docs homepage. Compiled CSS is in <code>/docs/assets/css/</code>.{{/i}}</li>
<ul> <li>{{_i}}Docs and repo: one makefile, just type <code>make</code> in the Terminal and get updated docs and CSS.{{/i}}</li>
<li>{{_i}}Same great classes, but now only 12 columns{{/i}}</li> </ul>
<li>{{_i}}Responsive approach means your projects virtually work out of the box on smartphones, tablets, and more{{/i}}</li> </section>
</ul>
</li>
<li>{{_i}}New thumbnails (previously media grids){{/i}}
<ul> <!-- Scaffolding
<li>{{_i}}<code>.media-grid</code> class has been changed to <code>.thumbnails</code>{{/i}}</li> ================================================== -->
<li>{{_i}}Individual thumbnails now require <code>.thumbnail</code> class{{/i}}</li> <section id="scaffolding">
</ul> <div class="page-header">
</li> <h1>{{_i}}Scaffolding{{/i}}</h1>
<li>{{_i}}Updated forms{{/i}} </div>
<ul> <h3>{{_i}}Grid system{{/i}}</h3>
<li>{{_i}}Default form style is now stacked to use less CSS and add flexibility{{/i}}</li> <ul>
<li>{{_i}}Exact same markup is required for vertical or horizontal forms&mdash;just swap the classes{{/i}}</li> <li>{{_i}}Updated grid system, now only 12 columns instead of 16{{/i}}
<li>{{_i}}New form defaults for search, inline, vertical, and horizontal{{/i}}</li> <li>{{_i}}Responsive approach means your projects virtually work out of the box on smartphones, tablets, and more{{/i}}</li>
</ul> <li>{{_i}}Removed unused (by default) grid columns support for 17-24 columns{{/i}}</li>
</li> </ul>
<li>Updated tables <h3>{{_i}}Responsive (media queries){{/i}}</h3>
<ul> <ul>
<li>{{_i}}Table classes made more consistent{{/i}}</li> <li>{{_i}}Media queries added for <strong>basic support</strong> across mobile and tablet devices{{/i}}
<li>{{_i}}Removed unused table color options (too much code for such little impact){{/i}}</li> <li>{{_i}}Responsive CSS is compiled separately, as bootstrap-responsive.css{{/i}}</li>
</ul> </ul>
</li> </section>
<li>Typography
<ul>
<li>{{_i}}Right-aligned option for blockquotes if float: right;{{/i}}</li>
<li>{{_i}}<code>h4</code> elements were dropped from 16px to 14px with a default <code>line-height</code> of 18px{{/i}}</li> <!-- Base CSS
<li>{{_i}}<code>h5</code> elements were dropped from 14px to 12px{{/i}}</li> ================================================== -->
<li>{{_i}}<code>h6</code> elements were dropped from 13px to 11px{{/i}}</li> <section id="baseCSS">
</ul> <div class="page-header">
</li> <h1>{{_i}}Base CSS{{/i}}</h1>
<li>{{_i}}Buttons{{/i}} </div>
<ul> <h3>{{_i}}Typography{{/i}}</h3>
<li>{{_i}}Added button bar options{{/i}}</li> <ul>
</ul> <li>{{_i}}<code>h4</code> elements were dropped from 16px to 14px with a default <code>line-height</code> of 18px{{/i}}</li>
</li> <li>{{_i}}<code>h5</code> elements were dropped from 14px to 12px{{/i}}</li>
<li>{{_i}}Examples{{/i}} <li>{{_i}}<code>h6</code> elements were dropped from 13px to 11px{{/i}}</li>
<ul> <li>{{_i}}Right-aligned option for blockquotes if <code>float: right;</code>{{/i}}</li>
<li>{{_i}}Fluid examples redone. <code>.fluid-container</code> now requires a <code>.sidebar-left</code> or <code>.sidebar-right</code> as well. Fluid sidebar element has a new class, <code>.fluid-sidebar</code>.{{/i}}</li> </ul>
</ul> <h3>{{_i}}Code{{/i}}</h3>
</li> <ul>
<li>{{_i}}Dropdown menus{{/i}} <li>{{_i}}New graphical style for <code>&lt;code&gt;</code>{{/i}}</li>
<ul> <li>{{_i}}Google Code Prettify styles updated (based on GitHub's gists){{/i}}</li>
<li>{{_i}}Updated the <code>.dropdown-menu</code> to tighten up spacing{{/i}}</li> </ul>
<li>{{_i}}Now requires you to add a <code>&lt;span class="caret"&gt;&lt;/span&gt;</code> to show the dropdown arrow{{/i}}</li> <h3>{{_i}}Tables{{/i}}</h3>
<li>{{_i}}The navbar (fixed topbar) has brand new dropdowns. Gone are the dark versions and in their place are the standard white ones with an additional caret at their tops for clarity of position.{{/i}}</li> <ul>
</ul> <li>{{_i}}Improved support for <code>colspan</code> and <code>rowspan</code>{{/i}}</li>
</li> <li>{{_i}}Styles now restricted to new base class, <code>.table</code>{{/i}}</li>
<li>{{_i}}Navigation{{/i}} <li>{{_i}}Table classes standardized with <code>.table-</code> required as a prefix{{/i}}</li>
<ul> <li>{{_i}}Removed unused table color options (too much code for such little impact){{/i}}</li>
<li>{{_i}}Tabs and pills now require the use of a new base class, <code>.nav</code>, on their <code>&lt;ul&gt;</code>{{/i}}</li> <li>{{_i}}Dropped support for TableSorter{{/i}}</li>
<li>{{_i}}New nav list component added that uses the same base class, <code>.nav</code>{{/i}}</li> </ul>
<li>{{_i}}Vertical tabs and pills have been added&mdash;just add <code>.stacked</code> to the <code>&lt;ul&gt;</code><{{/i}}/li> <h3>{{_i}}Buttons{{/i}}</h3>
<li>{{_i}}Pills were restyled to be less rounded by default{{/i}}</li> <ul>
<li>{{_i}}Pills now have dropdown menu support (they share the same markup and styles as tabs){{/i}}</li> <li>{{_i}}IE9: removed gradients and added rounded corners{{/i}}</li>
</ul> <li>{{_i}}Updated active state to make styling clearer in button groups (new) and look better with custom transition{{/i}}</li>
</li> <li>{{_i}}New mixin, <code>.buttonBackground</code>, to set button gradients{{/i}}</li>
</ul> </ul>
<!-- <h3>{{_i}}Forms{{/i}}</h3>
<li> <ul>
<ul> <li>{{_i}}Default form style is now vertical (stacked_ to use less CSS and add greater flexibility{{/i}}</li>
<li></li> <li>{{_i}}Form classes standardized with <code>.form-</code> required as a prefix{{/i}}</li>
</ul> <li>{{_i}}New built-in form defaults for search, inline, and horizontal forms{{/i}}</li>
</li> <li>{{_i}}More flexible horizontal form markup with classes for all styling, including new optional class for the <code>label</code>{{/i}}</li>
--> <li>{{_i}}Form states: colors updated and customizable via new LESS variables{{/i}}</li>
</ul> </ul>
<h3>{{_i}}Icons, by Glyphicons{{/i}}</h3>
<ul>
<li>{{_i}}New Glyphicons Halflings icon set added in sprite form, in black and white{{/i}}</li>
<li>{{_i}}Simple markup required for an icon in tons of contexts: <code>&lt;i class="icon cog"&gt;&lt;/&gt;</code>{{/i}}</li>
<li>{{_i}}Add another class, <code>.white</code>, for white variation of the same icon{{/i}}</li>
</ul>
</section>
<!-- Components
================================================== -->
<section id="components">
<div class="page-header">
<h1>{{_i}}Components{{/i}}</h1>
</div>
<h3>{{_i}}Button groups and dropdowns{{/i}}</h3>
<ul>
<li>{{_i}}Two brand new components in 2.0: button groups and button dropdowns{{/i}}</li>
<li>{{_i}}Dependency: button dropdowns are built on button groups, and therefore require all their styles{{/i}}</li>
<li>{{_i}}Button groups, <code>.btn-group</code>, can be grouped one level higher with a button toolbar, <code>.btn-toolbar</code>{{/i}}</li>
</ul>
<h3>{{_i}}Navigation{{/i}}</h3>
<ul>
<li>{{_i}}Tabs and pills now require the use of a new base class, <code>.nav</code>, on their <code>&lt;ul&gt;</code>{{/i}}</li>
<li>{{_i}}New nav list variation added that uses the same base class, <code>.nav</code>{{/i}}</li>
<li>{{_i}}Vertical tabs and pills have been added&mdash;just add <code>.stacked</code> to the <code>&lt;ul&gt;</code>{{/i}}</li>
<li>{{_i}}Pills were restyled to be less rounded by default{{/i}}</li>
<li>{{_i}}Pills now have dropdown menu support (they share the same markup and styles as tabs){{/i}}</li>
</ul>
<h3>{{_i}}Dropdown menus{{/i}}</h3>
<ul>
<li>{{_i}}Updated the <code>.dropdown-menu</code> to tighten up spacing{{/i}}</li>
<li>{{_i}}Now requires you to add a <code>&lt;span class="caret"&gt;&lt;/span&gt;</code> to show the dropdown arrow{{/i}}</li>
<li>{{_i}}The navbar (fixed topbar) has brand new dropdowns. Gone are the dark versions and in their place are the standard white ones with an additional caret at their tops for clarity of position.{{/i}}</li>
</ul>
<h3>{{_i}}Labels{{/i}}</h3>
<ul>
<li>{{_i}}Label colors updated to match form state colors{{/i}}</li>
<li>{{_i}}Not only do they match graphically, but they are powered by the same new variables{{/i}}</li>
</ul>
<h3>{{_i}}Thumbnails{{/i}}</h3>
<ul>
<li>{{_i}}Formerly <code>.media-grid</code>, now just <code>.thumbnails</code>, we've thoroughly extended this component for more uses while maintaining overall simplicity out of the box.{{/i}}</li>
<li>{{_i}}Individual thumbnails now require <code>.thumbnail</code> class{{/i}}</li>
</ul>
<h3>{{_i}}Alerts{{/i}}</h3>
<ul>
<li>{{_i}}New base class: <code>.alert</code> instead of <code>.alert-message</code>{{/i}}</li>
<li>{{_i}}Class names standardized for other options, now all starting with <code>.alert-</code>{{/i}}</li>
<li>{{_i}}Redesigned base alert styles to combine the deafult alerts and block-level alerts into one{{/i}}</li>
<li>{{_i}}Block level alert class changed: <code>.alert-block</code> instead of <code>.block-message</code>{{/i}}</li>
</ul>
<h3>{{_i}}Progress bars{{/i}}</h3>
<ul>
<li>{{_i}}New in 2.0{{/i}}</li>
<li>{{_i}}Features multiple styles via classes, including striped and animated variations via CSS3{{/i}}</li>
</ul>
<h3>{{_i}}Miscellaneous components{{/i}}</h3>
<ul>
<li>{{_i}}Added documentation for the well component and the close icon (used in modals and alerts){{/i}}</li>
</ul>
</section>
<!-- Javascript
================================================== -->
<section id="javascript">
<div class="page-header">
<h1>{{_i}}Javascript plugins{{/i}}</h1>
</div>
</section>
<!-- LESS
================================================== -->
<section id="less">
<div class="page-header">
<h1>{{_i}}Using LESS{{/i}}</h1>
</div>
<h3>{{_i}}Variables{{/i}}</h3>
<h3>{{_i}}Mixins{{/i}}</h3>
</section>
<!-- Customize
================================================== -->
<section id="less">
<div class="page-header">
<h1>{{_i}}Customize page{{/i}}</h1>
</div>
<ul>
<li>{{_i}}New in 2.0{{/i}}</li>
</ul>
</section>

View File

@ -63,92 +63,192 @@
<div class="container"> <div class="container">
<!-- Masthead <!-- Masthead
================================================== --> ================================================== -->
<header class="jumbotron subhead" id="overview"> <header class="jumbotron subhead" id="overview">
<h1>Upgrading to Bootstrap 2</h1> <h1>Upgrading to Bootstrap 2</h1>
<p class="lead">Learn about significant changes and additions since v1.4 with this handy guide.</p> <p class="lead">Learn about significant changes and additions since v1.4 with this handy guide.</p>
</header> </header>
<!-- Project
================================================== -->
<section id="docs">
<div class="page-header">
<h1>Project changes</h1>
</div>
<ul>
<li>Docs: major updates across the board to general structure, examples, and code snippets. Also made responsive with new media queries.</li>
<li>Docs: all docs pages are now powered by Mustache templates and strings are wrapped in i18n tags for translation by the Twitter Translation Center. All changes to documentation must be done here and then compiled (similar to our CSS and LESS).</li>
<li>Repo directory structure: removed the compiled CSS from the root in favor of a large direct download link on the docs homepage. Compiled CSS is in <code>/docs/assets/css/</code>.</li>
<li>Docs and repo: one makefile, just type <code>make</code> in the Terminal and get updated docs and CSS.</li>
</ul>
</section>
<!-- Scaffolding
================================================== -->
<section id="scaffolding">
<div class="page-header">
<h1>Scaffolding</h1>
</div>
<h3>Grid system</h3>
<ul>
<li>Updated grid system, now only 12 columns instead of 16
<li>Responsive approach means your projects virtually work out of the box on smartphones, tablets, and more</li>
<li>Removed unused (by default) grid columns support for 17-24 columns</li>
</ul>
<h3>Responsive (media queries)</h3>
<ul>
<li>Media queries added for <strong>basic support</strong> across mobile and tablet devices
<li>Responsive CSS is compiled separately, as bootstrap-responsive.css</li>
</ul>
</section>
<!-- Base CSS
================================================== -->
<section id="baseCSS">
<div class="page-header">
<h1>Base CSS</h1>
</div>
<h3>Typography</h3>
<ul>
<li><code>h4</code> elements were dropped from 16px to 14px with a default <code>line-height</code> of 18px</li>
<li><code>h5</code> elements were dropped from 14px to 12px</li>
<li><code>h6</code> elements were dropped from 13px to 11px</li>
<li>Right-aligned option for blockquotes if <code>float: right;</code></li>
</ul>
<h3>Code</h3>
<ul>
<li>New graphical style for <code>&lt;code&gt;</code></li>
<li>Google Code Prettify styles updated (based on GitHub's gists)</li>
</ul>
<h3>Tables</h3>
<ul>
<li>Improved support for <code>colspan</code> and <code>rowspan</code></li>
<li>Styles now restricted to new base class, <code>.table</code></li>
<li>Table classes standardized with <code>.table-</code> required as a prefix</li>
<li>Removed unused table color options (too much code for such little impact)</li>
<li>Dropped support for TableSorter</li>
</ul>
<h3>Buttons</h3>
<ul>
<li>IE9: removed gradients and added rounded corners</li>
<li>Updated active state to make styling clearer in button groups (new) and look better with custom transition</li>
<li>New mixin, <code>.buttonBackground</code>, to set button gradients</li>
</ul>
<h3>Forms</h3>
<ul>
<li>Default form style is now vertical (stacked_ to use less CSS and add greater flexibility</li>
<li>Form classes standardized with <code>.form-</code> required as a prefix</li>
<li>New built-in form defaults for search, inline, and horizontal forms</li>
<li>More flexible horizontal form markup with classes for all styling, including new optional class for the <code>label</code></li>
<li>Form states: colors updated and customizable via new LESS variables</li>
</ul>
<h3>Icons, by Glyphicons</h3>
<ul>
<li>New Glyphicons Halflings icon set added in sprite form, in black and white</li>
<li>Simple markup required for an icon in tons of contexts: <code>&lt;i class="icon cog"&gt;&lt;/&gt;</code></li>
<li>Add another class, <code>.white</code>, for white variation of the same icon</li>
</ul>
</section>
<!-- Components
================================================== -->
<section id="components">
<div class="page-header">
<h1>Components</h1>
</div>
<h3>Button groups and dropdowns</h3>
<ul>
<li>Two brand new components in 2.0: button groups and button dropdowns</li>
<li>Dependency: button dropdowns are built on button groups, and therefore require all their styles</li>
<li>Button groups, <code>.btn-group</code>, can be grouped one level higher with a button toolbar, <code>.btn-toolbar</code></li>
</ul>
<h3>Navigation</h3>
<ul>
<li>Tabs and pills now require the use of a new base class, <code>.nav</code>, on their <code>&lt;ul&gt;</code></li>
<li>New nav list variation added that uses the same base class, <code>.nav</code></li>
<li>Vertical tabs and pills have been added&mdash;just add <code>.stacked</code> to the <code>&lt;ul&gt;</code></li>
<li>Pills were restyled to be less rounded by default</li>
<li>Pills now have dropdown menu support (they share the same markup and styles as tabs)</li>
</ul>
<h3>Dropdown menus</h3>
<ul>
<li>Updated the <code>.dropdown-menu</code> to tighten up spacing</li>
<li>Now requires you to add a <code>&lt;span class="caret"&gt;&lt;/span&gt;</code> to show the dropdown arrow</li>
<li>The navbar (fixed topbar) has brand new dropdowns. Gone are the dark versions and in their place are the standard white ones with an additional caret at their tops for clarity of position.</li>
</ul>
<h3>Labels</h3>
<ul>
<li>Label colors updated to match form state colors</li>
<li>Not only do they match graphically, but they are powered by the same new variables</li>
</ul>
<h3>Thumbnails</h3>
<ul>
<li>Formerly <code>.media-grid</code>, now just <code>.thumbnails</code>, we've thoroughly extended this component for more uses while maintaining overall simplicity out of the box.</li>
<li>Individual thumbnails now require <code>.thumbnail</code> class</li>
</ul>
<h3>Alerts</h3>
<ul>
<li>New base class: <code>.alert</code> instead of <code>.alert-message</code></li>
<li>Class names standardized for other options, now all starting with <code>.alert-</code></li>
<li>Redesigned base alert styles to combine the deafult alerts and block-level alerts into one</li>
<li>Block level alert class changed: <code>.alert-block</code> instead of <code>.block-message</code></li>
</ul>
<h3>Progress bars</h3>
<ul>
<li>New in 2.0</li>
<li>Features multiple styles via classes, including striped and animated variations via CSS3</li>
</ul>
<h3>Miscellaneous components</h3>
<ul>
<li>Added documentation for the well component and the close icon (used in modals and alerts)</li>
</ul>
</section>
<!-- Javascript
================================================== -->
<section id="javascript">
<div class="page-header">
<h1>Javascript plugins</h1>
</div>
</section>
<!-- LESS
================================================== -->
<section id="less">
<div class="page-header">
<h1>Using LESS</h1>
</div>
<h3>Variables</h3>
<h3>Mixins</h3>
</section>
<!-- Customize
================================================== -->
<section id="less">
<div class="page-header">
<h1>Customize page</h1>
</div>
<ul>
<li>New in 2.0</li>
</ul>
</section>
<h2>Rough outline</h2>
<ul>
<li>Docs completely overhauled
<ul>
<li>Responsive thanks to new grid system</li>
<li>Now less marketing and more information</li>
<li>Extensive use of tables to share classes and elements of most components</li>
<li>Broken down into several pages for easier consumption</li>
</ul>
</li>
<li>Updated grid system, now only 12 columns
<ul>
<li>Same great classes, but now only 12 columns</li>
<li>Responsive approach means your projects virtually work out of the box on smartphones, tablets, and more</li>
</ul>
</li>
<li>New thumbnails (previously media grids)
<ul>
<li><code>.media-grid</code> class has been changed to <code>.thumbnails</code></li>
<li>Individual thumbnails now require <code>.thumbnail</code> class</li>
</ul>
</li>
<li>Updated forms
<ul>
<li>Default form style is now stacked to use less CSS and add flexibility</li>
<li>Exact same markup is required for vertical or horizontal forms&mdash;just swap the classes</li>
<li>New form defaults for search, inline, vertical, and horizontal</li>
</ul>
</li>
<li>Updated tables
<ul>
<li>Table classes made more consistent</li>
<li>Removed unused table color options (too much code for such little impact)</li>
</ul>
</li>
<li>Typography
<ul>
<li>Right-aligned option for blockquotes if float: right;</li>
<li><code>h4</code> elements were dropped from 16px to 14px with a default <code>line-height</code> of 18px</li>
<li><code>h5</code> elements were dropped from 14px to 12px</li>
<li><code>h6</code> elements were dropped from 13px to 11px</li>
</ul>
</li>
<li>Buttons
<ul>
<li>Added button bar options</li>
</ul>
</li>
<li>Examples
<ul>
<li>Fluid examples redone. <code>.fluid-container</code> now requires a <code>.sidebar-left</code> or <code>.sidebar-right</code> as well. Fluid sidebar element has a new class, <code>.fluid-sidebar</code>.</li>
</ul>
</li>
<li>Dropdown menus
<ul>
<li>Updated the <code>.dropdown-menu</code> to tighten up spacing</li>
<li>Now requires you to add a <code>&lt;span class="caret"&gt;&lt;/span&gt;</code> to show the dropdown arrow</li>
<li>The navbar (fixed topbar) has brand new dropdowns. Gone are the dark versions and in their place are the standard white ones with an additional caret at their tops for clarity of position.</li>
</ul>
</li>
<li>Navigation
<ul>
<li>Tabs and pills now require the use of a new base class, <code>.nav</code>, on their <code>&lt;ul&gt;</code></li>
<li>New nav list component added that uses the same base class, <code>.nav</code></li>
<li>Vertical tabs and pills have been added&mdash;just add <code>.stacked</code> to the <code>&lt;ul&gt;</code></li>
<li>Pills were restyled to be less rounded by default</li>
<li>Pills now have dropdown menu support (they share the same markup and styles as tabs)</li>
</ul>
</li>
</ul>
<!--
<li>
<ul>
<li></li>
</ul>
</li>
-->
</ul>
<!-- Footer <!-- Footer
================================================== --> ================================================== -->