postview 0.7.0

data/HISTORY

@@ -0,0 +1,67 @@
+[0.7.0 - not released - Features]
+  * The project is a Gem package.
+  * Postview command for create a new directory structure.
+  * Added CLI commands.
+  * Added basic classes for version and information about project.
+  * Added basic files for versioning and informations.
+  * Updated methods and constants to path of directories.
+  * Updated default views.
+  * Support to themes using ERB.
+
+[0.6.0 - 2009-07-31 - Features and enhancements]
+  * Added task for build settings file.
+  * Added task for build rackup file.
+  * Default root path has been added in settings.
+  * Improvements in synchronize tasks.
+  * Fixes in the page keywords.
+  * All tasks have been added in the rakefile.
+
+[0.5.0 - 2009-07-21 - Features and enhancements]
+  * Task for synchronize post files has been added.
+  * New instructions in README file.
+  * Added instructions in task for new post.
+  * Fixes and updates in settings.
+  * Default values have been added in settings.
+  * All views have been improved.
+  * All views for new helper methods have been updated.
+  * All tests have been fixed.
+  * Mapping class has been removed in favour of Sinatra::Mapping extension.
+  * All methods in the application have been updated for new methods of the
+    Sinatra::Mapping extension.
+
+[0.4.0 - 2009-07-13 - Features and enhancements]
+  * Postage have been used for handle post files.
+  * Several features have been updated for use Postage.
+
+[0.3.2 - 2009-07-09 - Enhancements]
+  * Task for create new post.
+  * Task for create release package.
+
+[0.3.1 - 2009-07-09 - Features]
+  * Added individual tasks.
+  * Added default settings to fix errors.
+
+[0.3.0 - 2009-07-07 - Features]
+  * Added render wrapper method for simplified local variables in views.
+  * Support for listing drafts.
+  * Added new mapping for list all drafts.
+  * Added rescue errors in settings file not found.
+
+[0.2.0 - 2009-07-02 - Features]
+  * The helper methods were improved.
+  * Improvements in routes and settings.
+  * Added class for mapping route paths.
+  * All tests and views were fixed.
+  * Improved methods in settings class.
+  * Improved initialize method in site, finder and mapping.
+
+[0.1.0 - 2009-06-04 - Main features for alpha version]
+  * All posts are loaded from files.
+  * All attributes for a post are loaded from a file name.
+  * Support for tags, archiving and search.
+  * Support for configuration of routes and directories for posts and
+    archive.
+  * Lightweight interface.
+  * Added support for settings.
+  * Listing posts by tags and search.
+

data/INFO

@@ -0,0 +1,14 @@
+:name: postview
+:summary:
+  Simple blog-engine that render Markdown files.
+:description:
+  Postview is a simple blog-engine written in Ruby using the Sinatra DSL for render files written in Markdown.
+:authors:
+  - Hallison Batista
+:email: email@hallisonbatista.com
+:homepage: http://postview.rubyforge.org/
+:dependencies:
+  sinatra: >= 0.9.1.1
+  sinatra-mapping: >= 1.0.5
+  postage: >= 0.1.4.1
+

data/README.rdoc

@@ -0,0 +1,103 @@
+= Postview
+
+Just write your posts ... and view!
+
+Postview is a simple blogware written in Ruby using Sinatra DSL that
+renders files written in Markdown.
+
+* Easy to configure.
+* Easy to synchronize.
+
+Install {Ruby}[http://www.ruby-lang.org/] Gem package and try.
+
+== Getting start
+
+The Postview requires the following gems:
+
+* {Rack}[http://rack.rubyforge.org/]
+* {Rack-Test}[http://github.com/brynary/rack-test]
+* {Sinatra}[http://www.sinatrarb.com/]
+* {Sinatra-Mapping}[http://sinatra-mapping.rubyforge.org/]
+* {Maruku}[http://maruku.rubyforge.org/]
+* {Postage}[http://postage.rubyforge.org/]
+
+Install stable gem from {RubyForge.org}[http://rubyforge.org/].
+
+  $ sudo gem install postview
+
+Or, install development gem from {Github.com}[http://github.com/].
+
+  $ sudo gem install hallison-postview --source http://gems.github.com/
+
+So, run command for create and setup a new Postview directory structure.
+
+  $ postview create path/to/website
+
+After setup, run server with command:
+
+  $ RACK_ENV=production postview server
+
+NOTE: Inopportunely, Postview not run server using production environment,
+yet.
+
+In your browser, access http://localhost:9000/.
+
+== Create new post
+
+New post can be created by using the task `post`:
+
+    $ cd path/to/postview
+    $ rake post
+
+Following all instructions. Please, set environment variable +EDITOR+
+or +VISUAL+ for editing your posts. Ether else, run:
+
+    $ cd path/to/postview
+    $ EDITOR=<your favorite editor> rake post
+
+The new post will be written in drafts directory. You can pass other
+directory.
+
+    $ cd path/to/postview
+    $ rake post[path/to/other/post/directory]
+
+NOTE: New feature for creates new post from blog manager will be added.
+
+== Synchronize your posts
+
+You can synchronize your page using the synchronize tasks. For more
+information about this task, run <code>rake -D sync</code>.
+
+It's need creates and edit file placed in +/your/home/directory/.netrc+.
+The +directory+ attribute most be setted in +settings.yml+ file.
+
+Example:
+
+    # remote host
+    /remote/path/to/postview
+    `-- posts
+        |-- archive
+        `-- drafts
+    # local host
+    posts
+    |-- 20090702-foo_post_article.ruby.sinatra.git.mkd
+    |-- archive
+    |   `-- 20080702-foo_post_article.ruby.sinatra.git.mkd
+    `-- drafts
+        `-- 20090703-foo_draft_article.ruby.sinatra.git.mkd
+
+    # To synchronize posts
+    $ rake sync:posts
+    $ rake sync:posts[remote/path/to/postview/posts]
+
+    # To synchronize archive
+    $ rake sync:archive
+    $ rake sync:archive[remote/path/to/postview/posts/archive]
+
+    # To synchronize drafts
+    $ rake sync:drafts
+    $ rake sync:drafts[remote/path/to/postview/posts/drafts]
+
+    # To synchronize all
+    $ rake sync:all
+

data/Rakefile

@@ -0,0 +1,174 @@
+$LOAD_PATH << File.expand_path(File.dirname(__FILE__))
+
+require 'lib/postview'
+require 'net/ftp'
+require 'rake/testtask'
+require 'rake/packagetask'
+
+
+# Show text message in console.
+def banner(message)
+  printf "\n%s\n", Postview
+  printf "\n%s\n\n", message
+end
+
+# Prompt for values.
+def prompt(label, default = nil)
+  while true
+    printf((default ? "%s [%s]: " : "%s: "), "#{label}", "#{default}")
+    value = $stdin.readline.chomp.strip
+    value = default if value.empty?
+    return value unless value.nil? || value.to_s.empty?
+  end
+end
+
+# Build default settings file and load.
+def settings
+  #Postview::Settings.build_default_file
+  Postview::Settings.load
+end
+
+# Build and load the resource file for FTP connection.
+def netrc
+  begin
+    @netrc ||= File.readlines(File.join(ENV['HOME'],".netrc"))
+  rescue Errno::ENOENT => message
+    puts <<-end_message.gsub(/^[ ]{6}/,'')
+      #{message}.
+      Please create the .netrc file in your home.
+      echo "\
+      machine #{settings.site[:domain]}
+        login <username>
+        password <password>
+      " >> #{ENV['HOME']}/.netrc
+    end_message
+    exit 1
+  end
+  match ||= @netrc.to_s.match(/machine (.*?)[\n ]login (.*?)[\n ]password (.*?)[\n ].*?/m)
+  { :machine => match[1].strip, :login => match[2].strip, :password => match[3].strip }
+end
+
+# Synchronize directory
+def ftp(directory, destination = nil)
+  origin        = settings.directories[directory]
+  destination ||= File.join(settings.site[:directory], settings.directories[directory])
+  posts         = settings.build_finder_for(directory).all_posts
+
+  $stdout.puts ">> Connecting to #{netrc[:machine]} ..."
+
+  Net::FTP.open(netrc[:machine]) do |ftp|
+    ftp.login netrc[:login], netrc[:password]
+
+    $stdout.puts ">> Logged as #{netrc[:login]} ..."
+
+    $stdout.puts ">> Accessing #{destination} ..."
+
+    ftp.chdir destination
+
+    posts.each do |post|
+      $stdout.puts ">> Copying #{post} ..."
+      ftp.putbinaryfile(File.join(origin, post.file))
+    end
+
+    $stdout.puts ">> Synchronization for #{directory} is done."
+  end
+end
+
+def rsync(directory, destination = nil)
+  origin        = settings.directories[directory]
+  destination ||= File.join(settings.site[:directory], settings.directories[directory])
+  posts         = settings.build_finder_for(directory).all_posts
+
+  $stdout.puts ">> Connecting to #{netrc[:machine]} ..."
+
+  Net::FTP.open(netrc[:machine]) do |ftp|
+    ftp.login netrc[:login], netrc[:password]
+
+    $stdout.puts ">> Logged as #{netrc[:login]} ..."
+
+    $stdout.puts ">> Accessing #{destination} ..."
+
+    ftp.chdir destination
+
+    posts.each do |post|
+      $stdout.puts ">> Copying #{post} ..."
+      ftp.putbinaryfile(File.join(origin, post.file))
+    end
+
+    $stdout.puts ">> Synchronization for #{directory} is done."
+  end
+end
+
+desc <<-end_desc.gsub(/^[ ]{2}/,'')
+  Create new post in #{settings.directory_for(:posts)}.
+  For edit posts, set environment variable EDITOR or VISUAL. Otherwise,
+  pass editor="<your favorite editor command and arguments>".
+
+  Example:
+
+  $ rake post editor="gvim -f"
+
+  Or use directory argument for create a post in other directory.
+
+  $ rake post[other/path/for/new/post]
+end_desc
+task :post, [:directory] do |spec, args|
+  banner "New post. Type all attributes for new post.\n"
+  path = if args.directory
+           if settings.directories.has_key? args.directory.to_sym 
+             settings.directory_for(args.directory.to_sym)
+           else
+             args.directory
+           end
+         else
+           settings.directory_for(:drafts)
+         end
+  post = Postage::Post.new :title        => prompt("Post title"),
+                           :publish_date => prompt("Publish date", Date.today),
+                           :tags         => prompt("Tags separated by spaces").split(' '),
+                           :filter       => :markdown,
+                           :content      => <<-end_content.gsub(/^[ ]{29}/,'')
+                             Tanks for use #{Postview}.
+                             Input here the content of your post.
+                           end_content
+
+  begin
+    post.build_file
+    post.create_into(path)
+  rescue Errno::ENOENT => message
+    $stderr.puts message
+    $stderr.puts "Try create path #{args.directory}."
+    exit 1
+  end
+
+  printf "%s\n", "The post '#{post.title}' was created in '#{path}/#{post.file}'."
+
+  editor = ENV['editor'] || ENV['EDITOR'] || ENV['VISUAL'] || 'none'
+  if prompt("Edit post using '#{editor}'?", "y") =~ /y/i
+    if editor
+      sh "#{editor} #{path}/#{post.file}"
+    else
+      printf "%s", "Editor not specified."
+    end
+  end
+
+  $stdout.puts ">> Post done."
+end
+
+namespace :sync do
+  settings.directories.keys.each do |dirname|
+    desc "Synchronize #{dirname}."
+    task dirname, [:destination] do |spec,args|
+      banner "Synchronize #{dirname} directory."
+      ftp(dirname, args.destination)
+    end
+  end
+
+  desc "Synchronize all directories."
+  task :all => settings.directories.keys
+end
+
+Dir["tasks/**.rake"].each do |task_file|
+  load task_file
+end
+

data/VERSION

@@ -0,0 +1,8 @@
+--- 
+:major: 0
+:release: 
+:minor: 7
+:cycle: Beta release
+:patch: 0
+:date: 2009-09-10
+:timestamp: 2009-08-24 07:46:28 -04:00

data/bin/postview

@@ -0,0 +1,51 @@
+#!/usr/bin/env ruby
+# Copyright (C) 2009 Hallison Batista
+
+require File.expand_path(File.join(__FILE__, "..", "..", "lib", "postview"))
+
+command = ARGV.shift if Postview::CLI.commands.include? ARGV.first
+program = File.basename(__FILE__)
+ENV['RACK_ENV'] = 'production'
+
+ARGV.options do |arguments|
+
+  arguments.summary_indent = "  "
+  arguments.summary_width  = 24
+  arguments.banner = <<-end_banner.gsub /^[ ]{4}/, ''
+    #{Postview::Version}
+
+    Usage:
+      #{program} <command> [options]
+      #{program} [options]
+
+    Commands:
+      #{Postview::CLI.commands.join("\n#{arguments.summary_indent}")}
+
+      Run command with option "-h" or "--help" for more information.
+
+  end_banner
+
+  arguments.separator "Global options:"
+
+  arguments.on("-h", "--help",    nil, "Show this message.")        { puts arguments }
+  arguments.on(nil,  "--version", nil, "Show version information.") { puts Postview::About }
+
+  arguments.separator ""
+
+  begin
+    if command
+      Postview::CLI.run(command, ARGV)
+    elsif ARGV.empty?
+      puts arguments
+      exit 0
+    else
+      arguments.parse!
+    end
+  rescue => error
+    puts arguments
+    puts error
+    exit 1
+  end
+
+end
+

data/lib/postview.rb

@@ -0,0 +1,68 @@
+# Copyright (c) 2009 Hallison Batista
+$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__))
+
+# Postview - The minimalist blogware and static page generator.
+#
+# == Configuration
+#
+# After create your blog, edit <tt>config/settings.yml</tt> file.
+#
+# *site*::        Attributes for your site.
+#                 * *title*
+#                 * *subtitle*
+#                 * *author*
+#                 * *email*
+#                 * *domain* for connect by FTP.
+#                 * *directory*, remote. This attribute will be used to synchronize your posts.
+#                 * *theme*
+# *sections*::    Attributes for sections (routes) used in site.
+#                 * *root* for main section
+#                 * *posts*
+#                 * *tags*
+#                 * *archive*
+#                 * *drafts*
+#                 * *search*
+#                 * *about*
+# *directories*:: Attributes for paths to post files.
+#                 * *posts*
+#                 * *archive*
+#                 * *drafts*
+#
+# == Themes
+#
+# Default theme is generated in <tt>themes/default</tt>. Change or migrate your favorite
+# theme.
+#
+module Postview
+
+  # RubyGems.
+  require 'rubygems'
+
+  # Core requires.
+  require 'optparse' 
+  require 'pathname'
+  require 'ostruct'
+
+  # 3rd part libraries/projects.
+  require 'sinatra/base' unless defined? ::Sinatra::Base
+  require 'sinatra/mapping' unless defined? ::Sinatra::Mapping
+  require 'postage' unless defined? ::Postage
+
+  # Internal requires
+  require 'postview/patches' if RUBY_VERSION < "1.8.7"
+
+  ROOT = Pathname.new("#{File.dirname(__FILE__)}/..").expand_path
+  PATH = Pathname.new(".").expand_path
+
+  # Auto-load all internal requires.
+  autoload :About,         'postview/about'
+  autoload :Version,       'postview/version'
+
+  autoload :Settings,      'postview/settings'
+  autoload :Site,          'postview/site'
+  autoload :Helpers,       'postview/helpers'
+  autoload :Application,   'postview/application'
+  autoload :CLI,           'postview/cli'
+
+end # module Postview
+