postage

= Postage - API for write posts in simple text files

• {Repository}[http://github.com/hallison/postage]
• {Project}[http://rubyforge.org/projects/postage]
• {Documentation}[:link:Postage.html]
• {Issues}[http://github.com/hallison/postage/issues]

Postage is a simple API which load your text files and handle the contents in Markdown syntax.

It's useful for blogwares, or anything else, that uses flat files organized in directories instead databases.

Use your post text file in following hierarchy and format:

/posts/path/yyyymmdd-name_of_post.tags.filter

Real example of use:

home
`-- hallison
    `-- blog
        `-- posts
            |-- 20090604-posting_blog_articles_using_postage.ruby.postage.mkd
            |-- 20090529-postview_blogging_posts_with_sinatra_and_postage.ruby.sinatra.postage.mkd
            |-- archive
                |-- 20080930-bash_condicional_variables.shell.script.mkd
                `-- 20081008-bash_arguments_validation.bash.shell.script.test.mkd
            `-- drafts

It's possible uses Markdown Extra syntax because Postage use Maruku for converting files.

About Markdown lightweight markup language, please, visit http://daringfireball.net/projects/markdown and Markdown Extra, visit http://michelf.com/projects/php-markdown/extra/.

== Requirements

Please, Postage has dependencies and most be installed.

• {Maruku}[http://maruku.rubyforge.org/], for convert Maruku in HTML.

== More information

• {Authors}[:link:AUTHORS.html]
• {Changes}[:link:CHANGES.html]
• {License}[:link:LICENSE.html]

== Copyright

Copyright (c) 2009 Hallison Batista