NAME¶
Text::BibTeX::BibSort - generate sort keys for bibliographic entries
SYNOPSIS¶
# Assuming $entry comes from a database of the 'Bib' structure
# (i.e., that it's blessed into the BibEntry class, which inherits
# the sort_key method from BibSort):
$sort_key = $entry->sort_key;
DESCRIPTION¶
"Text::BibTeX::BibSort" is a base class of
"Text::BibTeX::BibEntry" for generating sort keys from bibliography
entries. It could in principle (and, someday, might) offer a wide range of
highly customizable sort-key generators. Currently, though, it provides only a
single method ("sort_key") for public use, and that method only pays
attention to one structure option, "sortby".
METHODS¶
- sort_key ()
- Generates a sort key for a single bibliographic entry. Assumes this entry
conforms to the "Bib" database structure. The nature of this
sort key is controlled by the "sortby" option, which can be
either "name" or "year". (The "namestyle"
also has a role, in determining how author/editor names are formatted for
inclusion in the sort key.)
For by-name sorting (which is how BibTeX's standard styles work), the sort
key consists of one of the "author", "editor",
"organization", or "key" fields (depending on the
entry type and which fields are actually present), followed by the year
and the title. All fields are drastically simplified to produce the sort
key: non-English letters are mercilessly anglicized, non-alphabetic
characters are stripped, and everything is forced to lowercase. (The first
two steps are done by the "purify_string" routine; see
"Generic string-processing functions" in Text::BibTeX for a
brief description, and the descripton of the C function
"bt_purify_string()" in bt_misc for all the gory details.)
SEE ALSO¶
Text::BibTeX::Structure, Text::BibTeX::Bib, Text::BibTeX::BibFormat
AUTHOR¶
Greg Ward <gward@python.net>
COPYRIGHT¶
Copyright (c) 1997-2000 by Gregory P. Ward. All rights reserved. This file is
part of the Text::BibTeX library. This library is free software; you may
redistribute it and/or modify it under the same terms as Perl itself.