You just have to select your citation(s) and insert them
directly at the cursor location. Further explanation shouldnt be
necessary: just give it a try.
The only important point is that
before insertion, the reference goes through the style
filter. This means that the fields won't appear as in the
database but will be reformatted. This is an important feature of
Bibus and a strong improvement over OpenOffice.org.
When you choose this menu Bibus makes two things:
First, it goes through the document looking for bibliographic citations. When it finds a citation, it looks it up in the database. If it is not in the database it does nothing. If it is in the database, it reformats the citation according to the current style. This is very important to understand this because it means that:
If you changed a reference in the database, the change will be automatically inserted in your document.
You can reformat the bibliography by selecting a new style in the 'Format Bibliography' menu.
It updates the bibliographic index according to the settings defined in OpenOffice.org 'Insertion/Index/Index' menu.
How does Bibus recognizes a citation? For instance in the
displayed ScreenShot,
the Identifier of the
inserted citation is Brodie2009. Bibus simply looks in the
database for the record with Identifier=Brodie2009 and inserts
it. Of course, this means that you must not change the database or
Bibus will get confused and you will get the wrong reference
inserted.
Format all the fields
Choose how the index is displayed (sorting, etc...)
Define how each reference must look in the index
Define how the citation is formatted
Save all these settings for later use.
All this is easily accomplished with Bibus styles.
In the OpenOffice.org/Formating sub menu, there is a list of
available styles. There are also options for creating, editing or
loading styles from disk. The currently active style is displayed at
the right of the status bar of the Main
Window.
The list of styles is divided in two parts.
The first displayed styles are the default styles seen by all the users of Bibus. Those styles are located in the Format/Styles/ directory in the Bibus installation directory. If you create a style and want to make it available to all the users, just drop it in this directory (if you have write permission) and it will appear in the menu of Bibus (after restart). You cannot edit those styles. If you choose Edit, Bibus will do a copy of it in order to allow editing.
The second part of the list, after the separator under linux or just the end of the list under Windows, contains your personal styles. You are the only user with those styles in your menu (actually another user can share them if he has read access to them and load them using the load item). You can freely Edit those styles.
Creating or editing a new style is very easy. When you select New
the following 'Style editor' will pop up.
You
start with a style corresponding to the 'default' style of the style
menu. This is a fairly reasonable style and most of the time you just
have to modify few settings.
In this first Tab "Style
information", You can put any relevant informations concerning
this style. It is a good idea to give an e-mail address where users
can contact you and of course for which journal the style is
intended.
The second Tab controls how the index is formated. The choices are
easy to understand and correspond to the available choices in
OpenOffice.org.
This Tab controls the filters that are applied to the record
fields before insertion in OpenOffice.org.
For instance, if you
have a record with the corresponding authors:
Marx, Groucho; Marx, Harpo; Marx, Zippo; Marx, Zeppo; Marx, Gummo
you may want to format them as :
Marx G., Marx H., Marx Z., Marx Z., Marx G.
or
Marx G., Marx H., Marx Z., Marx Z. and Marx G.
On
the left, there is a list of all the available reference types that
OpenOffice.org knows about. The main type is of course ARTICLE and it
is why we use it as the default type. If you click on any other type,
for instance BOOK, you will see that all the choices are dimmed and
that the first RadioBox says that for BOOK you must 'Format fields as
in ARTICLE'.
When you want to define a new style:
format ARTICLE. In ARTICLE you can even format the fields which are not relevant for an ARTICLE like 'Booktitle' or 'Editors'. The most important part of this dialog is how authors and editors must be formated. To help you, there is a preview that shows the result of your choices as you type.
Choosing 'As in database' means that you don't want Bibus to format this field. The field will be directly copied from the database to OpenOffice.org.
At the top there is a checkbox 'use current language for month'. If you check it, month will use your current language, otherwise it will be in English. The month in the database must be either in you current language or in English in order for Bibus to recognize it.
Select the types which are not correctly formated with the ARTICLE style and select at the top 'Format fields as below', then define the style as for ARTICLE.
You can use 'singular | plural' forms. In the displayed example, you can see that Bibus will add, after the editor list, either (Editor) or (Editors) depending on the number of editors.
You can abbreviate the author list, if needed (For instance PNAS requires the listing of only the first 10 authors). If you choose 6 for instance, authors 1 to 6 will be listed and the 7th and followings will be replaced by 'et al.' (or something else).
The last Tab controls how the fields are ordered and formatted. For instance you may want to format references as:
Authors. Title. Journal (Year) Volume: pages.
This can be done in this Tab.
Starting with Bibus pre1.0.0, there is a new tab called
citation.
In this tab, you can define the formatting of the
citations in the text. This tab is a bit special because it contains
features not supported by OpenOffice.org. The configuration option in
this tab are used by the 'OpenOffice.org/Finalize' menu. Because it
is a one-way formatting and because it is not possible to go back to
the cancel these formatting, Bibus will use these setting on a copy
of your current document.
Here
is a short description:
Top: You can define here, the style of
the citation. Bold, italic, subscript, etc...
Depending on the
settings in the 'Bibliographic Index' tab, you will be also able to
define either the formatting of the numbering or author-date:
For
author-date, you must first define the template (for instance
'Author', 'Year'), then how Bibus should try to solve the duplicates.
There are 3 possibilities:
- Bibus can add a
letter after the year. This method will always generate unique
citation markers.
- You can choose to add
authors or to add their firstname. In some case this may not be
possible to solve all the duplicates. Bibus will warn you if there
are still some duplicates and you will have to edit them by hand.
- You can add a field. For instance, in APA style, you usually add
the 'title' of the book after the author. Again, in some rare cases,
it may not be enough to solve some duplicates. Again, Bibus will warn
you if it is the case.
Read the OpenOffice.org help to understand how styles works in
OpenOffice.org.
Bibus uses paragraph and character styles to
format the bibliography and the citations.
You can thus re-format
easily the citations and/or the Bibliography.
After using the Finalize function, the citations uses the character style 'bibus_citation_base'. For instance, you can choose a yellow background for this style and all the text citations will be easy to localize in you text.
The Bibliography title uses the paragraph style "Bibliography
title"
The Bibliography uses the paragraph style
"Bibliography 1"
The References use the character style
"bibus_base"
