I write the articles using a text editor like TextMate or TextWrangler. The whole site is nothing but directories with an `index.txt` file in them. This index file becomes the Article.

When I start to write a new article, I create a new directory with the “slug” as the name. Eg: If I want an article on Python, I create a directory `Python` under document root and copy the template into the new directory as `index.txt`.

From: Pradeep Gowda
Title: 
Date: date
Content-Type: text/x-textile
X-Index: yes

First I type in the title of the article I am writing. Next comes a neat little trick to enter the date. In TextMate, select the “date” text and press `Cmd-Ctrl-r`. TextMate will run the text under the shell and return the value – which is the current time in ISO format.

I start typing the article after leaving two blank linkes after the last line of the header. I mark up the text in Textile or Markdown. I’m comfortable in both and most common writing purposes they are equal¹.

And that’s it. Yaki takes over from that point. Yaki does a lot of things at the background like rendering the text to HTML, extracting internal links to show as “seealo” at the bottom of each article, create backlinks etc.,

¹ A detailed account of the storage format