The rewrite directives in question are located in the .htaccess file in the root directory of the install (www, not setup):
RewriteRule ^setup/(.*)$ setup/$1 [L]
RewriteRule ^(.*)$ citiwiki.php?wakka=$1 [QSA,L]
There are some other ones, but they don't appear to be relevant to the wiki. The first one can be omitted and the install will still succeed, but the last one is critical to the usage of the wiki. If you're using Apache, you can compile the source with --enable-module=rewrite to enable mod_rewrite.
You must then create a new .htpasswd file in the www directory, with an admin user named 'wiki' (which is referenced by the /www/setup/.htaccess file):
htpasswd -c <install dir>/www/.htpasswd wiki
It will prompt you for a password.
After running the install, you must edit the _sites table and set the 'htpasswdfile' field to point to the file you created before. If you don't do this, you will get an error when trying to log in.
To enable the default stylesheet, set the 'default_css_page' field in the _sites table to 'WikiCssDefault'.
-- Riggs, 2004-05-18
I was able to get through the CitiWIki installation process, but I am having trouble logging in. It appears the login.php script is being called with the username, password, and filename (which I assume should be the .htpasswd file), but the filename variable is blank.
I really like this php-based Wiki (especially the built-in CSS control), but I am not able to install it on my server, which is not configured with mod_rewrite - and I don't have privs to modify the modules configuration
Perhaps you should explicitly say in the SourceCode page that mod_rewrite must be installed for CitiWiki to work. Is there no workaround for using it without the rewrite module?
-- DarTar, 2004-03-09, earlier
OK, I've found a server with mod_rewrite, but I' having a problem similar to Luhmann. I've tried to modify the RewriteRules, but it still doesn't work - I didn't have time to look more carefully at the code (I'll do it as soon as possible).
Without the RewriteRules in the .htaccess file I manage at least to open the startpage of my test wiki (citiwiki.php?wakka=main) but the CSS are absent (probably because of a relative/absolute URL coding) and no link works.
I suggest you add some detailed instruction in the SourceCode page (like the Help Pages at WakkaWiki): I tried to understand how to edit the fields in the _sites table but without having a good documentation it is really hard!
-- DarTar, 2004-03-09, later
Glad to see the source code! Unfortunately, I quickly ran into difficulty:
- No problem downloading, setting up MySQL DB, importing, and launching /setup.
- However, I don't understand what a .htpassword file is. There doesn't seem to be one to edit. Do I need to create this? I'm running on localhost right now, so nobody else has access, but I'd like to better understand this.
- My big problem was after running setup. My installation looks like this:
http://localhost/~user/citiwiki/
but after naming my wiki in setup, it tried to look in a nonexistant directory:
http://localhost/~user/citiwiki/citiwiki/
So I don't seem to be able to find the root directory of my wiki!
- Then when I go to the root level, it automatically tries to load another non-existant page.
http://localhost/~user/citiwiki/wakka.php
and if I try to tell it to go to this page:
http://localhost/~user/citiwiki/citiwiki.php
I get this error:
--Luhmann, March 7, 2004
Do you have the mod_rewrite in your PHP?
--LaiHoKwan
Yes.
-- Luhmann
Hello,
Thank you for this wiki !
I have a problem not in the installation but in editing. It asks me to log in for editing the mainpage or citiwikidefaultcss. So I can't do anything. Thank you for answering !
-- bak