1. What is FAQ Builder?

2. How do I use faq_builder?

3. Where can I get faq_builder?

4. Where can I see a FAQ formatted with faq_builder?



1. What is FAQ Builder?

1.1 Intro

FAQ Builder is a simple Perl script faq_builder.pl which transforms ASCII input into nicely formatted FAQ (Frequently Asked Questions) layout.

1.2 Layout

You'll first get a collection of title lines which usually are the questions. These title lines are numbered automagically and are linked to the main section of the FAQ. The main section holds the title lines (questions) and below each title line the content (answer).

1.3 Features



2. How do I use faq_builder?

2.1 Write ASCII text

You use a char as indicator that a line is a title line (default '�'). So you can easily build complex setups like
� Title1
�� Sub title1.1
Here comes text for sub title1.1
Here comes text for sub title1.1
Here comes text for sub title1.1
�� Sub title1.2
Here comes text for sub title1.2
� Title2
Here comes text for title2


2.2 Process ASCII stuff

Simply do a

 faq_builder.pl my_ASCII.txt  >my_HTML.html
and you get ready formatted HTML text. Using our input sample will give you

1. Title1
  1.1 Sub title1.1
  1.2 Sub title1.2
2. Title2

1. Title1
1.1 Sub title1.1
Here comes text for sub title1.1
Here comes text for sub title1.1
Here comes text for sub title1.1

1.2 Sub title1.2
Here comes text for sub title1.2

2. Title2
Here comes text for title2



3. Where can I get faq_builder?

You can download faq_builder.pl from the Blinux file archive (BTW: Blinux deals with support for the Linux user who is blind) as http://www.leb.net/pub/blinux/hacks/faq_builder.pl



4. Where can I see a FAQ formatted with faq_builder?

Check out http://leb.net/blinux/blinux-faq.html
PS: This description was formatted using faq_builder

Enjoy!
Hans <hzo@goldfish.cube.net>