1. Inserting citations and bibliography
   1. Inserting a citation
   2. Formating the bibliography
2. Styles
   1. Using styles
   2. Creating a style
   3. Bibliographic index
   4. Fieds formatting
   5. Fields ordering
   6. Citation
   7. Further formatting
      1. Citation
      2. Bibliography

# Inserting citations and bibliography

## Inserting a citation

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.

## Formating the bibliography

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.

# Styles

- 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.

## Using 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 a style

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.

## Bibliographic index

The second Tab controls how the index is formated. The choices are easy to understand and correspond to the available choices in OpenOffice.org.

## Fieds formatting

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).

## Fields ordering

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.

## Citation

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.

## Further formatting

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.

### Citation

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.

### Bibliography

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"