Here a example how to setup PyLucid using apache + mod_rewite + fastCGI.

Note: All guides used the same directory structure.

↑ prepare  #

• First you must create a PyLucid environment with PyLucid-boot.
• You must have the python flup packages installed.

↑ setup page instance  #

We create a "page instance" in /var/www/YourSite and use the PyLucid installation from /home/FooBar/PyLucid_env/.

Copy fastCGI dispatcher and .htaccess files:

1
2

/home/FooBar$ cp scripts/fcgi_scripts/index.fcgi /var/www/YourSite/
/home/FooBar$ cp scripts/fcgi_scripts/default.htaccess /var/www/YourSite/.htaccess

Please edit /var/www/YourSite/.htaccess: In some cases you must activate the suitable AddHandler line.

make .fcgi file executable:

1

/home/FooBar$ chmod +x /var/www/YourSite/index.fcgi

↑ edit .fcgi file  #

You must change the path to your created environment in the .fcgi dispatcher file. Edit /var/www/YourSite/index.fcgi and change this part:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

...
#####################################################################################################
# CHANGE THIS PATH:
#
# The absolute filesystem path to ...PyLucid_env/bin/activate_this.py
#
os.environ["VIRTUALENV_FILE"] = "/home/FooBar/PyLucid_env/bin/activate_this.py"
#
#####################################################################################################
...

↑ static media files  #

Copy PyLucid and django static media files:

1
2
3
4
5

/home/FooBar$ mkdir -p /var/www/YourSite/media/django/
/home/FooBar$ mkdir -p /var/www/YourSite/media/PyLucid/

/home/FooBar$ cp -r PyLucid_env/src/django/django/contrib/admin/media/* /var/www/YourSite/media/django/
/home/FooBar$ cp -r PyLucid_env/src/pylucid/pylucid_project/media/* /var/www/YourSite/media/

more info: about static media files

↑ setup CLI tool 'manage.py'  #

copy 'manage.py' into your page instance:

1

/home/FooBar$ cp PyLucid_env/src/pylucid/scripts/manage.py /var/www/YourSite/

edit the file /var/www/YourSite/manage.py and change the ROOT_DIR to /home/FooBar/PyLucid_env/

↑ create local_settings.py  #

To set own settings variable, you should create:

• /var/www/YourSite/local_settings.py

You must set this into your local_settings.py:

1
2
3

MEDIA_ROOT = "/var/www/YourSite/media/"
MEDIA_URL = "/media/"
ADMIN_MEDIA_PREFIX = "/media/django/"

Note:

• This two path are in default .htaccess in the mod rewrite exception list.
• You will get JS errors, if pylucid media files can't be loaded.

(see also: a complete local_settings.py example)

↑ syncdb  #

To create all database tables run syncdb:

1

/var/www/YourSite$ ./manage.py syncdb

↑ insert the initial data  #

1

/var/www/YourSite$ ./manage.py loaddata pylucid.json

You must get something like this output:

Installing json fixture 'pylucid' from 'PyLucid_env/src/pylucid/pylucid_project/apps/pylucid_admin/fixtures'.
Installed 159 object(s) from 1 fixture(s)

If you didn't see similar output, something went wrong!

↑ setup site  #

Goto:

• Django admin site / Sites / Sites

change the "example.com" to your domain name.

↑ "install"  #

Select from menu these links:

• PyLucid admin menu / PyLucid install / PyLucid install
• PyLucid admin menu / PyLucid install / install PyLucid plugins

↑ vhost example  #

1
2
3

<VirtualHost YourSite1.tld>
  DocumentRoot /var/www/YourSite
</VirtualHost>

↑ setup .htaccess  #

A complete example can you found in /scripts/fcgi_scripts/default.htaccess

You must change the path to virtualenv in the line with "VIRTUALENV_FILE".

minimal .htaccess example:

1
2
3
4

RewriteEngine On
RewriteRule ^media - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.fcgi/$1 [QSA,L]