RubyGems - masterview - Versions diffs - 0.1.5 → 0.2.0 - Mend

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.

Files changed (105) hide show

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

data/TODO CHANGED Viewed

@@ -1,13 +1,18 @@
+- create install.rb for rails 1.1 plugin installs, it will create config/masterview and some sample configs
 - create namespace for mv and publish, update generated files
-- video
+- more videos
+- image_tag (improve support for referencing image assets in MasterView directives markup)
+- allow multiple namespace prefixes for directives (allow custom directives to declare their own namespace)
 - wiki for site
 - render from db
-- skip generation of ERB, provide way to get erb output
 - app for syntax
 - include additional stylesheets
 - ajax examples
 - ajax table component
-- investigate ways to improve splitting files and other team development issues
 - documentation
 - directive developer documentation and examples
 - more tests
+- internal code cleanup
+    - DirectiveHelpers ERB_xx constants to differentiate ' %>' and ' -%>'
+    - replace MasterView::NamespacePrefix+'<gen/import directivename>' concats in parser/analyzer with directive attr name constants
+    - run spell checker on doc/*.html, ripple typo fixes back in rdoc comment

data/doc/configuration.html ADDED Viewed

@@ -0,0 +1,485 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>MasterView - Configuration Guide</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link href="./stylesheets/masterview.css" rel="stylesheet" type="text/css" />
+  <link href="./stylesheets/mv-config.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+<div id="pageHeader">
+<div>MasterView Template Engine</div>
+<div class="description">Rails-optimized (x)html friendly template engine</div>
+</div>
+<div id="pageBody">
+<div id="bodyContent" mv:generate="{template_path}" mv:omit_tag="">
+<h1>MasterView - Configuration Guide</h1>
+<p><span class="productName">MasterView</span> supports a number of options for configuring its operation.</p>
+<div style="margin-left: 20px;">
+<p style="padding-bottom: 4px; margin-bottom: 4px;"><a href="#mv_options_ref">MasterView Configuration Options Reference</a></p>
+<ul> <!--TOC style-->
+<li><a href="#mv_general_options">General Options</a> - root paths for config settings, directives, templates</li>
+<li><a href="#mv_template_source_options">Template Source Options</a></li>
+<li><a href="#mv_template_generation_options">Template Generation Options</a></li>
+<li><a href="#mv_template_parsing_options">Template Parsing Options</a></li>
+<li><a href="#mv_rails_app_options">Rails Application Options</a></li>
+</ul>
+</div>
+<p>A standard set of configuration options are installed by default
+that are suitable for a typical Rails application.
+The goal is to allow Rails application developers to use
+the <span class="productName">MasterView</span> plugin "out of the box",
+with little or no initial setup effort: simply install the
+<span class="productName">MasterView</span> plugin in a rails application
+and start using the template engine facilities in its views.
+</p>
+<h2>Using MasterView in a Rails Application</h2>
+<p>The standard configuration of <span class="productName">MasterView</span> in
+a Rails application is to generate rhtml into the <code>RAILS_ROOT/app/views</code>
+directory from template files in <code>RAILS_ROOT/app/views/masterview</code>.
+The <code>mv:</code> attribute markup in the masterview templates determines
+the content of the generated rhtml view templates, which are then used by the Rails controller/view dispatching mechanisms in the usual fashion.
+</p>
+<p>
+By default, all masterview templates are parsed during rails application startup to ensure
+that generated rhtml views are up-to-date for the application.
+In a development environment, when Rails is reloading changed classes to dynamically
+update the application code as you make changes,
+<span class="productName">MasterView</span> will automatically
+detect changes you make to your masterview templates and regenerate the rails rhtml views.
+This ability to dynamically modify your rails application during development
+is a key factor for the productivity of Rails developers, so
+the <span class="productName">MasterView</span> designers have ensured
+that you continue to have this capability when using masterview templates.
+</p>
+<p>You can customize <span class="productName">MasterView</span> operation
+by modifying the standard set of configuration options.
+To specify your configuration, create a <code>masterview</code> directory
+in your Rails configuration directory (<code>RAILS_ROOT/config/masterview</code>).
+Within this directory, create a <code>settings.rb</code> file containing
+your application's configuration settings.
+Options are set by assigning values to the <code>config</code> instance
+that will be used to initialize  <span class="productName">MasterView</span>.
+</p>
+<p>Just as with with your Rails configuration settings, you can optionally provide
+environment-specific settings to override or augment your standard application settings.
+To specify environment-dependent configuration settings, provide
+additional config files in an <code>environments</code> subdirectory
+(e.g., create <code>RAILS_ROOT/config/masterview/environments/development.rb</code>
+to configure settings specifically for your development environment).
+</p>
+<h3>Sample <code>config/masterview/settings.rb</code> in a Rails Application</h3>
+<pre><code>
+    # Application configuration settings for the MasterView template engine.
+    # Run at plugin load time during Rails startup (after the base rails
+    # framework is loaded and before the application's own startup logic
+    # in its config/environment.rb is run).
+    #
+    # Set standard application
+    # change the template source directory location for this application
+    # Specify relative path from RAILS_ROOT (config.root_path)
+    config.template_src_dir_path = 'app/masterview/templates'  #default: 'app/masterview'
+    # Only use the MasterView admin pages for development
+    config.enable_admin_pages = false
+    # modify the default logging level from WARN to ERROR (only want to see serious errors)
+    config.logger = 'log4r'
+    config.log_level = 'ERROR'
+    config.after_initialize {
+      # we shouldn't see any of these in the log
+      MasterView.Log.debug "LOG CONFIG TEST: debug log entries suppressed at ERROR level"
+      MasterView.Log.info "LOG CONFIG TEST: info log entries suppressed at ERROR level"
+      MasterView.Log.warn "LOG CONFIG TEST: warning log entries suppressed at ERROR level"
+      # so this is the only log message that should get through
+      #MasterView.Log.error "LOG CONFIG TEST: only serious messages are reported at ERROR level"
+    }
+</code></pre>
+<h3>Sample <code>config/masterview/environments/development.rb</code> in a Rails Application</h3>
+<pre><code>
+    # Application configuration settings for the MasterView template engine.
+    #
+    # Set development-mode config settings here
+    # Only use the MasterView admin pages for development
+    config.enable_admin_pages = true
+    # include debug and all info/warning/error log messages during development
+    config.log_level = 'DEBUG'
+</code></pre>
+<h2>Using MasterView outside Rails</h2>
+<p><span class="productName">MasterView</span> has been designed so that it can also be
+used independently of the Rails application context.
+Outside Rails, you need to explicitly run the <code>MasterView::Initializer</code>
+in your application startup code.
+While the Rails framework handles masterview loading automatically through its
+framework startup and plugin loading facilities,
+with configuration settings files obtained from standard locations within the
+overall structure of a rails application,
+a non-rails application using the MasterView template engine needs to initiate
+loading the template engine and providing it with configuration information.
+</p>
+<pre><code>
+    require 'masterview/initializer'
+    config = MasterView::Configuration( :app_root_path = '/path/to/my/app' )
+    # This app has simple config, so it won't use the config files scheme used in Rails.
+    # We just specify our directory locations within the app right here.
+    config.template_src_dir_path = 'masterview/templates'  # rel path from app's root_path
+    config.template_dst_dir_path = 'masterview/output'
+    Masterview::Initializer(:process, config)
+</code></pre>
+<hr />
+<a name="mv_options_ref" />
+<h2>MasterView Configuration Options</h2>
+<a name="mv_general_options" />
+<h3>General Options</h3>
+<table class="settings_table" summary="general options">
+<thead>
+<tr><th>Option</th><th>Default</th><th>Description</th></tr>
+</thead>
+<tbody>
+<tr>
+<td class="setting">root_path</td>
+<td class="default">RAILS_ROOT or '.'</td>
+<td class="description">Path to the root location of the application.
+</td>
+</tr>
+<tr>
+<td class="setting">config_dir_path</td>
+<td class="default">RAILS_ROOT/config/masterview or nil</td>
+<td class="description">Path to the directory containing the application's config settings.
+<div class="explanation">Specified as a relative path from the <code>root_path</code>.</div>
+</td>
+</tr>
+<tr>
+<td class="setting">environment</td>
+<td class="default">RAILS_ENV or nil</td>
+<td class="description">The current execution environment, if applicable.
+<div class="explanation">Used for locating environment-specific settings in the  config directory, if available.</div>
+</td>
+</tr>
+<tr>
+<td class="setting">directive_paths</td>
+<td class="default">&nbsp;</td>
+<td class="description">Paths of directories to load directives from.
+<div class="explanation">Directory for built-in <code>MasterView</code> directives is included by default.
+Append additional directories to load custom directives (e.g., <code>config.directive_paths << /path/to/my/directives</code>).
+</div>
+</td>
+</tr>
+<!--DROPPED OUT [JJB 14-Jun-2006]
+<tr>
+<td class="setting">rebuild_backups_tmp_dir_path</td>
+<td class="default">RAILS_ROOT/tmp/masterview/rebuild/backups or nil</td>
+<td class="description">Relative path from the application's <code>root_path</code> of temp directory used for creating backup files before rebuilding/updating a template file.
+<div class="explanation">Set to <code>nil</code> to suppress backups.</div>
+</td>
+</tr>
+-->
+<tr>
+<td class="setting">logger</td>
+<td class="default">Log4r if available, otherwise standard ruby Logger</td>
+<td class="description">Logger which will be used to output debug, warning, and error messages.
+<div class="explanation">Supported loggers:
+<br />
+<code>'log4r'</code> - the Log4r logger
+<br />
+<code>'logger'</code> - ruby standard library logger
+</div>
+</td>
+</tr>
+<tr>
+<td class="setting">log_level</td>
+<td class="default"><code>INFO</code> for development, otherwise <code>WARN</code></td>
+<td class="description">Specify the name of the logging severity level.
+<div class="explanation">Logging levels names may be logger-dependent.</div>
+</td>
+</tr>
+<tr>
+<td class="setting">after_initialize</td>
+<td class="default">nil</td>
+<td class="description">Optional block which will be executed after MasterView
+has been fully initialized.
+</td>
+</tr>
+<!--####
+<tr>
+<td class="setting">XXX</td>
+<td class="default">&nbsp;</td>
+<td class="description">&nbsp;</td>
+</tr>
+###-->
+</tbody>
+</table>
+<a name="mv_template_source_options" />
+<h3>Template Source Options</h3>
+<table class="settings_table" summary="template source options">
+<thead>
+<tr><th>Option</th><th>Default</th><th>Description</th></tr>
+</thead>
+<tbody>
+<tr>
+<td class="setting">template_src_dir_path</td>
+<td class="default">RAILS_ROOT/app/masterview (rails)
+<br />{root_path}/masterview/templates<br />(non-rails app)</td>
+<td class="description">Path to the directory where masterview templates are located.
+<div class="explanation">
+Specify the location of your template source directory as a relative path from the application's <code>root_path</code> directory.
+Use <code>config.template_src_dir_abs_path(abs_path)</code> to specify the template source directory as an absolute path.
+</div>
+</td>
+</tr>
+<tr>
+<td class="setting">template_filename_pattern</td>
+<td class="default">*.html</td>
+<td class="description">Filename pattern for masterview template files within the template source directory.</td>
+</tr>
+<!--####
+<tr>
+<td class="setting">XXX</td>
+<td class="default">&nbsp;</td>
+<td class="description">&nbsp;</td>
+</tr>
+###-->
+</tbody>
+</table>
+<a name="mv_template_generation_options" />
+<h3>Template Generation Options</h3>
+<table class="settings_table" summary="template generation options">
+<thead>
+<tr><th>Option</th><th>Default</th><th>Description</th></tr>
+</thead>
+<tbody>
+<tr>
+<td class="setting">template_dst_dir_path</td>
+<td class="default">RAILS_ROOT/app/views(rails)
+<br />{root_path}/masterview/output<br />(non-rails app)</td>
+<td class="description">Path to the directory where Masterview template output (rhtml) will be generated.
+<div class="explanation">
+Specify the location of your template output directory as a relative path from
+the application's <code>root_path</code>.
+Use <code>config.template_dst_dir_abs_path(abs_path)</code> to specify the template output directory as an absolute path.
+</div>
+</tr>
+<tr>
+<td class="setting">output_filename_extension</td>
+<td class="default">.rhtml</td>
+<td class="description">Filename extension to use for generated output files if not specified.
+</td>
+</tr>
+<tr>
+<td class="setting">generated_file_default_extension</td>
+<td class="default">.rhtml</td>
+<td class="description">Filename extension to use for generated files if not specified.</td>
+</tr>
+<tr>
+<td class="setting">include_generated_file_comment</td>
+<td class="default">true</td>
+<td class="description">
+Boolean which controls whether to include a comment in template
+output files indicating that the file was generated by MasterView.
+<div class="explanation">By default, a warning comment is generated in template output files indicating that the file was generated by MasterView from a template and should not be directly edited, as any changes would be lost when the output file is regenerated.</div>
+</td>
+</tr>
+<tr>
+<td class="setting">generated_file_comment</td>
+<td class="default">&nbsp;</td>
+<td class="description">Text for generated-file comment inserted in rhtml template output files generated by MasterView.
+<div class="explanation">Standard comment includes the name of the master template file which contains the source to edit.
+Variable substitution on the comment text will replace <code>#{template_path}</code>
+with the pathname of the source template file.
+</div>
+</td>
+</tr>
+<!--####
+<tr>
+<td class="setting">XXX</td>
+<td class="default">&nbsp;</td>
+<td class="description">&nbsp;</td>
+</tr>
+###-->
+</tbody>
+</table>
+<a name="mv_template_parsing_options" />
+<h3>Template Parsing Options</h3>
+<table class="settings_table" summary="template parsing options">
+<thead>
+<tr><th>Option</th><th>Default</th><th>Description</th></tr>
+</thead>
+<tbody>
+<tr>
+<td class="setting">handle_parse_exceptions</td>
+<td class="default">true</td>
+<td class="description">Continue template parsing after logging parse exceptions.</td>
+</tr>
+<tr>
+<td class="setting">default_parser_options</td>
+<td class="default">hash containing parser options</td>
+<td class="description">Options for parser operation</td>
+</tr>
+<tr>
+<td>&nbsp;</td>
+<td class="default"><b>:tidy</b> => false</td>
+<td class="description">Run tidy before processing template
+<div class="explanation">(must set <code>tidy_path</code>)</div>
+</td>
+</tr>
+<tr>
+<td>&nbsp;</td>
+<td class="default"><b>:escape_erb</b> => true</td>
+<td class="description">Escape <code>&lt;%&nbsp;%&gt;</code> before parsing</td>
+</tr>
+<tr>
+<td class="setting">tidy_path</td>
+<td class="default">&nbsp;</td>
+<td class="description">Path on this system to tidy library if <b>:tidy</b> parser option is enabled so that masterview templates will be run through tidy before being parsed.</td>
+</tr>
+<tr>
+<td class="setting">namespace_prefix</td>
+<td class="default">mv:</td>
+<td class="description">XML name space prefix for MasterView directive attributes in template html.</td>
+</tr>
+<tr>
+<td class="setting">inline_erb_start</td>
+<td class="default">{{{</td>
+<td class="description">Xhtml safe substitution for <code>&lt;%</code> in a masterview template.</td>
+</tr>
+<tr>
+<td class="setting">inline_erb_end</td>
+<td class="description">}}}</td>
+<td class="description">Xhtml safe substitution for <code>%&gt;</code> in a masterview template.</td>
+</tr>
+<tr>
+<td class="setting">inline_erb_substitution_regex</td>
+<td class="default">&nbsp;</td>
+<td class="description">regex used to find escaped inline_erb markup.
+<div class="explanation">Needs to match <code>inline_erb_start</code> and <code>inline_erb_end</code></div>
+</td>
+</tr>
+<!--####
+<tr>
+<td class="setting">XXX</td>
+<td class="default">&nbsp;</td>
+<td class="description">&nbsp;</td>
+</tr>
+###-->
+</tbody>
+</table>
+<a name="mv_rails_app_options" />
+<h3>Rails Application Options</h3>
+<table class="settings_table" summary="rails application options">
+<thead>
+<tr><th>Option</th><th>Default</th><th>Description</th></tr>
+</thead>
+<tbody>
+<tr>
+<td class="setting">parse_masterview_templates_at_startup</td>
+<td class="default">true</td>
+<td class="description">Boolean which determines whether masterview templates are parsed during initial application startup loading.
+<div class="explanation">If the auto-parse option is disabled, template parsing must be manually triggered by the application developer.</div>
+</td>
+</tr>
+<tr>
+<td class="setting">reparse_changed_masterview_templates</td>
+<td class="default">true if both template parsing at startup and ActionController class reloading are enabled</td>
+<td class="description">Boolean which determines whether masterview templates are automatically reparsed if the template changes after initial application loading.
+</td>
+</tr>
+<tr>
+<td class="setting">enable_admin_pages</td>
+<td class="default">false</td>
+<td class="description">Enable MasterView admin pages in the rails application. If config/masterview/environments/production.rb was created during installation then the default is false in production mode.
+<div class="explanation">Enables the masterview admin controller at <code>http://yourappdomain/masterview</code>.</div>
+</td>
+</tr>
+<tr>
+<td class="setting">enable_view_rhtml</td>
+<td class="default">false</td>
+<td class="description">Enable MasterView admin pages in a rails application to be able to view the generated rhtml. When enabled it creates links on the list page to click to view the rhtml source. Requires that enable_admin_pages is true.  If config/masterview/environments/production.rb was created during installation then the default is false in production mode.
+<div class="explanation">This functionality is useful for understanding how your templates are being interpretted (ie. what rhtml is being generated by them) and for debugging. For security reasons you would probably disable this feature in production (or disable admin pages altogether).</div>
+</td>
+</tr>
+<tr>
+<td class="setting">generate_rhtml_files</td>
+<td class="default">false</td>
+<td class="description">Boolean which controls whether to generate rhtml (erb) files to file system and have rails load from there, otherwise Rails will load directly from MasterView.
+<div class="explanation">If this setting is false, then several methods in the rails controller and view will be enhanced to be able to read erb directly from MasterView in addition to being able to read the erb on the file system. If this setting is true then rhtml(erb) files will be generated to file system and rails will read them from there in the traditional manner.</div>
+</td>
+</tr>
+<!--####
+<tr>
+<td class="setting">XXX</td>
+<td class="default">&nbsp;</td>
+<td class="description">&nbsp;</td>
+</tr>
+###-->
+</tbody>
+</table>
+</div>  <!-- bodyContent -->
+</div>
+<div id="pageFooter">
+<div>
+&middot;&nbsp;
+<a href="./index.html">Doc Home</a>
+&nbsp;|&nbsp;
+<a href="./installation.html">Installation</a>
+&nbsp;|&nbsp;
+<a href="./configuration.html">Configuration</a>
+&nbsp;|&nbsp;
+<a href="./guide.html">Usage</a>
+&nbsp;|&nbsp;
+<a href="./directives.html">Directives</a>
+&nbsp;&middot;
+</div>
+<table summary="layout area">
+<tbody>
+<tr>
+<td class="copyright">&copy;&nbsp;Copyright MasterView 2006</td>
+<td class="validators">
+  <a href="http://validator.w3.org/check/referer">[Valid XHTML]</a>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+</body>
+</html>