htnews sample config
====================


Install htnews as described in ../README.

Add an alias to /etc/aliases:
sample-htnews: "|/usr/sbin/htnews -c /tmp/htnews/htnews.conf"

Create a directory "htnews" in /tmp (/tmp/htnews).

Copy all the filez here to the new location.

Edit /tmp/htnews/htnews.conf if you wish.

Send a mail to "sample-htnews@yoursite".

See, what response you receive. If it was a "good" response,
i.e. "htnews item inserted..." then it seems to run fine.
If you receive an error-mail, then read carefully the mail.
Try to resolve the problem (in most cases a permission-
problem), read the documentation and read the F.A.Q.

Try it again.

If all is ok, point your webbrowser to "file:/tmp/htnews/index.html"
and take a look to the result. If you installed the sample
on a remote machine, where you cannot access the local filesystem
with your browser, then simply copy the *.html files to a 
directory, where it is possible, i.e. "/home/httpd/www/sample/".

If you understand the functionality and the principles of htnews
and the configuration, then now you can go up to the final installation
on your site. It is a good idea to install it based on the sample-config.



Questions
---------

If you encounter problems, and if you allready read all the provided
documentation, and if that all did not help you, then write a mail
to me (tom@daemon.de). I will see, if I can help you. If you send a
mail to me, it would be good to have the whole config and the error-
messages you received.
So - please save the error-message(s) to a file in the same directory
/tmp/htnews/ and then pack it:
cd /tmp; tar cpz -f htnews-sample-yoursitename.tar.gz htnews
The tar.gz will be in /tmp. Attach it to your mail to me.



Updated informations are available at http://htnews.org.
