Chapter 4.  KBibTeX Interface

KBibTeX's Panels

The main functionality of KBibTeX is available through its nine panels. It is possible to rearrange these panels or even detach them from the main window by clicking with left mouse button on the panel's header and dragging it to the new place.

You can make the KBibTeX panels visible or hide them using the SettingsShow Panels submenu. It is enough to check the panel's item to make it visible or uncheck it to hide the panel.

List of Documents Panel

The List of Documents panel allows to switch between the opened bibliography documents (Open Files tab), open recently used documents (Recently Used tab), open your main bibliography documents (Favorites tab), or browse your computer file system to find bibliography documents (Filesystem Browser tab).

Tip

To add a bibliography file to favorites select it on any tab except Favorites, click with right mouse button and choose Add to Favorites. To remove the bibliography from favorites select it on Favorites tab, click with right mouse button and choose Remove from Favorites.

List of documents panel

List of Values Panel

The List of Values panel can be used to easy up viewing statistics on usage of values in the entries fields and batch editing of these values.

The upper drop down box is used to choose the bibliography field to display statistic data (a count of entries with the same value for the field) on the lower list.

You can click with right mouse button on an entry in the lower list to access the batch editing capabilities. It is possible to Replace all occurrences of the value, Delete all occurrences of the value, Search for selected values using the Filter Toolbar, Add value to selected entries, Replace value of selected entries or Remove value from selected entries (some entries should be selected in the main entry list first).

List of values panel

Statistics Panel

The Statistics panel is designed to display a comprehensive list of statistical information about the current bibliography document.

Statistics panel

Reference Preview Panel

The Reference Preview panel is used to preview and save in HTML format the currently selected bibliography entry.

Reference preview panel

It is possible to preview the reference as Source (BibTEX), Source (RIS), Wikipedia, standard (XML/XSLT), fancy (XML/XSLT), and abstract-only (XML/XSLT) formats. Additional options become available when bibtex2html is installed.

Tip

When you click on the elements of the reference in XML-based format KBibTeX will apply the corresponding filtering to the bibliography list.

Click the Open button to open the reference in the default Internet browser. The Save as HTML button can be used to save the reference in HTML for further use on your website.

You can click with right mouse button on the panel to select Reload to update the reference according to the latest changes in the entry.

File Settings Panel

The File Settings panel can be used to define some parameters of the bib file of the current bibliography.

File settings panel

It is possible to select Encoding, String Delimiters, Comment Quoting, Keyword Casing, and Person Names Formatting.

By default BibTEX will lowercase all intermediate words in sentences. Check Protect Titles check box to protect the case in the entry titles.

Online Search Panel

The Online Search panel can be used to perform a search in the Internet bibliography databases to find the needed entries or to obtain the complete set of data for a manually entered entry.

Online Search panel

The entries can be searched by Free text, Title, Author, or Year. The number of results shown on the Search Results panel can be tweaked using the Number of Results spin box.

Click the Use Entry button to fill the search criteria fields from the currently selected bibliography entry. This way you can complete the existing entry with the data from the Internet databases. The Search button can be used to start the search.

KBibTeX can perform a search in the most popular Internet databases. To select the set of the databases for your search switch to the Engines tab or click with left mouse button on the change link on the Query Terms tab.

To visit the database homepage in the Internet click with right mouse button on its entry in the Engines tab and select Go to Homepage.

Zotero Panel

The Zotero panel can be used to import your Zotero library.

Zotero uses specialized browser add-ons to save bibliography entries from Internet pages. The data are stored in an online database that can be reached from anywhere. Zotero documentation can be found here.

Zotero panel

Click the Get Credentials button on Credentials tab to start the Zotero authorization wizard. Follow the instructions to allow KBibTeX access your Zotero library.

Then the Load bibliography button can be used to download data from Zotero library.

To access the downloaded library entries double-click on the corresponding item on Collections or Tags tabs. The entries that satisfy the chosen criteria will be shown on the Search Results panel.

Search Results Panel

The Search Results panel is used to handle the search results obtained using Online Search panel.

Search Results panel

Click the Import button to import the currently selected search result into your bibliography.

To access other actions for the currently selected search result click on it with right mouse button. From the opened menu you can review the result (View Element item) or copy it for further pasting in BibTEX format elsewhere with Ctrl+V (Copy item).

Element Editor Panel

The Element Editor panel can be used to edit the currently selected bibliography element.

Element Editor panel

Click the button to select a suggested identifier for the element.

Enter the respective data in the editor fields. The field data format can be switched between Text, Reference and Source Code using the drop down box to the left of the text box.

Click the Options button to open a drop down menu with two items.

The Show all fields item can be used to show or hide all empty fields of the current element.

It is possible to switch keyboard focus between the fields using the Tab key. So the second menu item, Tab key visits only editable fields, can be used to switch on and off navigation between editable fields only.

Click the Check with BibTEX button to preview the editing entry as it will be shown in the compiled PDF file.

Check the Automatically apply changes box to have all your changes automatically applied to the entry without the need to click the Apply button.

Click the Reset button to revert all your changes.

Document Preview Panel

The Document Preview panel can be used to preview pages or documents linked with the currently selected bibliography entry.

Tip

By default, the Document Preview panel can be opened by pressing Ctrl+Shift+D keyboard shortcut.

Document Preview panel

Click the button to toggle between local files only and all documents including the remote ones.

Click the button to open the page or the document in the default external application.

The address drop down box can be used to switch between the pages and documents.