py4sci

Table Of Contents

Previous topic

Bibulous documentation

Next topic

Guidelines for writing bibliography style templates

This Page

Getting started

For general users, all that is needed is place the main bibulous.py file into the Python path and to tell LaTeX to use Bibulous rather than BibTeX as their bibliography engine. For users interested in using the auxiliary command bibulous_authorextract.py, this file must also be in the Python path, and must be in the same directory as the main file. It is also possible to tell any LaTeX front-end to use Bibulous in place of BibTeX. For Kile (on Linux) and WinEdt (on Windows), instructions for doing this are given below.

Kile: replacing BibTeX with Bibulous

  1. In your .tex file, change the filename of the \bibliography{...} command to the filename for the appropriate Bibulous-format bibliography style template (.bst file).
  2. In Kile, go to the menu bar and select Settings > Configure Kile. Select Tools > Build and choose BibTeX from the Select a tool menu (see the figure). To the right of the menu, after you select BibTeX you should see “Choose a configuration for the tool BibTeX”. Below the drop-down menu, select the button “New” and type in the name Bibulous (or whatever you prefer to call your new tool). Below, in the General tab, type in the location of the bibulous.py file. And in the Options field, type %dir_base/%S.aux.
_images/screenshot_for_kile_instructions.png _images/screenshot_for_kile_instructions2.png

That should be it. In case your default setup is different, you can also check the Advanced tab settings and verify that they are as shown in the second figure. (That is, Source extension is set to aux, and Target extension is set to bbl.)

  1. Note that the following variables are accessible in Kile’s Options field:

    %source = filename (i.e. filename with suffix but not path)
    %S = filename without suffix (and without path)
    %dir_base = source file directory (source file's path without the filename)
    %dir_target = target file directory (source file's path without the filename)

Modifying WinEdt5 to replace BibTeX with Bibulous

  1. Go to the menu Options > Execution Modes. In the Console Applications menu on the left hand side, select BibTeX. Then replace the three Command Line fields with the ones shown in the figure, replacing the files paths with the ones correct for your installation of Python and bibulous.py.
_images/original_Winedt5_setup.png _images/modified_Winedt5_setup.png
  1. Note that the following are definitions of WinEdt registers:

    %f = full path of active file (= %p/%n.%t)
    %n = name of the active file
    %p = the path of the active file
    %t = the extension of the active file
    %q = the path relative to the main file (i.e. for subdirectories)
    %b = WinEdt's local working directory (not the tex file directory)
    %B = path to the WinEdt executable file