Build the references cited section

build-citations

The "build-citations" pragma is used to instruct the BLUE-PROCESSOR to assemble the references declared in the manuscript's citemarks into a References Cited back-matter section.

Syntax

The syntax for the build-citations pragma consists of:

  • An exclamation point !
  • The keyword build-citations
  • A coalescer (optional), specified using a full-stop . followed by a citemark coalescer.
  • An order attribute, (sequential, alpha, numeric) to identify how the citations should be ordered.
  • A junctors attribute, (yes or no), to specify whether or not hyperlinks should be created from the entries in the References Cited section back to the place in the manuscript where they were cited.
!build-citations .coalescer *order=sequential|alpha|numeric *junctors=yes|no
build-citations pragma syntax

If a coalescer is specified, the builder will only include citemarks which specify that coalescer.

The default value for the junctors attribute is yes, which instructs the builder to create backlinks from the built section to the locations where the citations occur. But regardless of the junctors setting, each citemark occurance in the body-matter will always be hyperlinked to the corresponding full citation in the back-matter section built by the processor.

Examples

Here is what a build-citations pragma looks like within the body of a manuscript.

Later he asks a biologist to calculate what percentage
of a McDonald's meal was derived from corn.
{{.article1 '(Pollan 2006, 99–100)'
"Pollan, Michael. 2006. <<i The Omnivore’s Dilemma:
A Natural History of Four Meals.>> New York: Penguin."}}

pre {
Grasping the bowstring and the arrow's notch,
He drew them back, and forced the string to meet
}
{{.article1 '(Lattimore 1951, 91–92)'
"Lattimore, Richmond, trans. 1951.
<<i The Iliad of Homer.>> Chicago: University of Chicago Press."}}

. . .

div {
h1 References Cited
!build-citations .article1 *order=alpha *junctors=yes
}
Sample build-citations pragma

And here is the output created by the builder:

<p>Later he asks a biologist to calculate what percentage
of a McDonald's meal was derived from corn.
<mark id=ct20 class='article1'><a href='ct23'>
(Pollan 2006, 99–100)</a></mark></p>

<pre>
Grasping the bowstring and the arrow's notch,
He drew them back, and forced the string to meet
</pre>
<p><mark id=ct21 class='article1'><a href='ct22'>
(Lattimore 1951, 91–92)</a></mark></p>

. . .

<div>
<h1>References Cited</h1>
<ul class='article1'>
<li id=ct22 class='p'>
<mark><a href='ct21'>(Lattimore 1951, 91–92)</a></mark>
<cite>Lattimore, Richmond, trans. 1951. <i>The Iliad of Homer.</i>
Chicago: University of Chicago Press.</cite></li>

<li id=ct23 class='p'>
<mark><a href='ct20'>(Pollan 2006, 99–100)</a></mark>
<cite>Pollan, Michael. 2006. <i>The Omnivore’s Dilemma:
A Natural History of Four Meals.</i>
New York: Penguin.</cite></li>
</ul>
</div>
Sample build-citations output

syntax > pragmas > build-citationsBuild the references cited section

🔎