75 lines
2.6 KiB
Plaintext
75 lines
2.6 KiB
Plaintext
|
-*- kwotes install instructions -*-
|
||
|
|
|
||
|
|
Thanks for trying kwotes. Please forgive how slim this
|
||
|
|
INSTALL file is... at least there is one :)
|
||
|
|
|
||
|
|
WHAT YOU NEED:
|
||
|
|
--------------------------------------------------------------------------------------
|
||
|
|
CGI/Perl enabled web server
|
||
|
|
Mysql
|
||
|
|
DBI
|
||
|
|
DBD::Mysql
|
||
|
|
|
||
|
|
INSTALLING DBI and DBD:Mysql:
|
||
|
|
--------------------------------------------------------------------------------------
|
||
|
|
At a console:
|
||
|
|
|
||
|
|
perl -MCPAN -eshell
|
||
|
|
|
||
|
|
In the CPAN console:
|
||
|
|
|
||
|
|
install Bundle::DBI
|
||
|
|
install DBD::mysql
|
||
|
|
|
||
|
|
|
||
|
|
EXTRACTING THE TARBALL:
|
||
|
|
--------------------------------------------------------------------------------------
|
||
|
|
tar -zxvf kwotes.tar.gz
|
||
|
|
|
||
|
|
SETTING UP THE DATABASE:
|
||
|
|
--------------------------------------------------------------------------------------
|
||
|
|
Add the required kwotes tables to the database (in the directory where you
|
||
|
|
extracted kwotes):
|
||
|
|
|
||
|
|
mysql -u database_user -D database_name -h database_host_name -p < kwotes.sql
|
||
|
|
|
||
|
|
CONFIGURING KWOTES:
|
||
|
|
--------------------------------------------------------------------------------------
|
||
|
|
Open kwotes.conf.pl in your favorite text editor and modify as needed. The
|
||
|
|
only values that you MUST change are in the database section. They are:
|
||
|
|
|
||
|
|
$DB_TYPE - the database type (Must be mysql for now)
|
||
|
|
$DB_NAME - the name of the database on the database server
|
||
|
|
$DB_HOST - the hostname or ip address of the database server
|
||
|
|
$DB_USER - the username for connecting to the database
|
||
|
|
$DB_PASS - the password for connecting to the database
|
||
|
|
|
||
|
|
Other options that are cool for tweaking the functionality of kwotes can be
|
||
|
|
found in the "GENERAL STUFF" section of the configuration file.
|
||
|
|
|
||
|
|
SETTING PERMISSIONS:
|
||
|
|
--------------------------------------------------------------------------------------
|
||
|
|
Setting everything to 755 (rwxr-xr-x) doesn't hurt:
|
||
|
|
|
||
|
|
cd kwotes-directory;
|
||
|
|
chmod -R 755 *
|
||
|
|
|
||
|
|
You can come up with something more restrictive if you like.
|
||
|
|
|
||
|
|
CUSTOMIZING:
|
||
|
|
--------------------------------------------------------------------------------------
|
||
|
|
Kwotes can be easily customized by editing the files in the "html" directory
|
||
|
|
directly beneeth the kwotes directory. You can change the "site name" and
|
||
|
|
tagline (text that apears at the top of every page) by editing kwotes.conf.pl
|
||
|
|
|
||
|
|
FEEDBACK:
|
||
|
|
--------------------------------------------------------------------------------------
|
||
|
|
"It's broken you mofos!":
|
||
|
|
sux0r, well... submit a bug report at:
|
||
|
|
http://sourceforge.net/tracker/?atid=690836&group_id=121598&func=browse
|
||
|
|
|
||
|
|
"Hey, you should implement [insert your idea here]!"
|
||
|
|
sweet, submit a feature request here, and we'll see what we can do:
|
||
|
|
http://sourceforge.net/tracker/?group_id=121598&atid=690839
|
||
|
|
|