About Margo

Margo is a simple way to blog using static Markdown files. It really shouldn't exist but I'm too lazy to blog in raw HTML. I prefer writing in Markdown, so I wrote Margo to convert my Markdown files into HTML on the fly.

Features

Margo is refreshingly feature-free. The core concept is that everything is a text file. There are some serious advantages to this:

  • You can use whatever editor you want
  • There is no db to set up
  • You can edit on virtually any device
  • Things like Dropbox, github, or rsync become interesting

Files

There are only two files that should need editing:

  • margo/.htaccess - gives you purty URLs
  • margo/.margo/config.json - the margo configuration file - contains various settings for your blog

Usage

Here's the easiest possible setup:

  1. Place the parent margo directory in webroot directory of your web server
  2. Visit http://yousite.com/margo/sample-post-one in your web browser

You should see the sample post appear.

Possible next steps:

  • Put the margo folder anywhere you want
  • Rename the margo folder to anything you want
  • Update the config options in margo/.margo/config.json
  • Make your own templates for Margo
  • Remove the readme.md
  • Replace sample-post-one.mdown and sample-post-two.mdown with your own awesome posts

Dependencies

  • PHP 5.2 or later