Setting up Geeklog on Mac OS X
Wednesday, March 02 2005 @ 04:02 PM EST
Contributed by: Admin
Here's my guide to setting up Geeklog (1.3.11) on Mac OS X (non-Server, OS X 10.3.7). It's a bit thin but it hits all the high points. Consider this an OS X-specific 'cheat-sheet' addition to the mostly excellent included documentation.
Download and install PHP
You will see the following files:
-rw-r--r-- 1 admin staff 198 31 Dec 11:03 INSTALL
drwxr-xr-x 3 admin staff 102 31 Dec 11:03 backups
-rw-r--r-- 1 admin staff 35242 31 Dec 11:03 config.php
drwxr-xr-x 3 admin staff 102 31 Dec 11:03 data
-rwxr-xr-x 1 admin staff 509 31 Dec 11:03 emailgeeklogstories
drwxr-xr-x 40 admin staff 1360 31 Dec 11:03 language
drwxr-xr-x 4 admin staff 136 31 Dec 11:03 logs
drwxr-xr-x 6 admin staff 204 31 Dec 11:03 plugins
drwxr-xr-x 27 admin staff 918 31 Dec 11:03 public_html
-rw-r--r-- 1 admin staff 4018 31 Dec 11:03 readme
drwxr-xr-x 4 admin staff 136 31 Dec 11:03 sql
drwxr-xr-x 15 admin staff 510 31 Dec 11:03 system
Move the contents of 'public_html' into ~/Sites/ or /Library/WebServer/Documents/. (The rest of these notes assume you're serving from your home directory.)
Move rest into new directory like ~/geeklog-admin/
Part 1: Database Setup
Using phpMyAdmin, create a new empty database called 'geeklog'
Part 2: filesystem setup
- cd ~/geeklog-admin/
chmod -R 777 logs
chmod -R 777 data
cp config.php config.php.orig
edit config.php as needed: paths, etc.
- cd ~/Sites/
chmod 777 backend/geeklog.rdf
chmod 777 images/userphotos/
chmod 777 images/articles/
Part 3: docroot files
Edit lib-common.php--skip down to around line 70 and specify the path to config.php.
Part 4: web-based setup
Oops! If you're doing this in OS X 10.3, the site probably isn't working.
You probably just saw a message saying
"An SQL error has occured. Please see error.log for details."
As per http://lists.geeklog.net/pipermail/geeklog-users/2004-February/000810.html,
change line ~488 in ~/geeklog-admin/config-php around to
$_CONF['hidenewcomments'] = 1;
Part 5: Final steps
Filesystem: delete ~/Sites/admin/install/
Accounts: set new passwords for admin & moderator
- change password and email with 'account information' link
- log in and log out to make sure new info sticks
Part 6: Cleanup
Log in as admin
delete submissions (2) and stories (1) and links (1) and polls (1)
Blocks: season to taste
Download themes and unzip into ~/tmp/
My favorite theme--the one you're looking at now--is called 'clean.' I have slightly customized it. How? I'm glad you asked...
(Note that, UNIX-wise, they may not be the cleanest commands ever, but they work.)
cp -r tmp/layout/clean/* ~/Sites/layout/your-theme-name/
Change theme name (around line 200 of config.php) to your-theme-name
New logo: ~/Sites/layout/apple/theme-images/clean-sitelogo.gif
New topic icons: 48x48, copy to ~/Sites/images/topics/ or icons/