|Software||Tested versions||For Debian 4.0 “etch”||For Mac OS-X 10.4 with Fink 0.8.1|
||Download and install the stable release of
SWI-Prolog/XPCE for MacOS X 10.4 from
Unfortunately version 5.6.43 seems to require a newer version of libXft.2.dylib than that provided by Apple. With Darwinports it can be installed by
$ sudo port install xft2
Version 5.6.40 works out of the box.
|GNU sed||4.0.5, 4.1.5||Package sed||Fink package sed
GNU sed is required.
|sqlite3||3.2.8, 3.3.8||Package sqlite3||
Fink package sqlite3
|htpasswd||unspecified||Package apache2-utils||Comes with OS-X as
$ tar xzvf story.tgz
storydirectory to some place. Write access to the
storydirectory is not required. By default, the application assumes
storyis placed directly in your home directory. If another location is used, set the environment variable
STORYDIR, for example by a line like the following in
~/.storywith configuration files and stores for temporary data with the command
$ story/bin/install-story-skel.shThis command creates a password file
~/.story/passwdwith an entry for a single user of the Web server interface of the system. The user name is by default the value of
$USER, but can also be supplied as optional argument to
install-story-skel.sh. The password is prompted by
~/.story already exists, then
aborts without any effect.
Configuration settings are in
~/.story/config.pl. This file
can of course be manually adapted to specific needs.
places.sqlitehistory database files in the SQLite format generated by the Firefox 3 (Gran Paradiso) browser. The tested version is Firefox 3 (Gran Paradiso) Alpha 7.
places.sqlite file can be found
in your Firefox profile
folder, for example on Linux
~/.mozilla/firefox/xxxxxxxx.default/places.sqliteand on Mac OS-X
A small example of a places database is provided with the distribution as
History Time Span. Obviously, history databases are much more useful if the history spans longer time than the default 9 days (changed to 180 days in recent versions of Firefox 3). You can set this in the Firefox preferences: Edit -> Preferences -> Privacy: History, Remember visited pages for the last ... days.
Conversion from a Firefox 2 profile.
Since you might not want to use Firefox 3 regularly while in
alpha status, you can convert history data from a Firefox 2 profile
folder, by just invoking Firefox 3 once. The
file is then automatically generated, and you can
copy it from the Firefox profile folder to some other place.
To ensure that your Firefox profile folder is not permanently
affected by the one-time invocation of Firefox 3, you
can reconstruct it from a backup
after quitting Firefox 3, or you can run Firefox 3
as a different user with a copy of your original profile folder.
$ story/bin/story-server.shOptionally a port number can be given as argument to
story-server.sh. The default port is
~/.story/passwd. This is implemented with the
basicmethod of the HTTP authentication of the SWI-Prolog HTTP support library.
The server provides pages of four types:
A Control page allows to perform actions like loading places SQLite database files and changing configuration. It also shows information about the status of the system.
The server root points to a Control page.
The Searches page provides a kind of index or abstract of the entire history by just showing a choice of search terms of performed Google searches and associated date information. Visits are grouped into sessions, as specified with a Control page.
If there already is a browser window displaying the Searches page, this
window is re-used, effecting just a re-positioning in that window. Hence we
speak of the (instead of a) Searches page. This
is implemented with the HTML
Its upper part is like a Searches page, and its lower part like a Sessions page, but for all sessions in the entire history. The image shows the main differences to these page types.