§ What is FAQ Builder?
§§Intro
FAQ Builder is a simple Perl script <b>faq_builder.pl</b> which transforms ASCII input into nicely formatted FAQ (Frequently Asked Questions) layout. 
§§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). 

§§ Features
<ul>
<li> Simply input, high quality output.
<li> Faq_builder can create as many indentation levels as needed.
<li> You can include HTML code into the ASCII text, like lists, line breaks, fonts.
<li> When regrouping questions, blocks are renumbered automagically.
<li> Changing indendatation levels is as easy as adding/removing a line of text. 
<li> You can add comments into your text which will not shine up later. Comments are lines beginning with '#'.
</ul>

§ How do I use faq_builder?
§§ 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<br>
 § Title1<br>
 §§ Sub title1.1<br>
 Here comes text for sub title1.1<br>
 Here comes text for sub title1.1<br>
 Here comes text for sub title1.1<br>
 §§ Sub title1.2<br>
 Here comes text for sub title1.2<br>
 § Title2<br>
 Here comes text for title2<br>
<br><br>

§§ Process ASCII stuff
Simply do a <br>
<pre> faq_builder.pl my_ASCII.txt  >my_HTML.html</pre>
and you get ready formatted HTML text. Using our input sample will
give you <br><br>


1. Title1<br>
&nbsp;&nbsp;1.1 Sub title1.1<br>
&nbsp;&nbsp;1.2 Sub title1.2<br>
2. Title2<br>
<br>
1. Title1<br>
1.1 Sub title1.1<br>
Here comes text for sub title1.1<br>
Here comes text for sub title1.1<br>
Here comes text for sub title1.1<br>
<br>
1.2 Sub title1.2<br>
Here comes text for sub title1.2<br><br>

2. Title2<br>
Here comes text for title2<br>

§ 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 
<a href="http://www.leb.net/pub/blinux/hacks/faq_builder.pl">http://www.leb.net/pub/blinux/hacks/faq_builder.pl</a><br>

§ Where can I see a FAQ formatted with <b>faq_builder</b>?
Check out <a href="http://leb.net/blinux/blinux-faq.html">http://leb.net/blinux/blinux-faq.html</a>
<br>

PS: This description was formatted using <b>faq_builder</b>


<br><br>
Enjoy!<br>
Hans <a href="mailto:hzo@goldfish.cube.net">&lt;hzo@goldfish.cube.net&gt;</a>