#define TEXTCLASS_H
#include "ColorCode.h"
+#include "Counters.h"
+#include "FloatList.h"
#include "FontInfo.h"
+#include "Layout.h"
#include "LayoutEnums.h"
-#include "LayoutPtr.h"
-#include "TextClassPtr.h"
+#include "LayoutModuleList.h"
#include "insets/InsetLayout.h"
#include "support/docstring.h"
#include "support/types.h"
-#include <boost/shared_ptr.hpp>
+#include <boost/noncopyable.hpp>
#include <list>
#include <map>
#include <set>
+#include <string>
#include <vector>
namespace lyx {
namespace support { class FileName; }
-class Layout;
-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
+/// assignment constructor private.
+class ProtectCopy
+{
+protected:
+ ProtectCopy() {}
+ ~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.
///
-/// The main function of TextClass objecs is to provide layout information
-/// to a Buffer, by being the TextClass associated with the BufferParams for
-/// a given Buffer. This is the object returned by BufferParams::textClass().
-/// These instances of TextClass do not necessarily correspond just to a
-/// *.layout file---that is, to a LyX "document class" or *.layout file---
-/// since a Buffer's TextClass, though always based upon a "document class"
-/// may be modified by loading modules.
-
-/// That said, some TextClass instances do correspond strictly to document
-/// classes, that is, to *.layout files. These instances are known in the code
-/// as "base classes". These are cached in BaseClassList.
+/// 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
+/// 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
+/// 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
+/// unloaded, for example.
///
-/// Though it does not presently exist, one can imagine an extension of this
-/// mechanism that would lead to caching of *.module or *.inc files. In that
-/// case, some TextClass's would just correspond to *.module or *.inc files,
-/// just as some now correspond to *.layout files.
-class TextClass {
+class TextClass : protected ProtectCopy {
public:
+ ///
+ virtual ~TextClass() {}
+ ///////////////////////////////////////////////////////////////////
+ // typedefs
+ ///////////////////////////////////////////////////////////////////
+ // NOTE Do NOT try to make this a container of Layout pointers, e.g.,
+ // 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.
+ //
+ // 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::vector<LayoutPtr> LayoutList;
+ typedef std::list<Layout> LayoutList;
/// The inset layouts available to this class
typedef std::map<docstring, InsetLayout> InsetLayouts;
- /// Construct a layout with default values. Actual values loaded later.
- explicit TextClass(std::string const & = std::string(),
- std::string const & = std::string(),
- std::string const & = std::string(),
- bool texClassAvail = false);
-
- /// check whether the TeX class is available
- bool isTeXClassAvailable() const;
-
- /// Enumerate the paragraph styles.
- size_t layoutCount() const { return layoutlist_.size(); }
- /// Access the paragraph styles.
- LayoutPtr const & layout(size_t index) const { return layoutlist_[index]; }
-
- /// Enum used with TextClass::read
- 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
- };
- /// Performs the read of the layout file.
- /// \return true on success.
- bool read(support::FileName const & filename, ReadType rt = BASECLASS);
///
- void readOutputType(Lexer &);
- ///
- void readTitleType(Lexer &);
- ///
- void readMaxCounter(Lexer &);
- ///
- void readClassOptions(Lexer &);
- ///
- void readCharStyle(Lexer &, std::string const &);
- ///
- void readFloat(Lexer &);
- ///
- void readCounter(Lexer &);
- ///
- bool hasLayout(docstring const & name) const;
+ typedef LayoutList::const_iterator const_iterator;
+ ///////////////////////////////////////////////////////////////////
+ // Iterators
+ ///////////////////////////////////////////////////////////////////
+ ///
+ const_iterator begin() const { return layoutlist_.begin(); }
///
- LayoutPtr const & operator[](docstring const & vname) const;
+ const_iterator end() const { return layoutlist_.end(); }
- /// Sees to that the textclass structure has been loaded
- bool load(std::string const & path = std::string()) const;
- /// Has this layout file been loaded yet?
- /// NOTE This only makes sense when used with "static" TextClass
- /// objects, e.g., ones that represent files on disk, as opposed
- /// to ones that can be modified by modules.
- // FIXME Should we have a modular_ variable, set to true when
- // we load a module, that would force false to be returned here?
- bool loaded() const { return loaded_; }
- /// the list of floats defined in the document class
- FloatList & floats();
- /// the list of floats defined in the document class
- FloatList const & floats() const;
- /// The Counters present in this document class.
- Counters & counters() const;
- /// Inset layouts of this doc class
- InsetLayouts & insetLayouts() const { return insetlayoutlist_; };
+ ///////////////////////////////////////////////////////////////////
+ // Layout Info
+ ///////////////////////////////////////////////////////////////////
///
- InsetLayout const & insetLayout(docstring const & name) const;
+ Layout const & defaultLayout() const;
///
docstring const & defaultLayoutName() const;
///
- LayoutPtr const & defaultLayout() 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
- LayoutPtr const & emptyLayout() const
- { return operator[](emptylayout_); };
- ///
- docstring const & emptyLayoutName() const
- { return emptylayout_; }
- ///
- std::string const & name() const;
- ///
- docstring const & labelstring() const;
- ///
- std::string const & latexname() const;
- ///
- std::string const & description() const;
- ///
- bool isModular() const { return modular_; }
- /// Sets the layout as a modular one. There is never any
- /// need to reset this.
- void markAsModular() { modular_ = true; }
- ///
- std::string const & opt_fontsize() const;
- ///
- std::string const & opt_pagestyle() const;
- ///
- std::string const & options() const;
+ Layout const & plainLayout() const
+ { return operator[](plain_layout_); }
+ /// the name of the plain layout
+ docstring const & plainLayoutName() const
+ { return plain_layout_; }
+ /// Enumerate the paragraph styles.
+ size_t layoutCount() const { return layoutlist_.size(); }
///
- std::string const & class_header() const;
+ bool hasLayout(docstring const & name) const;
///
- std::string const & pagestyle() const;
+ bool hasInsetLayout(docstring const & name) const;
///
- docstring const & preamble() const;
+ Layout const & operator[](docstring const & vname) const;
+ /// Inset layouts of this doc class
+ InsetLayouts const & insetLayouts() const { return insetlayoutlist_; }
- /// 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_; }
+ ///////////////////////////////////////////////////////////////////
+ // reading routines
+ ///////////////////////////////////////////////////////////////////
+ /// Enum used with TextClass::read
+ 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
+ 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);
///
- unsigned int columns() const;
- ///
- PageSides sides() const;
+ ReturnValues read(std::string const & str, ReadType rt = MODULE);
///
- int secnumdepth() const;
+ ReturnValues read(Lexer & lex, ReadType rt = BASECLASS);
+ /// validates the layout information passed in str
+ static ReturnValues validate(std::string const & str);
///
- int tocdepth() const;
+ static std::string convert(std::string const & str);
- /// Can be LaTeX, DocBook, etc.
- OutputType outputType() const;
+ ///////////////////////////////////////////////////////////////////
+ // loading
+ ///////////////////////////////////////////////////////////////////
+ /// Sees to it the textclass structure has been loaded
+ /// This function will search for $classname.layout in default directories
+ /// and an optional path, but if path points to a file, it will be loaded
+ /// directly.
+ bool load(std::string const & path = std::string()) const;
+ /// Has this layout file been loaded yet?
+ /// Overridden by DocumentClass
+ virtual bool loaded() const { return loaded_; }
+ ///////////////////////////////////////////////////////////////////
+ // accessors
+ ///////////////////////////////////////////////////////////////////
///
- FontInfo const & defaultfont() const;
-
- /// Text that dictates how wide the left margin is on the screen
- docstring const & leftmargin() const;
-
- /// Text that dictates how wide the right margin is on the screen
- docstring const & rightmargin() const;
-
- /// The type of command used to produce a title
- TitleLatexType titletype() const;
- /// The name of the title command
- std::string const & titlename() const;
-
+ std::string const & name() const { return name_; }
///
- int size() const;
- /// The minimal TocLevel of sectioning layouts
- int min_toclevel() const;
- /// The maximal TocLevel of sectioning layouts
- int max_toclevel() const;
- /// returns true if the class has a ToC structure
- bool hasTocLevels() const;
+ std::string const & description() const { return description_; }
///
- static InsetLayout const & emptyInsetLayout() { return empty_insetlayout_; }
-private:
+ std::string const & latexname() const { return latexname_; }
///
- bool deleteLayout(docstring const &);
- /// \return true for success.
- bool readStyle(Lexer &, Layout &);
+ std::string const & prerequisites() 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_; }
+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
+ 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
+ unknown layout
+ */
+ Layout createBasicLayout(docstring const & name, bool unknown = false) const;
+
+ ///////////////////////////////////////////////////////////////////
+ // non-const iterators
+ ///////////////////////////////////////////////////////////////////
+ ///
+ typedef LayoutList::iterator iterator;
+ ///
+ iterator begin() { return layoutlist_.begin(); }
+ ///
+ iterator end() { return layoutlist_.end(); }
+
+ ///////////////////////////////////////////////////////////////////
+ // members
+ ///////////////////////////////////////////////////////////////////
+ /// Paragraph styles used in this layout
+ /// This variable is mutable because unknown layouts can be added
+ /// to const textclass.
+ mutable LayoutList layoutlist_;
/// Layout file name
std::string name_;
/// document class name
std::string latexname_;
/// document class description
std::string description_;
- /// whether this is a modular layout, i.e., whether it has been
- /// modified by loading of layout modules.
- bool modular_;
+ /// available types of float, eg. figure, algorithm.
+ mutable FloatList floatlist_;
+ /// Types of counters, eg. sections, eqns, figures, avail. in document class.
+ mutable Counters counters_;
+ /// Has this layout file been loaded yet?
+ mutable bool loaded_;
+ /// Is the TeX class available?
+ bool tex_class_avail_;
+ /// document class prerequisites
+ mutable std::string prerequisites_;
///
std::string opt_fontsize_;
///
std::string class_header_;
///
docstring defaultlayout_;
- /// name of empty layout
- static const docstring emptylayout_;
+ /// name of plain layout
+ static const docstring plain_layout_;
/// preamble text to support layout styles
docstring preamble_;
+ /// 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_;
/// latex packages loaded by document class.
std::set<std::string> provides_;
/// latex packages requested by document class.
std::set<std::string> requires_;
+ /// default modules wanted by document class
+ LayoutModuleList default_modules_;
+ /// modules provided by document class
+ LayoutModuleList provided_modules_;
+ /// modules excluded by document class
+ LayoutModuleList excluded_modules_;
///
unsigned int columns_;
///
int tocdepth_;
/// Can be LaTeX, DocBook, etc.
OutputType outputType_;
+ /// Can be latex, docbook ... (the name of a format)
+ std::string outputFormat_;
/** 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
FontInfo defaultfont_;
/// Text that dictates how wide the left margin is on the screen
docstring leftmargin_;
-
/// Text that dictates how wide the right margin is on the screen
docstring rightmargin_;
-
/// The type of command used to produce a title
TitleLatexType titletype_;
/// The name of the title command
std::string titlename_;
-
- /// Paragraph styles used in this layout
- LayoutList layoutlist_;
-
/// Input layouts available to this layout
- mutable InsetLayouts insetlayoutlist_;
-
- /// available types of float, eg. figure, algorithm.
- boost::shared_ptr<FloatList> floatlist_;
-
- /// Types of counters, eg. sections, eqns, figures, avail. in document class.
- boost::shared_ptr<Counters> counters_;
-
- /// Has this layout file been loaded yet?
- mutable bool loaded_;
-
- /// Is the TeX class available?
- bool texClassAvail_;
-
+ InsetLayouts insetlayoutlist_;
/// The minimal TocLevel of sectioning layouts
int min_toclevel_;
/// The maximal TocLevel of sectioning layouts
int max_toclevel_;
+ /// Citation formatting information
+ std::map<std::string, std::string> cite_formats_;
+ /// Citation macros
+ std::map<std::string, std::string> cite_macros_;
+private:
+ ///////////////////////////////////////////////////////////////////
+ // helper routines for reading layout files
+ ///////////////////////////////////////////////////////////////////
+ ///
+ bool deleteLayout(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;
+ ///
+ void readOutputType(Lexer &);
+ ///
+ void readTitleType(Lexer &);
+ ///
+ void readMaxCounter(Lexer &);
+ ///
+ void readClassOptions(Lexer &);
+ ///
+ void readCharStyle(Lexer &, std::string const &);
+ ///
+ bool readFloat(Lexer &);
+ ///
+ void readCiteFormat(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.
+///
+/// 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 {
+public:
+ ///
+ virtual ~DocumentClass() {}
+
+ ///////////////////////////////////////////////////////////////////
+ // Layout Info
+ ///////////////////////////////////////////////////////////////////
+ /// \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; }
+ /// \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:
+ /// An erroneous 'CharStyle:badname' (e.g., after a documentclass switch)
+ /// will invoke the layout object defined by name = 'CharStyle'.
+ /// If that doesn't work either, an empty object returns (shouldn't
+ /// 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_; }
+ /// add a new layout \c name if it does not exist in layoutlist_
+ /// \return whether we had to add one.
+ bool addLayoutIfNeeded(docstring const & name) const;
+
+ ///////////////////////////////////////////////////////////////////
+ // accessors
+ ///////////////////////////////////////////////////////////////////
+ /// the list of floats defined in the document class
+ FloatList const & floats() const { return floatlist_; }
+ ///
+ Counters & counters() const { return counters_; }
+ ///
+ std::string const & opt_fontsize() const { return opt_fontsize_; }
+ ///
+ 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 & pagestyle() const { return pagestyle_; }
+ ///
+ docstring const & preamble() const { return preamble_; }
+ ///
+ docstring const & htmlpreamble() const { return htmlpreamble_; }
+ ///
+ docstring const & htmlstyles() const { return htmlstyles_; }
+ /// 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_; }
+ ///
+ unsigned int columns() const { return columns_; }
+ ///
+ PageSides sides() const { return sides_; }
///
- static InsetLayout empty_insetlayout_;
+ int secnumdepth() const { return secnumdepth_; }
+ ///
+ int tocdepth() const { return tocdepth_; }
+ ///
+ FontInfo const & defaultfont() const { return defaultfont_; }
+ /// Text that dictates how wide the left margin is on the screen
+ docstring const & leftmargin() const { return leftmargin_; }
+ /// 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_; }
+ /// The name of the title command
+ std::string const & titlename() const { return titlename_; }
+ ///
+ int size() const { return layoutlist_.size(); }
+ /// The minimal TocLevel of sectioning layouts
+ int min_toclevel() const { return min_toclevel_; }
+ /// The maximal 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(std::string const & entry_type) const;
+ ///
+ std::string const & getCiteMacro(std::string const & macro) const;
+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_;
};
-/// This is simply a container for the text classes generated when modules
-/// are read, so that they stay in memory for use by Insets, CutAndPaste,
-/// and the like. Since they're constructed via new, they wouldn't actually
-/// disappear without this class---but this class holds the pointers to them
-/// so that they don't leak.
+/// 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 makeTextClass is called) whether the old TextClass is in use anywhere.
-///
-/// This is a singleton class. Its sole instance is accessed via
-/// TextClassBundle::get().
+/// (or makeDocumentClass is called) whether the old DocumentClass is in use
+/// anywhere.
///
-/// See \file TextClassPtr.h for the definition of TextClassPtr.
-class TextClassBundle {
+/// This is a singleton class. Its sole instance is accessed via
+/// DocumentClassBundle::get().
+class DocumentClassBundle : boost::noncopyable {
public:
- /// \return Pointer to a new class equal to baseClass
- TextClassPtr newClass(TextClass const & baseClass);
/// \return The sole instance of this class.
- static TextClassBundle & get();
- ///
- ~TextClassBundle();
+ 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
- TextClassBundle() {};
- /// noncopyable
- TextClassBundle(TextClassBundle const &);
+ DocumentClassBundle() {}
+ /// clean up
+ ~DocumentClassBundle();
+ /// \return Reference to a new DocumentClass equal to baseClass
+ DocumentClass & newClass(LayoutFile const & baseClass);
///
- std::list<TextClassPtr> tc_list_;
+ std::vector<DocumentClass *> documentClasses_;
};
/// 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;
+
} // namespace lyx