#ifndef TEXTCLASS_H
#define TEXTCLASS_H
-#include "ColorCode.h"
+#include "Citation.h"
#include "Counters.h"
+#include "DocumentClassPtr.h"
#include "FloatList.h"
#include "FontInfo.h"
-#include "Layout.h"
#include "LayoutEnums.h"
#include "LayoutModuleList.h"
#include "support/docstring.h"
#include "support/types.h"
-#include <boost/noncopyable.hpp>
-
+#include <list>
#include <map>
#include <set>
+#include <string>
#include <vector>
-#include <list>
+
+#ifdef ERROR
+#undef ERROR
+#endif
namespace lyx {
-namespace support { class FileName; }
+namespace support {
+class FileName;
+class Lexer;
+}
-class Counters;
class FloatList;
class Layout;
class LayoutFile;
-class Lexer;
/// Based upon ideas in boost::noncopyable, inheriting from this
/// class effectively makes the copy constructor protected but the
protected:
ProtectCopy() {}
~ProtectCopy() {}
- ProtectCopy(const ProtectCopy &) {};
+ ProtectCopy(const ProtectCopy &) {}
private:
const ProtectCopy & operator=(const ProtectCopy &);
};
-/// A TextClass represents a collection of layout information: At the
+/// A TextClass represents a collection of layout information: At the
/// moment, this includes Layout's and InsetLayout's.
///
/// There are two major subclasses of TextClass: LayoutFile and
/// DocumentClass. These subclasses are what are actually used in LyX.
-/// Simple TextClass objects are not directly constructed in the main
+/// Simple TextClass objects are not directly constructed in the main
/// LyX code---the constructor is protected. (That said, in tex2lyx
/// there are what amount to simple TextClass objects.)
///
/// A LayoutFile (see LayoutFile.{h,cpp}) represents a *.layout file.
-/// These are generally static objects---though they can be reloaded
-/// from disk via LFUN_LAYOUT_RELOAD, so one should not assume that
+/// These are generally static objects---though they can be reloaded
+/// from disk via LFUN_LAYOUT_RELOAD, so one should not assume that
/// they will never change.
///
/// A DocumentClass (see below) represents the layout information that
/// is associated with a given Buffer. These are static, in the sense
/// that they will not themselves change, but which DocumentClass is
-/// associated with a Buffer can change, as modules are loaded and
+/// associated with a Buffer can change, as modules are loaded and
/// unloaded, for example.
///
class TextClass : protected ProtectCopy {
public:
///
- virtual ~TextClass() {};
+ virtual ~TextClass() {}
///////////////////////////////////////////////////////////////////
// typedefs
///////////////////////////////////////////////////////////////////
- /// The individual paragraph layouts comprising the document class
// NOTE Do NOT try to make this a container of Layout pointers, e.g.,
- // std::vector<Layout *>. This will lead to problems. The reason is
- // that DocumentClass objects are generally created by copying a
+ // std::list<Layout *>. This will lead to problems. The reason is
+ // that DocumentClass objects are generally created by copying a
// LayoutFile, which serves as a base for the DocumentClass. If the
// LayoutList is a container of pointers, then every DocumentClass
// that derives from a given LayoutFile (e.g., article) will SHARE
// a basic set of layouts. So if one Buffer were to modify a layout
// (say, Standard), that would modify that layout for EVERY Buffer
- // that was based upon the same DocumentClass. (Of course, if you
- // really, REALLY want to make LayoutList a vector<Layout *>, then
- // you can implement custom assignment and copy constructors.)
+ // that was based upon the same DocumentClass.
//
// NOTE: Layout pointers are directly assigned to paragraphs so a
// container that does not invalidate these pointers after insertion
// is needed.
+ /// The individual paragraph layouts comprising the document class
typedef std::list<Layout> LayoutList;
/// The inset layouts available to this class
typedef std::map<docstring, InsetLayout> InsetLayouts;
docstring const & defaultLayoutName() const;
///
bool isDefaultLayout(Layout const &) const;
- ///
+ ///
bool isPlainLayout(Layout const &) const;
/// returns a special layout for use when we don't really want one,
/// e.g., in table cells
- Layout const & plainLayout() const
- { return operator[](plain_layout_); };
+ Layout const & plainLayout() const
+ { return operator[](plain_layout_); }
/// the name of the plain layout
- docstring const & plainLayoutName() const
+ docstring const & plainLayoutName() const
{ return plain_layout_; }
/// Enumerate the paragraph styles.
size_t layoutCount() const { return layoutlist_.size(); }
///
Layout const & operator[](docstring const & vname) const;
/// Inset layouts of this doc class
- InsetLayouts const & insetLayouts() const { return insetlayoutlist_; };
+ InsetLayouts const & insetLayouts() const { return insetlayoutlist_; }
///////////////////////////////////////////////////////////////////
// reading routines
///////////////////////////////////////////////////////////////////
/// Enum used with TextClass::read
- enum ReadType {
+ enum ReadType {
BASECLASS, //>This is a base class, i.e., top-level layout file
MERGE, //>This is a file included in a layout file
MODULE, //>This is a layout module
+ CITE_ENGINE, //>This is a cite engine
VALIDATION //>We're just validating
};
/// return values for read()
enum ReturnValues {
OK,
+ OK_OLDFORMAT,
ERROR,
FORMAT_MISMATCH
};
/// Performs the read of the layout file.
/// \return true on success.
+ // FIXME Should return ReturnValues....
bool read(support::FileName const & filename, ReadType rt = BASECLASS);
///
- bool read(std::string const & str, ReadType rt = BASECLASS);
+ ReturnValues read(std::string const & str, ReadType rt = MODULE);
///
- ReturnValues read(Lexer & lex, ReadType rt = BASECLASS);
+ ReturnValues read(support::Lexer & lex, ReadType rt = BASECLASS);
/// validates the layout information passed in str
- static bool validate(std::string const & str);
+ static ReturnValues validate(std::string const & str);
+ /// \return the conversion of \param str to the latest layout format
+ /// compatible with the lyx format.
+ static std::string convert(std::string const & str);
///////////////////////////////////////////////////////////////////
// loading
///
std::string const & name() const { return name_; }
///
+ std::string const & path() const { return path_; }
+ ///
+ std::string const & category() const { return category_; }
+ ///
std::string const & description() const { return description_; }
///
std::string const & latexname() const { return latexname_; }
+ ///
+ std::string const & prerequisites(std::string const & sep = "\n\t") const;
/// Can be LaTeX, DocBook, etc.
OutputType outputType() const { return outputType_; }
/// Can be latex, docbook ... (the name of a format)
std::string outputFormat() const { return outputFormat_; }
+ /// Does this class redefine the output format?
+ bool hasOutputFormat() const { return has_output_format_; }
+ /// Return the non-localised names for the toc types.
+ std::map<std::string, docstring> const &
+ outlinerNames() const { return outliner_names_; }
+ /// \returns Layout named \p name if it exists, otherwise 0
+ Layout const * getLayout(docstring const & name) const;
+ /// \returns Layout named \p name if it exists, otherwise 0
+ Layout * getLayout(docstring const & name);
+
protected:
/// Protect construction
TextClass();
///
Layout & operator[](docstring const & name);
/** Create an new, very basic layout for this textclass. This is used for
- the Plain Layout common to all TextClass objects and also, in
+ the Plain Layout common to all TextClass objects and also, in
DocumentClass, for the creation of new layouts `on the fly' when
previously unknown layouts are encountered.
- \param unknown Set to true if this layout is used to represent an
+ \param unknown Set to true if this layout is used to represent an
unknown layout
*/
Layout createBasicLayout(docstring const & name, bool unknown = false) const;
-
+
///////////////////////////////////////////////////////////////////
// non-const iterators
///////////////////////////////////////////////////////////////////
mutable LayoutList layoutlist_;
/// Layout file name
std::string name_;
+ /// Layout file path (empty for system layout files)
+ std::string path_;
+ /// Class category
+ std::string category_;
/// document class name
std::string latexname_;
/// document class description
/// Has this layout file been loaded yet?
mutable bool loaded_;
/// Is the TeX class available?
- bool texClassAvail_;
+ bool tex_class_avail_;
+ /// document class prerequisites
+ mutable std::string prerequisites_;
+ /// The possible cite engine types
+ std::string opt_enginetype_;
+ /// The cite framework (bibtex, biblatex)
+ std::string citeframework_;
///
std::string opt_fontsize_;
///
+ std::string opt_pagesize_;
+ ///
std::string opt_pagestyle_;
/// Specific class options
std::string options_;
+ /// Format of the fontsize option
+ std::string fontsize_format_;
+ /// Default page size
+ std::string pagesize_;
+ /// Format of the papersize option
+ std::string pagesize_format_;
///
std::string pagestyle_;
+ /// Option for full parskip
+ std::string parskip_full_;
+ /// Option for half parskip
+ std::string parskip_half_;
+ ///
+ std::string tablestyle_;
///
std::string class_header_;
///
/// same, but for HTML output
/// this is output as is to the header
docstring htmlpreamble_;
+ /// same, but specifically for CSS information
+ docstring htmlstyles_;
+ /// the paragraph style to use for TOCs, bibliography, etc.
+ mutable docstring html_toc_section_;
+ /// root element when exporting as DocBook
+ std::string docbookroot_;
+ /// whether this root element does not accept text without a section (i.e. the first text that is met in LyX must
+ /// be considered as the abstract if this is true); this text must be output within <info> and <abstract>
+ bool docbookforceabstract_;
/// latex packages loaded by document class.
std::set<std::string> provides_;
/// latex packages requested by document class.
- std::set<std::string> requires_;
+ std::set<std::string> required_;
+ ///
+ std::map<std::string, std::string> package_options_;
/// default modules wanted by document class
LayoutModuleList default_modules_;
/// modules provided by document class
OutputType outputType_;
/// Can be latex, docbook ... (the name of a format)
std::string outputFormat_;
+ /// Does this class redefine the output format?
+ bool has_output_format_;
/** Base font. The paragraph and layout fonts are resolved against
this font. This has to be fully instantiated. Attributes
FONT_INHERIT, FONT_IGNORE, and FONT_TOGGLE are
int min_toclevel_;
/// The maximal TocLevel of sectioning layouts
int max_toclevel_;
+ /// Citation formatting information
+ std::map<CiteEngineType, std::map<std::string, std::string> > cite_formats_;
+ /// Citation macros
+ std::map<CiteEngineType, std::map<std::string, std::string> > cite_macros_;
+ /// The default BibTeX bibliography style file
+ std::map<std::string, std::string> cite_default_biblio_style_;
+ /// Citation command aliases
+ std::map<std::string, std::string> cite_command_aliases_;
+ /// The maximum number of citations before "et al."
+ size_t maxcitenames_;
+ /// Whether full author lists are supported
+ bool cite_full_author_list_;
+ /// The possible citation styles
+ std::map<CiteEngineType, std::vector<CitationStyle> > cite_styles_;
+ /// Class-added citation styles
+ std::map<CiteEngineType, std::vector<CitationStyle> > class_cite_styles_;
+ ///
+ std::map<std::string, docstring> outliner_names_;
+ /// Does this class put the bibliography to toc by itself?
+ bool bibintoc_;
private:
///////////////////////////////////////////////////////////////////
// helper routines for reading layout files
///
bool deleteLayout(docstring const &);
///
+ bool deleteInsetLayout(docstring const &);
+ ///
bool convertLayoutFormat(support::FileName const &, ReadType);
/// Reads the layout file without running layout2layout.
ReturnValues readWithoutConv(support::FileName const & filename, ReadType rt);
/// \return true for success.
- bool readStyle(Lexer &, Layout &) const;
+ bool readStyle(support::Lexer &, Layout &, ReadType) const;
+ ///
+ void readOutputType(support::Lexer &);
///
- void readOutputType(Lexer &);
+ void readTitleType(support::Lexer &);
///
- void readTitleType(Lexer &);
+ void readMaxCounter(support::Lexer &);
///
- void readMaxCounter(Lexer &);
+ void readClassOptions(support::Lexer &);
///
- void readClassOptions(Lexer &);
+ void readCharStyle(support::Lexer &, std::string const &);
///
- void readCharStyle(Lexer &, std::string const &);
+ bool readFloat(support::Lexer &);
///
- void readFloat(Lexer &);
+ std::vector<CitationStyle> const & getCiteStyles(CiteEngineType const &) const;
+ ///
+ bool readCiteEngine(support::Lexer &, ReadType, bool const add = false);
+ ///
+ int readCiteEngineType(support::Lexer &) const;
+ ///
+ bool readCiteFormat(support::Lexer &, ReadType);
+ ///
+ bool readOutlinerName(support::Lexer &);
};
/// A DocumentClass represents the layout information associated with a
/// Buffer. It is based upon a LayoutFile, but may be modified by loading
-/// various Modules.
-///
+/// various Modules.
+///
/// In that regard, DocumentClass objects are "dynamic". But this is really
/// an illusion, since DocumentClass objects are not (currently) changed
/// when, say, a new Module is loaded. Rather, the old DocumentClass is
-/// discarded---actually, it's kept around in case something on the cut
-/// stack needs it---and a new one is created from scratch.
-///
-/// In the main LyX code, DocumentClass objects are created only by
-/// DocumentClassBundle, for which see below.
-///
-class DocumentClass : public TextClass, boost::noncopyable {
+/// discarded---actually, it will be kept around if something on the cut
+/// stack needs it---and a new one is created from scratch.
+class DocumentClass : public TextClass {
public:
///
virtual ~DocumentClass() {}
/// \return true if there is a Layout with latexname lay
bool hasLaTeXLayout(std::string const & lay) const;
/// A DocumentClass nevers count as loaded, since it is dynamic
- virtual bool loaded() { return false; }
+ bool loaded() const override { return false; }
/// \return the layout object of an inset given by name. If the name
/// is not found as such, the part after the ':' is stripped off, and
/// searched again. In this way, an error fallback can be provided:
/// happen). -- Idea JMarc, comment MV
InsetLayout const & insetLayout(docstring const & name) const;
/// a plain inset layout for use as a default
- static InsetLayout const & plainInsetLayout() { return plain_insetlayout_; }
+ static InsetLayout const & plainInsetLayout();
/// add a new layout \c name if it does not exist in layoutlist_
- void addLayoutIfNeeded(docstring const & name) const;
+ /// \return whether we had to add one.
+ bool addLayoutIfNeeded(docstring const & name) const;
+ /// Forced layouts in layout file syntax
+ std::string forcedLayouts() const;
///////////////////////////////////////////////////////////////////
// accessors
///
Counters & counters() const { return counters_; }
///
+ std::string const & opt_enginetype() const { return opt_enginetype_; }
+ ///
+ std::string const & citeFramework() const { return citeframework_; }
+ ///
std::string const & opt_fontsize() const { return opt_fontsize_; }
///
+ std::string const & opt_pagesize() const { return opt_pagesize_; }
+ ///
std::string const & opt_pagestyle() const { return opt_pagestyle_; }
///
std::string const & options() const { return options_; }
///
std::string const & class_header() const { return class_header_; }
///
+ std::string const & fontsizeformat() const { return fontsize_format_; }
+ ///
+ std::string const & pagesize() const { return pagesize_; }
+ ///
+ std::string const & pagesizeformat() const { return pagesize_format_; }
+ ///
+ std::string const & fullparskip() const { return parskip_full_; }
+ ///
+ std::string const & halfparskip() const { return parskip_half_; }
+ ///
std::string const & pagestyle() const { return pagestyle_; }
///
+ std::string const & tablestyle() const { return tablestyle_; }
+ ///
docstring const & preamble() const { return preamble_; }
///
docstring const & htmlpreamble() const { return htmlpreamble_; }
+ ///
+ docstring const & htmlstyles() const { return htmlstyles_; }
+ ///
+ bool docbookforceabstract() const { return docbookforceabstract_; }
+ ///
+ std::string const & docbookroot() const { return docbookroot_; }
+ /// Looks for the layout of "highest level", other than Part (or other
+ /// layouts with a negative toc number), for use in constructing TOCs and
+ /// similar information.
+ Layout const & getTOCLayout() const;
+ /// the paragraph style to use for TOCs, Bibliography, etc
+ /// we will attempt to calculate this if it was not given
+ Layout const & htmlTOCLayout() const;
/// is this feature already provided by the class?
bool provides(std::string const & p) const;
/// features required by the class?
- std::set<std::string> const & requires() const { return requires_; }
+ std::set<std::string> const & required() const { return required_; }
+ /// package options to write to LaTeX file
+ std::map<std::string, std::string> const & packageOptions() const
+ { return package_options_; }
///
unsigned int columns() const { return columns_; }
///
/// Text that dictates how wide the right margin is on the screen
docstring const & rightmargin() const { return rightmargin_; }
/// The type of command used to produce a title
- TitleLatexType titletype() const { return titletype_; };
+ TitleLatexType titletype() const { return titletype_; }
/// The name of the title command
- std::string const & titlename() const { return titlename_; };
+ std::string const & titlename() const { return titlename_; }
///
int size() const { return layoutlist_.size(); }
/// The minimal TocLevel of sectioning layouts
int max_toclevel() const { return max_toclevel_; }
/// returns true if the class has a ToC structure
bool hasTocLevels() const;
+ ///
+ std::string const getCiteFormat(CiteEngineType const & type,
+ std::string const & entry, bool const punct = true,
+ std::string const & fallback = "") const;
+ ///
+ std::string const & getCiteMacro(CiteEngineType const & type,
+ std::string const & macro) const;
+ ///
+ std::vector<std::string> const citeCommands(CiteEngineType const &) const;
+ ///
+ std::vector<CitationStyle> const & citeStyles(CiteEngineType const &) const;
+ ///
+ std::map<std::string, std::string> const & defaultBiblioStyle() const
+ { return cite_default_biblio_style_; }
+ ///
+ std::map<std::string, std::string> const & citeCommandAliases() const
+ { return cite_command_aliases_; }
+ /// The maximum number of citations before "et al."
+ size_t max_citenames() const { return maxcitenames_; }
+ ///
+ bool fullAuthorList() const { return cite_full_author_list_; }
+ ///
+ bool bibInToc() const { return bibintoc_; }
protected:
/// Constructs a DocumentClass based upon a LayoutFile.
DocumentClass(LayoutFile const & tc);
/// Needed in tex2lyx
DocumentClass() {}
private:
- /// The only class that can create a DocumentClass is
- /// DocumentClassBundle, which calls the protected constructor.
- friend class DocumentClassBundle;
- ///
- static InsetLayout plain_insetlayout_;
+ /// The only way to make a DocumentClass is to call this function.
+ friend DocumentClassPtr
+ getDocumentClass(LayoutFile const &, LayoutModuleList const &,
+ std::string const &,
+ bool clone, bool internal);
};
-/// DocumentClassBundle is a container for DocumentClass objects, so that
-/// they stay in memory for use by Insets, CutAndPaste, and the like, even
-/// when their associated Buffers are destroyed.
-/// FIXME Some sort of garbage collection or reference counting wouldn't
-/// be a bad idea here. It might be enough to check when a Buffer is closed
-/// (or makeDocumentClass is called) whether the old DocumentClass is in use
-/// anywhere.
-///
-/// This is a singleton class. Its sole instance is accessed via
-/// DocumentClassBundle::get().
-class DocumentClassBundle : boost::noncopyable {
-public:
- /// \return The sole instance of this class.
- static DocumentClassBundle & get();
- /// \return A new DocumentClass based on baseClass, with info added
- /// from the modules in modlist.
- DocumentClass & makeDocumentClass(LayoutFile const & baseClass,
- LayoutModuleList const & modlist);
-private:
- /// control instantiation
- DocumentClassBundle() {}
- /// clean up
- ~DocumentClassBundle();
- /// \return Reference to a new DocumentClass equal to baseClass
- DocumentClass & newClass(LayoutFile const & baseClass);
- ///
- std::vector<DocumentClass *> documentClasses_;
-};
-
+/// The only way to make a DocumentClass is to call this function.
+/// The shared_ptr is needed because DocumentClass objects can be kept
+/// in memory long after their associated Buffer is destroyed, mostly
+/// on the CutStack.
+DocumentClassPtr getDocumentClass(LayoutFile const & baseClass,
+ LayoutModuleList const & modlist,
+ std::string const & cengine = std::string(),
+ bool clone = false, bool internal = false);
/// convert page sides option to text 1 or 2
std::ostream & operator<<(std::ostream & os, PageSides p);
+/// current format of layout files
+extern int const LAYOUT_FORMAT;
+/// layout format for the current lyx file format (usually equal to
+/// LAYOUT_FORMAT)
+extern int const LYXFILE_LAYOUT_FORMAT;
+
} // namespace lyx