KBibTeX

Package Maintainers

… or anyone who wants to compile from source. The current stable release is 0.4, released on 2011-Nov-24.
Download kbibtex-0.4.tar.bz2 and verify your download using the checksums and signatures: .asc, .sha1, .sha1.asc (used GnuPG-key)
On 2012-May-05, a release candidate for version 0.4.1 has been released. For details, see the separate news release. Download the release candidates sources here: kbibtex-0.4.1-rc1.tar.bz2 and verify your download using the checksums and signatures: .asc, .sha1, .sha1.asc

Developers

… or anyone who wants to find bugs and use bleeding edge features.
You can fetch the most recent development version via Subversion (browse repository, track changes) to stay up-to-date.

Directory trunk contains the development code having all those unstable new features. Directory branches/0.4 contains bugfixes for the 0.4 release and will be base for version 0.4.1.

Compiling the Code

Go into the directory, where you extracted to or checked out KBibTeX, i. e. where the directory kbibtex (or alike) is located. Inside, create a new directory called build, and go into this directory. Run the build toolchain as follows (everything in one line):

cmake ../ -DCMAKE_INSTALL_PREFIX=KDEDIR -DCMAKE_BUILD_TYPE=BUILD_TYPE && make

where KDEDIR is the location of your KDE installation, e. g. /usr. Other directories such as /usr/local will not work. BUILD_TYPE is either debugfull (if you want to develop or trace bugs) or release (if you just want to use KBibTeX).

Installation

KBibTeX uses KDE 4's KParts technology, which requires you to install some libraries. Only after a complete installation steps you will be able to start KBibTeX successfully.

There are two ways of installing KBibTeX: you can either copy all files into your system's file system or use symbolic links to point to the extracted and compiled sources (see box below).

The easiest way to install KBibTeX (although it may taint your distribution's installation) is to run

make install

as root or with sudo.

Symbolic Links

Instead of running make install, you can use symbolic links (ln -s) to link all essential files into your KDE home directory or to your KDE installation. In the table on the right, interprete the variables as follows:

SOURCE
Extracted directory, where directories like src or xslt are located.
BUILD
The directory where you built KBibTeX, such as the build directory as described above.
INSTALL
Where you link KBibTeX to. Should be either the directory of the KDE installation (usually /usr, preferred but requires su or sudo) or the KDE directory in your home (~/.kde4).

Mapping Files to their Destination

File to linkLink to
SOURCE/config/biblatex.kbstyleINSTALL/share/apps/kbibtex/biblatex.kbstyle
SOURCE/config/bibtex.kbstyleINSTALL/share/apps/kbibtex/bibtex.kbstyle
SOURCE/config/kbibtexrcINSTALL/share/config/kbibtexrc
SOURCE/mime/bibliography.xmlINSTALL/share/mime/packages/bibliography.xml
SOURCE/src/gui/bibtex/findduplicatesui.rcINSTALL/share/apps/kbibtex/findduplicatesui.rc
SOURCE/src/parts/kbibtexpart.desktopINSTALL/share/kde4/services/kbibtexpart.desktop
SOURCE/src/parts/kbibtexpartui.rcINSTALL/share/apps/kbibtexpart/kbibtexpartui.rc
SOURCE/src/processing/lyx.rcINSTALL/share/apps/kbibtex/lyx.rc
SOURCE/src/program/kbibtex.desktopINSTALL/share/applications/kde4/kbibtex.desktop
SOURCE/src/program/kbibtexui.rcINSTALL/share/apps/kbibtex/kbibtexui.rc
SOURCE/xslt/arxiv2bibtex.xslINSTALL/share/apps/kbibtex/arxiv2bibtex.xsl
SOURCE/xslt/fancy.xslINSTALL/share/apps/kbibtex/fancy.xsl
SOURCE/xslt/pubmed2bibtex.xslINSTALL/share/apps/kbibtex/pubmed2bibtex.xsl
SOURCE/xslt/zoteroitems2bibtex.xslINSTALL/share/apps/kbibtex/zoteroitems2bibtex.xsl
SOURCE/xslt/pam2bibtex.xslINSTALL/share/apps/kbibtex/pam2bibtex.xsl
SOURCE/xslt/standard.xslINSTALL/share/apps/kbibtex/standard.xsl
BUILD/lib/kbibtexpart.soINSTALL/lib/kde4/kbibtexpart.so
BUILD/lib/libkbibtexgui.soINSTALL/lib/libkbibtexgui.so
BUILD/lib/libkbibtexio.soINSTALL/lib/libkbibtexio.so
BUILD/lib/libkbibtexnetworking.soINSTALL/lib/libkbibtexnetworking.so
BUILD/lib/libkbibtexproc.soINSTALL/lib/libkbibtexproc.so
BUILD/src/program/kbibtexINSTALL/bin/kbibtex

Windows & Mac OS X

To use KBibTeX on Windows, please use the package as it is included in the KDE on Windows Installer.
Get the KDE on Windows Installer

Installing KBibTeX on Mac OS X is considered experimental for now. If you want to contribute to the stability of KBibTeX on Mac OS X, please contact the project's maintainers.