bconf2html.pl 

Copyright (c) 2006-2013 Robert James Clay
All Rights Reserved. This is free software;  you can redistribute
it and/or modify it under the same terms as Perl itself.

Perl script that creates an html page from a file resulting from the BBBS
command 'bbbs bconf' and an HTML template file.  Requires the HTML::Template
module.

Usage:  bconf2html.pl [-t Template] [-o HTMLDir] [-s StatsFile] [-f HTMLFileName] [-l LogFile] [-x] [-h]

Options:
    -t   HTML page template file.  Defaults to /opt/bbbs/work/bcnfhtml.tpl.
    -o   Directory where the resulting HTML file should be put.  Defaults to /opt/bbbs/work.
    -s   Path & filename for Stats file generated by 'BBBS BCONF' command. Defaults to /opt/bbbs/work/bconf.txt.
    -f   Filename for HTML file being created.
    -l   Path & filename of logfile.  Defaults to /opt/bbbs/logs/wwwadm.log.
    -x   Debug Mode
    -h   This Help

It is hosted at the FTN for Perl project at Sourceforge and the original code
for it can be browsed for in the SVN repository at:
 http://ftnpl.svn.sourceforge.net/viewvc/ftnpl/trunk/scripts/BBBS/bconfhtm/
The current code for it can be found at the GIT repository at the ftnapps
project at GitHub:  
http://github.com/ftnapps/bconfhtm.

Archives of it can be found in the Project file downloads section.  They can
also be found on any FTN system that carries the BBBSUTIL File Echo, which is
distributed via the Filegate (www.filegate.net). Or they can be obtained from
the downloads section of the bconfhtm repository at GitHub.com/ftnapps/bconfhtm.

The ftnpl-user or ftnpl-develop mailing lists are available from the project site;
however, the FTN echo BBBS.ENGLISH is the preferred avenue for support.

============================================================

Files
----------------
bconf2html.pl   Perl script that creates an html page from a file resulting
                from the BBBS command 'bbbs bconf'.

bcnfhtml.tpl    Example HTML Template file for the page to be created.

bconfhtm.sh     Example shell script.  Uses bconf2html.pl with parameters to
                create an html page from a file resulting from the BBBS
                command 'bbbs bconf'.  The variables should be modified as
                neccessary for your local setup.  

doc/TODO        What needs to be, or is being, worked on
Changes         Changes file

README          This file
FILE_ID.DIZ     Description of archive.

============================================================

Installation
----------------

1)  Unzip the archive to a temporary directory
    perl Makefile.PL
    make
    make install
2)  Move the bcnfthml.tpl to the /opt/bbbs/work directory
3)  Move the bconf2html.pl & bconfhtm.sh /opt/bbbs/scripts
4)  Make changes as neccessary to the template file
5)  Make changes as neccesary to the bconfhtm.sh script
6)  Add the running of the bconfhtm.sh script as a daily
    event to the BBBS crontab or to another daily script

==================================

Robert J. Clay, 1:120/546@fidonet
jame@users.sf.net, jame@rocasa.us
http://ftnpl.sourceforge.net
http://ftnapps.github.io/bconfhtm/index.html