middleman-targets 1.0.4 → 1.0.5
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.
- checksums.yaml +4 -4
- data/Rakefile +21 -0
- data/documentation_project/Gemfile +1 -1
- data/documentation_project/config.rb +1 -1
- data/documentation_project/source/helpers-resources.html.md.erb +3 -6
- data/documentation_project/source/partials/config.erb +334 -288
- data/documentation_project/source/partials/helpers.erb +204 -322
- data/documentation_project/source/partials/helpers_extended.erb +139 -0
- data/documentation_project/source/partials/resources.erb +88 -78
- data/lib/middleman-targets/extension.rb +4 -1
- data/lib/middleman-targets/version.rb +1 -1
- data/yard/readme.md +3 -3
- data/yard/template-grouped/default/module/html/method_details_list.erb +11 -0
- data/yard/template-partials/default/method_details/setup.rb +4 -0
- data/yard/template-partials/default/module/html/method_details_list.erb +11 -0
- data/yard/template-partials/default/module/setup.rb +6 -0
- data/yard/template-partials/default/onefile/html/layout.erb +1 -0
- data/yard/template-partials/default/onefile/html/setup.rb +4 -0
- data/yard/yard_extensions.rb +86 -49
- metadata +10 -11
- data/yard/templates/default/fulldoc/html/css/common.css +0 -1
- data/yard/templates/default/fulldoc/html/css/full_list.css +0 -57
- data/yard/templates/default/fulldoc/html/css/style.css +0 -343
- data/yard/templates/default/onefile/html/files.erb +0 -5
- data/yard/templates/default/onefile/html/headers.erb +0 -6
- data/yard/templates/default/onefile/html/layout.erb +0 -17
- data/yard/templates/default/onefile/html/readme.erb +0 -3
- data/yard/templates/default/onefile/html/setup.rb +0 -61
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 5d85fe59332483c81a049792ad7a00eae847e3d2
|
|
4
|
+
data.tar.gz: eeba5c5a693173341bff0cfa0b81fcabdb37a245
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: bcceac1f84f709dd37eff8d7cb953ec5eb01a8a0b03d013a337f13b4d273d08e1d96295aacb7cc0f9a58029e94555f099b1e1fa825597a8d65c43314d6dc6ee0
|
|
7
|
+
data.tar.gz: 9b54fc64ccd56e90c70cc2e4f32ffb71070300e2262a2d755b9d2139d40a3945c07206b969ca960f69fc60f6c9a3ab31d3b42a583a0b57990a7e1553747292e8
|
data/Rakefile
CHANGED
|
@@ -14,3 +14,24 @@ end
|
|
|
14
14
|
YARD::Rake::YardocTask.new(:yard) do |task|
|
|
15
15
|
task.stats_options = ['--list-undoc']
|
|
16
16
|
end
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
desc 'Make separate documents for documentation_project.'
|
|
20
|
+
task :partials do
|
|
21
|
+
|
|
22
|
+
sections = [
|
|
23
|
+
{ :file => 'helpers.erb', :group => 'Helpers', },
|
|
24
|
+
{ :file => 'helpers_extended.erb', :group => 'Extended Helpers' },
|
|
25
|
+
{ :file => 'config.erb', :group => 'Middleman Configuration' },
|
|
26
|
+
{ :file => 'resources.erb', :group => 'Resource Extensions', },
|
|
27
|
+
{ :file => 'instance.erb', :group => 'Instance Methods', },
|
|
28
|
+
]
|
|
29
|
+
|
|
30
|
+
sections.each do |s|
|
|
31
|
+
command = "yardoc --query 'o.group == \"#{s[:group]}\" || has_tag?(:author)' -o doc -t default -p #{File.join(File.dirname(__FILE__), 'yard', 'template-partials')}"
|
|
32
|
+
puts command
|
|
33
|
+
system(command)
|
|
34
|
+
File.rename('doc/index.html', "doc/#{s[:file]}")
|
|
35
|
+
end
|
|
36
|
+
|
|
37
|
+
end
|
|
@@ -6,13 +6,10 @@ layout: template-logo-medium
|
|
|
6
6
|
# <%= current_page.data.title %>
|
|
7
7
|
|
|
8
8
|
`middleman-targets` includes some helpers and some page resources that make
|
|
9
|
-
working with multiple targets easier.
|
|
9
|
+
working with multiple targets easier. Most of them are demonstrated at [Simple
|
|
10
|
+
features demonstration](simple-demo.html).
|
|
10
11
|
|
|
11
|
-
|
|
12
|
-
## Helpers
|
|
13
|
-
|
|
14
|
-
This extension provides several useful helpers to manage multiple targets and
|
|
15
|
-
features. Most of them are demonstrated at [Simple features demonstration](simple-demo.html).
|
|
12
|
+
<%= partial 'partials/helpers_extended' %>
|
|
16
13
|
|
|
17
14
|
<%= partial 'partials/helpers' %>
|
|
18
15
|
|
|
@@ -1,326 +1,372 @@
|
|
|
1
|
-
<div class="attr_details">
|
|
2
1
|
|
|
3
|
-
<div class="method_details first">
|
|
4
|
-
<h3 class="signature first" id="config[:build_dir]=-instance_method">
|
|
5
2
|
|
|
6
|
-
- (<tt>String</tt>) <strong>config[:build_dir]=</strong>(value)
|
|
7
3
|
|
|
8
4
|
|
|
5
|
+
<div id="instance_attr_details" class="attr_details">
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
<span id="config[:build_dir]=-instance_method"></span>
|
|
9
|
+
<div class="method_details first">
|
|
10
|
+
<h3 class="signature first" id="config[:build_dir]=-instance_method">
|
|
11
|
+
|
|
12
|
+
- (<tt>String</tt>) <strong>config[:build_dir]=</strong>(value)
|
|
13
|
+
|
|
9
14
|
|
|
15
|
+
|
|
10
16
|
|
|
17
|
+
|
|
18
|
+
</h3><div class="docstring">
|
|
19
|
+
<div class="discussion">
|
|
20
|
+
|
|
21
|
+
<p>Indicates where <strong>Middleman</strong> will put build output. This standard config
|
|
22
|
+
value will be treated as a <em>prefix</em>; for example if the current target is
|
|
23
|
+
<code>:pro</code> and this value is set to its default <code>build</code>, then the actual build
|
|
24
|
+
directory will be <code>build (pro)/</code>.</p>
|
|
11
25
|
|
|
12
|
-
|
|
13
|
-
|
|
26
|
+
<p>If the <code>build_dir</code> key is present for any of the <code>config[:targets]</code>, they
|
|
27
|
+
will override this setting.</p>
|
|
14
28
|
|
|
15
|
-
<p>Indicates where <strong>Middleman</strong> will put build output. This standard config
|
|
16
|
-
value will be treated as a <em>prefix</em>; for example if the current target is <code>:pro</code> and this
|
|
17
|
-
value is set to its default <code>build</code>, then the actual build directory will
|
|
18
|
-
be <code>build (pro)/</code>.</p>
|
|
19
29
|
|
|
20
|
-
<p>If the <code>build_dir</code> key is present for any of the <code>config[:targets]</code>, they
|
|
21
|
-
will override this setting.</p>
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
</div>
|
|
25
|
-
</div>
|
|
26
|
-
<div class="tags">
|
|
27
|
-
<p class="tag_title">Parameters:</p>
|
|
28
|
-
<ul class="param">
|
|
29
|
-
|
|
30
|
-
<li>
|
|
31
|
-
|
|
32
|
-
<span class='name'>value</span>
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
<span class='type'>(<tt>String</tt>)</span>
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
—
|
|
40
|
-
<div class='inline'><p>Indicate the build directory prefix that should be
|
|
41
|
-
used for build output.</p>
|
|
42
|
-
</div>
|
|
43
|
-
|
|
44
|
-
</li>
|
|
45
|
-
|
|
46
|
-
</ul>
|
|
47
|
-
|
|
48
|
-
<p class="tag_title">Returns:</p>
|
|
49
|
-
<ul class="return">
|
|
50
|
-
|
|
51
|
-
<li>
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
<span class='type'>(<tt>String</tt>)</span>
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
—
|
|
59
|
-
<div class='inline'><p>Returns the current value of this configuration setting.</p>
|
|
60
|
-
</div>
|
|
61
|
-
|
|
62
|
-
</li>
|
|
63
|
-
|
|
64
|
-
</ul>
|
|
65
|
-
|
|
66
|
-
</div>
|
|
67
|
-
</div>
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
<div class="method_details">
|
|
71
|
-
<h3 class="signature">
|
|
72
|
-
|
|
73
|
-
- (<tt>Symbol</tt>) <strong>config[:target]=</strong>(value)
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
</h3><div class="docstring">
|
|
80
|
-
<div class="discussion">
|
|
81
|
-
|
|
82
|
-
<p>Indicates the current target that is being built or served. When
|
|
83
|
-
set in <code>config.rb</code> it indicates the default target if one is not
|
|
84
|
-
specified on the command line.</p>
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
</div>
|
|
88
|
-
</div>
|
|
89
|
-
<div class="tags">
|
|
90
|
-
<p class="tag_title">Parameters:</p>
|
|
91
|
-
<ul class="param">
|
|
92
|
-
|
|
93
|
-
<li>
|
|
94
|
-
|
|
95
|
-
<span class='name'>value</span>
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
<span class='type'>(<tt>Symbol</tt>)</span>
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
—
|
|
103
|
-
<div class='inline'><p>The target from <code>config[:targets]</code> that should
|
|
104
|
-
be used as the default.</p>
|
|
105
|
-
</div>
|
|
106
|
-
|
|
107
|
-
</li>
|
|
108
|
-
|
|
109
|
-
</ul>
|
|
110
|
-
|
|
111
|
-
<p class="tag_title">Returns:</p>
|
|
112
|
-
<ul class="return">
|
|
113
|
-
|
|
114
|
-
<li>
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
<span class='type'>(<tt>Symbol</tt>)</span>
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
—
|
|
122
|
-
<div class='inline'><p>Returns the current target.</p>
|
|
123
|
-
</div>
|
|
124
|
-
|
|
125
|
-
</li>
|
|
126
|
-
|
|
127
|
-
</ul>
|
|
128
|
-
|
|
129
|
-
</div>
|
|
130
30
|
</div>
|
|
31
|
+
</div>
|
|
32
|
+
<div class="tags">
|
|
33
|
+
<p class="tag_title">Parameters:</p>
|
|
34
|
+
<ul class="param">
|
|
35
|
+
|
|
36
|
+
<li>
|
|
37
|
+
|
|
38
|
+
<span class='name'>value</span>
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
<span class='type'>(<tt>String</tt>)</span>
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
—
|
|
46
|
+
<div class='inline'><p>Indicate the build directory prefix that should be
|
|
47
|
+
used for build output.</p>
|
|
48
|
+
</div>
|
|
49
|
+
|
|
50
|
+
</li>
|
|
51
|
+
|
|
52
|
+
</ul>
|
|
53
|
+
|
|
54
|
+
<p class="tag_title">Returns:</p>
|
|
55
|
+
<ul class="return">
|
|
56
|
+
|
|
57
|
+
<li>
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
<span class='type'>(<tt>String</tt>)</span>
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
—
|
|
65
|
+
<div class='inline'><p>Returns the current value of this configuration setting.</p>
|
|
66
|
+
</div>
|
|
67
|
+
|
|
68
|
+
</li>
|
|
69
|
+
|
|
70
|
+
</ul>
|
|
131
71
|
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
72
|
+
</div>
|
|
73
|
+
</div>
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
<span id="config[:target]=-instance_method"></span>
|
|
77
|
+
<div class="method_details ">
|
|
78
|
+
<h3 class="signature " id="config[:target]=-instance_method">
|
|
79
|
+
|
|
80
|
+
- (<tt>Symbol</tt>) <strong>config[:target]=</strong>(value)
|
|
81
|
+
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
</h3><div class="docstring">
|
|
87
|
+
<div class="discussion">
|
|
88
|
+
|
|
89
|
+
<p>Indicates the current target that is being built or served. When
|
|
90
|
+
set in <code>config.rb</code> it indicates the default target if one is not
|
|
91
|
+
specified on the command line.</p>
|
|
149
92
|
|
|
150
93
|
|
|
151
|
-
</div>
|
|
152
94
|
</div>
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
95
|
+
</div>
|
|
96
|
+
<div class="tags">
|
|
97
|
+
<p class="tag_title">Parameters:</p>
|
|
98
|
+
<ul class="param">
|
|
99
|
+
|
|
100
|
+
<li>
|
|
101
|
+
|
|
102
|
+
<span class='name'>value</span>
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
<span class='type'>(<tt>Symbol</tt>)</span>
|
|
106
|
+
|
|
107
|
+
|
|
108
|
+
|
|
109
|
+
—
|
|
110
|
+
<div class='inline'><p>The target from <code>config[:targets]</code> that should
|
|
111
|
+
be used as the default.</p>
|
|
112
|
+
</div>
|
|
113
|
+
|
|
114
|
+
</li>
|
|
115
|
+
|
|
116
|
+
</ul>
|
|
117
|
+
|
|
118
|
+
<p class="tag_title">Returns:</p>
|
|
119
|
+
<ul class="return">
|
|
120
|
+
|
|
121
|
+
<li>
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
<span class='type'>(<tt>Symbol</tt>)</span>
|
|
125
|
+
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
—
|
|
129
|
+
<div class='inline'><p>Returns the current target.</p>
|
|
130
|
+
</div>
|
|
131
|
+
|
|
132
|
+
</li>
|
|
133
|
+
|
|
134
|
+
</ul>
|
|
188
135
|
|
|
189
|
-
|
|
136
|
+
</div>
|
|
137
|
+
</div>
|
|
138
|
+
|
|
139
|
+
|
|
140
|
+
<span id="config[:target_magic_images]=-instance_method"></span>
|
|
141
|
+
<div class="method_details ">
|
|
142
|
+
<h3 class="signature " id="config[:target_magic_images]=-instance_method">
|
|
143
|
+
|
|
144
|
+
- (<tt>Boolean</tt>) <strong>config[:target_magic_images]=</strong>(value)
|
|
145
|
+
|
|
146
|
+
|
|
147
|
+
|
|
148
|
+
|
|
149
|
+
|
|
150
|
+
</h3><div class="docstring">
|
|
151
|
+
<div class="discussion">
|
|
152
|
+
|
|
153
|
+
<p>This option is used to enable or disable the target magic images feature.
|
|
154
|
+
If it’s <code>true</code> then the <code>image_tag</code> helper will attempt to substitute
|
|
155
|
+
target-specific images instead of the specified image, if the specified
|
|
156
|
+
image begins with <code>:target_magic_word</code>.</p>
|
|
190
157
|
|
|
191
|
-
</ul>
|
|
192
158
|
|
|
193
|
-
</div>
|
|
194
159
|
</div>
|
|
160
|
+
</div>
|
|
161
|
+
<div class="tags">
|
|
162
|
+
<p class="tag_title">Parameters:</p>
|
|
163
|
+
<ul class="param">
|
|
164
|
+
|
|
165
|
+
<li>
|
|
166
|
+
|
|
167
|
+
<span class='name'>value</span>
|
|
168
|
+
|
|
169
|
+
|
|
170
|
+
<span class='type'>(<tt>Boolean</tt>)</span>
|
|
171
|
+
|
|
172
|
+
|
|
173
|
+
|
|
174
|
+
—
|
|
175
|
+
<div class='inline'><p>Specify whether or not automatic target-specific
|
|
176
|
+
image substitution should be enabled.</p>
|
|
177
|
+
</div>
|
|
178
|
+
|
|
179
|
+
</li>
|
|
180
|
+
|
|
181
|
+
</ul>
|
|
182
|
+
|
|
183
|
+
<p class="tag_title">Returns:</p>
|
|
184
|
+
<ul class="return">
|
|
185
|
+
|
|
186
|
+
<li>
|
|
187
|
+
|
|
188
|
+
|
|
189
|
+
<span class='type'>(<tt>Boolean</tt>)</span>
|
|
190
|
+
|
|
191
|
+
|
|
192
|
+
|
|
193
|
+
—
|
|
194
|
+
<div class='inline'><p>Returns the current state of this option.</p>
|
|
195
|
+
</div>
|
|
196
|
+
|
|
197
|
+
</li>
|
|
198
|
+
|
|
199
|
+
</ul>
|
|
195
200
|
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
201
|
+
</div>
|
|
202
|
+
</div>
|
|
203
|
+
|
|
204
|
+
|
|
205
|
+
<span id="config[:target_magic_word]=-instance_method"></span>
|
|
206
|
+
<div class="method_details ">
|
|
207
|
+
<h3 class="signature " id="config[:target_magic_word]=-instance_method">
|
|
208
|
+
|
|
209
|
+
- (<tt>String</tt>) <strong>config[:target_magic_word]=</strong>(value)
|
|
210
|
+
|
|
211
|
+
|
|
212
|
+
|
|
213
|
+
|
|
214
|
+
|
|
215
|
+
</h3><div class="docstring">
|
|
216
|
+
<div class="discussion">
|
|
217
|
+
|
|
218
|
+
<p>Indicates the magic image prefix for image substitution with the
|
|
219
|
+
<code>image_tag</code> helper when <code>:target_magic_images</code> is enabled. For example
|
|
220
|
+
if you specify <code>all-image.png</code> and <code>pro-image.png</code> exists, then the
|
|
221
|
+
latter will be used by the helper instead of the former.</p>
|
|
213
222
|
|
|
214
223
|
|
|
215
|
-
</div>
|
|
216
224
|
</div>
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
225
|
+
</div>
|
|
226
|
+
<div class="tags">
|
|
227
|
+
<p class="tag_title">Parameters:</p>
|
|
228
|
+
<ul class="param">
|
|
229
|
+
|
|
230
|
+
<li>
|
|
231
|
+
|
|
232
|
+
<span class='name'>value</span>
|
|
233
|
+
|
|
234
|
+
|
|
235
|
+
<span class='type'>(<tt>String</tt>)</span>
|
|
236
|
+
|
|
237
|
+
|
|
238
|
+
|
|
239
|
+
—
|
|
240
|
+
<div class='inline'><p>Indicate the prefix that should indicate and image
|
|
241
|
+
the should be substituted, such as <code>all</code>.</p>
|
|
242
|
+
</div>
|
|
243
|
+
|
|
244
|
+
</li>
|
|
245
|
+
|
|
246
|
+
</ul>
|
|
247
|
+
|
|
248
|
+
<p class="tag_title">Returns:</p>
|
|
249
|
+
<ul class="return">
|
|
250
|
+
|
|
251
|
+
<li>
|
|
252
|
+
|
|
253
|
+
|
|
254
|
+
<span class='type'>(<tt>String</tt>)</span>
|
|
255
|
+
|
|
256
|
+
|
|
257
|
+
|
|
258
|
+
—
|
|
259
|
+
<div class='inline'><p>Returns the current magic prefix.</p>
|
|
260
|
+
</div>
|
|
261
|
+
|
|
262
|
+
</li>
|
|
263
|
+
|
|
264
|
+
</ul>
|
|
252
265
|
|
|
253
|
-
|
|
266
|
+
</div>
|
|
267
|
+
</div>
|
|
268
|
+
|
|
269
|
+
|
|
270
|
+
<span id="config[:targets]=-instance_method"></span>
|
|
271
|
+
<div class="method_details ">
|
|
272
|
+
<h3 class="signature " id="config[:targets]=-instance_method">
|
|
273
|
+
|
|
274
|
+
- (<tt>Hash</tt>) <strong>config[:targets]=</strong>(value)
|
|
275
|
+
|
|
276
|
+
|
|
277
|
+
|
|
278
|
+
|
|
279
|
+
|
|
280
|
+
</h3><div class="docstring">
|
|
281
|
+
<div class="discussion">
|
|
282
|
+
|
|
283
|
+
<p>A hash that defines all of the characteristics of your individual targets.
|
|
284
|
+
The <code>build_dir</code> and <code>features</code> keys in a target have special meanings;
|
|
285
|
+
other keys can be added arbitrarily and helpers can fetch these for you.
|
|
286
|
+
A best practice is to assign the same features to <em>all</em> of your targets and
|
|
287
|
+
toggle them <code>on</code> or <code>off</code> on a target-specific basis.</p>
|
|
254
288
|
|
|
255
|
-
</ul>
|
|
256
289
|
|
|
257
|
-
</div>
|
|
258
290
|
</div>
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
291
|
+
</div>
|
|
292
|
+
<div class="tags">
|
|
293
|
+
|
|
294
|
+
<div class="examples">
|
|
295
|
+
<p class="tag_title">Examples:</p>
|
|
296
|
+
|
|
297
|
+
|
|
298
|
+
<p class="example_title"><div class='inline'><p>You might define this in your <code>config.rb</code> like this:</p>
|
|
299
|
+
</div></p>
|
|
300
|
+
|
|
301
|
+
<pre class="example code"><code><span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:targets</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='lbrace'>{</span>
|
|
302
|
+
<span class='symbol'>:free</span> <span class='op'>=></span>
|
|
303
|
+
<span class='lbrace'>{</span>
|
|
304
|
+
<span class='symbol'>:sample_key</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>People who use free versions don\'t drive profits.</span><span class='tstring_end'>'</span></span><span class='comma'>,</span>
|
|
305
|
+
<span class='symbol'>:build_dir</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>build (%s)</span><span class='tstring_end'>'</span></span><span class='comma'>,</span>
|
|
306
|
+
<span class='symbol'>:features</span> <span class='op'>=></span>
|
|
307
|
+
<span class='lbrace'>{</span>
|
|
308
|
+
<span class='symbol'>:feature_advertise_pro</span> <span class='op'>=></span> <span class='kw'>true</span><span class='comma'>,</span>
|
|
309
|
+
<span class='symbol'>:insults_user</span> <span class='op'>=></span> <span class='kw'>true</span><span class='comma'>,</span>
|
|
310
|
+
<span class='symbol'>:grants_wishes</span> <span class='op'>=></span> <span class='kw'>false</span><span class='comma'>,</span>
|
|
311
|
+
<span class='rbrace'>}</span>
|
|
312
|
+
<span class='rbrace'>}</span><span class='comma'>,</span>
|
|
313
|
+
|
|
314
|
+
<span class='symbol'>:pro</span> <span class='op'>=></span>
|
|
315
|
+
<span class='lbrace'>{</span>
|
|
316
|
+
<span class='symbol'>:sample_key</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>You are a valued contributor to our balance sheet!</span><span class='tstring_end'>'</span></span><span class='comma'>,</span>
|
|
317
|
+
<span class='symbol'>:features</span> <span class='op'>=></span>
|
|
318
|
+
<span class='lbrace'>{</span>
|
|
319
|
+
<span class='symbol'>:feature_advertise_pro</span> <span class='op'>=></span> <span class='kw'>false</span><span class='comma'>,</span>
|
|
320
|
+
<span class='symbol'>:insults_user</span> <span class='op'>=></span> <span class='kw'>false</span><span class='comma'>,</span>
|
|
321
|
+
<span class='symbol'>:grants_wishes</span> <span class='op'>=></span> <span class='kw'>true</span><span class='comma'>,</span>
|
|
322
|
+
<span class='rbrace'>}</span>
|
|
323
|
+
<span class='rbrace'>}</span><span class='comma'>,</span>
|
|
324
|
+
<span class='rbrace'>}</span></code></pre>
|
|
325
|
+
|
|
281
326
|
</div>
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
<
|
|
286
|
-
|
|
287
|
-
<li>
|
|
288
|
-
|
|
327
|
+
<p class="tag_title">Parameters:</p>
|
|
328
|
+
<ul class="param">
|
|
329
|
+
|
|
330
|
+
<li>
|
|
331
|
+
|
|
289
332
|
<span class='name'>value</span>
|
|
290
|
-
|
|
291
|
-
|
|
333
|
+
|
|
334
|
+
|
|
292
335
|
<span class='type'>(<tt>Hash</tt>)</span>
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
336
|
+
|
|
337
|
+
|
|
338
|
+
|
|
296
339
|
—
|
|
297
340
|
<div class='inline'><p>The complete definition of your targets, their
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
341
|
+
features, and other keys-value pairs that you wish to include.</p>
|
|
342
|
+
</div>
|
|
343
|
+
|
|
344
|
+
</li>
|
|
345
|
+
|
|
346
|
+
</ul>
|
|
347
|
+
|
|
348
|
+
<p class="tag_title">Returns:</p>
|
|
349
|
+
<ul class="return">
|
|
350
|
+
|
|
351
|
+
<li>
|
|
352
|
+
|
|
353
|
+
|
|
311
354
|
<span class='type'>(<tt>Hash</tt>)</span>
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
355
|
+
|
|
356
|
+
|
|
357
|
+
|
|
315
358
|
—
|
|
316
359
|
<div class='inline'><p>Returns the attributes of your targets.</p>
|
|
317
|
-
|
|
360
|
+
</div>
|
|
361
|
+
|
|
362
|
+
</li>
|
|
363
|
+
|
|
364
|
+
</ul>
|
|
318
365
|
|
|
319
|
-
|
|
366
|
+
</div>
|
|
367
|
+
</div>
|
|
368
|
+
|
|
369
|
+
</div>
|
|
320
370
|
|
|
321
|
-
</ul>
|
|
322
371
|
|
|
323
|
-
</div>
|
|
324
|
-
</div>
|
|
325
372
|
|
|
326
|
-
</div>
|