* \author Angus Leeming
* \author Herbert Voß
* \author Richard Heck
+ * \author Julien Rioux
*
* Full author contact details are available in file CREDITS.
*/
#include "Citation.h"
-#include <vector>
#include <map>
#include <set>
+#include <vector>
namespace lyx {
/// and the values are the associated field values.
typedef std::map<docstring, docstring>::const_iterator const_iterator;
///
- BibTeXInfo() : is_bibtex_(true) {}
+ BibTeXInfo() : is_bibtex_(true), modifier_(0) {}
/// argument sets isBibTeX_, so should be false only if it's coming
/// from a bibliography environment
- BibTeXInfo(bool ib) : is_bibtex_(ib) {}
+ BibTeXInfo(bool ib) : is_bibtex_(ib), modifier_(0) {}
/// constructor that sets the entryType
BibTeXInfo(docstring const & key, docstring const & type);
- /// \return the short form of an authorlist
+ /// \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;
///
docstring const getYear() const;
///
Buffer const & buf, bool richtext) const;
/// \return formatted BibTeX data for a citation label
docstring const getLabel(BibTeXInfo const * const xref,
- Buffer const & buf, std::string const & format, bool richtext,
- docstring before, docstring after, docstring dialog, bool next = false) const;
+ Buffer const & buf, docstring const & format, bool richtext,
+ const docstring & before, const docstring & after,
+ const docstring & dialog, bool next = false) const;
///
const_iterator find(docstring const & f) const { return bimap_.find(f); }
///
/// 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.
- docstring getValueForKey(std::string const & key,
+ docstring getValueForKey(std::string const & key, Buffer const & buf,
docstring const & before, docstring const & after, docstring const & dialog,
- BibTeXInfo const * const xref = 0) const;
+ BibTeXInfo const * const xref, size_t maxsize = 4096) const;
/// replace %keys% in a format string with their values
/// called from getInfo()
/// format strings may contain:
/// {%key%[[format]]}, which prints format if key is non-empty
/// the latter may optionally contain an `else' clause as well:
/// {%key%[[if format]][[else format]]}
- /// material intended only for rich text (HTML) output should be
- /// wrapped in "{!" and "!}". it will be removed if richtext is
- /// false.
+ /// Material intended only for rich text (HTML) output should be
+ /// wrapped in "{!" and "!}". These markers are to be postprocessed
+ /// by processRichtext(); this step is left as a separate routine since
+ /// expandFormat() is recursive while postprocessing should be done
+ /// only once on the final string (just like convertLaTeXCommands).
/// a simple macro facility is also available. keys that look like
/// "%!key%" are substituted with their definition.
/// moreover, keys that look like "%_key%" are treated as translatable
/// so that things like "pp." and "vol." can be translated.
- docstring expandFormat(std::string const & fmt,
+ docstring expandFormat(docstring const & fmt,
BibTeXInfo const * const xref, int & counter,
- Buffer const & buf, bool richtext, 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;
/// true if from BibTeX; false if from bibliography environment
bool is_bibtex_;
/// the BibTeX key for this entry
docstring entry_type_;
/// a cache for getInfo()
mutable docstring info_;
+ /// a cache for getInfo(richtext = true)
+ mutable docstring info_richtext_;
///
docstring cite_number_;
///
/// \return a sorted vector of BibTeX entry types in use
std::vector<docstring> const getEntries() const;
/// \return the short form of an authorlist
- docstring const getAbbreviatedAuthor(docstring const & key) const;
+ docstring const getAbbreviatedAuthor(docstring const & key, Buffer const & buf) 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).
/// 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).
+ /// Note that this will get the year from the crossref 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,
+ bool use_modifier = false) const;
///
docstring const getCiteNumber(docstring const & key) const;
/// \return formatted BibTeX data associated with a given key.
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 = false,
- docstring const & before = docstring(),
- docstring const & after = docstring(),
+ 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?
/// 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 = false,
- docstring const & before = docstring(),
- docstring const & after = docstring(),
- 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
///
void addEntryType(docstring const & f) { entry_types_.insert(f); }
private:
+ /// Collects the cited entries from buf.
+ void collectCitedEntries(Buffer const & buf);
///
std::set<docstring> field_names_;
///
projects / lyx.git / blobdiff