<< Minor Ant Annoyance (Bug ID: 31245) | Home | I Heard It On The Radio >>

Almost Free Text

I was writing design documents in ASCII, like this:

Design Document
***************

Weiqi Gao
Wed Nov 17 20:08:10 CST 2004
----------------------------

Introduction
============

The phase two system will have two tiers

  - The business tier
  - The management tier

when Rob showed me AFT.

Rob: Have you used AFT?
Me: What is AFT?
Rob: Almost Free Text. It's like a Wiki. Byron turn me on to it.
Me: I'll give it a try.

AFT turnout to be pretty easy. You write design.aft:

*Title: Design Document
*Author: Weiqi Gao
*TOC

*Introduction

The phase two system will have two tiers

        * The business tier
        * The management tier

then run

[weiqi@gao] $ aft design.aft

to generate design.html:

You can even run

[weiqi@gao] $ aft -type tex design.aft
[weiqi@gao] $ pdflatex design
[weiqi@gao] $ pdflatex design

to generate design.pdf, with navigation tree and hyperlinks:

If you are looking for a lightweight but version controllable (i.e., text not binary) document tool for a project, AFT might fit the bill.



Re: Almost Free Text

Great tool. I considered writing something similar if I ever write another book...I am sick of Word docs, and I don't look forward to hand-coding all those XML tags for something like Docbook. I'll definitely consider this for the next thing I write. Thanks for the reference!

Re: Almost Free Text

thankx for the short tuto , aft is great !

Add a comment