templette 0.4.1 → 0.5.0

data/bin/templette

@@ -1,25 +1,26 @@
-#!/usr/bin/env ruby
-#
-
-usage = <<USAGE
-Generate the templette framework.
-Usage: templette <directory>
---help gets you this help message... Helpful!
-USAGE
-
-require 'fileutils'
-
-new_dir = ARGV.first
-
-if new_dir.nil? || new_dir.empty?
-	puts usage
-	exit(0)
-end
-
-FileUtils.mkdir(new_dir) unless File.exists?(new_dir)
-%w{/pages /templates /helpers /resources}.each do |dir|
-  FileUtils.mkdir(new_dir + dir) unless File.exists?(new_dir + dir)
-end
-
-FileUtils.cp(File.dirname(__FILE__) + '/../files/Rakefile', new_dir + '/Rakefile')
-FileUtils.cp(File.dirname(__FILE__) + '/../files/default_helper.rb', new_dir + '/helpers/default_helper.rb')
+#!/usr/bin/env ruby
+#
+
+usage = <<USAGE
+Generate the templette framework.
+Usage: templette <directory>
+--help gets you this help message... Helpful!
+USAGE
+
+require 'fileutils'
+
+new_dir = ARGV.first
+
+if new_dir.nil? || new_dir.empty?
+	puts usage
+	exit(0)
+end
+
+FileUtils.mkdir(new_dir) unless File.exists?(new_dir)
+%w{/pages /templates /helpers /resources}.each do |dir|
+  FileUtils.mkdir(new_dir + dir) unless File.exists?(new_dir + dir)
+end
+
+FileUtils.cp(File.dirname(__FILE__) + '/../files/Rakefile', new_dir + '/Rakefile')
+FileUtils.cp(File.dirname(__FILE__) + '/../files/default_helper.rb', new_dir + '/helpers/default_helper.rb')
+FileUtils.cp(File.dirname(__FILE__) + '/../files/config.rb', new_dir + '/config.rb')

data/files/config.rb

@@ -0,0 +1,2 @@
+# A site root can be set like this
+# Templette::config[:site_root] = '/new_root/'

data/lib/file_generator.rb

@@ -1,4 +1,3 @@
-require File.dirname(__FILE__) + '/templette'
 module FileGenerator
     
   class << self
@@ -30,6 +29,17 @@ module FileGenerator
 end"
       end
     end
+    
+    # Called by rake generate:config
+    #
+    # Generates a default config.rb file, with usage examples present and commented out.
+    def config
+      if File.exists?("config.rb")
+        puts 'Config file already exists!'
+      else
+        FileUtils.cp(File.dirname(__FILE__) + '/../files/config.rb', 'config.rb')
+      end
+    end
   end
   
 end

data/lib/tasks/templette_tasks.rb

@@ -1,5 +1,9 @@
+task :load_config do
+  Templette::load_config_from_file
+end
+
 desc "Build an HTML project from template files"
-task(:build) do
+task(:build => :load_config) do
   if ENV['destination']
     Templette::Generator.new(ENV['destination']).run
   else
@@ -8,7 +12,7 @@ task(:build) do
 end
 
 desc "Build and view the site locally using WEBrick"
-task(:preview) do
+task(:preview => :load_config) do
   gen = Templette::Generator.new('preview')
   gen.run
   
@@ -68,6 +72,12 @@ namespace :generate do
     require 'file_generator'
     FileGenerator.helper(ENV['name'])
   end 
+  
+  desc "Generate a config file"
+  task :config do
+    require 'file_generator'
+    FileGenerator.config
+  end
 
 end
 

data/lib/templette.rb

@@ -1,5 +1,20 @@
 %w{erb yaml fileutils}.each {|lib| require lib}
 
-%w{data_accessors errors generator method_collector page template engineer}.each do |file|
+%w{helpers data_accessors errors generator method_collector page template engineer}.each do |file|
   require File.dirname(__FILE__) + "/templette/#{file}"
+end
+
+module Templette
+  CONFIG_FILE_PATH = 'config.rb'
+  
+  @@config = {:site_root => '/' }
+  
+  def self.config
+    @@config
+  end
+  
+  def self.load_config_from_file
+    eval File.read(CONFIG_FILE_PATH) if File.exists?(CONFIG_FILE_PATH)
+  end
+  
 end

data/lib/templette/data_accessors.rb

@@ -1,5 +1,7 @@
 module Templette
   module DataAccessors
+    include Templette::Helpers
+    
     def attributes # :nodoc:
       @attributes ||= {}
     end
@@ -22,47 +24,9 @@ module Templette
     rescue RenderError => e
       raise PageError.new(page, e.message)      
     end
-
-    # Generates an image tag.  Default options {:alt => filename }
-    # 
-    # Ex. 
-    #    image_tag('ball.png', :alt => 'a red ball')
-    #    => "<img src='/images/ball.png' alt='a red ball' />"
-    
-    def image_tag(path, options = {})
-      options = {:alt => path}.merge(options)
-      "<img src='/images/#{path}' #{params_to_attributes(options)}/>"
-    end
-    
-    # Generates a link to a stylesheet.  Default options {:type => 'text/css'}
-    # 
-    # Ex. 
-    #    stylesheet_tag('print', :media => 'print')
-    #    => "<link href='/stylesheets/print.css' media='print' type='text/css' />"
-    
-    def stylesheet_tag(path, options = {})
-      options = {:type => 'text/css'}.merge(options)
-      "<link href='/stylesheets/#{path}.css' #{params_to_attributes(options)}/>"
-    end
-    
-    # Genrates a javascript scrip tag.
-    #
-    # Ex.
-    #     script_tag('slider')
-    #     => <script src='/javascripts/slider.js' type='text/javascript'></script>
-    
-    def script_tag(path)
-      "<script src='/javascripts/#{path}.js' type='text/javascript'></script>"
-    end
     
     private
     
-      def params_to_attributes(options)
-        options.inject('') do |str, h|
-          str << "#{h[0]}='#{h[1]}' "
-        end
-      end
-    
       def generate_accessor(k, v)
         raise TempletteError.new(page, "Method already defined: #{k}.  Change your config file and stop using it!") if self.methods.include?(k.to_s)
         if v.kind_of?(Hash)

data/lib/templette/generator.rb

@@ -7,21 +7,21 @@ module Templette
     end
   
     def run
-      FileUtils.mkdir(@out_dir) unless File.exists?(@out_dir)
+      FileUtils.mkdir_p(output_location) unless File.exists?(output_location)
       pages = Page.find_all
-      puts "Generating site in: #{@out_dir}; contains #{pages.size} pages"
+      puts "Generating site in: #{output_location}; contains #{pages.size} pages"
       pages.each do |page|
         puts "Generating page #{page.name} using template #{page.template.name}"
         begin
-          page.generate(@out_dir)
+          page.generate(output_location)
         rescue Templette::TempletteError => e
           @errors.push(e)
         end
       end
 
       if File.exists?(@resources_dir)
-        puts "Copying resources from #{@resources_dir} to #{@out_dir}"
-        FileUtils.cp_r("#{@resources_dir}/.", @out_dir)
+        puts "Copying resources from #{@resources_dir} to #{output_location}"
+        FileUtils.cp_r("#{@resources_dir}/.", output_location)
       end
 
       if @errors.empty?
@@ -32,6 +32,10 @@ module Templette
       end 
     end
     
+    def output_location
+      @out_dir + Templette::config[:site_root]
+    end
+    
     def clean
       FileUtils.rm_rf(@out_dir) if File.exists?(@out_dir)
     end

data/lib/templette/helpers.rb

@@ -0,0 +1,61 @@
+module Templette
+  
+  # Standard tag helpers to attempt to make life a little easier.
+  # Tag methods will not modify full paths (with an http protocol).
+  # If a tag is just a local path, it will heed the configurable site_root,
+  # and prepend the necessary directories to build the anticipated path.
+  
+  module Helpers
+    
+    # Generates an image tag.  Default options {:alt => filename }
+    # 
+    # Ex. 
+    #    image_tag('ball.png', :alt => 'a red ball')
+    #    => "<img src='/images/ball.png' alt='a red ball' />"
+    
+    #    image_tag('http://flickr.com/hilarious-picture.jpg', :alt => 'lol!')
+    #    => "<img src='http://flickr.com/hilarious-picture.jpg' alt='lol!' />"
+    
+    def image_tag(path, options = {})
+      options = {:alt => path}.merge(options)
+      "<img src='#{tag_path(path, 'images')}' #{params_to_attributes(options)}/>"
+    end
+    
+    # Generates a link to a stylesheet.  Default options {:type => 'text/css'}
+    # 
+    # Ex. 
+    #    stylesheet_tag('print', :media => 'print')
+    #    => "<link href='/stylesheets/print.css' media='print' type='text/css' />"
+    
+    def stylesheet_tag(path, options = {})
+      options = {:type => 'text/css'}.merge(options)
+      "<link href='#{tag_path(path, 'stylesheets', 'css')}' #{params_to_attributes(options)}/>"
+    end
+    
+    # Genrates a javascript scrip tag.
+    #
+    # Ex.
+    #     script_tag('slider')
+    #     => <script src='/javascripts/slider.js' type='text/javascript'></script>
+    
+    def script_tag(path)
+      "<script src='#{tag_path(path, 'javascripts', 'js')}' type='text/javascript'></script>"
+    end
+  
+    private
+    
+      def tag_path(path, asset_subdir, file_ext = nil)
+        if path =~ /http:\/\//
+          path
+        else
+          "#{Templette.config[:site_root]}#{asset_subdir}/#{path}#{ "."+file_ext if file_ext }"
+        end
+      end
+  
+      def params_to_attributes(options)
+        options.inject('') do |str, h|
+          str << "#{h[0]}='#{h[1]}' "
+        end
+      end    
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: templette
 version: !ruby/object:Gem::Version 
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors: 
 - Jacob Dunphy and Steve Holder
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-02-14 00:00:00 -08:00
+date: 2009-02-23 00:00:00 -08:00
 default_executable: templette
 dependencies: []
 
@@ -30,6 +30,7 @@ files:
 - lib/templette/engines/haml.rb
 - lib/templette/errors.rb
 - lib/templette/generator.rb
+- lib/templette/helpers.rb
 - lib/templette/method_collector.rb
 - lib/templette/page.rb
 - lib/templette/template.rb
@@ -37,6 +38,7 @@ files:
 - bin/templette
 - bin/templette.cmd
 - files/Capfile
+- files/config.rb
 - files/default_helper.rb
 - files/deploy.rb
 - files/Rakefile