Bibliographies

The following macros may be used in the main text for citations to entries in a bibliographic database.

<cite|ref-1||ref-n>

Each argument ref-i is a citation corresponding to an item in a BiB-TeX file. The citations are displayed in the same way as they are referenced in the bibliography and they also provide hyperlinks to the corresponding references. The citations are displayed as question marks if you did not generate the bibliography.

<nocite|ref-1||ref-n>

Similar as cite, but the citations are not displayed in the main text.

<cite-detail|ref|info>

A bibliographic reference ref like above, but with some additional information info, like a chapter or a page number.

The following macros may be redefined if you want to customize the rendering of citations or entries in the generated bibliography:

<render-cite|ref>

Macro for rendering a citation ref at the place where the citation is made using cite. The content may be a single reference, like “TM98”, or a list of references, like “Euler1, Gauss2”.

<render-cite-detail|ref|info>

Similar to render-cite, but for detailed citations made with cite-detail.

<render-bibitem|content>

<transform-bibitem|content>

At the moment, bibliographies are generated by BibTeX and imported into TeXmacs. The produced bibliography is a list of bibliographic items with are based on special LaTeX-specific macros (bibitem, block, protect, etc.). These macros are all defined internally in TeXmacs and eventually boil down to calls of the render-bibitem, which behaves in a similar way as item*, and which may be redefined by the user.

The transform-bibitem is used to “decorate” the content. For instance, transform-bibitem may put angular brackets and a space around content. Notice that the standard implementation of render-bibitem macro is based on transform-bibitem.

<bib-list|largest|body>

The individual “bibitems” are enclosed in a bib-list, which behaves in a similar way as the description environment, except that we provide an extra parameter largest which contains a good indication about the largest width of an item in the list.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".