Difference between revisions of "Simple Bibliography"

From ConTeXt wiki
Jump to navigationJump to search
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
<div style="color: red">Page in progress...</div>
+
Sometimes the bibliography needs to be more flexible in the bibliographic item description. Often the aviable data does not fit into the Bibtex schema; or  text needs to be written inside the bibliography list. For this case exists the module simplebib.
  
Sometimes the bibliography needs to be more flexible in the bibliographic item description. For this case exists the module simplebib.
+
==Items==
 +
 
 +
The bibliography can be listed in one block or distributed over several block in the document (e.g. at the end of every chapter):
 +
 
 +
<texcode>
 +
...
 +
 
 +
\startbibliography
 +
...
 +
\stopbibiography
 +
 
 +
...
 +
 
 +
\startbibliography
 +
...
 +
\stopbibiography
 +
 
 +
...
 +
</texcode>
  
But this bibliography module is more flexible than the "classic" bibliography module with its bibtex database.
+
Inside the bibliography environment you can specify bibliographic items via <code>\bibitem</code>.
  
==Items==
+
<texcode>
 +
\bibitem[reference=,label=,author=,editor=,year=,title=,in=,number=,series=,volume=,magazine=,edition=,revedition=,datedition=,publisher=,place=,isbn=,url=,pages=,access=]
 +
</texcode>
 +
 
 +
Most attributes should be self explaining. A speciality is the <code>in</code> attribute. Often you have to cite an article that is published in a journal, compendium etc. So you use the "normal" attributes to specify the article and via the <code>in</code> attribute you specify the book with the same attributes inside:
 +
 
 +
<texcode>
 +
\bibitem[reference=bpf,label={BüPrFr},author={Büchel, Christian; Price, Cathy J und Friston, Karl},year={1998},title={A multimodal language region in the ventral visual pathway},in={{title=Nature},volume={394},pages={274-277}}]
 +
</texcode>
  
The bibliography can be listed in one block or distributed over several block in the document (e.g. at the end of every chapter).  
+
If the label should be numbered automaticly just remove the <code>label</code> attribute of the <code>\bibitem</code> entity.
  
 
==Referencing==
 
==Referencing==
  
For referencing simplebib is using the crossref module. For the lazy ones it provides <code>\bibtex</code> what is nothing else than a <code>\crossred</code> with <code>type=external</code> preset.
+
For referencing simplebib is using the [[Cross Referencing|crossref]] module. For the lazy ones it provides <code>\bibtex</code> what is nothing else than a <code>\crossref</code> with <code>type=external</code> preset.
 +
 
 +
So in following example both blocks do the same:
 +
 
 +
<texcode>
 +
\bibref[ref1]
 +
\bibref[detail={p. 38}][ref1]
 +
 
 +
\crossref[type=external][ref1]
 +
\crossref[type=external,detail={p. 38}][ref1]
 +
</texcode>
 +
 
 +
Here a simple usage example:
 +
 
 +
<texcode>
 +
\usemodule[simplebib]
 +
 
 +
\starttext
 +
 
 +
\bibref[brk]
 +
\bibref[detail={p. 275}][bpf]
 +
 
 +
\starttext
 +
\startbibliography
 +
 
 +
\bibitem[reference=brk,label={Brk\-01},author={Brinker, Klaus},year={2001},title={Linguistische Textanalyse: Eine Einführung in Grundbegriffe und Methoden},series={Grundlagen der Germanistik},volume={29},revedition={5},publisher={Schmidt Verlag},place={Berlin},isbn={3-503-04995-9}]
 +
 
 +
\bibitem[reference=bpf,label={BüPrFr\-98},author={Büchel, Christian; Price, Cathy J und Friston, Karl},year={1998},title={A multimodal language region in the ventral visual pathway},in={{title=Nature},volume={394},pages={274-277}}]
 +
 
 +
\stopbibliography
 +
\stoptext
 +
</texcode>
  
 
==Settings==
 
==Settings==
 +
 +
To adjust the space for the bibitem labels you can specify the:
 +
 +
* <code>labelSpace</code> with a natural number (the default is 12).
 +
 +
They are defined as parameters of the module:
 +
 +
<texcode>
 +
\usemodule[crossref][labelSpace=...]
 +
...
 +
</texcode>
 +
 +
Depending on label definition or label numbering a text left and right of the label can be defined via <code>labelLeft</code> and <code>labelRight</code>. If brackets are needed they can be set with:
 +
 +
<texcode>
 +
\setupsimplebibtext[labelLeft={[}]
 +
\setupsimplebibtext[labelRight={]}]
 +
</texcode>
 +
 +
The language depending texts can be set via:
 +
 +
<texcode>
 +
\setupsimplebibtext[en][editor={ed.}]
 +
\setupsimplebibtext[en][number={number}]
 +
\setupsimplebibtext[en][fromSeries={from series}]
 +
\setupsimplebibtext[en][volume={volume}]
 +
\setupsimplebibtext[en][magazine={magazine}]
 +
\setupsimplebibtext[en][edition={edition}]
 +
\setupsimplebibtext[en][revedition={reviewed edition}]
 +
\setupsimplebibtext[en][datedition={edition from}]
 +
\setupsimplebibtext[en][isbn={ISBN}]
 +
\setupsimplebibtext[en][pages={p.}]
 +
\setupsimplebibtext[en][access={last access}]
 +
\setupsimplebibtext[en][in={in}]
 +
 +
\setupsimplebibtext[de][editor={Hrsg.}]
 +
\setupsimplebibtext[de][number={Nummer}]
 +
\setupsimplebibtext[de][fromSeries={aus der Reihe}]
 +
\setupsimplebibtext[de][volume={Band}]
 +
\setupsimplebibtext[de][magazine={Heft}]
 +
\setupsimplebibtext[de][edition={Auflage}]
 +
\setupsimplebibtext[de][revedition={überarbeitete Auflage}]
 +
\setupsimplebibtext[de][datedition={Auflage vom}]
 +
\setupsimplebibtext[de][isbn={ISBN}]
 +
\setupsimplebibtext[de][pages={S.}]
 +
\setupsimplebibtext[de][access={letzter Zugriff}]
 +
\setupsimplebibtext[de][in={in}]
 +
</texcode>

Latest revision as of 22:47, 3 November 2012

Sometimes the bibliography needs to be more flexible in the bibliographic item description. Often the aviable data does not fit into the Bibtex schema; or text needs to be written inside the bibliography list. For this case exists the module simplebib.

Items

The bibliography can be listed in one block or distributed over several block in the document (e.g. at the end of every chapter):

...

\startbibliography
...
\stopbibiography

...

\startbibliography
...
\stopbibiography

...

Inside the bibliography environment you can specify bibliographic items via \bibitem.

\bibitem[reference=,label=,author=,editor=,year=,title=,in=,number=,series=,volume=,magazine=,edition=,revedition=,datedition=,publisher=,place=,isbn=,url=,pages=,access=]

Most attributes should be self explaining. A speciality is the in attribute. Often you have to cite an article that is published in a journal, compendium etc. So you use the "normal" attributes to specify the article and via the in attribute you specify the book with the same attributes inside:

\bibitem[reference=bpf,label={BüPrFr},author={Büchel, Christian; Price, Cathy J und Friston, Karl},year={1998},title={A multimodal language region in the ventral visual pathway},in={{title=Nature},volume={394},pages={274-277}}]

If the label should be numbered automaticly just remove the label attribute of the \bibitem entity.

Referencing

For referencing simplebib is using the crossref module. For the lazy ones it provides \bibtex what is nothing else than a \crossref with type=external preset.

So in following example both blocks do the same:

\bibref[ref1]
\bibref[detail={p. 38}][ref1]

\crossref[type=external][ref1]
\crossref[type=external,detail={p. 38}][ref1]

Here a simple usage example:

\usemodule[simplebib]

\starttext

\bibref[brk]
\bibref[detail={p. 275}][bpf]

\starttext
\startbibliography

\bibitem[reference=brk,label={Brk\-01},author={Brinker, Klaus},year={2001},title={Linguistische Textanalyse: Eine Einführung in Grundbegriffe und Methoden},series={Grundlagen der Germanistik},volume={29},revedition={5},publisher={Schmidt Verlag},place={Berlin},isbn={3-503-04995-9}]

\bibitem[reference=bpf,label={BüPrFr\-98},author={Büchel, Christian; Price, Cathy J und Friston, Karl},year={1998},title={A multimodal language region in the ventral visual pathway},in={{title=Nature},volume={394},pages={274-277}}]

\stopbibliography
\stoptext

Settings

To adjust the space for the bibitem labels you can specify the:

  • labelSpace with a natural number (the default is 12).

They are defined as parameters of the module:

\usemodule[crossref][labelSpace=...]
...

Depending on label definition or label numbering a text left and right of the label can be defined via labelLeft and labelRight. If brackets are needed they can be set with:

\setupsimplebibtext[labelLeft={[}]
\setupsimplebibtext[labelRight={]}]

The language depending texts can be set via:

\setupsimplebibtext[en][editor={ed.}]
\setupsimplebibtext[en][number={number}]
\setupsimplebibtext[en][fromSeries={from series}]
\setupsimplebibtext[en][volume={volume}]
\setupsimplebibtext[en][magazine={magazine}]
\setupsimplebibtext[en][edition={edition}]
\setupsimplebibtext[en][revedition={reviewed edition}]
\setupsimplebibtext[en][datedition={edition from}]
\setupsimplebibtext[en][isbn={ISBN}]
\setupsimplebibtext[en][pages={p.}]
\setupsimplebibtext[en][access={last access}]
\setupsimplebibtext[en][in={in}]

\setupsimplebibtext[de][editor={Hrsg.}]
\setupsimplebibtext[de][number={Nummer}]
\setupsimplebibtext[de][fromSeries={aus der Reihe}]
\setupsimplebibtext[de][volume={Band}]
\setupsimplebibtext[de][magazine={Heft}]
\setupsimplebibtext[de][edition={Auflage}]
\setupsimplebibtext[de][revedition={überarbeitete Auflage}]
\setupsimplebibtext[de][datedition={Auflage vom}]
\setupsimplebibtext[de][isbn={ISBN}]
\setupsimplebibtext[de][pages={S.}]
\setupsimplebibtext[de][access={letzter Zugriff}]
\setupsimplebibtext[de][in={in}]