bemify 0.0.1 → 0.1.2

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    NGI1MmI0OWNjMDMxNTFmMDNhOGE1ZTZjYjViZTEyZWU5MjBjOGQ5OA==
+    YWM0NDAwZDQ1MzVmNjVkZTAxM2FmYWI2ZjllOWFjZDUwMTQ5MWNjMA==
   data.tar.gz: !binary |-
-    OWI3ODlmMTJiNzA3NDU3YTIwY2JlNWQzN2QzMDQxMWViMjY4YTg2Ng==
+    ZGEwNDgyNDlmNWIwMGU5N2JmNTdkNmQyZjUzMzA4YWYyZmNjOTQ2Nw==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    ZmRmNDZlMDg4MmM2YjdmYTgzYWUxZGFiOTJkOTZmYWNjMWQ5NDg0MThiMTBm
-    OGIyNjc1NzA5NzczMmE5ODA2NzhlZGUwY2VkMjQ3YTk4NTFlZmQ5NWJlYjYw
-    ZjE2NGIzYzJkNTc4ZTQ1ZTUxZWMyYjY2ODVlYzgwYTg2NWVkMTM=
+    MGMzYTM1MTBiMjhiNzU5OGQyZDM1ZTJlYTA2OGIxYmQ2ZGFjMmM1MTBiMTYy
+    ODVkZDIzM2Q5ZjkxNjJiZjkwNWZiNzQ2NjRiMGU3NjUwNmUwMGNjZTQ2MmJj
+    NmZmZDE3ZWExMDA0OGE3ZTRmMTA3NGZlOTljMTE3MTZkZDM3NTI=
   data.tar.gz: !binary |-
-    NjgyZTMxNTBiYjUxNjJhNDVlNjFiN2NiYmY1MmEzNDE4YTViN2MyOWUwYjk1
-    NDE1ZDhhZjA0ZDk2MTMzZGUzMWE3YzAzZWUxOGM3NjUyNjdlYjQwY2RhZTBi
-    ODJkMTczMzBmYTFiYzk2NjIxZjI3NjI5MWZkZThjZDgxMWEwMDI=
+    YTUyMmEyZDMzN2Q5ZDMwYjhkM2U0YmYwNTkzZDJkZmRkZDczNGNiMWY4Yjgz
+    NmI2ZmQ1YjUwZTFiMDM5NDlhZGZhOGMxZTkxZTk0NWMxN2QyNmQxMTgwOWYw
+    OWUxZjUyZjYyOWRlZTBiNzViMDAxNTlmMjNhZGQ4ZDY3MTRjYmM=

data/README.md

@@ -2,24 +2,33 @@
 
 [![Bower Version](https://img.shields.io/bower/v/bemify.svg)](https://img.shields.io/bower/v/bemify.svg)
 [![Gem Version](https://img.shields.io/gem/v/bemify.svg)](https://img.shields.io/gem/v/bemify.svg)
+[![npm Version](https://img.shields.io/npm/v/bemify.svg)](https://img.shields.io/npm/v/bemify.svg)
 
-Bemify is a set of mixins to help you write well-structured, readable, maintainable, component-based modular SCSS source using a BEM-style syntax.
+Bemify is a set of Sass mixins to help you write well-structured, readable, maintainable, component-based modular SCSS source using a BEM-style syntax.
 
+__Bemify site & documentation: [http://franzheidl.github.io/bemify/](http://franzheidl.github.io/bemify/)__
 
+Bemify supports [libsass](https://github.com/sass/libsass) since libsass 3.2.4.
 ## Install
 
-Bemify can be installed as a Ruby Gem, via [Bower](http://bower.io), or manually.
+Bemify can be installed as a [Ruby Gem](https://rubygems.org/gems/bemify), via [Bower](http://bower.io/search/?q=bemify), [NPM](https://www.npmjs.com/package/bemify), or manually. As a NPM module, bemify supports [eyeglass](https://github.com/sass-eyeglass/eyeglass). Bemify is also on [Sache.in](http://www.sache.in/search?query=bemify).
+
 
 ### Bower
 To install via bower run:
 
-    $ bower install --save-dev bemify
+    $ bower install bemify --save-dev
 
 ### Ruby Gem
 When installed as a Ruby Gem, Bemify will be installed as a Compass extension if Compass is installed on your system.
 
     $ gem install bemify
 
+### npm
+To install via npm run:
+
+    $npm install bemify --save-dev
+
 ### Manual Install
 Include `sass/_bemify.scss`in the appropriate location in your project.
 
@@ -83,19 +92,21 @@ The mixins can be nested to create modifiers for subcomponents:
     @include block('my-element') {
 
         @include element('child') {
+            …
             @include modifier('bad') {
+                …
                 @include state('happy') {
-
+                    …
                 }
             }
         }
 
         @include modifier('large') {
-
+            …
         }
 
         @include state('active') {
-
+            …
         }
 
     }
@@ -103,23 +114,23 @@ The mixins can be nested to create modifiers for subcomponents:
 This will result in:
 
     .my-element {
-
+        …
     }
 
     .my-element__child {
-
+        …
     }
 
     .my-element__child--bad {
-
+        …
     }
 
     .my-element__child--bad.is-happy {
-
+        …
     }
 
     .my-element--large {
-
+        …
     }
 
     .my-element.is-active {
@@ -143,16 +154,17 @@ Bemify can can of course also be used inside any scope:
 
 ### Configuration Options
 
-bemify uses a configuration file where you can adjust the block-element and the state separator, as well as the state prefix.
-To overwrite bemify's config with your own configuration file, import your configuration AFTER importing bemify, BUT BEFORE calling the mixins.
+bemify uses some configuration variables where to adjust the block-element and the state separator, as well as the state prefix.
+To overwrite bemify's config with your own configuration file, just import your variables before using one of the mixins.
 
+    @import "your-variables";
     @import "bemify";
-    @import "my_config";
 
     @include block('my-block') {
-        //…
+        …
     }
 
+
 Configurable options and their defaults are:
 
 * `$combined-state-selectors`: `true`
@@ -171,7 +183,7 @@ Configurable options and their defaults are:
 
 
 ## Aliases
-Not everyone thinks in the categories of 'block, element, modifier', but many of us still want to write modularized, components-based CSS. There are a couple of aliases included for those who think in terms of components, parent-child / -subcomponents included:
+Not everyone thinks in the categories of 'block, element, modifier', but many of us still want to write modularized, components-based CSS. There are a couple of aliases included for those who think in terms of components, parent-child / -subcomponents included (And it's totally straightforward to add your own):
 
     @include block('name') {}
         == @include component('name') {}
@@ -186,9 +198,14 @@ Not everyone thinks in the categories of 'block, element, modifier', but many of
 
 
 ## Resources
+Some highly recommended reading re CSS structure, decoupling markup and styles, BEM, and why this makes sense:
+
 
-* [Harry Roberts: MindBEMding – getting your head ’round BEM syntax](http://csswizardry.com/2013/01/mindbemding-getting-your-head-round-bem-syntax/)
 * [Nicolas Gallagher: About HTML semantics and front-end architecture](http://nicolasgallagher.com/about-html-semantics-front-end-architecture/)
+* [Philip Walton: Side Effects in CSS](http://philipwalton.com/articles/side-effects-in-css/)
+* [BEM official](http://getbem.com/)
+* [Harry Roberts: MindBEMding – getting your head ’round BEM syntax](http://csswizardry.com/2013/01/mindbemding-getting-your-head-round-bem-syntax/)
+
 
 
 ---

data/lib/bemify.rb

@@ -12,6 +12,6 @@ else
 end
 
 module Bemify
-  VERSION = "0.0.1"
-  DATE = "2015-04-17"
+  VERSION = "0.1.2"
+  DATE = "2016-03-30"
 end

data/sass/_bemify.scss

@@ -8,22 +8,22 @@
 // CONFIG
 // ======
 
-// You can change the configuration here. To use your own config/variables file, import your config after importing bemify and before calling bemify's mixins.
+// You can change the configuration here. To use your own config/variables file, just import your variables before using one of the mixins.
 
 // Output combined state selectors like:
 //    .block__element.is-active {}
 // Set to false to output single, non-combined state modifiers:
 //    .block__element--is-active {}
-$combined-state-selectors:    true;
+$combined-state-selectors: true !default;
 
 // .block[separator]element:
-$element-separator:              "__";
+$element-separator:        "__" !default;
 
 // .block[separator]modifier:
-$modifier-separator:             "--";
+$modifier-separator:       "--" !default;
 
 // The default prefix for state modifier selectors, will be combined with $modifier-separator:
-$state-prefix:                "is";
+$state-prefix:             "is" !default;
 
 
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bemify
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Franz Heidl
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-17 00:00:00.000000000 Z
+date: 2016-03-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sass