Overview

This page demonstrates a bibliography inside a book: references are cited in the running text, numbered in the order they appear, and gathered in a table at the end of the document.

A reference is numbered the first time it is cited. Every later citation of the same reference carries that same number. There is a single sequence of numbers for the whole document, and reloading the page gives the same numbers, because the order of the text does not change.

The bibliography itself does not depend on the citations: it lists what the BibTeX data contains. A page without any citation still gets its table — see publications.html.

How the bibliography is designed, what it does not do and why: bibliography-design.html.

How to use

Four steps: write the data, cite in the text, add the placeholder, call the JS API.

<link rel="stylesheet" href="wexa_statics/css/extras/bibbook.css">

<noscript>
    <style> #bibtex { display: block; } </style>
</noscript>

<pre id="bibtex" hidden>
@inproceedings{bigi2022lrec,
    author = {Brigitte Bigi and Maryvonne Zimmermann and Carine André},
    ...
}
</pre>

<p>The corpus is described in
    <span data-bibtex="bigi2022lrec">Bigi et al., 2022</span>.</p>

<!-- with JavaScript:    The corpus is described in [1]. -->
<!-- without JavaScript: The corpus is described in Bigi et al., 2022. -->

<div id="bibliography"></div>

const biblio = new BookBibliography('bibtex', 'bibliography', 'main-content');
biblio.run();

What a citation gives

A citation opens on demand: the full reference, its abstract, its BibTeX source and its links, without leaving the sentence and without scrolling the page. Several may stay open at once, and none closes on its own. Keys that name nothing are reported through Wexa.logger.

A link goes from a citation to its entry in the bibliography, and from that entry back to every place where it is cited.

CSS classes

Everything the bibliography writes carries a class, and bibbook.css only styles what a bibliography needs to be read: the rest is left to whoever writes the document. An unlayered rule of your own wins over the ones of the framework, so overriding any of these takes no !important and no complex selector.

A reference

A reference is written in three lines: who wrote it, what it is called, and where it came out. The three names never change, whatever the type of the entry, so a stylesheet can lay them out side by side, wrap them, or reorder them.

.bib-reference {
    display: flex;
    flex-wrap: wrap;
    gap: 0.5rem;
}

The table

What opens

Citations in a running text

The paragraphs below cite five keys. The first three are cited once each, in the order they appear, and take the numbers 1, 2 and 3. The fourth citation repeats the first key, and carries the number 1 again. The last one names a key that no entry defines.

A corpus of French Cued Speech is described in Bigi et al., 2022, and the kinds of data collected when studying spoken language are discussed in Ghio & Bigi, 2023. Tools and principles for corpus annotation are gathered in Amoyal et al., 2022.

The same corpus Bigi et al., 2022 is cited a second time here, and keeps its first number. Resources for a less-resourced language are presented in Pakrashi et al., 2026.

This last citation Nobody, 2026 names a key that no entry defines: it stays visible, says that it is missing, and receives no number.

Bibliography