Intro |
The PBib Input Document Format and Styles
perl pbib.pl I<filename> pbib I<filename>
This is a short introduction to the PBib Input Document Format and provided PBib Styles. You may first want to read QUICK START in the PBib::PBib manpage how to get pbib running.
In your document, there can be three types of fields that are interpreted by PBib.
The references are identified with their ``CiteKey'' which is specified in the bibliography database. It depends on the database type, how the CiteKey is specified. BibTeX places the CiteKey before listing other fields (see also PBib Reference Types (``CiteType'') below):
@inproceedings{BEACH-ConnecTables, author = {Peter Tandler and Thorsten Prante and Christian M{\"u}ller-Tomfelde and Norbert Streitz and Ralf Steinmetz}, title = {ConnecTables: Dynamic Coupling of Displays for the Flexible Creation of Shared Workspaces}, booktitle = {Proceedings of 14th Annual ACM Symposium on User Interface and Software Technology (UIST'01)}, location = {Orlando, Florida, USA}, pages = {11--20}, publisher = {ACM Press, New York, NY}, month = {Nov. 11-14}, year = {2001}, url = {http://ipsi.fraunhofer.de/ambiente/publications/}, }
In this example ``BEACH-ConnecTables'' is the CiteKey (while ``@inproceedings'' is the CiteType). This paper can be referenced in the text as [[BEACH-ConnecTables]].
One major property of ubiquitous computing environments is the heterogeneity of the available devices. In order to provide a “coherent user experience” [[EasyLiving-Technologies], [Roomware-NextGeneration]], the “system must have a deeper understanding of the physical space” [[EasyLiving-Technologies], p. 3].
References [{}]
Peter’s References [{“Authors” LIKE ‘%Seitz%’ or “Authors” LIKE ‘%Tandler%’}] [< add some more detailed example here >] [## I think I should clarify this! ##]
You can add options to PBib fields that control how a style formats the field. Options are specified at the beginning of a field, starting with a colon.
Please note: Not all styles support all options. Not all options can be combined.
[ :I<option1> :I<option2> ... | [I<references>] ]
[:inline|[COAST-Model]] [:inline|[COAST-Model], p. 4] [ : inline : etal = 5 | [COAST-Model], p. 3]
Hint: You can process this introduction with pbib to get an idea of how the fields are formatted. (Be sure to change to the docs directory so that PBib finds the right local.pbib configuration file.
To specify which style should be used for a document, the easiest way is to use one of the predefined styles from the styles directory. For a document filename.ext PBib searches for a PBib style file called filename.pbib or filename.ext.pbib. In this file you can include the predefined style with the include
statement, e.g. include styles/IEEE/TR.pbib
.
There are two ways of defining custom styles. Adding PBib Style classes (which requires writing perl code) and combining the PBib styles in a custom way. Here, a very brief introduction for the later is given.
PBib styles are combined from four sub-styles, that each is configured by a couple of configuration entries. The sub-styles are:
bib
item
label
ref
For now, please look at the provided styles in the styles directory and the perl style classes the PBib::BibliographyStyle manpage, the PBib::BibItemStyle manpage, the PBib::LabelStyle manpage, and the PBib::ReferenceStyle manpage.
PBib supports the reference types as BibTeX and bp, with some additions / modifications. The numbers are used internally only.
Please, take a look at docs/CiteTypes.sxc for more information. (Note: The reference types are implemented in class PBib::BibItemStyle.)
with new label (RepType): [[Pebbles-Amulet]]
Intro |