w2tags 0.9.3

data/README.rdoc

@@ -0,0 +1,264 @@
+= W2TAGS
+=== Run on MRI Ruby : 1.8.x / 1.9.x
+
+  C:\>w2tags -irb
+  ARGV  : -irb
+
+  Your W2Tags instance object stored in WH...
+  Ex: puts WH.parse_line("#content\n  %span Hello")
+  Shortcut command => wh("#content\n  %span Hello")
+
+  irb(main):001:0> wh(<<END)
+  irb(main):002:0" #wow
+  irb(main):003:0"  #kereen
+  irb(main):004:0"   %span Hello World
+  irb(main):005:0" END
+  =>C:/mingw/lib/ruby/gems/1.9.1/gems/w2tags-0.9.1/hot/html.hot
+  <div id="wow">
+   <div id="kereen">
+    <span>Hello World</span>
+   </div>
+  </div>
+  => nil
+  irb(main):006:0>
+  
+== DESCRIPTION:
+
+W2Tags is the way to tags, a short cut / macros. When it do, it use some patern 
+define in HOT file to produce tags from minimal code to become full fledge tags.
+
+== FEATURES
+
+Before it release it use some patern, but I reliaze, today web development have 
+some popular patern in view engine, so I change the patern. Now syntax mimics HAML 
+to easy transisition, and proven to be useable and best.
+
+Extended Syntax are the remain patern before I choose HAML-like syntax like
+"^" - NextTag (next tag will be use after using a tag like "ul" next tag "li"), 
+Redefinition NextTag command using "~^", define variable "&var=", 
+define uniq variable "@var=", Key-Variable 
+
+  "$:","*:" for attribute NAME, 
+  "$#","*#" for attribute ID, 
+  "$.","*." for attribute CLASS, 
+  "$@","*@" for custome attribute,
+  "$$" for all Key-Variable. 
+  
+This Constanta will be ready every time it parse the W2TAGS HOT (% / -).
+
+HOT file is the powerfull features in w2tags, it contains some patern that you can
+call it later using command "%" or "-", it contains one or more line of html/w2tags/hot
+command, if you detect in you source that not DRY you can migrate the patern to HOT
+files and you can call it later
+
+The rest of the command you can see in each RDOC Documentation or by reading 
+the source of W2Tags::Parser or see in Test folder, 
+So you can code less typing.
+
+== PROBLEMS:
+
+=== Demo files
+
+Some of Demo not yet convert to new patern so please not to tray it, I'll do it 
+if I have some time to do it. 
+
+=== Auto closing for Code
+
+Closing tags for HAML code like:
+
+  - if <condition>
+
+does not have automatically close so you must closing it your self with
+
+  - end
+
+for w2erb, the HOT have definition for autoclosing and the help from
+method on parser "shortcut_exec(regex)", now it can auto intelligent 
+closing
+
+  -if index>100
+    .bigger bigger than 100
+  -elsif index>50
+    .bigger bigger than 50 but less than 100
+  -else
+    .less less than 50
+
+  .common
+    Common Tag
+
+work around to have a closing code, you can use feature to save some patern
+in a hot file and use it in your code, example: "common.hot"
+
+  >>_if
+  - if $*
+  <</
+  - end
+  
+and use it in your code:
+
+  -if <condition>
+
+and it do automatic closing   
+  
+
+== SYNOPSIS:
+
+=== HAML Like Syntax
+
+just use it like haml basic, and if alredy comfort with that syntax you 
+can extend the syntax and combine it with patern definition created in hot
+file or you can create your own hot file.
+
+==== Example 1 - HAML:
+
+  #content
+    %h1 menu
+    %ul
+      %li menu 1
+      %li menu 2
+      
+will produce
+
+  <div id="content">
+    <h1>menu</h1>
+    <ul>
+      <li>menu 1</li>
+      <li>menu 2</li>
+    </ul>
+  </div>
+
+Extended syntax that produce the same result
+
+  #content
+    %h1 menu
+    %ul
+      ^ menu 1; menu 2
+
+or if the patern is so common, it can be save in a hot file 
+and use it as hot command. Example: inside "common.hot"
+
+  >>_ul
+  %ul
+    ^$*
+
+and code in source:
+
+  !hot!common
+  #content
+    %h1 menu
+    -ul menu 1; menu 2
+
+==== Example 2 - Form input
+
+HAML format:
+
+  %h1 New user
+
+  = error_messages_for :user 
+
+  -form_for @user do |f| 
+    %p
+      %b Name
+      %br
+      = f.text_field :name 
+    %p
+      %b Email
+      %br
+      = f.text_field :email 
+    %p
+      %b Last login
+      %br
+      = f.datetime_select :last_login 
+
+    %p
+      = f.submit "Create"
+  = link_to 'Back', users_path 
+
+You can see that it not DRY, some patern will go to HOT files "rails_basic.hot"
+
+  >>_input
+  %p
+    %b $0.capitalize.gsub('_',' ')-
+    %br
+    = f.text_field :$0
+
+  >>_submit
+  !/
+  %p
+    = f.submit "$0"
+
+and code in source:
+
+  !hot!rails_basic
+  %h1 New user
+
+  = error_messages_for :user
+
+  -form_for @user do |f|
+    -input name;email;last_login
+    -submit Create
+
+  = link_to 'Back', users_path
+
+== REQUIREMENTS:
+
+no requirement for now, since it use only regular expression to do
+parsing.
+
+== INSTALL:
+
+sudo gem install w2tags
+
+=== COMMAND LINE
+
+get it from commandline "w2tags"
+
+  How to WaytoTags:
+  ~~~~~~~~~~~~~~~~~~~~~~~
+  syntax:
+  w2tags [*.w2htm] [-a] [-d:*opt*]
+  OR
+  w2tags [file1,file2,file3] [-b] [-d:*opt*]
+
+  example:
+  1. w2tags -a             #=> translate all file with ext: w2htm
+  2. w2tags *.w2xml -a     #=> translate all file with ext: w2xml
+  3. w2tags file1.w2htm    #=> translate a file
+  4. w2tags file1.w2htm -b #=> translate a file with no initialize/finalize
+  5. w2tags file1.w2htm -d:parser #=> translate with debug parser
+  6. w2tags file1.w2htm -d:constanta #=> translate with debug constanta
+  7. w2tags file1.w2htm -d:stack #=> translate with debug stack indentation
+  8. w2tags -irb           #=> Start IRB with WH as instance object of W2Tags
+  9. w2tags -rails         #=> Copy w2scaffold Rails and set environment.rb
+
+  Enjoy... 
+
+=== RAILS HOOK
+
+add inside file "config/environment.rb" in the bottom:
+
+  require 'w2tags'
+  require 'w2tags/rails_hook'
+  
+You can automatically add by using commandline "w2tags -rails"
+
+=== MERB HOOK
+
+add inside file "config/init.rb" in the bottom:
+
+  require 'w2tags'
+  require 'w2tags/merb_hook'
+  
+=== SINATRA HOOK
+
+sinatra usualy consist only one file "main.rb", so just add below sinatra require:
+
+  require 'w2tags'
+  require 'w2tags/sinatra_hook'
+
+== LICENSE:
+
+Copyright (c) 2008 - 2009 Widi Harsojo
+
+Distributed under the user's choice of the {GPL Version 2}[http://www.gnu.org/licenses/old-licenses/gpl-2.0.html] 
+(see COPYING for details) or the MIT License .

data/Rakefile

@@ -0,0 +1,23 @@
+# Look in the tasks/setup.rb file for the various options that can be
+# configured in this Rakefile. The .rake files in the tasks directory
+# are where the options are used.
+
+load 'tasks/setup.rb'
+
+ensure_in_path 'lib'
+require 'w2tags'
+
+task :default => 'spec:run'
+
+PROJ.name = 'w2tags'
+PROJ.authors = 'widi harsojo'
+PROJ.email = 'wharsojo@gmail.com'
+PROJ.url = 'w2tags.rubyforge.org'
+PROJ.rubyforge.name = 'w2tags'
+
+PROJ.rdoc.opts << '--line-numbers' << '--inline-source' << '-A cattr_accessor=object'
+PROJ.rdoc.opts << '--charset' << 'utf-8' << '--all'
+
+PROJ.spec.opts << '--color'
+
+# EOF

data/VERSION

@@ -0,0 +1 @@
+0.9.1

data/bin/w2tags

@@ -0,0 +1,143 @@
+#!/usr/bin/env ruby
+# The command line W2tags parser.
+#  How to WaytoTags:
+#  ~~~~~~~~~~~~~~~~~~~~~~~
+#  syntax:
+#  w2tags [*.w2htm] [-a] [-d:*opt*]
+#  OR
+#  w2tags [file1,file2,file3] [-b] [-d:*opt*]
+#
+#  example:
+#  1. w2tags -a             #=> translate all file with ext: w2htm
+#  2. w2tags *.w2xml -a     #=> translate all file with ext: w2xml
+#  3. w2tags file1.w2htm    #=> translate a file
+#  4. w2tags file1.w2htm -b #=> translate a file with no initialize/finalize
+#  5. w2tags file1.w2htm -d:parser #=> translate with debug parser
+#  6. w2tags file1.w2htm -d:constanta #=> translate with debug constanta
+#  7. w2tags file1.w2htm -d:stack #=> translate with debug stack indentation
+#  8. w2tags -irb           #=> Start IRB with WT as instant object of W2Tags
+#
+#  Enjoy... 
+
+require File.expand_path(
+        File.join(File.dirname(__FILE__),%w[.. lib w2tags]))
+wpath=  File.dirname(__FILE__).gsub(/bin$/,'')
+def howto_w2tags
+puts <<END
+
+How to WaytoTags:
+~~~~~~~~~~~~~~~~~~~~~~~
+syntax:
+w2tags [*.w2htm] [-a] [-d:*opt*]
+OR
+w2tags [file1,file2,file3] [-b] [-d:*opt*]
+
+example:
+1. w2tags -a             #=> translate all file with ext: w2htm
+2. w2tags *.w2xml -a     #=> translate all file with ext: w2xml
+3. w2tags file1.w2htm    #=> translate a file
+4. w2tags file1.w2htm -b #=> translate a file with no initialize/finalize
+5. w2tags file1.w2htm -d:parser #=> translate with debug parser
+6. w2tags file1.w2htm -d:constanta #=> translate with debug constanta
+7. w2tags file1.w2htm -d:stack #=> translate with debug stack indentation
+8. w2tags -irb           #=> Start IRB with WH as instance object of W2Tags
+9. w2tags -rails         #=> Copy w2scaffold Rails and set environment.rb
+
+Enjoy... 
+END
+
+end
+
+arg = ARGV 
+if arg.size>0
+	arg = ['w2htm'] + arg if arg.size==1 && arg[0]=='-a'
+	puts 'ARGV  : '+arg.join(" ")
+	puts arg[1]
+	
+	WH = W2Tags::Parser.new
+
+	x = arg.select {|s|s[0,3]=='-d:'}
+	#WH.dbg[:stack] = (x.size==0)	
+	x.each do |s|
+		WH.dbg[:parse]     = true if s=='-d:parser'
+		WH.dbg[:stack]     = true if s=='-d:stack'
+		WH.dbg[:constanta] = true if s=='-d:constanta'
+		WH.dbg[:show_hot]  = true if s=='-d:show_hot'
+	end
+	
+	if arg[0]=='-irb'
+    ARGV.shift
+    
+    class Object
+      def wh(str)
+        puts WH.parse_line(str)
+      end
+    end
+
+    require 'irb'
+    puts "Your W2Tags instance object stored in WH..."
+    puts 'Ex: puts WH.parse_line "#content\\n  %span Hello"'
+    puts 'Shortcut wh() => puts WH.parse_line()'
+    puts ''
+    
+    IRB.start      
+	elsif arg[0]=='-rails'
+    if !File.exist?('vendor/plugins')
+      puts 'No Folder: vendor/plugins...'
+    elsif !File.exist?('config/environment.rb')
+      puts 'No File: config/environment.rb...'
+    else
+      ttl_copy = 0
+      require 'fileutils'
+      Dir[wpath + "plugins/**/*"].each do |fl|
+        if !File.directory?(fl)
+          path= fl.gsub(/.*\/plugins\//,'vendor/plugins/')
+          dir = File.dirname(path)
+          FileUtils.mkdir_p(dir) if !File.exist?(dir)
+          if !File.exist?(path)
+            ttl_copy += 1
+            puts "Copy w2tags plugins for rails..." if ttl_copy==1
+            puts "=> #{fl.gsub(/.*\/w2tags\//,'')}"
+            File.open(path, 'wb') { |file| file.write(File.read(fl)) }
+          end
+        end
+      end
+      ttl_copy = 0
+      Dir[wpath + "hot/rails/**/*"].each do |fl|
+        path= fl.gsub(/.*\/rails\//,'')
+        if !File.exist?(path)
+          ttl_copy += 1
+          puts "Copy w2tags HOT files..." if ttl_copy==1
+          puts "=> #{path}"
+          File.open(path, 'wb') { |file| file.write(File.read(fl)) }
+        end
+      end
+      content = File.read('config/environment.rb')
+      ori= content.length
+      content << "\nrequire 'w2tags'" if /\n *require *\'w2tags\'/ !~ content
+      content << "\nrequire 'w2tags/rails_hook'" if /\n *require *\'w2tags\/rails_hook\'/ !~ content
+      if ori != content.length
+        puts 'Update config/environment.rb...'
+        File.open('config/environment.rb', 'wb') { |file| file.write(content) }
+      end
+      puts(<<END)
+
+FINISH W2TAGS for RAILS...
+You can try w2scaffold:
+
+script/generate w2scaffold post title:string body:text published:boolean
+rake db:migrate
+script/server
+
+END
+    end
+  else
+    case arg[1]
+    when '-a' ;WH.parse_files(Dir["*.#{arg[0]}*"]) 
+    when '-b' ;WH.parse_files(arg[0].split(','),false)
+    else      ;WH.parse_files(arg[0].split(','))
+    end
+	end
+else
+	howto_w2tags
+end

data/doc/ERB.HOT.rdoc

@@ -0,0 +1,82 @@
+= ERB HOT
+definition for file with extention of ".erb", this template is use on some of the
+well know frame work.
+
+== DEFINED COMMAND
+
+=== INITIALIZE & FINALLIZE
+this command are use on (appended) so user who use it frequently can define
+any kind of element / tags for the beginning / ending document.
+
+  %initialize
+  not use but you can define it again 
+
+  %finallize
+  use for extract all end of tags, it use command ",/"
+
+=== INCLUDE ANOTHER HOT FILES
+for merb application, I define 2 short cut of how you can use another hot file:
+
+  -merb_table (it will include: erb_merb, erb_table, erb_jquery)
+   it use when you define html for listing data, usually for method of "index"
+  
+  -merb_form  (it will include: erb_merb, erb_form, erb_jquery)
+   it use when you define html for fill in form, usually for method of 
+   "new", or "edit".
+
+=== AUTOCLOSE with -END
+these definition are auto close with "-end".
+
+  -if
+  -elsif
+  -else
+    ex:###############################################
+    -if @page.page_count>1 && !@page.first_page?
+        %a.first_page{href="?page=1"} First
+    -else
+        %span.first_page First
+     
+    ##################################################
+    <% if @page.page_count>1 && !@page.first_page? %>
+        <a class="first_page" href="?page=1">First</a>
+    <% else %>
+        <span class="first_page">First</span>
+    <% end %>
+    &nbsp;
+    
+  -for
+  -each
+  -times
+    ex:###############################################
+    -times pgt;pg1 = pg1 + 1
+      -if pg1 == @page.current_page
+          %span.current_page <%= pg1 %>
+      -else
+          %a.page_index{href="?page=<%= pg1 %>"} <%= pg1 %>
+      &nbsp;
+    ##################################################
+    <% pgt.times do pg1 = pg1 + 1 %>
+      <% if pg1 == @page.current_page %>
+          <span class="current_page"><%= pg1 %></span>
+      <% else %>
+          <a class="page_index" href="?page=<%= pg1 %>"><%= pg1 %></a>
+      <% end %>
+      &nbsp;
+    <% end %>
+    
+=== COMMAND
+
+  -end
+  -
+    ex:###############################################
+    - page = 25
+    ##################################################
+    <% page = 25 %>
+  
+=== EXPAND TAGS
+
+  %br
+  %hr
+  %img
+  %img=
+  

data/doc/FAQ.rdoc

@@ -0,0 +1,81 @@
+= Frequently Asked Questions
+
+== W2TAGS
+
+=== How do I put a punctuation mark after an element, like:
+
+  I Like <strong class="bold"><i class="italic">cake</i></strong>!
+
+  I Like (%strong.bold (%i.italic cake%)%)!
+
+=== I have Patern in HOT with define close and autoclosing (!/) at first line. How do I use it, since patern write after define close.
+
+If you have "ul_li" patern ( below ), it can't be use since define closing ( <</ ) 
+immediately push to stack after "ul_li" patern called, and then perser will loop inside 
+"ul_li" patern line by line, it counter the first line to popup all the stack where 
+indentation is the same or wider, and it means current patern have same indentations.
+
+  >>ul_li
+  !/
+  <div>
+    %ul
+      ^$*
+  <</
+  </div>
+  
+to get work-around of this situations, you define two patern like this:
+
+  >>ul_li
+  !/
+  <div>
+    %ul
+      ^$*
+  %end_div
+
+  >>end_div
+  <</
+  </div>
+
+the last line in "ul_li" patern, will call %end_div and it will push define closing 
+to stack "end".
+
+In README.txt if patern change to have auto closing ( !/ ), the change are:
+
+  >>if
+  !/
+  - if $*
+  %end_if
+  
+  >>end_if
+  <</
+  - end
+  
+=== Why you not implement > and < (Remove White Spaces) 
+
+Not implement it, since focus on how to make it DRY in w2tags.
+
+HAML style
+  
+  %ul.tabSet
+    %li.tabs.off<
+      %a Overview
+    %li.tabs.off<
+      %a 200 calories
+
+W2TAGS style
+
+  %ul.tabSet
+    ~^ <li class="tabs off"><a href="#">$0</a></li>
+    ^ Overview;200 calories
+
+=== Can it source have multiple w2tags command in one line
+
+Yes it can!, just make HOT a patern like this:
+
+  >>_w
+  $0
+
+  -w %li inli;: input
+
+  <li>inli</li>
+  <input value="input"/>