Biber::Config(3pm) User Contributed Perl Documentation Biber::Config(3pm)
NAME
Biber::Config - Configuration items which need to be saved across the
lifetime of a Biber object
This class contains a static object and static methods to access
configuration and state data. There are several classes of data in here
which have separate accessors:
* Biber options
* Biblatex options
* State information used by Biber as it processes entries
* displaymode date
_init
Reset internal hashes to defaults.
_initopts
Initialise default options, optionally with config file as argument
config_file
Returns the full path of the Biber configuration file. If returns the first file found among:
o "biber.conf" in the current directory
o "$HOME/.biber.conf"
o "$ENV{XDG_CONFIG_HOME}/biber/biber.conf"
o "$HOME/Library/biber/biber.conf" (Mac OSX only)
o "$ENV{APPDATA}/biber.conf" (Windows only)
o the output of "kpsewhich biber.conf" (if available on the system).
If no file is found, it returns "undef".
get_unul_done
Return a boolean saying whether uniquenename+uniquelist processing is finished
set_unul_changed
Set a boolean saying whether uniquename+uniquelist has changed
postprocess_biber_opts
Place to postprocess biber options when they have been
gathered from all the possible places that set them
set_structure
Sets the structure information object
get_structure
Gets the structure information object
set_ctrlfile_path
Stores the path to the control file
get_ctrlfile_path
Retrieved the path to the control file
setoption
Store a Biber config option
getoption
Get a Biber option
setcmdlineoption
Store a Biber command-line option
setconfigfileoption
Store a Biber config-file option
iscmdlineoption
Check if an option is explicitly set by user on the command
line
isconfigfileoption
Check if an option is explicitly set by user in their
config file
isexplicitoption
Check if an option is explicitly set by user on the command
line or in the config file
setblxoption
Set a biblatex option on the appropriate scope
getblxoption
Get a biblatex option from the global or per entry-type scope
getblxoption('option', ['entrytype'], ['citekey'])
Returns the value of option. In order of decreasing preference, returns:
1. Biblatex option defined for entry
2. Biblatex option defined for entry type
3. Biblatex option defined globally
set_graph
Record who inherited what fields from whom
Can be used for crossrefs and xdata. This records the actual fields
inherited from another entry, for tree generation.
Biber::Config->set_graph($source_key, $target_key, $source_field, $target_field)
get_graph
Return an inheritance graph data structure for an inheritance type
set_inheritance
Record that $target inherited information from $source
Can be used for crossrefs and xdata. This just records that an entry
inherited from another entry, for loop detection.
Biber::Config->set_inheritance($source, $target)
get_inheritance
Check if $target directly inherited information from $source
Can be used for crossrefs and xdata
Biber::Config->get_inheritance($source, $target)
is_inheritance_path
Checks for an inheritance path from entry $e1 to $e2
Can be used for crossrefs and xdata
[
{s => 'A',
t => 'B'},
{s => 'A',
t => 'E'},
{s => 'B',
t => 'C'},
{s => 'C',
t => 'D'} ];
Biber::Config->is_inheritance_path($type, $key1, $key2)
incr_la_disambiguation
Increment a counter to say we have seen this labelalpha
Biber::Config->incr_la_disambiguation($la);
get_la_disambiguation
Get the disambiguation counter for this labelalpha
Biber::Config->get_la_disambiguation($la);
get_seenkey
Get the count of a key
Biber::Config->get_seenkey($hash);
incr_seenkey
Increment the seen count of a key
Biber::Config->incr_seenkey($ay);
get_seenname
Get the count of occurences of a labelname which
takes into account all of maxcitenames, uniquelist,
uniquename, useprefix
Biber::Config->get_seenname($name);
incr_seenname
Increment the count of occurences of a labelname which
takes into account all of maxcitenames, uniquelist,
uniquename, useprefix
Biber::Config->incr_seename($name);
reset_seen_extra
Reset the counters for extra*
Biber::Config->reset_extra;
incr_seen_extrayear
Increment and return the counter for extrayear
Biber::Config->incr_seen_extrayear($ay);
incr_seen_extraalpha
Increment and return the counter for extraalpha
Biber::Config->incr_seen_extraalpha($ay);
get_seen_nameyear
Get the count of an labelname/labelyear combination for tracking
extrayear. It uses labelyear plus name as we need to disambiguate
entries with different labelyear (like differentiating 1984--1986 from
just 1984)
Biber::Config->get_seen_nameyear($ny);
incr_seen_nameyear
Increment the count of an labelname/labelyear combination for extrayear
Biber::Config->incr_seen_nameyear($ns, $ys);
We pass in the name and year strings separately as we have to
be careful and only increment this counter beyond 1 if there is
both a name and year component. Otherwise, extrayear gets defined for all
entries with no name but the same year etc.
get_uniquelistcount
Get the number of uniquelist entries for a (possibly partial) list
Biber::Config->get_uniquelistcount($namelist);
add_uniquelistcount
Incremenent the count for a list part to the data for a name
Biber::Config->add_uniquelistcount($liststring);
add_uniquelistcount_final
Incremenent the count for a complete list to the data for a name
Biber::Config->add_uniquelistcount_final($liststring);
add_uniquelistcount_minyear
Incremenent the count for a list and year to the data for a name
Used to track uniquelist = minyear
Biber::Config->add_uniquelistcount_minyear($minyearliststring, $year, $namelist);
get_uniquelistcount_minyear
Get the count for a list and year to the data for a name
Used to track uniquelist = minyear
Biber::Config->get_uniquelistcount_minyear($minyearliststring, $year);
get_uniquelistcount_final
Get the number of uniquelist entries for a full list
Biber::Config->get_uniquelistcount_final($namelist);
reset_uniquelistcount
Reset the count for list parts and complete lists
Biber::Config->reset_uniquelistcount;
list_differs_nth
Returns true if some other list differs at passed nth place
and is at least as long
list_differs_nth([a, b, c, d, e], 3) = 1
if there is another list like any of these:
[a, b, d, e, f]
[a, b, e, z, z, y]
Biber::Config->list_differs_nth($namelist, $n)
list_differs_last
Returns true if some list differs from passed list in its last place
list_differs_last([a, b, c]) = 1
if there is another list like any of these:
[a, b, d]
[a, b, d, e]
Biber::Config->list_differs_last($namelist)
list_differs_superset
Returns true if some list differs from passed list by being
identical to the list up to the end of the list but also
by having extra elements after this
list_differs_superset([a, b, c]) = 1
if there is another list like any of these:
[a, b, c, d]
[a, b, c, d, e]
Biber::Config->list_differs_superset($namelist)
get_numofuniquenames
Get the number of uniquenames entries for a visible name
Biber::Config->get_numofuniquenames($name);
get_numofuniquenames_all
Get the number of uniquenames entries for a name
Biber::Config->get_numofuniquenames_all($name);
add_uniquenamecount
Add a name to the list of name contexts which have the name in it
(only called for visible names)
Biber::Config->add_uniquenamecount($name, $namecontext);
add_uniquenamecount_all
Add a name to the list of name contexts which have the name in it
(called for all names)
Biber::Config->add_uniquenamecount_all($name, $namecontext);
reset_uniquenamecount
Reset the list of names which have the name part in it
Biber::Config->reset_uniquenamecount;
_get_uniquename
Get the list of name contexts which contain a name
Mainly for use in tests
Biber::Config->get_uniquename($name);
get_crossrefkeys
Return ref to array of keys which are crossref targets
Biber::Config->get_crossrefkeys();
get_crossrefkey
Return an integer representing the number of times a
crossref target key has been ref'ed
Biber::Config->get_crossrefkey($key);
del_crossrefkey
Remove a crossref target key from the crossrefkeys state
Biber::Config->del_crossrefkey($key);
incr_crossrefkey
Increment the crossreferences count for a target crossref key
Biber::Config->incr_crossrefkey($key);
set_displaymode
Set the display mode for a field.
setdisplaymode(['entrytype'], ['field'], ['citekey'], $value)
This sets the desired displaymode to use for some data in the bib.
Of course, this is entirey separate semantically from the
displaymodes *defined* in the bib which just tell you what to return
for a particular displaymode request for some data.
get_displaymode
Get the display mode for a field.
getdisplaymode(['entrytype'], ['field'], ['citekey'])
Returns the displaymode. In order of decreasing preference, returns:
1. Mode defined for a specific field in a specific citekey
2. Mode defined for a citekey
3. Mode defined for a fieldtype (any citekey)
4. Mode defined for an entrytype (any citekey)
5. Mode defined globally (any citekey)
dump
Dump config information (for debugging)
AUTHORS
Francois Charette, "<firmicus at ankabut.net>" Philip Kime "<philip at kime.org.uk>"
BUGS
Please report any bugs or feature requests on our sourceforge tracker at <https://sourceforge.net/tracker2/?func=browse&group_id=228270>.
COPYRIGHT & LICENSE
Copyright 2009-2012 Francois Charette and Philip Kime, all rights reserved.
This module is free software. You can redistribute it and/or modify it under the terms of the Artistic License 2.0.
This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of
merchantability or fitness for a particular purpose.
perl v5.14.2 2012-06-17 Biber::Config(3pm)