/** * \file BiblioInfo.cpp * This file is part of LyX, the document processor. * Licence details can be found in the file COPYING. * * \author Angus Leeming * \author Herbert Voß * \author Richard Heck * * Full author contact details are available in file CREDITS. */ #include #include "BiblioInfo.h" #include "Buffer.h" #include "BufferParams.h" #include "buffer_funcs.h" #include "InsetIterator.h" #include "Paragraph.h" #include "insets/Inset.h" #include "insets/InsetBibitem.h" #include "insets/InsetBibtex.h" #include "insets/InsetInclude.h" #include "support/docstream.h" #include "support/gettext.h" #include "support/lstrings.h" #include "boost/regex.hpp" using namespace std; using namespace lyx::support; namespace lyx { ////////////////////////////////////////////////////////////////////// // // BibTeXInfo // ////////////////////////////////////////////////////////////////////// BibTeXInfo::BibTeXInfo(bool ib) : is_bibtex_(ib) {} BibTeXInfo::BibTeXInfo(docstring const & key, docstring const & type) : is_bibtex_(true), bib_key_(key), entry_type_(type) {} bool BibTeXInfo::hasField(docstring const & field) const { return count(field) == 1; } docstring const & BibTeXInfo::getValueForField(docstring const & field) const { BibTeXInfo::const_iterator it = find(field); if (it != end()) return it->second; static docstring const empty_value = docstring(); return empty_value; } docstring const & BibTeXInfo::getValueForField(string const & field) const { return getValueForField(from_ascii(field)); } static docstring familyName(docstring const & name) { if (name.empty()) return docstring(); // Very simple parser docstring fname = name; // possible authorname combinations are: // "Surname, FirstName" // "Surname, F." // "FirstName Surname" // "F. Surname" docstring::size_type idx = fname.find(','); if (idx != docstring::npos) return ltrim(fname.substr(0, idx)); idx = fname.rfind('.'); if (idx != docstring::npos && idx + 1 < fname.size()) fname = ltrim(fname.substr(idx + 1)); // test if we have a LaTeX Space in front if (fname[0] == '\\') return fname.substr(2); return rtrim(fname); } docstring const BibTeXInfo::getAbbreviatedAuthor() const { if (!is_bibtex_) return docstring(); docstring author = getValueForField("author"); if (author.empty()) { author = getValueForField("editor"); if (author.empty()) return bib_key_; } // OK, we've got some names. Let's format them. // Try to split the author list on " and " vector const authors = getVectorFromString(author, from_ascii(" and ")); if (authors.size() == 2) return bformat(_("%1$s and %2$s"), familyName(authors[0]), familyName(authors[1])); if (authors.size() > 2) return bformat(_("%1$s et al."), familyName(authors[0])); return familyName(authors[0]); } docstring const BibTeXInfo::getYear() const { if (!is_bibtex_) return docstring(); docstring year = getValueForField("year"); if (year.empty()) year = _("No year"); return year; } docstring const BibTeXInfo::getInfo() const { if (!is_bibtex_) { BibTeXInfo::const_iterator it = find(from_ascii("ref")); return it->second; } // FIXME // This could be made a lot better using the entryType // field to customize the output based upon entry type. // Search for all possible "required" fields docstring author = getValueForField("author"); if (author.empty()) author = getValueForField("editor"); docstring year = getValueForField("year"); docstring title = getValueForField("title"); docstring docLoc = getValueForField("pages"); if (docLoc.empty()) { docLoc = getValueForField("chapter"); if (!docLoc.empty()) docLoc = from_ascii("Ch. ") + docLoc; } else { docLoc = from_ascii("pp. ") + docLoc; } docstring media = getValueForField("journal"); if (media.empty()) { media = getValueForField("publisher"); if (media.empty()) { media = getValueForField("school"); if (media.empty()) media = getValueForField("institution"); } } docstring volume = getValueForField("volume"); odocstringstream result; if (!author.empty()) result << author << ", "; if (!title.empty()) result << title; if (!media.empty()) result << ", " << media; if (!year.empty()) result << ", " << year; if (!docLoc.empty()) result << ", " << docLoc; docstring const result_str = rtrim(result.str()); if (!result_str.empty()) return result_str; // This should never happen (or at least be very unusual!) return docstring(); } ////////////////////////////////////////////////////////////////////// // // BiblioInfo // ////////////////////////////////////////////////////////////////////// namespace { // A functor for use with sort, leading to case insensitive sorting class compareNoCase: public binary_function { public: bool operator()(docstring const & s1, docstring const & s2) const { return compare_no_case(s1, s2) < 0; } }; } // namespace anon vector const BiblioInfo::getKeys() const { vector bibkeys; BiblioInfo::const_iterator it = begin(); for (; it != end(); ++it) bibkeys.push_back(it->first); sort(bibkeys.begin(), bibkeys.end(), compareNoCase()); return bibkeys; } vector const BiblioInfo::getFields() const { vector bibfields; set::const_iterator it = field_names_.begin(); set::const_iterator end = field_names_.end(); for (; it != end; ++it) bibfields.push_back(*it); sort(bibfields.begin(), bibfields.end()); return bibfields; } vector const BiblioInfo::getEntries() const { vector bibentries; set::const_iterator it = entry_types_.begin(); set::const_iterator end = entry_types_.end(); for (; it != end; ++it) bibentries.push_back(*it); sort(bibentries.begin(), bibentries.end()); return bibentries; } docstring const BiblioInfo::getAbbreviatedAuthor(docstring const & key) const { BiblioInfo::const_iterator it = find(key); if (it == end()) return docstring(); BibTeXInfo const & data = it->second; return data.getAbbreviatedAuthor(); } docstring const BiblioInfo::getYear(docstring const & key) const { BiblioInfo::const_iterator it = find(key); if (it == end()) return docstring(); BibTeXInfo const & data = it->second; return data.getYear(); } docstring const BiblioInfo::getInfo(docstring const & key) const { BiblioInfo::const_iterator it = find(key); if (it == end()) return docstring(); BibTeXInfo const & data = it->second; return data.getInfo(); } vector const BiblioInfo::getCiteStrings( docstring const & key, Buffer const & buf) const { biblio::CiteEngine const engine = buf.params().getEngine(); if (engine == biblio::ENGINE_BASIC || engine == biblio::ENGINE_NATBIB_NUMERICAL) return getNumericalStrings(key, buf); else return getAuthorYearStrings(key, buf); } vector const BiblioInfo::getNumericalStrings( docstring const & key, Buffer const & buf) const { if (empty()) return vector(); docstring const author = getAbbreviatedAuthor(key); docstring const year = getYear(key); if (author.empty() || year.empty()) return vector(); vector const & styles = biblio::getCiteStyles(buf.params().getEngine()); vector vec(styles.size()); for (vector::size_type i = 0; i != vec.size(); ++i) { docstring str; switch (styles[i]) { case biblio::CITE: case biblio::CITEP: str = from_ascii("[#ID]"); break; case biblio::NOCITE: str = _("Add to bibliography only."); break; case biblio::CITET: str = author + " [#ID]"; break; case biblio::CITEALT: str = author + " #ID"; break; case biblio::CITEALP: str = from_ascii("#ID"); break; case biblio::CITEAUTHOR: str = author; break; case biblio::CITEYEAR: str = year; break; case biblio::CITEYEARPAR: str = '(' + year + ')'; break; } vec[i] = str; } return vec; } vector const BiblioInfo::getAuthorYearStrings( docstring const & key, Buffer const & buf) const { if (empty()) return vector(); docstring const author = getAbbreviatedAuthor(key); docstring const year = getYear(key); if (author.empty() || year.empty()) return vector(); vector const & styles = getCiteStyles(buf.params().getEngine()); vector vec(styles.size()); for (vector::size_type i = 0; i != vec.size(); ++i) { docstring str; switch (styles[i]) { case biblio::CITE: // jurabib only: Author/Annotator // (i.e. the "before" field, 2nd opt arg) str = author + "/<" + _("before") + '>'; break; case biblio::NOCITE: str = _("Add to bibliography only."); break; case biblio::CITET: str = author + " (" + year + ')'; break; case biblio::CITEP: str = '(' + author + ", " + year + ')'; break; case biblio::CITEALT: str = author + ' ' + year ; break; case biblio::CITEALP: str = author + ", " + year ; break; case biblio::CITEAUTHOR: str = author; break; case biblio::CITEYEAR: str = year; break; case biblio::CITEYEARPAR: str = '(' + year + ')'; break; } vec[i] = str; } return vec; } void BiblioInfo::fillWithBibKeys(Buffer const * const buf) { /// if this is a child document and the parent is already loaded /// use the parent's list instead [ale990412] Buffer const * const tmp = buf->masterBuffer(); BOOST_ASSERT(tmp); if (tmp != buf) { this->fillWithBibKeys(tmp); return; } for (InsetIterator it = inset_iterator_begin(buf->inset()); it; ++it) it->fillWithBibKeys(*this, it); } namespace biblio { ////////////////////////////////////////////////////////////////////// // // CitationStyle // ////////////////////////////////////////////////////////////////////// namespace { char const * const citeCommands[] = { "cite", "nocite", "citet", "citep", "citealt", "citealp", "citeauthor", "citeyear", "citeyearpar" }; unsigned int const nCiteCommands = sizeof(citeCommands) / sizeof(char *); CiteStyle const citeStyles[] = { CITE, NOCITE, CITET, CITEP, CITEALT, CITEALP, CITEAUTHOR, CITEYEAR, CITEYEARPAR }; unsigned int const nCiteStyles = sizeof(citeStyles) / sizeof(CiteStyle); CiteStyle const citeStylesFull[] = { CITET, CITEP, CITEALT, CITEALP, CITEAUTHOR }; unsigned int const nCiteStylesFull = sizeof(citeStylesFull) / sizeof(CiteStyle); CiteStyle const citeStylesUCase[] = { CITET, CITEP, CITEALT, CITEALP, CITEAUTHOR }; unsigned int const nCiteStylesUCase = sizeof(citeStylesUCase) / sizeof(CiteStyle); } // namespace anon CitationStyle::CitationStyle(string const & command) : style(CITE), full(false), forceUCase(false) { if (command.empty()) return; string cmd = command; if (cmd[0] == 'C') { forceUCase = true; cmd[0] = 'c'; } string::size_type const n = cmd.size() - 1; if (cmd != "cite" && cmd[n] == '*') { full = true; cmd = cmd.substr(0,n); } char const * const * const last = citeCommands + nCiteCommands; char const * const * const ptr = find(citeCommands, last, cmd); if (ptr != last) { size_t idx = ptr - citeCommands; style = citeStyles[idx]; } } string const CitationStyle::asLatexStr() const { string cite = citeCommands[style]; if (full) { CiteStyle const * last = citeStylesFull + nCiteStylesFull; if (find(citeStylesFull, last, style) != last) cite += '*'; } if (forceUCase) { CiteStyle const * last = citeStylesUCase + nCiteStylesUCase; if (find(citeStylesUCase, last, style) != last) cite[0] = 'C'; } return cite; } vector const getCiteStyles(CiteEngine const engine) { unsigned int nStyles = 0; unsigned int start = 0; switch (engine) { case ENGINE_BASIC: nStyles = 2; start = 0; break; case ENGINE_NATBIB_AUTHORYEAR: case ENGINE_NATBIB_NUMERICAL: nStyles = nCiteStyles - 1; start = 1; break; case ENGINE_JURABIB: nStyles = nCiteStyles; start = 0; break; } typedef vector cite_vec; cite_vec styles(nStyles); size_t i = 0; int j = start; for (; i != styles.size(); ++i, ++j) styles[i] = citeStyles[j]; return styles; } } // namespace biblio } // namespace lyx