Postage - API for write posts in simple text files

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 <daringfireball.net/projects/markdown> and Markdown Extra, visit <michelf.com/projects/php-markdown/extra/>.

Requirements

Please, Postage has dependencies and most be installed.

  • Maruku, for convert Maruku in HTML.

More information