diff --git a/.bootstraprc-4-default b/.bootstraprc-4-default index 21044fab..3afd107b 100644 --- a/.bootstraprc-4-default +++ b/.bootstraprc-4-default @@ -12,6 +12,7 @@ useFlexbox: true styleLoaders: - style - css + - postcss - sass # Extract styles to stand-alone css file diff --git a/CHANGELOG.md b/CHANGELOG.md index bb546d20..ac48b826 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,15 @@ # Change Log +All notable changes to this project will be documented in this file. Items under `Unreleased` is upcoming features that will be out in next version. -See [GitHub Releases section](https://github.com/shakacode/bootstrap-loader/releases). +Contributors: please follow the recommendations outlined at [keepachangelog.com](http://keepachangelog.com/). Please use the existing headings and styling as a guide, and add a link for the version diff at the bottom of the file. Also, please update the `Unreleased` link to compare to the latest release version. +## [Unreleased] + +## [1.0.9] - 2016-02-28 +##### Fixed +- Updated to support Bootstrap 4, Alpha 2, including examples. See [#56](https://github.com/shakacode/bootstrap-loader/pull/56) by [justin808](https://github.com/justin808). + +## [1.0.8] + +[Unreleased]: https://github.com/shakacode/bootstrap-loader/compare/1.0.9...master +[1.0.9]: https://github.com/shakacode/bootstrap-loader/compare/1.0.8...1.0.9 +[1.0.8]: https://github.com/shakacode/bootstrap-loader/compare/1.0.7...1.0.8 diff --git a/README.md b/README.md index 226fe953..2d126ecf 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,19 @@ Successor to [bootstrap-sass-loader](https://github.com/shakacode/bootstrap-sass-loader). Load Bootstrap styles and scripts in your Webpack bundle. This loader uses SASS to process CSS styles. Bootstrap 3 & 4 are supported. +**NOTE:** [Bootstrap 4](http://v4-alpha.getbootstrap.com/), (twbs/bootstrap)[https://github.com/twbs/bootstrap] is currently in alpha right now. Bootstrap 4 definitely worked when we first released this package. The parent company of this product, [ShakaCode](http://www.shakacode.com) had originally planned to use it for our upcoming commercial product, but we decided that Bootstrap 4 was changing to fast for a production product. Thus, we're still using Bootstrap 3, and we're not actively developing with Bootstrap 4. Consequently, for Bootstrap 4 issues, we need one of: + +1. Community support to help us with Bootstrap 4 issues and pull requests. +2. We'd be thrilled to have another maintainer join us to help with Bootstrap 4 issues. +3. We'd also be thrilled if any companies are open to sponsoring the development of features and issues regarding Bootstrap 4. + +That being said, Bootstrap 4 probably works just fine! + +## NEWS + +2016-02-28: Released 1.0.9. Updated to support Bootstrap 4, alpha 2! + + ## Installation Get it via npm: @@ -41,6 +54,8 @@ entry: [ 'bootstrap-loader', './app' ] Config is optional. It can be placed in root dir with name `.bootstraprc`. You can write it in `YAML` or `JSON` formats. Take a look at the default config files for [Bootstrap 3](.bootstraprc-3-default) and [Bootstrap 4](.bootstraprc-4-default). Note, we recommend using a configuration or else you might pick up unwanted upgrades, such as when we make Bootstrap 4 the default. +Config is optional. It can be placed in root dir with name `.bootstraprc`. You can write it in `YAML` or `JSON` formats. Take a look at the default config files for [Bootstrap 3](.bootstraprc-3-default) and [Bootstrap 4](.bootstraprc-4-default). Note, we recommend using a configuration or else you might pick up unwanted upgrades, such as when we make Bootstrap 4 the default. Config options don't fall back on the defaults once a config file is present. Be sure not to delete config options. To start with a custom config, copy over a default config file as a starting point. + ```yaml --- # You can use comments here @@ -247,6 +262,31 @@ Enable / disable flexbox model. useFlexbox: true ``` +#### Tether +Additionally, Bootstrap 4 requires Tether. You can add Tether per the examples in the `/examples` directory. + +1. Add tether to package.json: `npm i --save tether` +2. Add tether as an entry point to your webpack config. +3. Add this plugin to your webpack config: + +``` + plugins: [ + new ExtractTextPlugin('app.css', { allChunks: true }), + new webpack.ProvidePlugin({ + "window.Tether": "tether" + }), + ], +``` + +#### PostCSS +Bootstrap 4 seems to require postcss: + +1. Add postcss and the the postcss-loader: `npm i --save postcss postcss-loader` +2. Put `postcss` before `sass` in the order of loaders in your `.bootstraprc` file. + +#### Glyphicons +Glyphicons have been removed from Bootstrap 4. The examples demonstrate how to use the font-awesome-loader + ## Additional configurations #### Paths to custom assets diff --git a/examples/basic/.bootstraprc-4-example b/examples/basic/.bootstraprc-4-example index cbceaedd..3f04aac0 100644 --- a/examples/basic/.bootstraprc-4-example +++ b/examples/basic/.bootstraprc-4-example @@ -12,6 +12,7 @@ useFlexbox: true styleLoaders: - style - css + - postcss - sass # Extract styles to stand-alone css file diff --git a/examples/basic/app/markup/bootstrap-dev.html b/examples/basic/app/markup/bootstrap-dev.html index aeed2715..d383afdf 100644 --- a/examples/basic/app/markup/bootstrap-dev.html +++ b/examples/basic/app/markup/bootstrap-dev.html @@ -8,33 +8,142 @@
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
+This is a simple hero unit, a simple jumbotron-style component for calling + extra attention to featured content or information.
It uses utility classes for typography and spacing to space content out within the larger container.
+It uses utility classes for typography and spacing to space content out within the + larger container.
- + Learn more
This is a longer card with supporting text below as a natural + lead-in to additional content. This content is a little bit longer.
+++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a + ante.
+ +
This card has supporting text below as a natural lead-in to + additional content.
++ Last updated 3 mins ago +
+++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat.
+ +
This card has supporting text below as a natural lead-in to + additional content.
++ Last updated 3 mins ago +
+++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a + ante.
+ +
This is a wider card with supporting text below as a natural + lead-in to additional content. This card has even longer content than the first to + show that equal height action.
++ Last updated 3 mins ago +
+This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
+This is a simple hero unit, a simple jumbotron-style component for calling + extra attention to featured content or information.
It uses utility classes for typography and spacing to space content out within the larger container.
+It uses utility classes for typography and spacing to space content out within the + larger container.
- + Learn more
This is a longer card with supporting text below as a natural + lead-in to additional content. This content is a little bit longer.
+++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a + ante.
+ +
This card has supporting text below as a natural lead-in to + additional content.
++ Last updated 3 mins ago +
+++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat.
+ +
This card has supporting text below as a natural lead-in to + additional content.
++ Last updated 3 mins ago +
+++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a + ante.
+ +
This is a wider card with supporting text below as a natural + lead-in to additional content. This card has even longer content than the first to + show that equal height action.
++ Last updated 3 mins ago +
+This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.
+++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
+ +
This card has supporting text below as a natural lead-in to additional content.
+Last updated 3 mins ago
+++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat.
+ +
This card has supporting text below as a natural lead-in to additional content.
+Last updated 3 mins ago
+++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
+ +
++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
+ +
This is a wider card with supporting text below as a natural lead-in to additional content. This card has even longer content than the first to show that equal height action.
+Last updated 3 mins ago
+