masterview_gem_pack 0.1.5 → 0.2.0

data/CHANGELOG

@@ -1,3 +1,20 @@
+0.2.0 - June 20th, 2006 - Big release. Added capability for eliminating rhtml generation, extends rails so that rhtml can be pulled directly from MasterView. 
+Support template compilation directly into Rails view cache for templates in app/views (rhtml generation now optional)
+New mechanism for configuring MasterView from settings files; internal initialization rework. Configuration can now be driven by editing config/masterview/settings.rb and/or config/masterview/environments/*.rb.
+Add support for configuring MasterView logger and log_level; default level INFO for dev, WARN otherwise
+Add keyword substitution for generate/import attributes (mv:generate="{template_path}" notation)
+Added capability to view rhtml from MasterView Admin pages.
+Add 'View Configuration' page in MasterView Admin pages to display config settings.
+Reorganize and enhance documentation: doc/index.html; improved installation guide, added config guide, improved User Guide
+Internals: Renamed PartialExtension to GeneratedFileDefaultExtension
+Internals: Renamed partial_filename_extension to generated_file_default_extension
+Internals: Major internal rework of file handling and I/O.
+--UPGRADE NOTE: you *must* redo any config customizations in plugin init.rb to use new settings file and config vars
+--UPGRADE NOTE: default location for masterview template files is now the app/views directory in your Rails app
+--UPGRADE NOTE: directive gen_render was renamed gen_partial for clarity, update any templates which reference gen_render
+
+0.1.6 - June 2nd - Implement basic dateselect and datetime_select in generator. Simplify only empty elements that are specified as empty in xhtml-1.0-Strict DTD.
+
 0.1.5 - May 31st - Remove app_[ENV] customization hook in leau of a block based initializer approach (similar to rails) from Deborah Lewis which would allow customization from the environment config files.
 
 0.1.4 - May 30th - Apply patch by Deborah Lewis to allow customized generated comment. Add omit_tag directive to conditionally suppress output of element tag. Add user configuration user.rb, user_RAILS_ENV.rb

data/README

@@ -5,14 +5,20 @@ It is designed to use the full power and productivity of rails including
 layouts, partials, and rails html helpers while still being editable/styleable 
 in a WYSIWYG HTML editor.  
 
-MasterView is distributed as a gem or a plugin. You may install it as a gem and then generate a lightweight plugin which mainly refers to the gem *or* you can simply install as a plugin which is self contained. I personally prefer installing as a gem for ease of management, however if you are running at a shared hosting environment you might not have authority to install this gem so you may install as a self contained plugin.
+MasterView is distributed as a gem or a plugin. You may install it as a gem and 
+then generate a lightweight plugin which mainly refers to the gem *or* you can 
+simply install as a plugin which is self contained. I personally prefer installing 
+as a gem for ease of management, however if you are running at a shared hosting 
+environment you might not have authority to install this gem so you may install 
+as a self contained plugin.
 
 If you are interested in the background story behind all this, it is at the end of this page.
 
 Author:: Jeff Barczewski
 Email:: jeff.barczewski @ gmail.com
-Rubyforge project:: masterview
+Primary developers:: Jeff Barczewski, Deb Lewis
 Website:: http://masterview.org
+Rubyforge project:: masterview
 License:: MIT open source license like Rails
 
 == Goals
@@ -35,513 +41,32 @@ Optional::
 	tidy (gem) and tidy library - if these are installed you can use tidy to cleanup html into valid xhtml for use by MasterView
 	log4r (gem) - if this gem is installed then MasterView will use it for logging otherwise it defaults to using built in Logger.
 
-== Installation
-
-Install in one of the two following ways depending on whether you can use gems or not. 
-
-=== Installation using gems (if you are able to use gems)
+== User Documentation
 
-If you can use gems you may simply do the following
+MasterView documentation is available online at the MasterView site:
+  http://www.masterview.org 
+and on the rubyforge project
+  http://rubyforge.org/projects/masterview/
 
-gem install masterview_gem_pack
-
-Now your gem is installed and you can skip these steps in the future. After creating your rails directory, change directory to it and run the following to create a very lightweight plugin instance for this application mainly consisting of an init.rb file which will get loaded at runtime. This init.rb refers to the gem for everything but allows you to override any constants or setup that has been provided. See MasterView module masterview.rb for a list of the available constants. 
-
-script/generate masterview_plugin
-
-After this MasterView is ready for use. Skip down to the Usage section for more details. 
-
-=== Installation without using gems, install as plugin
+== Installation
 
-script/plugin install svn://rubyforge.org/var/svn/masterview/tags/latest
+Detailed installation instructions for installing the masterview gems
+or a self-contained copy of the plugin is provided in the MasterView
+Installation Guide.
 
-This will copy entire MasterView system into your vendor/plugin/masterview directory. You may tweak its init.rb to override any MasterView constants at runtime. See MasterView module masterview.rb for a list of available constants. Note that if you don't have svn (subversion) installed, you may also retrieve the plugin package (masterview_plugin.tgz or masterview_plugin.zip) from http://rubyforge.org/projects/masterview and simply extract into vendor/plugins/masterview 
+The Configuration Guide describes how to customize the configuration
+of the MasterView template engine for your application.
 
 == Usage
 
-You may add MasterView attributes to existing (x)html or you may use the masterview generator to create a complete working application. The generator can create controllers, models, and the MasterView template file similar to how the built-in generator works. Simply change directory to your rails application and run the following
-
-script/generate masterview YourModelName [YourControllerName] [--style [cssStylesheet]] [--single-file] [--show-all | --show-only list] 
-
-The generator by default will generate five masterview template files, one for each distinct page, list, new, edit, show, and destroy. They exist in the app/views/masterview directory with the filename controller_action.html. The layout and message partial are defined in the list template file and imported into the others. Similarly the new template defines the form partial which is imported into edit, and finally the show file defines a _show partial which is imported into destroy. Thus there is one definition of each part (layout and partial) and they are imported into the other files where needed to provide accurate WYSIWYG design time editing. By generating separate files, teams can work on a project easier, however MasterView also supports generating all parts to a single file for the ultimate in DRY.
-
-By adding the --single-file switch MasterView will create a single file and to make it easier to use this template at design time, some design time css stylesheets are included in the file to hide all sections except one. By default the NEW section is the only one shown. Other options are --show-all which makes all sections visible or [--show-only list] which shows only the LIST section. When you are editing the masterview file you may comment/uncomment one of the other css files to show a different section. The --style param allows you to suppress default style generation and specify an existing stylesheet to use, if you exlude the stylesheet none will be used, if you include this option multiple times with different stylesheets each will be used.
-
-Once it is done generating, the generated MasterView template file(s) will be created in app/views/masterview/. These files are html and can be edited with any standard html editor. The rails specific logic is contained in simple attributes which are ignored by html editors. The syntax for these attributes is heavily derived from the rails helper tags themselves so it should feel natural to the rails developer.
-
-Another interesting thing to know is that while all of the pages for this Model have been bundled up into a few html file for ease of editing, at runtime these templates gets rendered into the exact same layouts and partials that you would use if you were building from scratch. Its jsut that now you can see what your pages will render like in your wysiwyg html editor and change and layout accordingly. Additionally MasterView supplies some javascript to show only one action view at time (list, new, show, edit, destroy) so you can view in your browser without running in Rails. Dummy html can be included to improve the accuracy of the page which can be easily removed at runtime. To make it easier to work with in an editor, design time stylesheets are included in the file to allow you to hide all sections except the one you are working on, simply uncomment the appropriate stylesheet for the section you would like to work with.
-
-MasterView is designed to be easy for a developer and designer to work together. By keeping the template in an html friendly format, designers can apply style, layout changes, wording changes, without causing havoc on the rails view code. The designer can be involved at anytime during the development cycle including being able to change style and layout after the system is built. This is great for allowing design or wording changes without reinvolving the developers. One can even start from a designer created prototype and add MasterView tags to make it become real. Whichever way you prefer to work, MasterView accomodates you.
-
-With Version 0.1.0 a MasterView admin controller/view was added to provide a birds-eye view of all your masterview templates, the status of those templates (OK, Invalid xhtml, Conflicts, Imports outdated), the details regarding the status, and the ultimate erb files generated from each template. By default the MasterView admin controller is enabled by the plugin and is available at http://yourserver/masterview This controller can easily be disabled if not wanted by setting the EnableMasterViewAdminPages = false in the vendor/plugins/masterview/init.rb file. Additionally all of the power of the MasterView admin controller is available via a set of rake commands as well. rake mv:list mv:list_all mv:rebuild mv:rebuild_all mv:copy_layout. rake -T will give you further information about these commands.
-
-Since it can be difficult to import a layout by hand into a new file, the MasterView admin controller has a link where you can copy the layout into a new file by providing the new files Action. It will take the layout from the template chosen and create a new file controller_action.html with the layout imported and a shell for the new Action code. You can also do this from command line using rake mv:copy_layout TEMPLATE=foo_list.html ACTION=newaction command.
-
-== MasterView attribute directive syntax
-
-These attribute directives are provided by MasterView and you can create your own custom attributes for even more power.
-
-mv:generate="layouts/product.rhtml"
-	When the generate directive is encountered it creates a new output rhtml file where this element and its 
-	children will be rendered. It also will suspend outputting to any previous output file until it is done with this 
-	one (nested). MasterView will not output any rhtml files unless it encouters one of these or mv:gen_render directive 
-	below. Typically you will have one of these in the very top html element to generate the layout, and you will have 
-	additional directives further inside to output different view partials and forms. MasterView takes this one html 
-	file and generates all the other layout, forms, and partials that you would do manually. for example...
-
-	<html mv:generate="layouts/product.rhtml">
-	  <title>Hello</title>
-	  <body>
-	    <div mv:replace="@content_for_layout">
-	    	<div mv:generate="product/new.rhtml">
-	      	  <form></form>
-	    	</div>
-	    </div>
-	  </body>
-	</html>
-
-	  outputs to two files
-
-	app/views/layouts/product.rhtml
-	<html>
-	  <title>Hello</title>
-	  <body>
-	    <%= @content_for_layout %>
-	  </body>
-	</html>
-
-	app/views/product/new.rhtml
-	<div>
-	  <form></form>
-	</div>
-
-mv:import="layouts/product.rhtml"
-	When the import directive is used, it is a mirror image of the generate directive, except that this directive 
-	doesn't generate any output, it is only used for design time editing. The code inside this tag represents a point
-	in time capture of the real generated code and if it ever gets out of sync it can easily be sync'd back up by
-	visiting the MasterView admin page or using rake mv:rebuild_all
-
-mv:gen_render=":partial => 'product/form'"
-	This directive does two things it creates a partial and it outputs the appropriate code to render this 
-	partial in the parent output file before beginning output of the partial. It calculates the file name from the 
-	:partial value and appends .rhtml for example...
-
-	
-	<html mv:generate="layouts/product.rhtml">
-	  <body>
-	    <div mv:gen_render=":partial => 'product/show'">
-	      Name: <span class="static" mv:content="h @product.send(:name)">product Name dummy text</span>
-	      Description: <span class="static" mv:content="h @product.send(:description)">product description dummy text</span>
-	    </div>
-	  </body>
-        </html>
-
-	  outputs two files
-
-	app/views/layouts/product.rhtml
-	<html>
-	  <body>
-	    <%= render :partial => 'product/show' %>
-	  </body>
-	</html>
-
-	app/views/product/_show.rhtml
-	<div>
-           Name: <span class="static"><%= h @product.send(:name) %></span>
-	   Description: <span class="static"><%= h @product.send(:description) %></span>
-	</div>
-
-	You can also use collections with your partials like
-
-	<div mv:gen_render=":partial => 'shared/product', :collection => @products">
-
-	which will create the partial shared/_product.rhtml and will render this partial over a collection
-
-mv:import_render="partial => 'product/form'"
-	Similar to how import directive is a mirror to generate, import_render is a mirror to gen_render. This directive
-	generates the appropriate render partial helper, but doesn't generate any additional output, it is only used for 
-	design time editing and can be easily sync'd up if it ever gets out of sync with the original code.
-
-mv:gen_replace="whatToLeave"
-	When used in conjunction with mv:generate directive it causes the value of the attribute to be erb 
-	executed output in the parent file before transferring to the child (nested) output file. for example...
-
-	<html mv:generate="layouts/product.rhtml">
-	  <title>Hello</title>
-	  <body>
-	    <div mv:generate="product/new.rhtml" mv:gen_replace="@content_for_layout>
-	      <form></form>
-	    </div>
-	  </body>
-	</html>
-	
-	  outputs two files
-
-	app/views/layouts/product.rhtml
-	<html>
-	  <title>Hello</title>
-	  <body>
-	    <%= @content_for_layout %>
-	  </body>
-	</html>
-
-	app/views/product/new.rhtml
-	<div>
-	  <form></form>
-	</div>
-
-mv:attr=":foo => 'bar', :cat => #{h product.name}"
-	At runtime this sets attribute values on the element this directive is defined on, for example...
-
-	<div mv:attr=":foo => 'bar', :hi => 'cat'">hello</div>
-
-	  becomes
-
-	<div foo="bar" hi="cat">hello</div>
-
-	You can put erb evaluated code in #{ } like in this example
-
-	<div mv:attr=":foo => #{h product.name}, :hi => 'cat'">hello</div>
-
-	  becomes
-
-	<div foo="<%= h product.name %>" hi="cat">hello</div>
-
-mv:block="rubyBlockCodeHere"
-	At runtime this expands to the equivalent rhtml (erb) block code around this element, for example...
-	
-	<div mv:block="products.each do |product|">foobar</div> 
-	  
-	  becomes
-	  
-	<% products.each do |product| %>
-	  <div>foobar</div>
-        <% end %>
-
-	Note how MasterView automatically put in the 'end' after the closing tag.
-	Another example using the brace form of a block
-
-	<div mv:block="products.each { |product|">foobar</div> 
-	
-	  becomes
-	  
-	<% products.each { |product| %>
-	  <div>foobar</div>
-        <% } %>
-
-	Its all based on the ruby and rails syntax while keeping things xhtml and designer friendly.
-	
-mv:content="foo"
-	Replaces the content of the tag with the erb output of foo, for example...
-
-	<div mv:content="foo">some dummy html here</div>
-
-	  becomes
-	
-	<div><%= foo %></div>
-
-mv:form=":action => 'new'"
-	Replaces this tag and closing tag with the form_tag and end_form_tag helpers. It also pulls the 
-	method and multipart attributes from the element and merges that into the form_tag options, for example...
-
-	<form mv:form=":action => 'new'">foobar</form>
-	
-	  becomes
-	
-	<% form_tag :action => 'new' %>
-	  foobar
-	<% end_form_tag %>
-
-	<form method="GET" mv:form=":action => 'new'">foobar</form>
-	
-	  becomes
-	
-	<% form_tag { :action => 'new' }, :method => 'GET' %>
-	  foobar
-	<% end_form_tag %>
-	
-mv:hidden_field="object, method"
-	Replaces this tag with an hidden input tag using the rails hidden_tag helper, for example...
-
-	<input mv:hidden_field="product, desc" type="hidden" value="dummy text"/>
-
-	  becomes
-
-	<%= hidden_field product, desc %>
-
-mv:if="yourIfConditionHere"
-	Wraps the tag with an if block using the attribute contents for the condition, for example...
-
-	<div mv:if="@flash[:notice]">foo</div>
-
-	  becomes
-	
-	<% if @flash[:notice] %>
-	  <div>foo</div>
-	<% end %>
-
-	And combining if and content directives we can do the following
-      		
-	<div mv:if="@flash[:notice]" mv:content="@flash[:notice]" class="messages">
-	  dummy notice message here 
-	</div>
-
-	  becomes
-
-	<% if @flash[:notice] %>
-	  <div>
-	    <%= @flash[:notice] %>
-	  </div>
-	<% end %>
-	
-mv:elsif="yourElseConditionHere"
-	Used in conjunction with an if directive allows you to create if, elsif blocks, for example...
-
-	<div mv:if="foo()">
-	  hello
-	</div>
-	<div mv:elsif="bar()">
-	  world
-	</div>
-
-	  becomes
-
-	<% if foo() %>
-	  <div>
-	    hello
-	  </div>
-	<% elsif bar() %>
-	  <div>
-	    world
-	  </div>
- 	<% end %>
-
-	Note that the elsif directive element needs to follow the if element's closing tag
-
-mv:else=""
-	Used in conjunction with if and elsif, allows you to create if, elseif, else blocks, for example...
-
-	<div mv:if="@foo">
-	  hello
-  	</div>
-	<div mv:else="">
-	  world
-	</div>
-
-	  becomes
-
-	<% if @foo %>
-	  <div>
-	    hello
-	  </div>
-	<% else %>
-	  <div>
-	    world
-	  </div>
-	<% end %>
-
-mv:javascript_include="prototype.js"
-	Replaces the tag with a javascript_include_tag helper, for example...
-	
-	<script type="text/javascript" src="../../../public/javascripts/prototype.js" 
-           mv:javascript_include="prototype.js"></script>
-
-	  becomes
-
-	<%= javascript_include_tag 'prototype.js' %>
-
-	This is useful to allow scripts to be used for demos/prototypes and then at runtime 
-        use the appropriate asset using the rails helper.
-
-mv:link_to="linkToOptions"
-	Replaces the tag with a link_to helper, it uses the contents of the tag for the name of the link, 
-	so the name of the link can be changed by the html designer and it gets used in the appropriate place 
-	in the helper, for example...
-
-	<a mv:link_to=":action => 'new'">New product</a>
-	
-	  becomes
-
-	<%= link_to 'New product', :action => 'new' %>
-
-mv:link_to_if="linkToIfConditionAndOption"
-	Replaces the tag with a link_to_if helper, uses the contents of the tag for the name of the 
-	link so the name of the link can be changed by the html designer and it gets used in the appropriate 
-	place in the helper, for example...
-
-	<a mv:link_to_if="@product_pages.current.previous, { :page => @product_pages.current.previous }"Previous page"</a>
-
-	  becomes
-
-	<%= link_to_if @product_pages.current.previous, 'Previous page', {:page => @product_pages.current.previous } %>
-
-mv:link_to_remote="linkToRemoteOptions"
-	Replaces the tag with a link_to_remote helper, uses the contents of the tag for the name of the 
-	link so the name of the link can be changed by the html designer and it gets used in the appropriate 
-	place in the helper, for example...
-
-	<a mv:link_to_remote=":action => 'new'">New product</a>
-	
-	  becomes
-
-	<%= link_to_remote 'New product', :action => 'new' %>
-
-mv:omit_tag="evalString"
-	Omit the element tag if the evalString is empty or evaluates to true. For example...
-
-	<span mv:omit_tag="">hello</span>
-
-	  becomes
-
-	hello
-
-	<span mv:omit_tag="@test">hello</span>
-
-	  becomes
-
-	<% if @test %><span><% end %>hello<% if @test %></span><% end %>
-
-
-mv:password_field="user, password"
-	Replaces the tag with a password_field helper using the attribute as well as merging any html 
-	attributes that have been set by the designer, for example...
-
-	<input type="password" mv:password_field="user, password"/>
-
-	  becomes
-
-	<%= password_field user, password %>
-
-	and similarly
-
-	<input type="password" mv:password_field="user, password" size="10" maxlength="15" class="pwdStyle"/>
-	
-	  becomes
-
-	<%= password_field, user, password, :class => 'pwdStyle', :maxlength = 15, :size => 10 %>
-
-mv:replace="foo bar"
-	Replaces the tag and contents with the erb executed output of the attribute. If the attribute 
-	value is an empty string then the tag is simply removed and nothing is output,  for example...
-
-	<span mv:replace="h product.name">dummy product name</span>
-
-	  becomes
-
-	<%= h product.name %>
-
-	and similarly, you can use this to remove dummy html which was there for prototyping/demoing
-
-	<table>
-	  other rows here
-	<tr mv:replace="">
-	  <td>foo</td>
-	  <td>bar</td>
-	</tr>
-	</table>
-
-	  becomes
-
-	<table>
-	  other rows here
-	</table>
-
-	Passing in an empty attribute simply eliminated the tag, children, and contents
-
-mv:stylesheet_link="style"
-	Replaces the tag with a stylesheet_link_tag helper, for example...
-	
-      <link rel="stylesheet" type="text/css" href="../../../public/stylesheets/scaffold.css" mv:stylesheet_link="scaffold"/>
-
-	becomes
-
-      <%= stylesheet_link_tag "scaffold" %>
-
-      This is useful to allow style to be used for demos/prototypes and then at runtime 
-      use the appropriate asset using the rails helper.
-
-mv:submit="submitOptions"
-	Replaces the tag with a submit_tag helper, it uses the html value attribute to set the text 
-	in the helper, and appends any options after, for example...
-
-	<input type="submit" mv:submit="" value="Save product"/>
-
-	  becomes
-
-	<%= submit_tag 'Save product' %>
-
-	and 
-
-	<input type="submit" mv:submit=":foo => 'bar'" value="Save product"/>
-
-	  becomes
-
-	<%= submit_tag 'Save product', :foo => 'bar' %>
-
-
-mv:text_area="object, method"
-	Replaces the tag with a text_area helper, it uses the html attributes like rows, cols, disabled, 
-	readonly, class, style, tabindex, accesskey and merges them with the object and method specified 
-	in the attribute value, for example...
-
-	<textarea mv:text_areas="product, desc">dummy text</textarea>
-
-	  becomes
-
-	<%= text_area prouct, desc %>
-
-	or a more complex example
-
-	<textarea mv:text_area="product, desc" rows="4" cols="60", class="mystyle">dummy text</textarea>
-
-	  becomes
-
-	<%= textarea product, desc, :class => 'mystyle', :cols => '60', :rows => 4 %>
-
-mv:text_field="object, method"
-	Replaces the tag with a text_field helper, it uses the html attributes like size, maxlength, 
-	disabled, readonly, class, style, tabindex, accesskey and merges them with the object and 
-	method specified in the attribute value, for example...
-	
-	<input type="text" mv:text_field="product, name" value="dummy text"/>
-
-	  becomes
-
-	<%= text_field product, name %>
-
-	and 
-
-	<input type="text" mv:text_field="product, name" value="dummy text" class="mystyle" size="15" maxlength="20"/>
-
-	  becomes
-
-	<%= text_field product, name, :class => 'mystyle', :maxlength => 20, :size => 15 %>
-
-	
-
-Inline substitutions
-	Since <%= foobar %> and <% foo %> are invalid xhtml values, MasterView has an inline substitution to 
-	replace these for the cases when you simply want to inject something. {{{ gets replaced with <% 
-	and {{{= gets replaced with <%= also }}} gets replaced with %> If you instead want to use the 
-	old <% syntax instead, MasterView by default is setup to perform a substitution on those values before 
-	parsing. However to be safe you should use the xhtml safe syntax otherwise html editors might end 
-	up changing things on you.
-
-	{{{= foobar }}}
-
-	  becomes
-
-	<%= foobar %>
-
-
-	and
-
-	{{{ foo }}}
-	
-	  becomes
-
-	<% foo %>
+The MasterView User's Guide and a complete Directives Reference are provided
+in the MasterView user documentation.  MasterView templates can be
+created by hand simply by adding masterview directives markup to
+an (x)html template, or generated for typical Rails controller/view
+scenarios using the supplied masterview generator developer tool.
 
+A MasterView Admin controller can optionally be activated in your application
+to assist you during development with creating and managing your templates.
 
 == Background story
 
@@ -586,8 +111,10 @@ structures to pass to the templates) as so many of the other engines relied on.
 I expanded my search outside of Ruby for the best html template technology I could find. 
 After reviewing all the front runners I still didn't find anything that quite met with my 
 goals for developing with ruby and rails. I also didn't find any technology that was 
-close enough that I could adapt it. However I did come across features in a variety of
-systems that inspired me, and helped me shape the ideas that are presented here.
+close enough that I could adapt it. However I did come across features in a variety of 
+systems that inspired me, and helped me shape the ideas that are presented here. 
+A few of those systems were Tapestry, Zope/PHP TAL, Kwartz, Amrita 2, Liquid, 
+and Web Objects. 
 
 After putting much thought into all the possible options I could not see extending 
 an existing template engine to meet my needs. And since I wanted this engine to have
@@ -614,6 +141,12 @@ thank God for bringing the right people into my life just when I needed them and
 bringing me on this wonderful journey, I am so very blessed. May I be able to give 
 back some of what has been given to me.
 
+And one more mention of tremendous thanks to Deb Lewis, the other core developer on the
+team, she has spent countless hours reviewing, revising, and improving the codebase, 
+configuration, and documentation. The project wouldn't be half of what it is today 
+without all her help, inspiration, and hard work. I thoroughly enjoy working and 
+debating the finer points of the project with her each step of the way.
+
 So that's the story, I hope that many of you will find MasterView to be a useful
 tool for your development. I am continuing to refine MasterView by using it daily for
 Genesis Ministry sites and all my web projects. I know that there is much more work needed 
@@ -622,4 +155,3 @@ appreciate any feedback and ideas that you have. Thanks for taking the time to
 review MasterView!
 
 Jeff Barczewski (jeff.barczewski  @   gmail.com)
-

data/RELEASE_NOTES

@@ -1,15 +1,105 @@
 = MasterView - Rails-optimized (x)html friendly template engine 
 
-== Recent changes
-
-MasterView now by default generates five masterview template files instead of one, though you can specify the --single-file option to only generate one file. Using one masterview template file gives the most DRY implementation but since all the views are in one file, it can become a point of contention and is a little more difficult for designers to work with. This Version 0.1.0 upgrade fixes that by generating one masterview template for each action (list, new, edit, show, destroy). The layout and message partials are defined in the list template and are imported into the other files so that you can have a complete page rendering when working with style and design of page. Similarly new defines the form partial which is imported into edit, and show defines a _show partial which is imported into destroy.
-
-One can edit the layout or other partials in the file they are defined in, so for instance to edit the layout, edit the list template and once finished, you can trigger the other templates to be rebuilt with the current information. MasterView now contains an MasterView admin controller/view to visually see all the status and details about the templates. You can rebuild any out of sync templates from this page. Alternatively you can view and rebuild templates from the command line as well using the built in rake commands (mv:list, mv:list_all, mv:rebuild TEMPLATE=foo.html, mv:rebuild_all).
-
-To make it easy to add additional actions which also import the layout, MasterView now has a way to generate a starter template file for your action by simply choosing from which other template file you want to import the layout from. For instance say you want to add an action called hello to your Product controller. Find the masterview template you want to get the layout imported from which could be (product_list.html, product_new.html, product_edit.html, ...), you can choose any of the templates that have the layout you want (it doesn't matter whether they defined the layout or simply imported it. To generate the starter template go to the MasterView Admin page http://yourserver/masterview and click copy link next to the appropriate template. On the next screen indicate the name of the action you wish to add (in this case 'hello') and click the submit button. MasterView generates a starter template file product_hello.html which imports the layout from the template file you chose and it creates some placeholder divs in the template that you can edit to add your hello view code. Alternatively there is also a rake mv:copy_layout TEMPLATE=product_list.html ACTION=hello command to allow you to do the same thing via command line.
-
-Note that you don't have to use the starter or generated files to use MasterView (you can just add MasterView attribute directives manually), but I found that once you had things started and wanted to reuse that same information, that having an automated way to get the layout imported makes it much easier and quicker to get things going. You can also change the default action div that is generated by simply creating your own file in app/views/masterview/admin/empty.rhtml which if found the copy_layout will use it, otherwise it uses the one from the gem/plugin.
- 
+== Recent changes (Release 0.2.0)
+
+Release 0.2.0 features a number of significant improvements.
+
+MasterView templates can now be compiled directly into the Rails
+view cache, just like .rhtml files in your app/views directory.
+Output generation of .rhtml files from a MasterView template
+is now optional.
+
+A keyword substitution mechanism is now supported for the
+mv:generate and mv:import group of template processing directives
+to enable you to more easily specify standard output file names
+derived from the template filename and relative path.
+Template markup of the form:
+
+  mv:generate="{template_path}"
+
+avoids having to replicate the name of the template file itself
+or its relative path within the masterview templates directory.
+See the MasterView User's Guide and Directives Reference for details.
+
+A new configuration facility has been added to allow you to
+customize the MasterView configuration using settings
+files in your rails app config directory, following the
+same approach as the Rails framework itself.
+See the new Configuration Guide documentation for details.
+
+Configuration settings for controlling logging level have been added.
+The MasterView admin controller is now disabled by default.
+Use the config.enable_admin_pages setting to enable
+(usually want only in your config/masterview/environments/development.rb).
+
+The documentation has been reworked and enhanced to provide
+improved documentation on installation and usage, along with
+a new Configuration Guide describing how to customize the
+MasterView configuration.
+
+UPGRADE NOTES: If you have customized your MasterView configuration
+in the init.rb file of your existing plugin installation, you *MUST* 
+migrate your configuration to the new settings file configuration mechanism
+(config/masterview/settings.rb and environment settings files).
+
+Also note that a directive was renamed from gen_render to gen_partial to 
+more clearly represent the functionality and eliminate future confusion.
+Be sure to change any references to gen_render to gen_partial.
+
+The default location for MasterView templates is now the standard Rails 
+app/views directory.  Either move your existing templates into app/views 
+or update the MasterView config.template_src_dir_path setting in your
+config/masterview/settings.rb to reference your existing templates source 
+directory.
+
+== Recent changes (Release 0.1.0)
+
+MasterView now by default generates five masterview template files instead 
+of one, though you can specify the --single-file option to only generate 
+one file. Using one masterview template file gives the most DRY implementation 
+but since all the views are in one file, it can become a point of contention 
+and is a little more difficult for designers to work with. 
+This Version 0.1.0 upgrade fixes that by generating one masterview template 
+for each action (list, new, edit, show, destroy). The layout and message 
+partials are defined in the list template and are imported into the other 
+files so that you can have a complete page rendering when working with style 
+and design of page. Similarly new defines the form partial which is imported 
+into edit, and show defines a _show partial which is imported into destroy.
+
+One can edit the layout or other partials in the file they are defined in, 
+so for instance to edit the layout, edit the list template and once finished, 
+you can trigger the other templates to be rebuilt with the current information. 
+MasterView now contains an MasterView admin controller/view to visually see 
+all the status and details about the templates. You can rebuild any out of sync 
+templates from this page. Alternatively you can view and rebuild templates from 
+the command line as well using the built in rake commands (mv:list, mv:list_all, 
+mv:rebuild TEMPLATE=foo.html, mv:rebuild_all).
+
+To make it easy to add additional actions which also import the layout, 
+MasterView now has a way to generate a starter template file for your action 
+by simply choosing from which other template file you want to import the layout 
+from. For instance say you want to add an action called hello to your Product 
+controller. Find the masterview template you want to get the layout imported 
+from which could be (product_list.html, product_new.html, product_edit.html, ...), 
+you can choose any of the templates that have the layout you want (it doesn't 
+matter whether they defined the layout or simply imported it. To generate the 
+starter template go to the MasterView Admin page http://yourserver/masterview 
+and click copy link next to the appropriate template. On the next screen indicate 
+the name of the action you wish to add (in this case 'hello') and click the submit 
+button. MasterView generates a starter template file product_hello.html which 
+imports the layout from the template file you chose and it creates some 
+placeholder divs in the template that you can edit to add your hello view code. 
+Alternatively there is also a 
+    rake mv:copy_layout TEMPLATE=product_list.html ACTION=hello 
+command to allow you to do the same thing via command line.
+
+Note that you don't have to use the starter or generated files to use MasterView 
+(you can just add MasterView attribute directives manually), but I found that 
+once you had things started and wanted to reuse that same information, that 
+having an automated way to get the layout imported makes it much easier and 
+quicker to get things going. You can also change the default action div that is 
+generated by simply creating your own file in app/views/masterview/admin/empty.rhtml 
+which if found the copy_layout will use it, otherwise it uses the one from the gem/plugin. 
 
 == Description
 
@@ -18,14 +108,20 @@ It is designed to use the full power and productivity of rails including
 layouts, partials, and rails html helpers while still being editable/styleable 
 in a WYSIWYG HTML editor.  
 
-MasterView is distributed as a gem or a plugin. You may install it as a gem and then generate a lightweight plugin which mainly refers to the gem *or* you can simply install as a plugin which is self contained. I personally prefer installing as a gem for ease of management, however if you are running at a shared hosting environment you might not have authority to install this gem so you may install as a self contained plugin.
+MasterView is distributed as a gem or a plugin. You may install it as a gem and 
+then generate a lightweight plugin which mainly refers to the gem *or* you can 
+simply install as a plugin which is self contained. I personally prefer installing 
+as a gem for ease of management, however if you are running at a shared hosting 
+environment you might not have authority to install this gem so you may install 
+as a self contained plugin.
 
 If you are interested in the background story behind all this, it is at the end of this page.
 
 Author:: Jeff Barczewski
 Email:: jeff.barczewski @ gmail.com
-Rubyforge project:: masterview
+Primary developers:: Jeff Barczewski, Deb Lewis
 Website:: http://masterview.org
+Rubyforge project:: masterview
 License:: MIT open source license like Rails
 
 == Goals
@@ -48,44 +144,29 @@ Optional::
 	tidy (gem) and tidy library - if these are installed you can use tidy to cleanup html into valid xhtml for use by MasterView
 	log4r (gem) - if this gem is installed then MasterView will use it for logging otherwise it defaults to using built in Logger.
 
-== Installation
-
-Install in one of the two following ways depending on whether you can use gems or not. 
-
-=== Installation using gems (if you are able to use gems)
-
-If you can use gems you may simply do the following
-
-gem install masterview_gem_pack
+== User Documentation
 
-Now your gem is installed and you can skip these steps in the future. After creating your rails directory, change directory to it and run the following to create a very lightweight plugin instance for this application mainly consisting of an init.rb file which will get loaded at runtime. This init.rb refers to the gem for everything but allows you to override any constants or setup that has been provided. See MasterView module masterview.rb for a list of the available constants.
+MasterView documentation is available online at the MasterView site:
+  http://www.masterview.org 
+and on the rubyforge project
+  http://rubyforge.org/projects/masterview/
 
-script/generate masterview_plugin
-
-After this MasterView is ready for use. Skip down to the Usage section for more details. 
-
-=== Installation without using gems, install as plugin
+== Installation
 
-script/plugin install svn://rubyforge.org/var/svn/masterview/tags/latest
+Detailed installation instructions for installing the masterview gems
+or a self-contained copy of the plugin is provided in the MasterView
+Installation Guide.
 
-This will copy entire MasterView system into your vendor/plugin/masterview directory. You may tweak its init.rb to override any MasterView constants at runtime. See MasterView module masterview.rb for a list of available constants. Note that if you don't have svn (subversion) installed, you may also retrieve the plugin package (masterview_plugin.tgz or masterview_plugin.zip) from http://rubyforge.org/projects/masterview and simply extract into vendor/plugins/masterview 
+The Configuration Guide describes how to customize the configuration
+of the MasterView template engine for your application.
 
 == Usage
 
-You may add MasterView attributes to existing (x)html or you may use the masterview generator to create a complete working application. The generator can create controllers, models, and the MasterView template file similar to how the built-in generator works. Simply change directory to your rails application and run the following
-
-script/generate masterview YourModelName [YourControllerName] [--style [cssStylesheet]] [--single-file] [--show-all | --show-only list] 
-
-The generator by default will generate five masterview template files, one for each distinct page, list, new, edit, show, and destroy. They exist in the app/views/masterview directory with the filename controller_action.html. The layout and message partial are defined in the list template file and imported into the others. Similarly the new template defines the form partial which is imported into edit, and finally the show file defines a _show partial which is imported into destroy. Thus there is one definition of each part (layout and partial) and they are imported into the other files where needed to provide accurate WYSIWYG design time editing. By generating separate files, teams can work on a project easier, however MasterView also supports generating all parts to a single file for the ultimate in DRY.
-
-By adding the --single-file switch MasterView will create a single file and to make it easier to use this template at design time, some design time css stylesheets are included in the file to hide all sections except one. By default the NEW section is the only one shown. Other options are --show-all which makes all sections visible or [--show-only list] which shows only the LIST section. When you are editing the masterview file you may comment/uncomment one of the other css files to show a different section. The --style param allows you to suppress default style generation and specify an existing stylesheet to use, if you exlude the stylesheet none will be used, if you include this option multiple times with different stylesheets each will be used.
-
-Once it is done generating, the generated MasterView template file will be created in app/views/masterview/controller.html. This file is html and can be edited with any standard html editor. The rails specific logic is contained in simple attributes which are ignored by html editors. The syntax for these attributes is heavily derived from the rails helper tags themselves so it should feel natural to the rails developer.
-
-Another interesting thing to know is that while all of the pages for this Model have been bundled up into a few html file for ease of editing, at runtime these templates gets rendered into the exact same layouts and partials that you would use if you were building from scratch. Its jsut that now you can see what your pages will render like in your wysiwyg html editor and change and layout accordingly. Additionally MasterView supplies some javascript to show only one action view at time (list, new, show, edit, destroy) so you can view in your browser without running in Rails. Dummy html can be included to improve the accuracy of the page which can be easily removed at runtime. To make it easier to work with in an editor, design time stylesheets are included in the file to allow you to hide all sections except the one you are working on, simply uncomment the appropriate stylesheet for the section you would like to work with.
-
-MasterView is designed to be easy for a developer and designer to work together. By keeping the template in an html friendly format, designers can apply style, layout changes, wording changes, without causing havoc on the rails view code. The designer can be involved at anytime during the development cycle including being able to change style and layout after the system is built. This is great for allowing design or wording changes without reinvolving the developers. One can even start from a designer created prototype and add MasterView tags to make it become real. Whichever way you prefer to work, MasterView accomodates you.
-
-With Version 0.1.0 a MasterView admin controller/view was added to provide a birds-eye view of all your masterview templates, the status of those templates (OK, Invalid xhtml, Conflicts, Imports outdated), the details regarding the status, and the ultimate erb files generated from each template. By default the MasterView admin controller is enabled by the plugin and is available at http://yourserver/masterview This controller can easily be disabled if not wanted by setting the EnableMasterViewAdminPages = false in the vendor/plugins/masterview/init.rb file. Additionally all of the power of the MasterView admin controller is available via a set of rake commands as well. rake mv:list mv:list_all mv:rebuild mv:rebuild_all mv:copy_layout. rake -T will give you further information about these commands.
+The MasterView User's Guide and a complete Directives Reference are provided
+in the MasterView user documentation.  MasterView templates can be
+created by hand simply by adding masterview directives markup to
+an (x)html template, or generated for typical Rails controller/view
+scenarios using the supplied masterview generator developer tool.
 
-Since it can be difficult to import a layout by hand into a new file, the MasterView admin controller has a link where you can copy the layout into a new file by providing the new files Action. It will take the layout from the template chosen and create a new file controller_action.html with the layout imported and a shell for the new Action code. You can also do this from command line using rake mv:copy_layout TEMPLATE=foo_list.html ACTION=newaction command.
+A MasterView Admin controller can optionally be activated in your application
+to assist you during development with creating and managing your templates.

data/Rakefile

@@ -10,8 +10,6 @@ require 'rake/contrib/rubyforgepublisher'
 require 'rake/contrib/xforge'
 require 'rake/clean'
 
-require 'gmailer'
-
 #require 'archive/tar/minitar'
 #require 'zlib'
 
@@ -25,37 +23,107 @@ RUBY_FORGE_GROUPID = "1290"
 
 Main_dir  = Dir.getwd
 
-desc "Default Task"
+desc "Default Task: run all tests"
 task :default => [ :test ]
 
-desc "Delete tar.gz / zip / rdoc"
-task :cleanup => [ :rm_packages, :clobber_rdoc ]
+task :install => [:package] do
+  `gem install pkg/#{PKG_FILE_NAME}.gem`
+end
+
+desc "Delete tar.gz / zip / gem / rdoc / tmp"
+task :cleanup => [ :rm_packages, 'doc:clobber_rdoc', 'dev:cleanup', 'test:cleanup' ]
+
+
+#==============================================================================
+# Test tasks
+#==============================================================================
+
+desc 'Run all tests'
+task :test do
+  Rake::Task["test:units"].invoke       rescue got_error = true
+  #Rake::Task["test:functionals"].invoke rescue got_error = true
+  #??Rake::Task["test:cleanup"].invoke       rescue got_error = true
+  raise "Test failures" if got_error
+end
 
-# Run the unit tests
-Rake::TestTask.new(:test) do |t|
+# Run all unit tests
+namespace 'test' do
+Rake::TestTask.new(:units) do |t|
   t.libs << "lib"
   t.libs << "test"
-  t.pattern = 'test/*_test.rb'
+  t.pattern = 'test/unit/*_test.rb'
   t.verbose = false
 end
+end
 
-# Run parser on masterview html files
-desc "Run parser on masterview html files"
-task :mvparse do
-  TmpOutputDir = 'tmp/views'
-  filelist = Dir.glob('examples/**/*.html')
-  filelist.each do |file|
-    MasterView::Parser.parse_file( file, TmpOutputDir, :tidy => true )
-  end
+desc 'Clean up tmp files from running tests'
+namespace 'test' do
+task :cleanup do
+  FileUtils.remove_dir('test/tmp', true)
+end
 end
 
 
-task :install => [:package] do
-  `gem install pkg/#{PKG_FILE_NAME}.gem`
+#==============================================================================
+# Documentation Tasks
+#==============================================================================
+
+# Generate the RDoc documentation
+namespace 'doc' do
+Rake::RDocTask.new { |rdoc|
+  rdoc.rdoc_dir = 'doc/api'
+  rdoc.title    = "MasterView Template Engine"
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('RELEASE_NOTES')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+}
+end
+
+#==============================================================================
+# Development Utilities Tasks
+#==============================================================================
+
+desc 'Install MasterView gems locally from pkg dir'
+namespace 'dev' do
+task :install_local_gems do
+  pkg_build = ENV['PKG_BUILD'] ? '.' + ENV['PKG_BUILD'] : ''
+  pkg_version = MasterView::VERSION::STRING + pkg_build
+  `gem install pkg/masterview-#{pkg_version}.gem --local -f`
+  `gem install pkg/masterview_generator-#{pkg_version}.gem --local -f`
+  `gem install pkg/masterview_plugin_generator-#{pkg_version}.gem --local -f`
+  `gem install pkg/masterview_gem_pack-#{pkg_version}.gem --local -f`
+end
+end
+
+desc 'Uninstall all MasterView gems'
+namespace 'dev' do
+task :uninstall_gems do
+  `gem uninstall masterview -a -x -i`
+end
 end
 
-task :syntax do 
-  filelist = Dir.glob('**/*.rb')
+
+desc 'Run parser on masterview html templates in examples'
+namespace 'dev' do
+task :mvparse_examples do
+  template_mio_tree = MasterView::FileMIOTree.new('examples', '.html', :logging => true )
+  output_mio_tree = MasterView::FileMIOTree.new('tmp/views', '.rhtml', :logging => true )
+  template_mio_tree.find(:pattern => '*.html') do |mio|
+    MasterView::Parser.parse_mio( mio, output_mio_tree )
+  end
+end
+end
+
+# Run syntax check on all ruby code files
+desc 'Run syntax check on all ruby code files'
+namespace 'dev' do
+task :check_syntax do 
+  #WAS: filelist = Dir.glob('**/*.rb')
+  #skip: generators - erb-ized code templates confuse the parser
+  filelist = [ 'init.rb', 'lib/masterview.rb' ]
+  filelist.concat Dir.glob('lib/**/*.rb')
+  filelist.concat Dir.glob('test/**/*.rb')
   filelist.each do |file|
     output = `ruby -c #{file}`
     unless output =~ /Syntax OK/
@@ -64,26 +132,29 @@ task :syntax do
       return 
     end
   end
+  puts "#{filelist.length} files checked"
   puts 'Syntax OK'  
 end
+end
 
-# Genereate the RDoc documentation
-Rake::RDocTask.new { |rdoc|
-  rdoc.rdoc_dir = 'doc'
-  rdoc.title    = "MasterView Template Engine"
-  rdoc.options << '--line-numbers' << '--inline-source'
-  rdoc.rdoc_files.include('README')
-  rdoc.rdoc_files.include('RELEASE_NOTES')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-}
-
-task :lines do
+# Count LOC in plugin lib
+desc 'Count LOC'
+namespace 'dev' do
+task :count_loc do
+  files = 0
   lines = 0
   codelines = 0
-  Dir.foreach("lib") { |file_name| 
-    next unless file_name =~ /.*rb/
+  
+  #VER1 WAS: Dir.foreach("lib") { |file_name| 
+  #VER1 WAS:   next unless file_name =~ /.*rb/
+  #VER1 WAS:   f = File.open("lib/" + file_name)
+  filelist = [ 'init.rb', 'lib/masterview.rb' ]
+  filelist.concat Dir.glob('lib/**/*.rb')
+  #filelist.concat Dir.glob('test**/*.rb')
+  filelist.each { |file_name|
     
-    f = File.open("lib/" + file_name)
+    f = File.open(file_name)
+    files += 1
 
     while line = f.gets
       lines += 1
@@ -92,10 +163,22 @@ task :lines do
       codelines += 1
     end
   }
-  puts "Lines #{lines}, LOC #{codelines}"
+  puts "Lines #{lines}, LOC #{codelines} in #{files} files"
+end
+end
+
+desc 'Remove tmp files from running dev utilities'
+namespace 'dev' do
+task :cleanup do
+  FileUtils.remove_dir('tmp', true)
+end
 end
 
 
+#==============================================================================
+# Build/Release Tasks
+#==============================================================================
+
 # Publish beta gem  
 #desc "Publish the gem"
 #task :publish => [:rdoc, :package] do
@@ -119,27 +202,92 @@ task :verify_gmail do
   raise "GMAIL_PASSWORD environment variable not set!" unless ENV['GMAIL_PASSWORD']
 end
 
+def copy_if_different(src,dst)
+  return if File.exist?(src) and File.exist?(dst) and File.read(src) == File.read(dst)
+  FileUtils.cp src, dst
+end
+
+desc 'Copy duplicated files - copy files that are duplicated between packages'
+task :copy_duplicated_files do
+  copy_if_different 'init.rb', 'generators/masterview_plugin/templates/init.rb'
+  copy_if_different 'tasks/masterview.rake', 'generators/masterview_plugin/templates/masterview.rake'
+  copy_if_different 'lib/masterview/extras/app/views/masterview/admin/empty.rhtml', 'generators/masterview_plugin/templates/empty.rhtml'
+  copy_if_different 'examples/rails_app_config/masterview/settings.rb', 'generators/masterview_plugin/templates/settings.rb'
+  copy_if_different 'examples/rails_app_config/masterview/environment/development.rb', 'generators/masterview_plugin/templates/development.rb'
+  copy_if_different 'examples/rails_app_config/masterview/environment/production.rb', 'generators/masterview_plugin/templates/production.rb'
+end
 
 desc 'Build all packages'
-task :package => ['masterview_plugin:package', 
-                      'masterview:package', 
-                      'masterview_generator:package',
-                      'masterview_plugin_generator:package',
-                      'masterview_gem_pack:package']
+task :package => [
+        :copy_duplicated_files,
+        # gems (runtime, mv generator, mv plugin generator, 3-in-1 supersaver)
+        'masterview:package', 
+        'masterview_generator:package',
+        'masterview_plugin_generator:package',
+        'masterview_gem_pack:package',
+        # zip/gzip of full masterview
+        'masterview_plugin:package'
+        ]
 
 desc 'Re-build all packages'
-task :repackage => ['masterview_plugin:repackage', 
-                        'masterview:repackage', 
-                        'masterview_generator:repackage',
-                        'masterview_plugin_generator:repackage',
-                        'masterview_gem_pack:repackage']
+task :repackage => [
+        :copy_duplicated_files,
+        # gems (runtime, mv generator, mv plugin generator, 3-in-1 supersaver)
+        'masterview:repackage', 
+        'masterview_generator:repackage',
+        'masterview_plugin_generator:repackage',
+        'masterview_gem_pack:repackage',
+        # zip/gzip of full masterview
+        'masterview_plugin:repackage'
+        ]
 
 desc 'Release all files'
-task :release_files => ['masterview_plugin:release_files',
-                            'masterview:release_files',
-                            'masterview_generator:release_files',
-                            'masterview_plugin_generator:release_files',
-                            'masterview_gem_pack:release_files']
+task :release_files => [
+        # gems (runtime, mv generator, mv plugin generator, 3-in-1 supersaver)
+        'masterview:release_files',
+        'masterview_generator:release_files',
+        'masterview_plugin_generator:release_files',
+        'masterview_gem_pack:release_files',
+        # zip/gzip of full masterview
+        'masterview_plugin:release_files'
+        ]
+
+desc 'Remove all tar.gz / zip / gem build pkg files'
+task :rm_packages do
+  FileUtils.remove_dir('pkg', true)
+end
+
+####
+#ISSUE: jeff - we don't include that top-level index.html in any of the packages?!
+####
+PKG_FILES_RELEASE_DOCS = [
+      "[A-Z]*"   # README, RELEASE_NOTES, CHANGELOG, MIT_LICENSE, TODO
+      ]
+
+PKG_FILES_RUNTIME = [
+      "lib/**/*",
+      "directives/**/*",  #SHOULD THIS GO AWAY (??)
+      "Rakefile", 
+      "init.rb"
+    ]
+PKG_FILES_MV_GENERATOR = [
+      "generators/masterview/**/*"   # generator for creating app template scaffold
+      ]
+PKG_FILES_MV_PLUGIN_GENERATOR = [
+      "generators/masterview_plugin/**/*"  # generator for creating vendor/plugins stub for gem install
+      ]
+
+PKG_FILES_DOCS = [  # docs and examples, actually
+      "doc/*",
+      "doc/stylesheets/*",
+      "examples/**/*"
+    ]
+PKG_FILES_TESTS = [
+      "test/**/*"
+    ]
+PKG_FILES_EXCLUDE_PATTERN = /\bCVS\b|~$|\.svn|semantic.cache/
+
+RAKE_PROCESSOR = RUBY_PLATFORM =~ /mswin32/ ? 'rake.cmd' : 'rake'  # sigh
 
 namespace 'masterview_plugin' do
   module MasterViewComplete
@@ -149,16 +297,8 @@ namespace 'masterview_plugin' do
     PKG_FILE_NAME   = "#{PKG_NAME}-#{PKG_VERSION}"
     PKG_DESTINATION = ENV["RAILS_PKG_DESTINATION"] || "../#{PKG_NAME}"
     RELEASE_NAME  = "REL #{PKG_VERSION}"
-    PKG_FILES = FileList[
-      "lib/**/*",
-      "generators/masterview/**/*", #exclude the masterview_plugin generator, not needed for non-gem install
-      "directives/**/*",
-      "test/**/*", 
-      "example/**/*",
-      "[A-Z]*", 
-      "Rakefile", 
-      "init.rb"
-    ].exclude(/\bCVS\b|~$|\.svn|semantic.cache/)
+    PKG_INCLUDES = PKG_FILES_RUNTIME + PKG_FILES_MV_GENERATOR + PKG_FILES_DOCS + PKG_FILES_TESTS + PKG_FILES_RELEASE_DOCS
+    PKG_FILES = FileList.new( PKG_INCLUDES ).exclude( PKG_FILES_EXCLUDE_PATTERN )
 
     spec = Gem::Specification.new do |s|
       s.name = PKG_NAME
@@ -226,9 +366,8 @@ namespace 'masterview_gem_pack' do
     PKG_FILE_NAME   = "#{PKG_NAME}-#{PKG_VERSION}"
     PKG_DESTINATION = ENV["RAILS_PKG_DESTINATION"] || "../#{PKG_NAME}"
     RELEASE_NAME  = "REL #{PKG_VERSION}"
-    PKG_FILES = FileList[
-      "[A-Z]*", 
-    ].exclude(/\bCVS\b|~$|\.svn|semantic.cache/)
+    PKG_INCLUDES = PKG_FILES_RELEASE_DOCS
+    PKG_FILES = FileList.new( PKG_INCLUDES ).exclude( PKG_FILES_EXCLUDE_PATTERN )
 
     spec = Gem::Specification.new do |s|
       s.name = PKG_NAME
@@ -299,15 +438,8 @@ namespace 'masterview' do
     PKG_FILE_NAME   = "#{PKG_NAME}-#{PKG_VERSION}"
     PKG_DESTINATION = ENV["RAILS_PKG_DESTINATION"] || "../#{PKG_NAME}"
     RELEASE_NAME  = "REL #{PKG_VERSION}"
-    PKG_FILES = FileList[
-      "lib/**/*",
-      "directives/**/*",
-      "test/**/*", 
-      "example/**/*",
-      "[A-Z]*", 
-      "Rakefile", 
-      "init.rb"
-    ].exclude(/\bCVS\b|~$|\.svn|semantic.cache/)
+    PKG_INCLUDES = PKG_FILES_RUNTIME + PKG_FILES_DOCS + PKG_FILES_TESTS + PKG_FILES_RELEASE_DOCS
+    PKG_FILES = FileList.new( PKG_INCLUDES ).exclude( PKG_FILES_EXCLUDE_PATTERN )
 
     spec = Gem::Specification.new do |s|
       s.name = PKG_NAME
@@ -378,12 +510,14 @@ namespace 'masterview_generator' do
     PKG_FILE_NAME   = "#{PKG_NAME}-#{PKG_VERSION}"
     PKG_DESTINATION = ENV["RAILS_PKG_DESTINATION"] || "../#{PKG_NAME}"
     RELEASE_NAME  = "REL #{PKG_VERSION}"
-
+    #PKG_INCLUDES = PKG_FILES_MV_GENERATOR
+    #PKG_FILES = FileList.new( PKG_INCLUDES ).exclude( PKG_FILES_EXCLUDE_PATTERN )
+    
     desc "Package masterview_generator"
     task :package do
       work_dir = Dir.getwd
       Dir.chdir 'generators/masterview'
-      system( "rake package" )
+      system( "#{RAKE_PROCESSOR} package" )
       Dir.chdir work_dir
     end
 
@@ -391,7 +525,7 @@ namespace 'masterview_generator' do
     task :repackage do
       work_dir = Dir.getwd
       Dir.chdir 'generators/masterview'
-      system( "rake repackage" )
+      system( "#{RAKE_PROCESSOR} repackage" )
       Dir.chdir work_dir
     end
 
@@ -442,16 +576,14 @@ namespace 'masterview_plugin_generator' do
     PKG_FILE_NAME   = "#{PKG_NAME}-#{PKG_VERSION}"
     PKG_DESTINATION = ENV["RAILS_PKG_DESTINATION"] || "../#{PKG_NAME}"
     RELEASE_NAME  = "REL #{PKG_VERSION}"
-    PKG_FILES = FileList[
-      "generators/masterview_plugin/**/*",
-      "[A-Z]*" 
-    ].exclude(/\bCVS\b|~$|\.svn|semantic.cache/)
+    PKG_INCLUDES = PKG_FILES_MV_PLUGIN_GENERATOR + PKG_FILES_RELEASE_DOCS
+    PKG_FILES = FileList.new( PKG_INCLUDES ).exclude( PKG_FILES_EXCLUDE_PATTERN )
 
     desc "Package masterview_generator"
     task :package do
       work_dir = Dir.getwd
       Dir.chdir 'generators/masterview_plugin'
-      system( "rake package" )
+      system( "#{RAKE_PROCESSOR} package" )
       Dir.chdir work_dir
     end
 
@@ -459,7 +591,7 @@ namespace 'masterview_plugin_generator' do
     task :repackage do
       work_dir = Dir.getwd
       Dir.chdir 'generators/masterview_plugin'
-      system( "rake repackage" )
+      system( "#{RAKE_PROCESSOR} repackage" )
       Dir.chdir work_dir
     end
 
@@ -502,8 +634,6 @@ namespace 'masterview_plugin_generator' do
 end
 
 
-
-
 desc "Publish news on RubyForge"
 task :publish_news => [ :verify_rubyforge, :tar, :gem, :demotar] do
   Rake::XForge::NewsPublisher.new(Ruby_PDF) do |news|
@@ -527,12 +657,11 @@ end
 desc "Post a release announcement via GMail."
 #task :email_announcement => [ :verify_gmail, :tar, :gem, :demotar] do
 task :email_announcement => [ :verify_gmail ] do
+  require 'gmailer'
   GMailer.connect(ENV["GMAIL_USER"], ENV["GMAIL_PASSWORD"]) do |gmail|
     gmail.send  :to       => "ruby-talk@ruby-lang.org",
                 :subject  => "[ANN] PDF::Writer #{PDF::Writer::VERSION}",
                 :body     => File.read("Release-Announcement")
   end
-end
-
-
 
+end

data/TODO

@@ -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

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.8.11
 specification_version: 1
 name: masterview_gem_pack
 version: !ruby/object:Gem::Version 
-  version: 0.1.5
-date: 2006-05-31 00:00:00 -05:00
+  version: 0.2.0
+date: 2006-06-21 00:00:00 -05:00
 summary: A (x)html friendly template engine for rails with the power of layouts, and partials. This gem package includes the other masterview gems for easy installation
 require_paths: 
 - .
@@ -29,11 +29,11 @@ authors:
 - Jeff Barczewski
 files: 
 - CHANGELOG
-- MIT-LICENSE
 - Rakefile
 - TODO
 - RELEASE_NOTES
 - README
+- MIT-LICENSE
 test_files: []
 
 rdoc_options: []
@@ -54,7 +54,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 0.1.5
+        version: 0.2.0
     version: 
 - !ruby/object:Gem::Dependency 
   name: masterview_generator
@@ -63,7 +63,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 0.1.5
+        version: 0.2.0
     version: 
 - !ruby/object:Gem::Dependency 
   name: masterview_plugin_generator
@@ -72,5 +72,5 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 0.1.5
+        version: 0.2.0
     version: