htnews 0.6.7 Frequently Asked Questions |
Table of Contents1. Introduction
1.1. What is htnews?htnews is a mail-robot. That means, one can send an email to a special e-mail address and htnews will take this mail and parses the containing stuff. htnews creates one news item per incoming mail. A new item will be inserted to a webpage to the top of the page. The page will be created based on a template file and on various switches in the config-file.htnews can, if you like, store only the N recent messages on a "front page" and the older ones to a archiv-page.
1.2. Where can I get it?
1.3. Features of htnews
1.4. Is there more documentation available?Yes, of course! There is a manpage available, which you can read using the command man htnews. It describes the configuration and troubleshooting of the program.There are some additional files available, a README and a FAQ (which you are reading currently). You can view these files via the htnews website too (htnews.org).
1.5. Is there a mailinglist available?Now a Mailinglist for htnews is also available! Subscribe to the list if you want to receive updates or want to get help or contact to other htnews-users or the developers. TO subscribe, simply send a message with the following text in the body:subscribe htnews to majordomo@daemon.de. To send a posting to the list, send it to htnews@daemon.de. Additionally, there is an archive of the mailinglist available: http://htnews.org/list.
2.1. Do I have to do something before compiling?Normally not. The provided script configure ckecks all dependencies and configuration parameters required in order to successful compile htnews.Anyway, you can modify many parameters, or predefine them. Issue the command ./configure --help to get more informations. You have to make sure, sendmail is installed. Htnews needs it to send out the notification messages and error messages.
2.2. How do I complie htnews?issue the following commands in the same order:
2.3. I am having problems understanding the configuration of htnews!Within the source distribution you will find a directory called sample. There is a README. Follow exactly the intructions there and play with the configuration.
2.4. What I need to do, if I downloaded the binary package?You have only to issue the command make install. That's all. If you encounter problems during installation of the binary package, I recommend you to use the sources and to compile them in order to get properly working binaries.
3.1. I am getting the error "user not found" from sendmail.This happens mostly, if you have edited the "aliases" file, but you did not issue the command newaliases, which will build a database from aliases, this is required for sendmail.
Try to aktivate your changes to aliases with this command and then try to send an email to htnews.
3.2. I am getting an error like "unknown mailer error..." from sendmail.If this happens, something really strange error has occured. Such a "unknown mailer error" occurs mostly, if sendmail did not know, what to do.In our case it happens, when htnews exits with an error-code other than 0! I.e. -1 will have this error as a result.
But, why? At first note, that htnews never exits with an other exit-code than 0! But htnews calls some external programs, i.e. sendmail. If the location of sendmail could not be found or something else went wrong, then the "shell" or sendmail itself will exit with -1.
3.3. I am getting an error mail back from htnews!If you get an error message back from htnews, then you will know, what was wrong, if you read the error message.In most cases htnews could not read or write a file, or the user made a mistake or was not allowed to use htnews(if the authentication feature is turned on). Additionally htnews sends back an error message, if the subjectline was empty and if the body itself was empty!
3.4. Why htnews cannot write to my output page?Normaly htnews will create this file, if it not exist. But, of course, it is only possible to create a file, if the user running htnews (sendmail, mostly daemon or root), has write and execute access to the directory, where the file will go.Take also a look to the permissions of the directories where the file is located.
3.5. How can I test htnews from commandline?In the source directory you will find a file called fake.mail. Change to the source directoy and issue the following command:"cat textfile | htnews -c /where/ever/the/configfile/is/htnews.conf". Now see, what hapens.
3.6. Config has changed, how to update the output file?Write a mail to htnews with the term "refresh" in the subject. You must be the person defiined in the configfile as the admin to be allowed to do this, otherwise you will get an error-mail!
3.7. How is it possible to run htnews without sendmail?You can successfull install htnews without root permissions on a system. You need at least a mail account and a homedirectory with a shell.You have to use procmail to filter incoming mails. Procmail will based on your filter pipe the message to htnews - the rest will work like it should be :-) Add the following line to your .procmailrc: :0: * 2147483647^1 htnews@yoursite "|/home/you/bin/htnews -c /home/you/htnews.conf" If you want to use it with exim you can use /etc/aliases as well, but you have to allow the exim-user the right to execute external commands: address_pipe: driver = pipe user =It is also possible to use qmail with htnews. Please refer to the documentations of these programs to learn more about how to pipe a message to an external program.
|
this page was generated using the faq-system 0.3.5 by Thomas Linden. Copyright © 1999 Thomas Linden |