blog

What does a FAQ need?

1. A table of contents listing the questions
2. A way to hyperlink the question

Unfortunately most FAQs seem to fail to do this. To save you time doing this by hand, I highly recommend anolis

FAQ template, faq.src.html:

<h2 class="no-toc no-num">Frequently Asked Questions</h2>
<div id="tocwrapper"><!-- toc --></div>

<h3>How do I create a FAQ?</h3>
<p>Using HTML</p>

<h3>What's the best kiosk software out there?</h3>
<p><a href="http://webconverger.com">Webconverger</a></p>

Run anolis faq.src.html faq.html and boom:

<h2 class="no-toc no-num">Frequently Asked Questions</h2>
<div id=tocwrapper>
<!--begin-toc-->
<ol class=toc>
 <li><a href=#how-do-i-create-a-faq?><span class=secno>1 </span>How do I create a FAQ?</a></li>
 <li><a href="#what's-the-best-kiosk-software-out-there?"><span class=secno>2 </span>What's the best kiosk software out there?</a></li></ol>
<!--end-toc--></div>

<h3 id=how-do-i-create-a-faq?><span class=secno>1 </span>How do I create a FAQ?</h3>
<p>Using HTML</p>

<h3 id="what's-the-best-kiosk-software-out-there?"><span class=secno>2 </span>What's the best kiosk software out there?</h3>
<p><a href=http://webconverger.com>Webconverger</a></p>

Job done. Here is a better example FAQ

Here is Makefile I use a lot on my Websites:

INFILES = $(shell find . -name "*.src.html")
OUTFILES = $(INFILES:.src.html=.html)
TEMP:= $(shell mktemp -u /tmp/web.XXXXXX)

all: $(OUTFILES)

%.html: %.src.html
    m4 -PEIinc $< > $(TEMP)
    anolis $(TEMP) $@
    rm -f $(TEMP)

clean:
    rm -f $(OUTFILES)

PHONY: all clean

After installing Apache 2.4 in /usr/local/apache2/, I struggled to get my VirtualHost setup going.

After plonking in at conf/extra/virtual.conf:

<VirtualHost 127.0.0.1:80>
UseCanonicalName    Off
VirtualDocumentRoot /srv/www/%0
Options All ExecCGI FollowSymLinks +Includes
</VirtualHost>

Then enabling LoadModule vhost_alias_module modules/mod_vhost_alias.so and restarting the httpd, I kept getting these messages:

AH01630: client denied by server configuration: /srv/www/webconverger/

Turns out there seems to be a new permission model, whereby this policy:

<Directory />
    AllowOverride none
    Require all denied
</Directory>

Stops access to /srv/www. To alleviate this, after that “deny all” stanza above you add the exception:

<Directory "/srv/www">
Options All
AllowOverride All
Require all granted
</Directory>

Read the Access Control bit in the caniocial Apache httpd documentation for more.