/// and the values are the associated field values.
typedef std::map<docstring, docstring>::const_iterator const_iterator;
///
/// and the values are the associated field values.
typedef std::map<docstring, docstring>::const_iterator const_iterator;
///
BibTeXInfo() : is_bibtex_(true), modifier_(0) {}
/// argument sets isBibTeX_, so should be false only if it's coming
/// from a bibliography environment
BibTeXInfo() : is_bibtex_(true), modifier_(0) {}
/// argument sets isBibTeX_, so should be false only if it's coming
/// from a bibliography environment
/// constructor that sets the entryType
BibTeXInfo(docstring const & key, docstring const & type);
/// \return the short form of an authorlist, used for sorting
/// constructor that sets the entryType
BibTeXInfo(docstring const & key, docstring const & type);
/// \return the short form of an authorlist, used for sorting
- docstring const getAbbreviatedAuthor(bool jurabib_style = false) const;
- /// \return the short form of an authorlist, translated to the
- /// buffer language.
- docstring const getAbbreviatedAuthor(Buffer const & buf, bool jurabib_style = false) const;
+ /// this will be translated to the UI language if buf is null
+ /// otherwise, it will be translated to the buffer language.
+ docstring const getAbbreviatedAuthor(
+ Buffer const * buf = 0, bool jurabib_style = false) const;
- /// \param pointer to crossref information
- docstring const & getInfo(BibTeXInfo const * const xref,
+ /// \param vector of pointers to crossref/xdata information
+ docstring const & getInfo(BibTeXInfoList const xrefs,
Buffer const & buf, bool richtext) const;
/// \return formatted BibTeX data for a citation label
Buffer const & buf, bool richtext) const;
/// \return formatted BibTeX data for a citation label
Buffer const & buf, docstring const & format, bool richtext,
Buffer const & buf, docstring const & format, bool richtext,
const docstring & dialog, bool next = false) const;
///
const_iterator find(docstring const & f) const { return bimap_.find(f); }
const docstring & dialog, bool next = false) const;
///
const_iterator find(docstring const & f) const { return bimap_.find(f); }
bool isBibTeX() const { return is_bibtex_; }
private:
/// like operator[], except, if the field is empty, it will attempt
bool isBibTeX() const { return is_bibtex_; }
private:
/// like operator[], except, if the field is empty, it will attempt
- /// to get the data from xref BibTeXInfo object, which would normally
- /// be the one referenced in the crossref field.
+ /// to get the data from xref BibTeXInfo objects, which would normally
+ /// be the one referenced in the crossref or xdata field.
docstring getValueForKey(std::string const & key, Buffer const & buf,
docstring const & before, docstring const & after, docstring const & dialog,
docstring getValueForKey(std::string const & key, Buffer const & buf,
docstring const & before, docstring const & after, docstring const & dialog,
/// replace %keys% in a format string with their values
/// called from getInfo()
/// format strings may contain:
/// replace %keys% in a format string with their values
/// called from getInfo()
/// format strings may contain:
/// moreover, keys that look like "%_key%" are treated as translatable
/// so that things like "pp." and "vol." can be translated.
docstring expandFormat(docstring const & fmt,
/// moreover, keys that look like "%_key%" are treated as translatable
/// so that things like "pp." and "vol." can be translated.
docstring expandFormat(docstring const & fmt,
Buffer const & buf, docstring before = docstring(),
docstring after = docstring(), docstring dialog = docstring(),
bool next = false) const;
Buffer const & buf, docstring before = docstring(),
docstring after = docstring(), docstring dialog = docstring(),
bool next = false) const;
/// bibliography key --> data for that key
typedef std::map<docstring, BibTeXInfo>::const_iterator const_iterator;
/// bibliography key --> data for that key
typedef std::map<docstring, BibTeXInfo>::const_iterator const_iterator;
/// \return a sorted vector of bibliography keys
std::vector<docstring> const getKeys() const;
/// \return a sorted vector of present BibTeX fields
/// \return a sorted vector of bibliography keys
std::vector<docstring> const getKeys() const;
/// \return a sorted vector of present BibTeX fields
/// \return the year from the bibtex data record for \param key
/// if \param use_modifier is true, then we will also append any
/// modifier for this entry (e.g., 1998b).
/// \return the year from the bibtex data record for \param key
/// if \param use_modifier is true, then we will also append any
/// modifier for this entry (e.g., 1998b).
- /// Note that this will get the year from the crossref if it's
- /// not present in the record itself.
+ /// If no legacy year field is present, check for date (common in
+ /// biblatex) and extract the year from there.
+ /// Note further that this will get the year from the crossref or xdata
+ /// if it's not present in the record itself.
docstring const getYear(docstring const & key,
bool use_modifier = false) const;
/// \return the year from the bibtex data record for \param key
/// if \param use_modifier is true, then we will also append any
/// modifier for this entry (e.g., 1998b).
docstring const getYear(docstring const & key,
bool use_modifier = false) const;
/// \return the year from the bibtex data record for \param key
/// if \param use_modifier is true, then we will also append any
/// modifier for this entry (e.g., 1998b).
- /// Note that this will get the year from the crossref if it's
- /// not present in the record itself.
+ /// If no legacy year field is present, check for date (common in
+ /// biblatex) and extract the year from there.
+ /// Note further that this will get the year from the crossref or xdata
+ /// if it's not present in the record itself.
/// If no year is found, \return "No year" translated to the buffer
/// language.
docstring const getYear(docstring const & key, Buffer const & buf,
/// If no year is found, \return "No year" translated to the buffer
/// language.
docstring const getYear(docstring const & key, Buffer const & buf,
docstring const getCiteNumber(docstring const & key) const;
/// \return formatted BibTeX data associated with a given key.
/// Empty if no info exists.
docstring const getCiteNumber(docstring const & key) const;
/// \return formatted BibTeX data associated with a given key.
/// Empty if no info exists.
/// If \param richtext is true, then it will output any richtext tags
/// marked in the citation format and escape < and > elsewhere.
docstring const getInfo(docstring const & key, Buffer const & buf,
bool richtext = false) const;
/// \return formatted BibTeX data for citation labels.
/// Citation labels can have more than one key.
/// If \param richtext is true, then it will output any richtext tags
/// marked in the citation format and escape < and > elsewhere.
docstring const getInfo(docstring const & key, Buffer const & buf,
bool richtext = false) const;
/// \return formatted BibTeX data for citation labels.
/// Citation labels can have more than one key.
- docstring const getLabel(std::vector<docstring> const & keys,
- Buffer const & buf, std::string const & style, bool richtext,
- docstring const & before, docstring const & after,
+ docstring const getLabel(std::vector<docstring> keys,
+ Buffer const & buf, std::string const & style, bool for_xhtml,
+ size_t max_size, docstring const & before, docstring const & after,
docstring const & dialog = docstring()) const;
/// Is this a reference from a bibtex database
/// or from a bibliography environment?
docstring const & dialog = docstring()) const;
/// Is this a reference from a bibtex database
/// or from a bibliography environment?
/// list of keys, using either numerical or author-year style depending
/// upon the active engine.
std::vector<docstring> const getCiteStrings(std::vector<docstring> const & keys,
/// list of keys, using either numerical or author-year style depending
/// upon the active engine.
std::vector<docstring> const getCiteStrings(std::vector<docstring> const & keys,
- std::vector<CitationStyle> const & styles, Buffer const & buf, bool richtext,
- docstring const & before, docstring const & after,
- docstring const & dialog = docstring()) const;
- /// Collects the cited entries from buf.
- void collectCitedEntries(Buffer const & buf);
+ std::vector<CitationStyle> const & styles, Buffer const & buf,
+ docstring const & before, docstring const & after, docstring const & dialog,
+ size_t max_size) const;
/// A list of BibTeX keys cited in the current document, sorted by
/// the last name of the author.
/// Make sure you have called collectCitedEntries() before you try to
/// A list of BibTeX keys cited in the current document, sorted by
/// the last name of the author.
/// Make sure you have called collectCitedEntries() before you try to