PUBLISH(1)

NAME
publish - A Bibliographic Reference System

SYNOPSIS
publish <command> [command/global option]... [filename]

DESCRIPTION
The publish command provides a command-line interface to the Publish Bibliographic Reference System.

COMMANDS

import [option]... <filename>
    Imports papers from given file and saves valid papers to a database. Invalid papers will be saved to a separate file and may be imported again after they have been corrected. Options may be given to adjust specific attributes of imported papers.

    Options:

    attribute=value
        Marks imported papers with given attribute and value,
        for example year=2002, department=SC, category=books,
        status=submitted etc.

    Several attributes may be set at the same time, as illustrated by the following example:

    publish import year=2002 status=submitted papers.bib

validate [option]... [filename]
    Validates papers saved in the database, or, if a filename is given, all papers found in the given file (only pub format supported). At the end of the validation, all valid papers will be stored back into the database and invalid papers will be stored to a separate file.

export [option]... <filename>
    Exports papers to the given file. Options may be given to filter out a subset of the papers stored in the database.

    Options:

    attribute=value
        Filters out all papers that match the given attribute and value,
        for example year=2002, department=SC, category=books, etc.

    attribute!=value
        Filters out all papers not matching the given attribute and
        value, for example year!=2007, category!=talks etc.

    view_pdf=no
        Don't display generated PDF files when exporting to PDF.

    pdf_viewer=<command>
        Specify command that should be used to display PDF files.

GLOBAL OPTIONS

debug=yes
    Enable debugging output. With this option, Python exceptions are not caught, resulting in a full Traceback on errors.

autofix=yes
    Automatically choose the default option when an error is encountered. This is useful (but dangerous) when importing large amounts of data into the database.

-h, --help
    Display a short help text.

-v, --version
    Display version information.

SUPPORTED FILE FORMATS

    Publish accepts several file formats for input and output.

    The following input formats are supported:
        pub (internal format)
        BibTeX

    The following output formats are supported:
        pub (internal format)
        BibTeX
        LaTeX
        PDF

    The file format is automatically deduced from the file suffix:
        .pub    --> pub
        .bib    --> BibTeX
        .bibtex --> BibTeX
        .tex    --> LaTeX
        .pdf    --> PDF

FILES

papers.pub
    This file is the default database file and contains all imported papers.

papers.pub.bak
    This file stores a backup of the database file and is generated automatically each time the database is updated.

venues.list
    This file contains new venues that have been added during validation.

AUTHOR
Written by Anna Logg <anna@loggsystems.se>, Logg Systems.

Copyright (C) 2008 Anna Logg. Free use of this software is granted under the terms of the GNU General Public License (GPL) version 3 or any later version.