guard-sass 0.5.2 → 0.5.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/README.md +24 -6
- data/lib/guard/sass/runner.rb +1 -1
- data/lib/guard/sass/version.rb +1 -1
- data/lib/guard/sass.rb +1 -0
- metadata +10 -10
data/README.md
CHANGED
@@ -3,6 +3,7 @@
|
|
3
3
|
guard-sass compiles or validates your sass (and scss) files automatically when
|
4
4
|
changed.
|
5
5
|
|
6
|
+
|
6
7
|
## Install
|
7
8
|
|
8
9
|
You will need to have [guard](http://github.com/guard/guard) to continue, so
|
@@ -20,16 +21,18 @@ And finally add a basic setup to your Guardfile with:
|
|
20
21
|
|
21
22
|
guard init sass
|
22
23
|
|
24
|
+
|
23
25
|
## Usage
|
24
26
|
|
25
27
|
Please read the [Guard usage documentation][gdoc].
|
26
28
|
|
29
|
+
|
27
30
|
## Guardfile
|
28
31
|
|
29
32
|
guard-sass can be adapted to all kind of projects. Please read the
|
30
33
|
[Guard documentation][gdoc] for more information about the Guardfile DSL.
|
31
34
|
|
32
|
-
### Ruby
|
35
|
+
### Ruby Project
|
33
36
|
|
34
37
|
In a Ruby project you want to configure your input and output directories.
|
35
38
|
|
@@ -39,7 +42,7 @@ If your output directory is the same as the input directory, you can simply skip
|
|
39
42
|
|
40
43
|
guard 'sass', :input => 'styles'
|
41
44
|
|
42
|
-
### Rails
|
45
|
+
### Rails App With the Asset Pipeline
|
43
46
|
|
44
47
|
With the introduction of the [asset pipeline][rpipe] in Rails 3.1 there is no
|
45
48
|
need to compile your Sass stylesheets with this Guard. However, if you would
|
@@ -59,13 +62,22 @@ compilation message:
|
|
59
62
|
:noop => true,
|
60
63
|
:hide_success => true
|
61
64
|
|
62
|
-
### Rails
|
65
|
+
### Rails App Without the Asset Pipeline
|
63
66
|
|
64
67
|
Without the asset pipeline you just define an input and output directory as in
|
65
68
|
a normal Ruby project:
|
66
69
|
|
67
70
|
guard 'sass', :input => 'app/stylesheets', :output => 'public/stylesheets'
|
68
71
|
|
72
|
+
### Output Extensions
|
73
|
+
|
74
|
+
It is standard practice in Rails 3.1 to write sass/scss files with the extension
|
75
|
+
`.css.sass` to prevent these being written as `.css.sass.css` you need to set
|
76
|
+
the `:extension` option like so:
|
77
|
+
|
78
|
+
guard 'sass', :input => 'styles', :extension => ''
|
79
|
+
|
80
|
+
|
69
81
|
## Options
|
70
82
|
|
71
83
|
The following options can be passed to guard-sass:
|
@@ -74,8 +86,11 @@ The following options can be passed to guard-sass:
|
|
74
86
|
# A suffix `/(.+\.s[ac]ss)` will be added to this option.
|
75
87
|
# default: nil
|
76
88
|
|
77
|
-
:output => '
|
89
|
+
:output => 'stylesheets' # Relative path to the output directory.
|
78
90
|
# default: 'css' or the :input option when supplied
|
91
|
+
|
92
|
+
:extension => '' # Extension used for written files.
|
93
|
+
# default: '.css'
|
79
94
|
|
80
95
|
:hide_success => true # Disable successful compilation messages.
|
81
96
|
# default: false
|
@@ -96,7 +111,7 @@ The following options can be passed to guard-sass:
|
|
96
111
|
:debug_info => true # File and line number info for FireSass.
|
97
112
|
# default: false
|
98
113
|
|
99
|
-
### Output
|
114
|
+
### Output Short Notation
|
100
115
|
|
101
116
|
guard-sass also has a short notation like [guard-coffeescript][gcs], this lets
|
102
117
|
you define an input folder (with an optional output folder) automatically creating
|
@@ -116,7 +131,7 @@ These are equivalent to
|
|
116
131
|
watch %r{^stylesheets/(.+\.s[ac]ss)$}
|
117
132
|
end
|
118
133
|
|
119
|
-
### Nested
|
134
|
+
### Nested Directories
|
120
135
|
|
121
136
|
By default the guard detects nested directories and writes files into the output
|
122
137
|
directory with the same structure.
|
@@ -147,6 +162,7 @@ This behaviour can be switched off by passing the option `:shallow => true` to t
|
|
147
162
|
Guard, so that all stylesheets will be compiled directly to the output directory.
|
148
163
|
So the previous example would have compiled to `public/stylesheets/button.css`.
|
149
164
|
|
165
|
+
|
150
166
|
## Development
|
151
167
|
|
152
168
|
- Source hosted at [GitHub](https://github.com/hawx/guard-sass)
|
@@ -157,6 +173,7 @@ Pull requests are very welcome!
|
|
157
173
|
For questions please join us on our [Google group][ggroup] or
|
158
174
|
on `#guard` (irc.freenode.net).
|
159
175
|
|
176
|
+
|
160
177
|
## Contributors
|
161
178
|
|
162
179
|
Have a look at the [GitHub contributor][contrib] list to see all contributors.
|
@@ -164,6 +181,7 @@ Have a look at the [GitHub contributor][contrib] list to see all contributors.
|
|
164
181
|
Since this Guard is very close to [guard-coffeescript][gcs], some features have been
|
165
182
|
incorporated into guard-sass.
|
166
183
|
|
184
|
+
|
167
185
|
## License
|
168
186
|
|
169
187
|
(The MIT License)
|
data/lib/guard/sass/runner.rb
CHANGED
@@ -93,7 +93,7 @@ module Guard
|
|
93
93
|
# @param file [String] Name of the file
|
94
94
|
# @return [String] Path of file written
|
95
95
|
def write_file(content, dir, file)
|
96
|
-
path = File.join(dir, File.basename(file
|
96
|
+
path = File.join(dir, File.basename(file, '.*')) << options[:extension]
|
97
97
|
|
98
98
|
unless options[:noop]
|
99
99
|
FileUtils.mkdir_p(dir)
|
data/lib/guard/sass/version.rb
CHANGED
data/lib/guard/sass.rb
CHANGED
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: guard-sass
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.5.
|
4
|
+
version: 0.5.3
|
5
5
|
prerelease:
|
6
6
|
platform: ruby
|
7
7
|
authors:
|
@@ -9,11 +9,11 @@ authors:
|
|
9
9
|
autorequire:
|
10
10
|
bindir: bin
|
11
11
|
cert_chain: []
|
12
|
-
date: 2011-10-
|
12
|
+
date: 2011-10-29 00:00:00.000000000Z
|
13
13
|
dependencies:
|
14
14
|
- !ruby/object:Gem::Dependency
|
15
15
|
name: guard
|
16
|
-
requirement: &
|
16
|
+
requirement: &2152970280 !ruby/object:Gem::Requirement
|
17
17
|
none: false
|
18
18
|
requirements:
|
19
19
|
- - ! '>='
|
@@ -21,10 +21,10 @@ dependencies:
|
|
21
21
|
version: 0.4.0
|
22
22
|
type: :runtime
|
23
23
|
prerelease: false
|
24
|
-
version_requirements: *
|
24
|
+
version_requirements: *2152970280
|
25
25
|
- !ruby/object:Gem::Dependency
|
26
26
|
name: sass
|
27
|
-
requirement: &
|
27
|
+
requirement: &2156208240 !ruby/object:Gem::Requirement
|
28
28
|
none: false
|
29
29
|
requirements:
|
30
30
|
- - ! '>='
|
@@ -32,10 +32,10 @@ dependencies:
|
|
32
32
|
version: '3.1'
|
33
33
|
type: :runtime
|
34
34
|
prerelease: false
|
35
|
-
version_requirements: *
|
35
|
+
version_requirements: *2156208240
|
36
36
|
- !ruby/object:Gem::Dependency
|
37
37
|
name: bundler
|
38
|
-
requirement: &
|
38
|
+
requirement: &2156348440 !ruby/object:Gem::Requirement
|
39
39
|
none: false
|
40
40
|
requirements:
|
41
41
|
- - ~>
|
@@ -43,10 +43,10 @@ dependencies:
|
|
43
43
|
version: 1.0.2
|
44
44
|
type: :development
|
45
45
|
prerelease: false
|
46
|
-
version_requirements: *
|
46
|
+
version_requirements: *2156348440
|
47
47
|
- !ruby/object:Gem::Dependency
|
48
48
|
name: rspec
|
49
|
-
requirement: &
|
49
|
+
requirement: &2156734020 !ruby/object:Gem::Requirement
|
50
50
|
none: false
|
51
51
|
requirements:
|
52
52
|
- - ! '>'
|
@@ -54,7 +54,7 @@ dependencies:
|
|
54
54
|
version: 2.0.0.rc
|
55
55
|
type: :development
|
56
56
|
prerelease: false
|
57
|
-
version_requirements: *
|
57
|
+
version_requirements: *2156734020
|
58
58
|
description: Guard::Sass automatically rebuilds sass (like sass --watch)
|
59
59
|
email:
|
60
60
|
- m@hawx.me
|