48
edits
Changes
m
'''ConTeXt mkiv and LMTX''' have support Support for bibliographies is integrated into their in MkIV’s and LMTX’s core (forthe curious, the files are named [https://source.contextgarden.net/?search=bibl-tra bibl-tra]. '''This is the page for mkiv and LMTX support'''. Two other important sources of informations information are: * [http[manual://pragma-ade.nl/general/manuals/mkiv-publications.pdf |Bibliographies manual]]
For traditional ConTeXt mkii, support for bibliographies was added by Taco. The [[Bibliography_mkii|Bibliography mkii]] page explains a few basic facts and points you to the manual of the module.<br><br>TeX offers excellent ways to handle bibliographic references. bibTeX BibTeX allows you to use a database to manage your references and to insert citations and a list of references into your document. If you're you’re completely new to this subject, you should probably begin to read some basic hints about bibTeX BibTeX databases. You will find a good selection of resources (most of them are free and available on-line) at the section "Bibliographies “Bibliographies and Citations" Citations” of the [[http://texfaq.net/index.html#Bibliographiesandcitations TeX faq]]. A good place for beginners is Nicolas Markey’s [[http://mirror.ctan.org/info/bibtex/tamethebeast/ttb_en.pdf Tame the Beast]]. If you have TeXLive installed, it may already be on your hard disk.
===;Fields===: Some known fields of {{code|@Article}} are (see [http://pragma-ade.nl/general/manuals/mkiv-publications.pdf#[19,{%22name%22:%22Fit%22}] manual p.19])::* Title (also Title:en, Title:de etc.), Subtitle:* Author (see manual for possible formats):* Journal, Type, Number, Volume, Pages, Review:* Year, Month, Day:* Warning, Comment, Note:* XCrossref:* Doi:* Keywords:* Language:* Url:* author, editor: fields are parsed as "Firstname(s) Lastname", multiple entries separated by 'and' (see manual p.6/14):* keywords: separated by semicolons: There’s a (complete?) overview of categories and their fields in the manual on page 18 (Table 3.2).
Some known fields of {{code|@Article}} are (see manual p.14):* Title (also Title:en, Title:de etc.), Subtitle* Author (see manual for possible formats)* Journal, Type, Number, Volume, Pages, Review* Year, Month, Day* Warning, Comment, Note* XCrossref* Doi* Keywords* Language* Url * author, editor: fields are parsed as "Firstname(s) Lastname", multiple entries separated by 'and' (see manual p.6/14)* keywords: separated by semicolons There’s a (complete?) overview of categories and their fields in the manual on page 18 (Table 3.2). ===;Commands in entries=== You : you can define unknown commands like this:
\def\startbibitem{\dodoubleempty\dostartbibitem}
→Before using any database: the buffer method: modification of 'Cicéron' into 'Cicero'
__TOC__
{{TwoColumnsUnderLevel1
|
* [http://meeting.contextgarden.net/2014/talks/2014-09-09-alan-bibtex/From_BibTeX_to_ConTeXt_MKVI.pdf From BibTEX to ConTEXt mkiv], a 2014 presentation about BibTeX and the state of Bibliography in MkIV.
For older ConTeXt MkII, support for bibliographies was added by Taco. The '''[[Bibliography_mkii|Bibliography mkii]]''' page explains a few basic facts and points you to the manual of the module.
|
}}
\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 = {Cicero, 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},
}
</texcode>
<texcode>
@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 method :
<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>
<texcode>
\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]}.
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=
ConTeXt MkIV Bibliography can read several different formats of bibliographic databases:
==BibTeX .bib format==
ConTeXt is independent from the BibTeX program, but can read .bib databases, if it’s they’re not too polluted with non-standarddized standardized (LaTeX) commands.
This format is the oldest, but supported by most bibliography management programs. The other supported formats use the same structure of records, just ported to different “languages”.
ConTeXt understands UTF-8 encoded bib files as well as old fashioned TeX accent combinations.
<texcode>
\definebtxcommand\<#1>{\type{#1}}
</texcode>
: btx commands use a separate namespace.
==MkII .bbl format==
* aps (used in physical sciences)
* vancouver (used in biological sciences)
* [https://github.com/jjmccollum/context-sbl sbl] (used in theology), external project
Note: Only apa , aps, and aps chicago styles are currently provided as a showcase.
==Language==
[specification=mycustom,
numbering=yes]
\stopbtxrenderingdefinitions
</texcode>
<texcode>
% LMTX: \tolerant\def\dostartbibitemstartbibitem[#1]#*[#2]%LMTX!
{\doifsomethingelse{#2}%
{\startBibItem[reference={#1},title={#2}]}%
{\startBibItem[reference={#1},title={#1}]}%
}
\def\stopbibitem{\stopBibItem}
% MkIV:
%\def\dostartbibitem[#1][#2]%
% {\doifsomethingelse{#2}%
% {\startBibItem[reference={#1},title={#2}]}%
% {\startBibItem[reference={#1},title={#1}]}%
%}
%\def\startbibitem{\dodoubleempty\dostartbibitem}
%\def\stopbibitem{\stopBibItem}
\definedescription[BibItem][
</texcode>
See also : [[Simple_Bibliography]]
[[Manual_Bibliography|Here’s a similar approach]] using {{cmd|defineitemgroup}}.
[[Category:Bibliography]]