What does a FAQ need?
- A table of contents listing the questions
- 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.