masterview 0.1.5 → 0.2.0
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/CHANGELOG +17 -0
- data/README +36 -504
- data/RELEASE_NOTES +126 -45
- data/Rakefile +215 -86
- data/TODO +8 -3
- data/doc/configuration.html +485 -0
- data/doc/directives.html +1085 -0
- data/doc/guide.html +243 -0
- data/doc/index.html +287 -0
- data/doc/installation.html +376 -0
- data/doc/stylesheets/masterview.css +206 -0
- data/doc/stylesheets/mv-config.css +23 -0
- data/doc/stylesheets/mv-directives.css +18 -0
- data/doc/stylesheets/mv-installation.css +10 -0
- data/doc/troubleshooting.html +18 -0
- data/examples/product.html +256 -0
- data/examples/product.html.old +107 -0
- data/examples/rails_app_config/masterview/environment/development.rb +22 -0
- data/examples/rails_app_config/masterview/environment/production.rb +9 -0
- data/examples/rails_app_config/masterview/settings.rb +59 -0
- data/examples/test.import +80 -0
- data/init.rb +26 -12
- data/lib/masterview/analyzer.rb +25 -15
- data/lib/masterview/directive_base.rb +4 -0
- data/lib/masterview/directive_helpers.rb +7 -5
- data/lib/masterview/directives/import_render.rb +6 -0
- data/lib/masterview/directives/insert_generated_comment.rb +8 -8
- data/lib/masterview/extras/app/controllers/masterview_controller.rb +154 -2
- data/lib/masterview/extras/app/views/masterview/admin/create.rhtml +4 -4
- data/lib/masterview/extras/app/views/masterview/admin/empty.rhtml +1 -1
- data/lib/masterview/extras/app/views/masterview/admin/list.rhtml +14 -9
- data/lib/masterview/extras/app/views/masterview/admin/view_rhtml.rhtml +70 -0
- data/lib/masterview/extras/init_logger.rb +102 -0
- data/lib/masterview/extras/init_rails_erb_mv_direct.rb +117 -0
- data/lib/masterview/extras/init_rails_reparse_checking.rb +59 -0
- data/lib/masterview/extras/watcher.rb +17 -23
- data/lib/masterview/filter_helpers.rb +26 -0
- data/lib/masterview/initializer.rb +912 -0
- data/lib/masterview/io.rb +352 -0
- data/lib/masterview/keyword_expander.rb +116 -0
- data/lib/masterview/masterview_version.rb +2 -2
- data/lib/masterview/mtime_tracking_hash.rb +44 -0
- data/lib/masterview/parser.rb +64 -92
- data/lib/masterview/pathname_extensions.rb +33 -0
- data/lib/masterview/template_spec.rb +49 -56
- data/lib/masterview.rb +40 -85
- data/test/fixtures/configs/fake_rails_app_with_config/config/masterview/environments/development.rb +12 -0
- data/test/fixtures/configs/fake_rails_app_with_config/config/masterview/environments/production.rb +11 -0
- data/test/fixtures/configs/fake_rails_app_with_config/config/masterview/settings.rb +23 -0
- data/test/fixtures/templates/product.html +256 -0
- data/test/fixtures/templates/test.import +80 -0
- data/test/test_helper.rb +5 -3
- data/test/tmp/template/foo.txt +1 -0
- data/test/tmp/templates_src/product.html +256 -0
- data/test/tmp/views/layouts/product.rhtml +35 -0
- data/test/tmp/views/product/_form.rhtml +30 -0
- data/test/tmp/views/product/_product.rhtml +14 -0
- data/test/tmp/views/product/_show.rhtml +27 -0
- data/test/tmp/views/product/destroy.rhtml +27 -0
- data/test/tmp/views/product/edit.rhtml +26 -0
- data/test/tmp/views/product/list.rhtml +31 -0
- data/test/tmp/views/product/new.rhtml +29 -0
- data/test/tmp/views/product/show.rhtml +16 -0
- data/test/unit/config_settings_test.rb +172 -0
- data/test/{attr_test.rb → unit/directive_attr_test.rb} +2 -2
- data/test/{block_test.rb → unit/directive_block_test.rb} +2 -2
- data/test/{content_test.rb → unit/directive_content_test.rb} +2 -2
- data/test/{else_test.rb → unit/directive_else_test.rb} +2 -2
- data/test/{elsif_test.rb → unit/directive_elsif_test.rb} +2 -2
- data/test/{form_test.rb → unit/directive_form_test.rb} +2 -2
- data/test/{global_inline_erb_test.rb → unit/directive_global_inline_erb_test.rb} +2 -2
- data/test/{hidden_field_test.rb → unit/directive_hidden_field_test.rb} +2 -2
- data/test/{if_test.rb → unit/directive_if_test.rb} +2 -2
- data/test/unit/directive_import_render_test.rb +62 -0
- data/test/{import_test.rb → unit/directive_import_test.rb} +2 -2
- data/test/{javascript_include_test.rb → unit/directive_javascript_include_test.rb} +2 -2
- data/test/{link_to_if_test.rb → unit/directive_link_to_if_test.rb} +2 -2
- data/test/{link_to_test.rb → unit/directive_link_to_test.rb} +2 -2
- data/test/{omit_tag_test.rb → unit/directive_omit_tag_test.rb} +2 -2
- data/test/{password_field_test.rb → unit/directive_password_field_test.rb} +2 -2
- data/test/{replace_test.rb → unit/directive_replace_test.rb} +2 -2
- data/test/{stylesheet_link_test.rb → unit/directive_stylesheet_link_test.rb} +2 -2
- data/test/{submit_test.rb → unit/directive_submit_test.rb} +2 -2
- data/test/{text_area_test.rb → unit/directive_text_area_test.rb} +2 -2
- data/test/{text_field_test.rb → unit/directive_text_field_test.rb} +2 -2
- data/test/{example_test.rb → unit/example_test.rb} +1 -1
- data/test/unit/file_mio_test.rb +368 -0
- data/test/{filter_helpers_test.rb → unit/filter_helpers_test.rb} +1 -1
- data/test/unit/keyword_expander_test.rb +95 -0
- data/test/unit/mio_test.rb +110 -0
- data/test/unit/mtime_string_hash_mio_tree_test.rb +289 -0
- data/test/unit/mtime_tracking_hash_test.rb +38 -0
- data/test/{parser_test.rb → unit/parser_test.rb} +19 -1
- data/test/unit/pathname_extensions_test.rb +46 -0
- data/test/{run_parser_test.rb → unit/run_parser_test.rb} +7 -3
- data/test/unit/string_hash_mio_test.rb +320 -0
- data/test/unit/template_file_watcher_test.rb +107 -0
- data/test/{template_spec_test.rb → unit/template_spec_test.rb} +57 -21
- data/test/{template_test.rb → unit/template_test.rb} +123 -22
- data/test/xtras/config-mv-logger_config.rb +109 -0
- data/test/xtras/config_initialize_standalone.rb +53 -0
- metadata +111 -38
- data/lib/masterview/extras/rails_init.rb +0 -72
- data/test/import_render_test.rb +0 -30
- data/test/template_file_watcher_test.rb +0 -50
|
@@ -0,0 +1,376 @@
|
|
|
1
|
+
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
2
|
+
<!DOCTYPE html
|
|
3
|
+
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
+
|
|
6
|
+
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
|
7
|
+
<head>
|
|
8
|
+
|
|
9
|
+
<title>MasterView - Installation Guide</title>
|
|
10
|
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
11
|
+
<meta http-equiv="Content-Script-Type" content="text/javascript" />
|
|
12
|
+
|
|
13
|
+
<link href="./stylesheets/masterview.css" rel="stylesheet" type="text/css" />
|
|
14
|
+
<link href="./stylesheets/mv-config.css" rel="stylesheet" type="text/css" />
|
|
15
|
+
</head>
|
|
16
|
+
|
|
17
|
+
<body>
|
|
18
|
+
|
|
19
|
+
<div id="pageHeader">
|
|
20
|
+
<div>MasterView Template Engine</div>
|
|
21
|
+
<div class="description">Rails-optimized (x)html friendly template engine</div>
|
|
22
|
+
</div>
|
|
23
|
+
|
|
24
|
+
<div id="pageBody">
|
|
25
|
+
<div id="bodyContent" mv:generate="{template_path}" mv:omit_tag="">
|
|
26
|
+
|
|
27
|
+
<h1>MasterView - Installation Guide</h1>
|
|
28
|
+
|
|
29
|
+
<p>
|
|
30
|
+
<span class="productName">MasterView</span> is a Ruby/Rails
|
|
31
|
+
optimized HTML/XHTML friendly template engine. It is designed to use the
|
|
32
|
+
full power and productivity of Rails, including layouts, partials, and Rails
|
|
33
|
+
html helpers while still being editable/styleable in a WYSIWYG HTML editor.
|
|
34
|
+
</p>
|
|
35
|
+
|
|
36
|
+
<p>
|
|
37
|
+
<span class="productName">MasterView</span> is distributed as both
|
|
38
|
+
a gem and as a fully self-contained plugin.
|
|
39
|
+
You may install it as a gem and then generate a lightweight
|
|
40
|
+
plugin in your Rails application which references the gem
|
|
41
|
+
<b>or</b> you can simply install a complete copy as a self-contained plugin
|
|
42
|
+
in your application.
|
|
43
|
+
</p>
|
|
44
|
+
|
|
45
|
+
<p class="explanation">
|
|
46
|
+
If you are new to Ruby and not yet familiar with <code>gem</code>,
|
|
47
|
+
the standard Ruby package manager, see the
|
|
48
|
+
<a href="#gem_tips">MasterView Gem Tips</a> section at the end of this document
|
|
49
|
+
for additional information and links to the <code>RubyGems</code> documentation.
|
|
50
|
+
</p>
|
|
51
|
+
|
|
52
|
+
<!--
|
|
53
|
+
<p class="explanation">###TODO: TOC here: Supported Platforms, Prerequisites, Installation [as gem, as complete plugin], Gem Tips####</p>
|
|
54
|
+
|
|
55
|
+
<p class="explanation">###TODO: add a little "Quick Start" for experienced ruby-ists here - repeat the gem install and the plugin install incantations ###</p>
|
|
56
|
+
-->
|
|
57
|
+
|
|
58
|
+
<h2>Supported Platforms</h2>
|
|
59
|
+
|
|
60
|
+
<p><span class="productName">MasterView</span> has been tested
|
|
61
|
+
on Ruby 1.8.4 and Rails 1.1.2 on *nix and Windows.
|
|
62
|
+
</p>
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
<h2>Prerequisites</h2>
|
|
66
|
+
<table summary="prerequisites">
|
|
67
|
+
<tbody>
|
|
68
|
+
<tr class="subheader">
|
|
69
|
+
<td colspan="2">Required:</td>
|
|
70
|
+
</tr>
|
|
71
|
+
<tr>
|
|
72
|
+
<td> </td>
|
|
73
|
+
<td class="explanation">No required external dependencies</td>
|
|
74
|
+
</tr>
|
|
75
|
+
<tr class="subheader">
|
|
76
|
+
<td colspan="2">Optional:</td>
|
|
77
|
+
</tr>
|
|
78
|
+
<tr>
|
|
79
|
+
<td class="package">tidy</td>
|
|
80
|
+
<td>
|
|
81
|
+
If HTML tidy support is installed, you can use tidy to
|
|
82
|
+
automatically clean up html in your templates into valid xhtml
|
|
83
|
+
prior to MasterView template parsing.
|
|
84
|
+
You will need both the tidy processor and the Ruby gem tidy library installed on your system.
|
|
85
|
+
Visit the <a href="http://tidy.sourceforge.net/" target="_blank">HTML Tidy project on sourceforge</a> to download and install tidy on your system.
|
|
86
|
+
To install the Ruby gem tidy library:
|
|
87
|
+
<pre class="code">gem install tidy</pre>
|
|
88
|
+
</td>
|
|
89
|
+
</tr>
|
|
90
|
+
<tr>
|
|
91
|
+
<td class="package">Log4r</td>
|
|
92
|
+
<td>A flexible logging library for Ruby that will be used by Masterview if installed.
|
|
93
|
+
(If not, the standard ruby library <code>Logger</code> is used).
|
|
94
|
+
Visit the <a href="http://log4r.sourceforge.net/" target="_blank">Log4r project on sourceforge</a> for more information.
|
|
95
|
+
To install the Ruby gem Log4r library:
|
|
96
|
+
<pre class="code">gem install log4r</pre>
|
|
97
|
+
</td>
|
|
98
|
+
</tr>
|
|
99
|
+
</tbody>
|
|
100
|
+
</table>
|
|
101
|
+
|
|
102
|
+
<p class="explanation">(see the
|
|
103
|
+
<a href="#gem_tips">MasterView Gem Tips</a> section below if you need more information about the <code>RubyGem</code> package manager)</p>
|
|
104
|
+
|
|
105
|
+
<h2>Installation</h2>
|
|
106
|
+
|
|
107
|
+
<p>
|
|
108
|
+
You can install <span class="productName">MasterView</span> either
|
|
109
|
+
by using the standard Ruby <code>gem</code> package manager
|
|
110
|
+
to <a href="#install_gem">install the MasterView gem</a>
|
|
111
|
+
<b>or</b>
|
|
112
|
+
you can <a href="#install_plugin">install a copy of the MasterView plugin</a> in your application.
|
|
113
|
+
Masterview releases are published on
|
|
114
|
+
<a href="http://rubyforge.org/projects/masterview/" target="_blank">rubyforge.org</a>
|
|
115
|
+
and can be downloaded and installed manually or installed using the standard procedures described here.
|
|
116
|
+
</p>
|
|
117
|
+
|
|
118
|
+
<p class="explanation"><b>Tip:</b>
|
|
119
|
+
Installing <span class="productName">MasterView</span> as a gem is generally
|
|
120
|
+
easier to manage and maintain.
|
|
121
|
+
The <code>gem</code> package manager installs MasterView in your
|
|
122
|
+
system Ruby library path, from which it is then available
|
|
123
|
+
to all your Ruby applications.
|
|
124
|
+
However, if you are running at a shared hosting
|
|
125
|
+
environment you might not have authority to install this gem so you may
|
|
126
|
+
install as a self contained plugin.
|
|
127
|
+
</p>
|
|
128
|
+
|
|
129
|
+
<a name="install_gem"></a>
|
|
130
|
+
<h3>Installation of the MasterView gem</h3>
|
|
131
|
+
|
|
132
|
+
<p>To install the current release of <span class="productName">MasterView</span> as a gem,
|
|
133
|
+
run the Ruby <code>gem</code> package manager from the command line:
|
|
134
|
+
</p>
|
|
135
|
+
|
|
136
|
+
<pre class="code">gem install masterview_gem_pack</pre>
|
|
137
|
+
|
|
138
|
+
<p class="explanation">(answer <b>Yes</b> when prompted whether to install the dependent masterview component gems)</p>
|
|
139
|
+
|
|
140
|
+
<p>This will install MasterView in the Ruby library on your system.
|
|
141
|
+
The MasterView API documentation will be added your RubyGems documentation
|
|
142
|
+
and made available in the installed Gems documentation that you access by running your RubyGems RDoc server.
|
|
143
|
+
</p>
|
|
144
|
+
|
|
145
|
+
<h4>Installing the MasterView gem as a Rails Plugin</h4>
|
|
146
|
+
|
|
147
|
+
<p>In order to activate support for MasterView templates in a Rails application,
|
|
148
|
+
you need to install <code>masterview</code> as a Rails plugin in that application.
|
|
149
|
+
If you are adding MasterView support to an existing Rails application, open a command shell and <code>cd</code> to the directory containing the rails application.</p>
|
|
150
|
+
|
|
151
|
+
<pre class="code">
|
|
152
|
+
cd /path/to/myrailsapp
|
|
153
|
+
</pre>
|
|
154
|
+
|
|
155
|
+
<p>If you are starting a new application, create a directory to contain your application and run the <code>rails</code> generator to generate the standard framework structure of a skeleton rails application.
|
|
156
|
+
</p>
|
|
157
|
+
|
|
158
|
+
<pre class="code">
|
|
159
|
+
cd /path/to/myrails
|
|
160
|
+
mkdir mynewapp
|
|
161
|
+
cd mynewapp
|
|
162
|
+
rails
|
|
163
|
+
</pre>
|
|
164
|
+
|
|
165
|
+
<p>Now run the <code>masterview_plugin_generator</code> in your Rails application directory
|
|
166
|
+
to install <span class="productName">MasterView</span> as a plugin.
|
|
167
|
+
The plugin generator will create a lightweight plugin for <code>masterview</code>
|
|
168
|
+
in your rails <code>vendor/plugins</code> directory, consisting
|
|
169
|
+
of an <code>init.rb</code> file which causes the MasterView template
|
|
170
|
+
engine to be loaded during Rails startup.
|
|
171
|
+
</p>
|
|
172
|
+
|
|
173
|
+
<p>Use one of the following two forms of running the generator.
|
|
174
|
+
<span class="explanation">
|
|
175
|
+
(On Windows, you need to explicitly invoke Ruby to run the script)
|
|
176
|
+
</span>
|
|
177
|
+
</p>
|
|
178
|
+
<pre class="code">
|
|
179
|
+
script/generate masterview_plugin
|
|
180
|
+
ruby script/generate masterview_plugin
|
|
181
|
+
</pre>
|
|
182
|
+
|
|
183
|
+
<p>
|
|
184
|
+
The lightweight <code>masterview</code> plugin runs the template engine
|
|
185
|
+
using the installed gem, but allows you to provide application-specific
|
|
186
|
+
configuration settings using settings files that you can provide in
|
|
187
|
+
your application's <code>config/masterview</code> directory.
|
|
188
|
+
</p>
|
|
189
|
+
|
|
190
|
+
<p>Congratulations - you are now ready to use MasterView in your application!</p>
|
|
191
|
+
|
|
192
|
+
<p>To run <span class="productName">MasterView</span> with the default
|
|
193
|
+
configuration settings, which are designed to be appropriate for a
|
|
194
|
+
typical Rails application, simply start creating <code>.html</code>
|
|
195
|
+
template views containing MasterView <code>mv:</code> attribute markup
|
|
196
|
+
and run your application.
|
|
197
|
+
</p>
|
|
198
|
+
|
|
199
|
+
<p>For information about customizing <span class="productName">MasterView</span>
|
|
200
|
+
configuration settings, see the
|
|
201
|
+
<a href="configuration.html">MasterView Configuration Guide</a>.
|
|
202
|
+
</p>
|
|
203
|
+
|
|
204
|
+
<p>For an overview and information about using MasterView templates, see the
|
|
205
|
+
<!--##TODO: factor out guide.html and convert following to link -->
|
|
206
|
+
<i>MasterView User's Guide</i>
|
|
207
|
+
and the detailed
|
|
208
|
+
<!--##TODO: factor out directives.html and convert following to link -->
|
|
209
|
+
<i>MasterView Directives Reference</i>.
|
|
210
|
+
For information about using the <code>masterview_generator</code>
|
|
211
|
+
to assist you in creating templates, see the
|
|
212
|
+
<!--##TODO: factor out guide.html and convert following to link -->
|
|
213
|
+
<i>MasterView User's Guide</i>.
|
|
214
|
+
</p>
|
|
215
|
+
|
|
216
|
+
<a name="install_plugin"></a>
|
|
217
|
+
<h3>Installation of the complete MasterView plugin</h3>
|
|
218
|
+
|
|
219
|
+
<p>If you are unable or otherwise do not wish to install
|
|
220
|
+
<code>masterview</code> as a gem,
|
|
221
|
+
you can install a full copy of the template engine and its generators
|
|
222
|
+
as a plugin in your rails application.
|
|
223
|
+
</p>
|
|
224
|
+
|
|
225
|
+
<p>If you have Subversion client support installed on your system,
|
|
226
|
+
you can install the latest release directly from the
|
|
227
|
+
release build archive on rubyforge.
|
|
228
|
+
In a command shell, <code>cd</code> to the directory containing
|
|
229
|
+
your rails application and run the standard Rails
|
|
230
|
+
<code>plugin</code> script.
|
|
231
|
+
<span class="explanation">
|
|
232
|
+
(On Windows, you need to explicitly invoke Ruby to run the script)
|
|
233
|
+
</span>
|
|
234
|
+
</p>
|
|
235
|
+
|
|
236
|
+
<pre class="code">
|
|
237
|
+
script/plugin install svn://rubyforge.org/var/svn/masterview/tags/masterview
|
|
238
|
+
ruby script/plugin install svn://rubyforge.org/var/svn/masterview/tags/masterview
|
|
239
|
+
</pre>
|
|
240
|
+
|
|
241
|
+
<p>This will copy the complete MasterView
|
|
242
|
+
system into your <code>vendor/plugins/masterview</code> directory.
|
|
243
|
+
</p>
|
|
244
|
+
|
|
245
|
+
<p>If you do not have a Subversion (<code>svn</code>) client,
|
|
246
|
+
you can manually download a copy of the <code>masterview</code>
|
|
247
|
+
plugin package from
|
|
248
|
+
<a href="http://rubyforge.org/projects/masterview" target="_blank">rubyforge.org/projects/masterview</a>.
|
|
249
|
+
<span class="explanation">(Go to the <code>Files</code> tab and
|
|
250
|
+
select the latest release version <i>D.D.D</i>)</span>
|
|
251
|
+
Download either <code>masterview_plugin-<i>D.D.D</i>.tgz</code>
|
|
252
|
+
or <code>masterview_plugin-<i>D.D.D</i>.zip</code>
|
|
253
|
+
according to the preferred compressed files format for your system.
|
|
254
|
+
Unpack the plugin into the <code>vendor/plugins</code> directory
|
|
255
|
+
of your rails application to install the <code>masterview</code> plugin.
|
|
256
|
+
</p>
|
|
257
|
+
|
|
258
|
+
<p>Congratulations - you are now ready to use MasterView in your application!</p>
|
|
259
|
+
|
|
260
|
+
<p>To run <span class="productName">MasterView</span> with the default
|
|
261
|
+
configuration settings, which are designed to be appropriate for a
|
|
262
|
+
typical Rails application, simply start creating <code>.html</code>
|
|
263
|
+
template views containing MasterView <code>mv:</code> attribute markup
|
|
264
|
+
and run your application.
|
|
265
|
+
</p>
|
|
266
|
+
|
|
267
|
+
<p>For information about customizing <span class="productName">MasterView</span>
|
|
268
|
+
configuration settings, see the
|
|
269
|
+
<a href="configuration.html">MasterView Configuration Guide</a>.
|
|
270
|
+
</p>
|
|
271
|
+
|
|
272
|
+
<p>For an overview and information about using MasterView templates, see the
|
|
273
|
+
<!--##TODO: factor out guide.html and convert following to link -->
|
|
274
|
+
<i>MasterView User's Guide</i>
|
|
275
|
+
and the detailed
|
|
276
|
+
<!--##TODO: factor out directives.html and convert following to link -->
|
|
277
|
+
<i>MasterView Directives Reference</i>.
|
|
278
|
+
For information about using the <code>masterview_generator</code>
|
|
279
|
+
to assist you in creating templates, see the
|
|
280
|
+
<!--##TODO: factor out guide.html and convert following to link -->
|
|
281
|
+
<i>MasterView User's Guide</i>.
|
|
282
|
+
</p>
|
|
283
|
+
|
|
284
|
+
|
|
285
|
+
<a name="gem_tips"></a>
|
|
286
|
+
<h2>MasterView Gem Tips</h2>
|
|
287
|
+
|
|
288
|
+
<p><code>RubyGems</code> is the standard package manager for Ruby.
|
|
289
|
+
It makes it easy to download, install, and manage Ruby libraries.
|
|
290
|
+
A nice User Guide and complete command reference are available at
|
|
291
|
+
<a href="http://docs.rubygems.org/" target="_blank">rubygems.org</a>.
|
|
292
|
+
</p>
|
|
293
|
+
|
|
294
|
+
<ul>
|
|
295
|
+
<li><a href="http://docs.rubygems.org/read/book/1" target="_blank">RubyGems User Guide</a></li>
|
|
296
|
+
<li><a href="http://docs.rubygems.org/read/book/2" target="_blank">gem Command Reference</a></li>
|
|
297
|
+
</ul>
|
|
298
|
+
|
|
299
|
+
<a name="gem_roadmap"></a>
|
|
300
|
+
<h3>Roadmap to the MasterView gem packages</h3>
|
|
301
|
+
|
|
302
|
+
<p><span class="productName">MasterView</span> releases are published on the
|
|
303
|
+
<a href="http://rubyforge.org/projects/masterview/" target="_blank">MasterView project on rubyforge</a>.
|
|
304
|
+
</p>
|
|
305
|
+
|
|
306
|
+
<p>There are 3 components published as gems in a <span class="productName">MasterView</span> release:</p>
|
|
307
|
+
<ul>
|
|
308
|
+
<li><code>masterview</code> - the MasterView template engine</li>
|
|
309
|
+
<li><code>masterview_gem_plugin_generator</code> - a Rails generator for creating the necessary entry (a small loader stub) in your rails application's <code>vendor/plugins</code> directory to load the MasterView template engine gem as a Rails plugin in your application</li>
|
|
310
|
+
<li><code>masterview_generator</code> - Rails generator for creating MasterView templates in your application <span class="explanation">[### NEEDS MORE EXPLANATION###]</span></li>
|
|
311
|
+
</ul>
|
|
312
|
+
|
|
313
|
+
<p>Most of the time you'll want to simply install the all-in-one easy-install gem that brings in everything:
|
|
314
|
+
</p>
|
|
315
|
+
<ul>
|
|
316
|
+
<li><code>masterview_gem_pack</code> - the MasterView value-pak for easy install - installs the base MasterView template engine plus the supporting Rails generators</li>
|
|
317
|
+
</ul>
|
|
318
|
+
|
|
319
|
+
<p class="explanation"><b>Tip:</b> the gems named <code>masterview_parser</code>
|
|
320
|
+
and <code>masterview_gem_plugin_generator</code> are obsolete versions from early alpha
|
|
321
|
+
releases. They are obsolete and should be ignored.
|
|
322
|
+
</p>
|
|
323
|
+
|
|
324
|
+
<h3>Useful Gem Expressions</h3>
|
|
325
|
+
<ul>
|
|
326
|
+
<li>list the installed version(s) of MasterView
|
|
327
|
+
<div class="cmdLine">gem list masterview</div>
|
|
328
|
+
</li>
|
|
329
|
+
<li>list the available versions of Masterview
|
|
330
|
+
<div class="cmdLine">gem query -r -n ^masterview</div>
|
|
331
|
+
</li>
|
|
332
|
+
<li>install the current release of MasterView
|
|
333
|
+
<div class="cmdLine">gem install masterview_gem_pack</div>
|
|
334
|
+
</li>
|
|
335
|
+
<li>uninstall MasterView gems (all versions)
|
|
336
|
+
<!--
|
|
337
|
+
<div class="cmdLine">gem uninstall masterview_gem_pack</div>
|
|
338
|
+
<div class="cmdLine">gem uninstall masterview_generator</div>
|
|
339
|
+
<div class="cmdLine">gem uninstall masterview_plugin_generator</div>
|
|
340
|
+
<div class="cmdLine">gem uninstall masterview</div>
|
|
341
|
+
-->
|
|
342
|
+
<div class="cmdLine">gem uninstall masterview -a -x -i</div>
|
|
343
|
+
</li>
|
|
344
|
+
</ul>
|
|
345
|
+
|
|
346
|
+
</div> <!-- bodyContent -->
|
|
347
|
+
</div>
|
|
348
|
+
|
|
349
|
+
<div id="pageFooter">
|
|
350
|
+
<div>
|
|
351
|
+
·
|
|
352
|
+
<a href="./index.html">Doc Home</a>
|
|
353
|
+
|
|
|
354
|
+
<a href="./installation.html">Installation</a>
|
|
355
|
+
|
|
|
356
|
+
<a href="./configuration.html">Configuration</a>
|
|
357
|
+
|
|
|
358
|
+
<a href="./guide.html">Usage</a>
|
|
359
|
+
|
|
|
360
|
+
<a href="./directives.html">Directives</a>
|
|
361
|
+
·
|
|
362
|
+
</div>
|
|
363
|
+
<table summary="layout area">
|
|
364
|
+
<tbody>
|
|
365
|
+
<tr>
|
|
366
|
+
<td class="copyright">© Copyright MasterView 2006</td>
|
|
367
|
+
<td class="validators">
|
|
368
|
+
<a href="http://validator.w3.org/check/referer">[Valid XHTML]</a>
|
|
369
|
+
</td>
|
|
370
|
+
</tr>
|
|
371
|
+
</tbody>
|
|
372
|
+
</table>
|
|
373
|
+
</div>
|
|
374
|
+
|
|
375
|
+
</body>
|
|
376
|
+
</html>
|
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
/* Masterview documentation stylesheet (stripped down from rdoc styles and revised) */
|
|
2
|
+
|
|
3
|
+
body {
|
|
4
|
+
margin: 0;
|
|
5
|
+
padding: 0;
|
|
6
|
+
color: #333;
|
|
7
|
+
background-color: white;
|
|
8
|
+
font-family: "Times New Roman", Times, serif;
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
img {
|
|
12
|
+
border: 0;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
table {
|
|
16
|
+
border: 0;
|
|
17
|
+
}
|
|
18
|
+
th, td {
|
|
19
|
+
vertical-align: top;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
.layoutArea {
|
|
23
|
+
width: 100%;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/* --- general text styles ----------------------------- */
|
|
27
|
+
|
|
28
|
+
h1,h2,h3,h4,h5,h6 {
|
|
29
|
+
font-family: Verdana,Arial,Helvetica,sans-serif;
|
|
30
|
+
margin: 0;
|
|
31
|
+
/*background: transparent; */
|
|
32
|
+
}
|
|
33
|
+
h1 { font-size: 150%; }
|
|
34
|
+
h2,h3,h4 { margin-top: 1em; }
|
|
35
|
+
|
|
36
|
+
a { background: #eef; color: #039; text-decoration: none; }
|
|
37
|
+
a:hover { background: #039; color: #eef; }
|
|
38
|
+
|
|
39
|
+
/* Override the base stylesheet's Anchor inside a table cell [???from rdoc - do we use this???] */
|
|
40
|
+
td > a {
|
|
41
|
+
background: transparent;
|
|
42
|
+
color: #039;
|
|
43
|
+
text-decoration: none;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/* and inside a section title [???from rdoc - do we use this???] */
|
|
47
|
+
.section-title > a {
|
|
48
|
+
background: transparent;
|
|
49
|
+
color: #eee;
|
|
50
|
+
text-decoration: none;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/* === Page layout structure elements ===================================== */
|
|
54
|
+
|
|
55
|
+
/* ???? from rdoc.....
|
|
56
|
+
div#index {
|
|
57
|
+
margin: 0;
|
|
58
|
+
margin-left: -40px;
|
|
59
|
+
padding: 0;
|
|
60
|
+
font-size: 90%;
|
|
61
|
+
}
|
|
62
|
+
div#index a {
|
|
63
|
+
margin-left: 0.7em;
|
|
64
|
+
}
|
|
65
|
+
div#index .section-bar {
|
|
66
|
+
margin-left: 0px;
|
|
67
|
+
padding-left: 0.7em;
|
|
68
|
+
background: #ccc;
|
|
69
|
+
font-size: small;
|
|
70
|
+
}
|
|
71
|
+
???*/
|
|
72
|
+
|
|
73
|
+
div#pageHeader, div#pageFooter {
|
|
74
|
+
width: 100%;
|
|
75
|
+
text-align: left;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
div#pageHeader {
|
|
79
|
+
padding-bottom: 6px;
|
|
80
|
+
border-bottom: 1px solid black;
|
|
81
|
+
}
|
|
82
|
+
div#pageHeader div {
|
|
83
|
+
width: 800px;
|
|
84
|
+
text-align: center;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
div#pageBody {
|
|
88
|
+
padding: 15px 20px;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
div#pageFooter {
|
|
92
|
+
border-top: 1px solid black;
|
|
93
|
+
padding-top: 6px;
|
|
94
|
+
padding-bottom: 6px;
|
|
95
|
+
border-bottom: 1px solid black;
|
|
96
|
+
margin-bottom: 8px;
|
|
97
|
+
}
|
|
98
|
+
div#pageFooter div {
|
|
99
|
+
width: 800px;
|
|
100
|
+
text-align: center;
|
|
101
|
+
}
|
|
102
|
+
div#pageFooter table {
|
|
103
|
+
width: 800px;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/* --- page header styles ------------------------------ */
|
|
107
|
+
|
|
108
|
+
div#pageHeader {
|
|
109
|
+
font-family: "Times New Roman", Times, serif;
|
|
110
|
+
font-size: 36px;
|
|
111
|
+
font-weight: bold;
|
|
112
|
+
/*vertical-align: middle;*/
|
|
113
|
+
}
|
|
114
|
+
div#pageHeader .description {
|
|
115
|
+
font-size: 14px;
|
|
116
|
+
font-style: italic;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/* --- page body styles -------------------------------- */
|
|
120
|
+
|
|
121
|
+
/*??? this came in from the rdoc stylesheet - do we want this?? */
|
|
122
|
+
div#description {
|
|
123
|
+
padding: 0.5em 1.5em;
|
|
124
|
+
background-color: #efefef;
|
|
125
|
+
border: 1px dotted #999;
|
|
126
|
+
}
|
|
127
|
+
div#description h1,h2,h3,h4,h5,h6 {
|
|
128
|
+
color: #125;
|
|
129
|
+
background: transparent;
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/* --- page footer styles ------------------------------ */
|
|
133
|
+
|
|
134
|
+
div#validator-badges {
|
|
135
|
+
text-align: center;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
div#copyright {
|
|
139
|
+
color: #333;
|
|
140
|
+
background: #efefef;
|
|
141
|
+
font: 0.75em sans-serif;
|
|
142
|
+
margin-top: 5em;
|
|
143
|
+
margin-bottom: 0;
|
|
144
|
+
padding: 0.5em 2em;
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
div#pageFooter td.copyright {
|
|
148
|
+
padding-left: 20px;
|
|
149
|
+
font-size: smaller;
|
|
150
|
+
font-style: italic;
|
|
151
|
+
}
|
|
152
|
+
div#pageFooter td.validators {
|
|
153
|
+
text-align: right;
|
|
154
|
+
padding-right: 20px;
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
/* === Page content style elements ======================================== */
|
|
158
|
+
|
|
159
|
+
.productName {
|
|
160
|
+
font-family: "Courier New", Courier, monospace;
|
|
161
|
+
}
|
|
162
|
+
.directiveName {
|
|
163
|
+
font-weight: bold;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
.alert {
|
|
167
|
+
color: red;
|
|
168
|
+
font-style: italic;
|
|
169
|
+
}
|
|
170
|
+
.explanation {
|
|
171
|
+
font-style: italic;
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
.configurationSettings {
|
|
175
|
+
font-family: Verdana,Arial,Helvetica,sans-serif;
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
.cmdLine {
|
|
179
|
+
margin-left: 20px;
|
|
180
|
+
font-family: "Courier New", Courier, monospace;
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
pre.code { /* from http://facets.rubyforge.org/wiki/wiki.css */
|
|
184
|
+
border: #646464 1px solid;
|
|
185
|
+
padding: 0.5em;
|
|
186
|
+
margin-left: 1em;
|
|
187
|
+
margin-right: 2em;
|
|
188
|
+
white-space: pre;
|
|
189
|
+
color: black;
|
|
190
|
+
background-color: #e6e6e6;
|
|
191
|
+
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
/* --- Ruby keyword styles --------------------- */
|
|
195
|
+
|
|
196
|
+
.standalone-code { background: #221111; color: #ffdead; overflow: hidden; }
|
|
197
|
+
|
|
198
|
+
.ruby-constant { color: #7fffd4; background: transparent; }
|
|
199
|
+
.ruby-keyword { color: #00ffff; background: transparent; }
|
|
200
|
+
.ruby-ivar { color: #eedd82; background: transparent; }
|
|
201
|
+
.ruby-operator { color: #00ffee; background: transparent; }
|
|
202
|
+
.ruby-identifier { color: #ffdead; background: transparent; }
|
|
203
|
+
.ruby-node { color: #ffa07a; background: transparent; }
|
|
204
|
+
.ruby-comment { color: #b22222; font-weight: bold; background: transparent; }
|
|
205
|
+
.ruby-regexp { color: #ffa07a; background: transparent; }
|
|
206
|
+
.ruby-value { color: #7fffd4; background: transparent; }
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/* styles used in the Configuration Guide */
|
|
2
|
+
|
|
3
|
+
table.settings_table {
|
|
4
|
+
margin-left: 20px;
|
|
5
|
+
margin-right: 20px;
|
|
6
|
+
}
|
|
7
|
+
.settings_table thead {
|
|
8
|
+
background-color: #dcdcdc;
|
|
9
|
+
}
|
|
10
|
+
th, td {
|
|
11
|
+
text-align: left;
|
|
12
|
+
vertical-align: top;
|
|
13
|
+
}
|
|
14
|
+
.settings_table .setting {
|
|
15
|
+
font-weight: bold;
|
|
16
|
+
padding-right: 20px;
|
|
17
|
+
}
|
|
18
|
+
.settings_table .default {
|
|
19
|
+
font-family: "Courier New", Courier, monospace;
|
|
20
|
+
padding-right: 20px;
|
|
21
|
+
}
|
|
22
|
+
.settings_table .description {
|
|
23
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/* styles used in the Directives Reference Guide */
|
|
2
|
+
|
|
3
|
+
.toc td {
|
|
4
|
+
padding-left: 6px;
|
|
5
|
+
}
|
|
6
|
+
.toc tr.subheader {
|
|
7
|
+
font-weight: bold;
|
|
8
|
+
}
|
|
9
|
+
.toc tr.subheader td {
|
|
10
|
+
padding-top: 8px;
|
|
11
|
+
}
|
|
12
|
+
.toc tr.subheader td {
|
|
13
|
+
padding-left: 0;
|
|
14
|
+
}
|
|
15
|
+
.toc td.directive {
|
|
16
|
+
padding-left: 20px;
|
|
17
|
+
}
|
|
18
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
2
|
+
|
|
3
|
+
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
|
4
|
+
<head>
|
|
5
|
+
<title>MasterView - Troubleshooting</title>
|
|
6
|
+
</head>
|
|
7
|
+
|
|
8
|
+
<body>
|
|
9
|
+
<div mv:generate="*" mv:omit_tag="">
|
|
10
|
+
|
|
11
|
+
<h1>MasterView - Troubleshooting</h1>
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
<p style="font-style:italic;">###Describe file locking problem observed on windows after editing MV template while app running on Win32, subsequent edit says file in use (encountered with TopStyle, doesn't happen with UltraEdit). [DJL 03-Jun-2006]</p>
|
|
15
|
+
|
|
16
|
+
</div>
|
|
17
|
+
</body>
|
|
18
|
+
</html>
|