Skip to content


Subversion checkout URL

You can clone with
Download ZIP
tree: a5507276e8
Fetching contributors…

Cannot retrieve contributors at this time

162 lines (108 sloc) 4.723 kB
Get Started Quickly With Karl
Karl requires PostgreSQL be installed on your system. If you are on OSX, this
is reported to work::
$ sudo port install postgresql90
$ sudo port install postgresql90-server
Link pg_config to a place that is in the path:
$ sudo ln -s /opt/local/lib/postgresql90/bin/pg_config /usr/local/bin/
Alternately, add /opt/local/lib/postgresql90/bin/ to your path.
Check out the buildout from github::
$ git clone git:// karl
$ cd karl
Create a virtual environment and run the buildout::
$ virtualenv -p python2.6 --no-site-packages .
$ bin/python
$ bin/buildout
Karl is now built and ready to run. Run Karl using Paste HTTP server in the
$ bin/karlserve serve
Alternatively, you can use Paster::
$ bin/paster serve etc/karlserve.ini
Visit the filesystem ZODB based test instance of Karl at::
Default login and password are admin/admin.
Create the user and database for the PostgreSQL/Relstroage based instance of
$ createuser -P karltest
(Enter 'test' for password. Repeat. Answer 'n' to next three questions.)
$ createdb -O karltest karltest
Visit the Relstorage instance at::
Later, if you want to blow away the database and start over::
$ dropdb karltest; createdb -O karltest karltest
Customization Packages
Both instances are 'vanilla' instances of Karl which do not use any
customization package. Most customers that are not OSI, going forward, will
not use any customization package. To make the pg instance use the 'osi'
customization package::
$ bin/karlserve settings set pg package osi
$ bin/karlserve serve (restart if already running)
To revert back to vanilla::
$ bin/karlserve settings remove pg package
Localization of date formats
Karl uses the Globalize javascript library to handle date formatting. It is
recommended that whenever you need to use a date in a Karl or customization
package template, you use Karl's globalize mechanism instead of formatting
the date in Python code.
To use gloablize, it's best to serve the date to the template in one of two
formats: 'dd/mm/yyyy' for dates and 'dd/mm/yyyy hh:mm:ss' for dates with
times. In the template, the date has to be by itself inside a tag and must
use one of the globalize classes:
- globalize-short-date:
MM/dd/yyyy (02/15/2012)
- globalize-long-date:
MMMM dd yyyy (February 15 2012)
- globalize-full-date:
dddd, MMMM dd yyyy HH:mm (Wednesday, February 15 2012 12:00)
- globalize-date-time:
M/d/yyyy HH:mm (2/15/2012 12:00)
- globalize-calendar-full:
dddd M/d (Wednesday 2/15)
- globalize-calendar-abbr:
ddd M/d (Wed 2/15)
- globalize-calendar-long:
dddd, MMMM d (Wednesday, February 15)
- globalize-calendar-list:
ddd, MMM d (Wed, Feb 15)
Globalize will convert the date to the proper format for the current
culture on page load. Default culture is en-US.
As an example::
<h3 class="globalize-long-date">02/15/2012</h3>
Will display an h3 title with the date 'February 15 2012'. The same date will
show up as '15 February 2012' if the user has 'europe' as date format default.
Users can pick their date formatting culture when editing their own profile.
Currently, the only options are US and Europe (uses en-GB). To set a
different default for the whole site use karlserve settings::
$ bin/karlserve settings set pg date_format en-GB
To hack on some source code::
$ bin/develop co karl
$ bin/buildout -No
Source code will now be in src/karl and src/karlserve.
When playing with the code it's usually very useful to have some sample
content added to the site, so that it looks a bit closer to a real site.
The karlserve command can be used for that::
$ bin/karlserve samplegen
Using this command 10 sample communities will be added to the site, each
with their own wikis, blogs, calendars and files.
The samplegen command does not create intranets, so they need to be added
manually if they are required. To do that visit your instance at:
Fill the form to add a community, making sure the 'intranets' checkbox is
selected. An 'intranets' tab will be visible on the community pages after
that, from which new intranets can be added.
If you need to work with versioning, you need to initialize the repository
before the versioning UI will show up. This is done with::
$ bin/karlserve init_repozitory pg
Jump to Line
Something went wrong with that request. Please try again.