INTRO:
srini,
You don't know me, but I'm a long time visitor to
http://unamerican.com/. Over the years, I've learned a lot
from what you've written, and the truth is that it changed
my life for the better.
In gratitude for all your hard work and in respect of the
struggle that is your life, I'd like to present you with
this gift. It is the realization of truth #301 which
states:
I envision this - this is the spec.
you've got this document - the "truth"
as it were - and you invite commentary
on each and every single point in it.
every bullet point has "add comment" and
"read comments" hyperlinks. Ideally, the
"read comments" hyperlinks also indicate
how many comments have been added to
that particular truth.
INSTALLATION:
* Install the following Perl modules if you don't
have them already.
CGI::Application
HTML::Template
HTML::Parser
Bundle::DBI
DBD::mysql
$ perl -MCPAN -e 'install CGI::Application'
$ perl -MCPAN -e 'install HTML::Template'
$ perl -MCPAN -e 'install HTML::Parser'
$ perl -MCPAN -e 'install Bundle::DBI'
$ perl -MCPAN -e 'install DBD::mysql'
* Unarchive Unamerican-Truth-1.0?.tar.gz
$ tar zxvf Unamerican-Truth-1.0?.tar.gz
* Install Unamerican::Truth Perl module
$ cd Unamerican-Truth-1.0?
$ perl Makefile.PL
$ make
$ su
$ make install
* Create the truth database
$ mysqladmin create truth
* Create tables in that database by sourcing
the table definitions from sql/truth.sql
$ mysql truth
mysql> \. sql/truth.sql
* Populate the database with truths by
parsing truth1.htm and truth2.htm with a perl script.
$ bin/parse-truth.pl -d truth --user='srini' --password='s3cr37' \
truth1.htm truth2.htm
Be sure to specify a user and password pair that'll work
on your system.
* Copy everything in www/ to the directory that corresponds
to "
http://www.unamerican.com/truth/". For our example, we'll
assume that it's "/var/www/html/truth"
$ cp -R www/* /var/www/html/truth
* Modify your httpd.conf so that CGI scripts can be executed
from that directory.
# Unamerican::Truth
<Directory /var/www/html/truth>
Options +ExecCGI
AddHandler cgi-script cgi
</Directory>
* Edit truth.cgi so that @CONNECT has the right
information for connecting to the truth database.
You can also modify the following parameters:
proverbs_per_page number of proverbs on a page
is_numbered 1 to use an ordered list
0 to use a bulleted list
* Restart apache so that the changes to httpd.conf can
take effect.
$ apachectl restart
* Try to load "
http://www.unamerican.com/truth/truth.cgi"
and see if it works. If it doesn't, see what the
error_log says, and try to figure out what's wrong.
I recommend getting a sysadmin friend to help you out. If all else fails,
you can write to me at
[email protected], and I'll help you in whatever way
I can.