Changes

Jump to navigation Jump to search
→‎Quickstart: add a sub-section on buffer
\stoptext
</texcode>
 
==Before using any database: the buffer method==
 
Before using a bibliographic database built with tools such as [https://www.jabref.org/ JabRef] or [https://www.zotero.org/ Zotero] (among others), it is possible to use the BibTeX format for bibliographic data by buffering it. With ConTexT MKIV, a relatively simple document of a few pages can be composed with simple commands such as \startbuffer .... \stopbuffer, between which you copy all the bibliographic references to be used in the text like this :
 
<texcode>
\startbuffer[biblio]
 
@Book{cicero-tuscu2011,
author = {Cicéron, Marcus Tullius},
editor = {Fohlen, G.},
publisher = {Les Belles Lettres},
title = {Tusculanes},
year = {2011},
address = {Paris},
edition = {7e tirage},
isbn = {9782251010830},
series = {œuvres philosophiques},
volume = {1},
ppn_gvk = {1823774121},
translator = {Jules Humbert},
}
 
@Book{Aristote2008,
Title = {Les Politiques},
Author = {Aristote},
Editor = {Pellegrin, Pierre},
Publisher = {Garnier-Flammarion},
Year = {2008},
Address = {Paris, France},
Series = {Le monde de la philosophie},
Date = {2008},
ISBN = {978-2-08-121816-1},
Location = {Paris, France},
Pagetotal = {xxiii+518},
Translator = {Pierre Pellegrin}
}
\stopbuffer
<\texcode>
 
Next, we will write text between the starttext and stoptext tags, before defining how the references will be printed after the body of the text, in the area defined for the table of contents (and possibly the various indexes, index rerum and index nominum). For the simplest texts, the bibliographic references after the \stopbuffer command can, for example, be defined (with our example) as follows:
 
<texcode>
\usebtxdataset[ancient philosophy][biblio.buffer]
 
\usebtxdefinitions[apa]
 
\definebtxrendering[ancient philosophy][apa][dataset=ancient philosophy]
 
\setupbtxrendering[continue =yes]
 
<\texcode>
 
As you can see, the memory buffer named 'biblio' will be associated with a database named 'ancient philosophy'; the format will follow the American Psychological Association (APA) model. We are writing a short text on Aristotle and Cicero with two bibliographical references in footnotes (one for each philosopher).
 
Then, we have to give place to what is called 'backmatter', say the the space where the bibliographic references given in the text will be printed, either in the body of the text or, as in our example, as footnotes. In this way, at the end of the document, all the references used from the buffer are summarised. Personally, I find the buffer method simple and easy, but much less powerful and convenient than the method of feeding a bibliographic file, constructed in the form *.bib, using software such as JabRef. ConTeXt will fetch the references from this file as and when they are called up using the \cite command, instead of having to copy each reference into the buffer.
 
Below a sample using a buffer.
 
<texcode>
 
\startbuffer[biblio]
 
@Book{cicero-tuscu2011,
author = {Cicéron, Marcus Tullius},
editor = {Fohlen, G.},
publisher = {Les Belles Lettres},
title = {Tusculanes},
year = {2011},
address = {Paris},
edition = {7e tirage},
isbn = {9782251010830},
series = {œuvres philosophiques},
volume = {1},
ppn_gvk = {1823774121},
translator = {Jules Humbert},
}
 
@Book{Aristote2008,
Title = {Les Politiques},
Author = {Aristote},
Editor = {Pellegrin, Pierre},
Publisher = {Garnier-Flammarion},
Year = {2008},
Address = {Paris, France},
Series = {Le monde de la philosophie},
Date = {2008},
ISBN = {978-2-08-121816-1},
Location = {Paris, France},
Pagetotal = {xxiii+518},
Translator = {Pierre Pellegrin}
}
\stopbuffer
 
\usebtxdataset[philosophie ancienne][biblio.buffer]
 
\usebtxdefinitions[apa]
 
\definebtxrendering[philosophie ancienne][apa][dataset=philosophie ancienne]
 
\setupbtxrendering[continue =yes]
 
\starttext
 
\startchapter[title={An Introduction To Philosophy}]
 
In the notes that follow, we will focus on philosophical thought as political philosophy. Aristotle, the Greek philosopher who published and commented on the Constitutions of the ancient Greek cities, begins his work {Politics} with the thesis that {man is a political animal}\footnote{cite[alternative=entry][ancient philosophy::Aristotle2008]}.
 
 
Cicéron, ce grand homme politique et cet écrivain savant, a eu la formule bien connue, selon laquelle \quotation{Socrate fit descendre la philosophie du ciel sur la terre.}\footnote{\cite[alternative=entry][philosophie ancienne::cicero-tuscu2011]}, qui désigne la question fondamentale de l’intérêt nourri par la philosophie pour les {\it choses humaines}.
 
Cicero, the great politician and scholarly writer, had the well-known phrase, \quotation{Socrates brought philosophy down from heaven to earth.}\footnote{\cite[alternative=entry][philosophie ancienne::cicero-tuscu2011]}, which refers to the fundamental question of philosophy's interest in {\it human things}.
 
\stopchapter
 
\starttext
 
\startbackmatter
 
\startchapter[title={Bibliographie}]
 
\startsection[title={Philosophie ancienne}]
 
\placelistofpublications[philosophie ancienne][method=local]
 
\stopsection
 
\stopchapter
 
\stopbackmatter
 
\stoptext
 
<\texcode>
=Database Formats=
48

edits

Navigation menu