SIXPACK - Bibliography and Reference Manager

by Sixten Boeck and Andre Merzky

modified by Michael Lachmann

Version 0.99 (=0.0.2)
Sorry I don't have time to make a nice, flashy web page. I spent already too much time on the coding this week. Maybe later.... ;)

Here's a link to the original SIXPACk web page





SIXPACK is a free BibTeX and Reference Manager designed to SIXPACK is under the GPL.
Here's the README file:


The current version is called 0.99, because the last one was called
0.98, and I didn't want any confusion to arise. But this is *ALPHA*
software. The only one who tested this latest version is me, and I made
a lot of changes! On a real scale, I would call this version 0.0.2.
So, backup your databases before you use it. Sixpack has no autosave
feature, but it creates backups of files it writes to.



1. bp (will be installed from bp-0.2.97.tar.gz )
2. Perl/Tk (you'll have to do this yourself)
3. wget (if you want to be able to directly import from the web)

you have two options - automatic and manually.

1. edit "install" and check that all is defined well
2. run (as root if you are installing globally)
   if you want to install both bp and sixpack:
     ./install with-bp
   or, if you want to install sixpack only
0. install bp
1. edit bib, and set the correct path for perl
2. copy the file bib to somewhere in your path.
3. copy the Directory Pict somewhere. You will have to set the configuration
   variable PICSDIR to that in sixpack.rc
4. (optional) If you need a specialised configuration (for example setting
   PICSDIR to something other than /usr/local/lib/sixpack/Pics), then copy
   the file sixpack.rc either to /etc/sixpack.rc or to ~/.sixpack.rc and edit
   it appropriately.

For the command-line interface, if you use vim, you could also install the
vim style file biblio.vim in the appropriate place


bib [-gui] [-sixtex=file.bref] [-bibtex=file.bib]

-gui          Use graphical interface
-sixtex=file  load database from file
-bibtex=file  import database from bibtex file

In the configuration file (sixpack.rc) the following variables are
recognised: (all have default values, and thus aren't necessary)

WC = /usr/bin/wc
AWK = /usr/bin/awk
CAT = /bin/cat
TMP = /tmp/
CONV = /usr/local/bin/bibconv
DATE = /bin/date
EDIT = /usr/bin/vim -f
GREP = /bin/grep
LESS = /usr/bin/less
MV = /bin/mv
RM = /bin/rm
# if wget is defined, then import from URL is possible
WGET = /usr/bin/wget
PICSDIR = /usr/local/lib/sixpack/Pics

PAPERS = ~/papers    # This variable holds the directory in which the raw
                     # papers are stored

BPHOME = /usr/local/lib/bp    # place where BP is installed. This will be
                              # overridden by the BPHOME environment
                              # variable, if defined

# TMP = /tmp/dirktest  # temporary file prefix - if not set it will default
                       # to /tmp/$USER

If a reference entry contains a line file=filename in its bibtex file,
then this line will show up under the 'Misc' entry in the dialog. By pressing
alt-v, or the leftmost icon, the file will be shown for viewing. You can
define handlers for various extensions. The variable
MISCHANDLE = /bin/echo no handler for file %s

holds the action to be done for an unrecognised type.

To define a handler for an extension, add a variable with the name
EXHANDLE.ext as in:

EXTHANDLE.pdf = xpdf = gv = zcat %s | gv -
EXTHANDLE.tar.gz = view_article
EXTHANDLE.dvi = xdvi
EXTHANDLE.html = netscape-remote -remote "openFILE(%s)"

the special string %s will be replaced by the filename. Otherwise the
filename will be appended at the end.

If an entry contains a line
Then the url can be accessed. You can define the url handler:
URLHANDLE = netscape-remote -remote "openURL(%s)"

If you now view the file, the program will first try to open the file, and then
try the url. You can also open the url directly from the menu.

User Interface


up, down, pageUp, pageDown, end, home
                           - move in the entry list

shift-up, shift-down,
alt-up, alt-down         - move to next marked entry

alt-enter                 - start editing current entry

alt-o                     - open file
alt-s                     - save file
alt-x                     - exit (if no modification to current database)
                             To exit when the database is modified, use the

alt-insert                - insert new entry

alt-delete                - delete current entry, or marked entries, if any
                             are marked!!

alt-+                     - mark entry
                 (this can also be done with the left mouse button)

alt--                     - unmark entry
alt-a                     - mark all
alt-u                     - unmark all

alt-v                     - view article, entry has a line of the form


rolodex | clamp   | pencil| hammer| box   |binoc. |screen|letter | signs  | book |
open    | new     | new   | edit  | delete|open   |open  |sort by| sort by| view |
database| database| entry | entry | entry |query  |exec  |author | title  | file |
        |         |       |       |       |window |window|       |        |      |
you can do pretty sophisticated searches:

select all entries with authors whose name includes "smith"
select all entries with titles that include "group"
Now you defined queries 0 and you, and you can do
#0 or #1
You can open the query window from the 'View' menu.

You could also have done
au=smith or ti=group

The full list of all names of fields is available under the 'Query' menu.

Under the 'Query' menu you'll also see an entry 'store current marks' (which
is equivalent to the command-line 'mark') . Using
this entry you can save the currently marked fields.
For example, you could import a new database. This marks all the imported
entries. Store the current marks. Now in the query window, you'll see
that entry #0 is 'mark'. Now you can do searches only on the new entries:
au=smith and #0

The button third from the right (ignoring the 4 arrows) sorts by author,
and the one left of it by title. You can also select sorts from the 'Edit'
menu. Between sorts, the data isn't re-shuffled, so if you want to sort by
year, and within the year by author do:
1. sort by author
2. sort by year
(sadly sort by author sorts by the first name....)

The special command "mark double CITEIDs" will sort by CITEID, and mark all
entries that occur twice.

In order to change an entry, you have to open it for editing, edit it, and
then lock it. So do the following:
1. Select the entry
2. hit alt-enter
3. Edit the entry to your hearts content
4. hit alt-enter

Instead of 2 and 4 you cane also use the 4th button from the left, the one
with the tools which changes to a lock once you start editing.

You can see in the 'Transfer' menu the various formats that sixpack
(actually, bp) supports. Just select import/export, and enter the filename.

If the configuration variable WGET is set to the path of wget, then
importing from a url is possible.

Just select the url (in netscape there is an option under the right-click
menu to 'copy link location), and then paste it in. (paste is also possible
with the 'insert' keyboard button).

for problems and comments, please email Michael Lachmann:

last modified: March 1, 2000