descriptionfree desktop feed aggregator
homepage URL
last changeSun, 10 Aug 2008 18:34:39 +0000 (10 20:34 +0200)
content tags

= Contents =

    * Introduction
    * Minimum Requirements
    * Installation
    * Notes on Installation
    * Notes on Translation
    * Notes on Configuring your Web Browser
    * Database Corruption: How to recover data
    * Database Conversion Problems ( for version 0.21.x and below ONLY )
    * Environment variables
    * Help?

=== Introduction ===

Straw is a desktop news aggregator for the GNOME environment. Its aim is to
be a faster, easier and more accessible way to read news and blogs than the
traditional browser.

=== Minimum Requirements ===

1. Python 2.4
2. Berkeley DB and their python bindings (pybsddb)
3. PyGTK 2.8+ (incl. extras which contains the gtkhtml2 module)
4. GConf

=== Installation ===

1. Make sure you have the required packages to run Straw

[]$ cd straw
[]$ python install_modules_check

2. Build the necessary files to run Straw

[]$ python build

3. Install

[]$ python install

... Or if you want to install straw in /usr/local..

[]$ python install --prefix=/usr/local

=== Notes on Installation ===

Straw installs files into three locations: 

1. The straw executable into a directory that should be in your $PATH, like
   '/usr/bin/' or '/usr/local/bin'.

2. A library directory to a location that should be in python's search path,
    like '/usr/lib/python2.X/site-packages' or '/usr/local/lib/python2.X/site-packages'.

3. And a data directory into a location that should be an architecture-neutral
    directory like it '/usr/share/' or '/usr/local/share'

If the library directory[2] isn't in your search path, or if you for some
reason installed it elsewhere, you should point the STRAW_LIB
environment variable at the directory under which the straw library
directory was created. 

=== Notes on Translation ===

(1) Updating the POT file

[]$ python translate --pot

(2) Merging LANGCODE.po with straw.pot

[]$ python translate --dist LANGCODE

(3) Merging translation with desktop file

[]$ python build_desktop

'python --help-commands' for more info.

=== Database Corruption: How to recover data ===

When you see following error ...

"Recovery Error: See README for details on how to recover data."

... run ...

[]$ db_recover -h $HOME/.straw -c -v
[]$ db_checkpoint -1 -v

... after which you can now restart straw and everything should be fine. 

If it still errors, read the last paragraph of the next section (... conversion problems)

=== Database conversion problems ( for version 0.21.x and below ONLY ) ===

The database format changed between Straw versions 0.21 and
0.22. Straw will automatically convert your database, but people have
experienced problems which we have been unable to trace.

If the conversion fails, you will be shown a dialog reporting the
problem. The exception will be saved to a file, the dialog will tell
you the name. You should see what's the problem; if it contains an
error telling you to run recover, you should try running db_recover on
the $HOME/.straw directory, like this:

$ db_recover -h $HOME/.straw -c -v
$ db_checkpoint -1 -v

However, this does not always help. If all else fails, you should
rescue your $HOME/.straw/config file and put it in a new, empty
$HOME/.straw directory. You will lose all the articles and images, but
your subscriptions will be safe.

We apologize for the inconvenience.

=== Environment variables ===

While most of Straw's configuration is stored in gconf and its own
configuration file, there are also some more developer-oriented
environment variables that modify Straw's behaviour.

STRAW_RELOAD_CSS: If defined, reload CSS every time an article is

STRAW_IN_SOURCE_DIR: Tell Straw it's running in the source directory,
                     so it knows where to look for dependencies.

=== Help? ===

1. Visit for mailing lists and reporting defects.
2. We have a channel in called #straw.
3. For more installation commands, run:

[]$ python --help-commands

- Straw Maintainers
2008-08-10 Paweł PaprotaRemove gtkmozembed view widget from the frame - workaro... master
2008-07-07 Paweł PaprotaCleaned up item view.origin/future
2008-07-07 Paweł PaprotaUse the new icon.
2008-06-08 Paweł PaprotaMerge commit 'origin/future'
2008-06-07 Paweł PaprotaImplemented "mark all as read".
2008-04-20 Paweł PaprotaLet's play it safe when restoring state in select_node.
2008-04-20 Paweł PaprotaMap space bar to scroll_unread_items (thanks estar).
2008-04-20 Paweł PaprotaMark displayed items as read (thanks estar).
2008-04-20 Paweł PaprotaLittle tweaks to item fetching.
2008-04-20 Paweł PaprotaAdded debug logging around document view creation.
2008-04-20 Paweł PaprotaDon't set main window size/position twice.
2008-04-20 Paweł PaprotaCleaned up the logging system a bit.
2008-04-20 Paweł PaprotaDisallow adding new categories under feeds. It's not...
2008-04-20 Paweł Paprota=?utf-8?q?Bug=20507683=20=E2=80=93=20Store=20applicatio...
2008-04-20 Paweł Paprota=?utf-8?q?Bug=20507683=20=E2=80=93=20Store=20applicatio...
2008-04-20 Paweł PaprotaNits.
11 years ago v0.27
10 years ago master
10 years ago future
11 years ago mob
Cached version (4343s old)
straw/fork.git Straw work fork 10 years ago