]> git.lyx.org Git - lyx.git/blobdiff - src/BiblioInfo.h
Hack to display section symbol
[lyx.git] / src / BiblioInfo.h
index c348a235418bfcf94a2600c8e5184e38cddabe47..f4051bf2251a7b526d0de0306bdae7971e1db753 100644 (file)
@@ -6,7 +6,7 @@
  *
  * \author Angus Leeming
  * \author Herbert Voß
- * \author Richard Heck
+ * \author Richard Kimberly Heck
  * \author Julien Rioux
  *
  * Full author contact details are available in file CREDITS.
@@ -17,9 +17,6 @@
 
 #include "support/docstring.h"
 
-#include "BufferParams.h"
-#include "Citation.h"
-
 #include <map>
 #include <set>
 #include <vector>
 namespace lyx {
 
 class Buffer;
+class BufferParams;
+class CitationStyle;
+class CiteItem;
+class XMLStream;
 
 /// \param latex_str a LaTeX command, "cite", "Citep*", etc
 CitationStyle citationStyleFromString(std::string const & latex_str,
@@ -35,6 +36,9 @@ CitationStyle citationStyleFromString(std::string const & latex_str,
 /// the other way round
 std::string citationStyleToString(CitationStyle const &, bool const latex = false);
 
+/// Transforms the information about authors into a <authorgroup> (directly written to a XMLStream).
+docstring authorsToDocBookAuthorGroup(docstring const & authorsString, XMLStream & xs, Buffer const & buf);
+
 
 /// Class to represent information about a BibTeX or
 /// bibliography entry.
@@ -49,17 +53,17 @@ public:
        ///
        typedef std::vector<BibTeXInfo const *> const BibTeXInfoList;
        ///
-       BibTeXInfo() : is_bibtex_(true), modifier_(0) {}
+       BibTeXInfo() : is_bibtex_(true), num_bib_key_(0), modifier_(0) {}
        /// argument sets isBibTeX_, so should be false only if it's coming
        /// from a bibliography environment
-       BibTeXInfo(bool ib) : is_bibtex_(ib), modifier_(0) {}
+       BibTeXInfo(bool ib) : is_bibtex_(ib), num_bib_key_(0), modifier_(0) {}
        /// constructor that sets the entryType
        BibTeXInfo(docstring const & key, docstring const & type);
        /// \return an author or editor list (short form by default),
        /// used for sorting.
        /// This will be translated to the UI language if buf is null
        /// otherwise, it will be translated to the buffer language.
-       docstring const getAuthorOrEditorList(Buffer const * buf = 0,
+       docstring const getAuthorOrEditorList(Buffer const * buf = nullptr,
                        bool full = false, bool forceshort = false) const;
        /// Same for a specific author role (editor, author etc.)
        docstring const getAuthorList(Buffer const * buf, docstring const & author,
@@ -67,12 +71,15 @@ public:
                                      bool const allnames = false, bool const beginning = true) const;
        ///
        docstring const getYear() const;
+       ///
+       void getLocators(docstring & doi, docstring & url, docstring & file) const;
        /// \return formatted BibTeX data suitable for framing.
        /// \param vector of pointers to crossref/xdata information
-       docstring const & getInfo(BibTeXInfoList const xrefs,
-                       Buffer const & buf, CiteItem const & ci) const;
+       docstring const & getInfo(BibTeXInfoList const & xrefs,
+                                 Buffer const & buf, CiteItem const & ci,
+                                 docstring const & format = docstring()) const;
        /// \return formatted BibTeX data for a citation label
-       docstring const getLabel(BibTeXInfoList const xrefs,
+       docstring const getLabel(BibTeXInfoList const xrefs,
                Buffer const & buf, docstring const & format,
                CiteItem const & ci, bool next = false, bool second = false) const;
        ///
@@ -123,7 +130,7 @@ private:
        /// 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,
-               CiteItem const & ci, BibTeXInfoList const xrefs, size_t maxsize = 4096) const;
+               CiteItem const & ci, BibTeXInfoList const xrefs, size_t maxsize = 4096) const;
        /// replace %keys% in a format string with their values
        /// called from getInfo()
        /// format strings may contain:
@@ -141,7 +148,7 @@ private:
        /// 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,
-               BibTeXInfoList const xrefs, int & counter,
+               BibTeXInfoList const xrefs, int & counter,
                Buffer const & buf, CiteItem const & ci,
                bool next = false, bool second = false) const;
        /// true if from BibTeX; false if from bibliography environment
@@ -162,6 +169,8 @@ private:
        mutable docstring info_;
        /// a cache for getInfo(richtext = true)
        mutable docstring info_richtext_;
+       /// cache for last format pattern
+       mutable docstring format_;
        ///
        docstring cite_number_;
        ///
@@ -210,6 +219,9 @@ public:
        /// language.
        docstring const getYear(docstring const & key, Buffer const & buf,
                        bool use_modifier = false) const;
+       /// get either local pdf or web location of the citation referenced by key.
+       /// DOI/file are prefixed so they form proper URL for generic qt handler
+       void getLocators(docstring const & key, docstring & doi, docstring & url, docstring & file) const;
        ///
        docstring const getCiteNumber(docstring const & key) const;
        /// \return formatted BibTeX data associated with a given key.
@@ -219,7 +231,7 @@ public:
        /// output any richtext tags marked in the citation format and escape < and >
        /// elsewhere, and the general output context.
        docstring const getInfo(docstring const & key, Buffer const & buf,
-                       CiteItem const & ci) const;
+                       CiteItem const & ci, docstring const & format = docstring()) const;
        /// \return formatted BibTeX data for citation labels.
        /// Citation labels can have more than one key.
        docstring const getLabel(std::vector<docstring> keys, Buffer const & buf,