// -*- C++ -*-
-/* This file is part of
- * ======================================================
+/**
+ * \file lyxtextclass.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
*
- * LyX, The Document Processor
- *
- * Copyright 1995 Matthias Ettrich
- * Copyright 1995-2001 The LyX Team.
- *
- * ====================================================== */
+ * Full author contact details are available in file CREDITS.
+ */
#ifndef LYXTEXTCLASS_H
#define LYXTEXTCLASS_H
-#ifdef __GNUG__
-#pragma interface
-#endif
-
#include "lyxlayout.h"
-#include "LString.h"
#include "lyxlayout_ptr_fwd.h"
-#include "FloatList.h"
-#include "support/types.h"
+#include <boost/shared_ptr.hpp>
#include <vector>
+#include <set>
+
+namespace lyx {
+
+namespace support { class FileName; }
class LyXLex;
+class Counters;
+class FloatList;
+
///
+class CharStyle {
+public:
+ std::string name;
+ std::string latextype;
+ std::string latexname;
+ std::string latexparam;
+ LyXFont font;
+ LyXFont labelfont;
+ docstring preamble;
+};
+
+
+/// List of semantically defined character style insets
+typedef std::vector<CharStyle> CharStyles;
+
+
+/// Stores the layout specification of a LyX document class.
class LyXTextClass {
public:
- ///
+ /// The individual styles comprising the document class
typedef std::vector<LyXLayout_ptr> LayoutList;
- ///
+ /// Enumerate the paragraph styles.
typedef LayoutList::const_iterator const_iterator;
- ///
+ /// Construct a layout with default values. Actual values loaded later.
explicit
- LyXTextClass (string const & = string(),
- string const & = string(),
- string const & = string());
+ LyXTextClass(std::string const & = std::string(),
+ std::string const & = std::string(),
+ std::string const & = std::string(),
+ bool = false);
- ///
+ /// check whether the TeX class is available
+ bool isTeXClassAvailable() const;
+
+ /// paragraph styles begin iterator.
const_iterator begin() const { return layoutlist_.begin(); }
- ///
+ /// paragraph styles end iterator
const_iterator end() const { return layoutlist_.end(); }
- ///
- bool Read(string const & filename, bool merge = false);
+ /// Performs the read of the layout file.
+ bool read(support::FileName const & filename, bool merge = false);
///
void readOutputType(LyXLex &);
///
+ void readTitleType(LyXLex &);
+ ///
void readMaxCounter(LyXLex &);
///
void readClassOptions(LyXLex &);
///
+ void readCharStyle(LyXLex &, std::string const &);
+ ///
void readFloat(LyXLex &);
///
- bool hasLayout(string const & name) const;
+ void readCounter(LyXLex &);
+ ///
+ bool hasLayout(std::string const & name) const;
///
- LyXLayout_ptr const & operator[](string const & vname) const;
+ LyXLayout_ptr const & operator[](std::string const & vname) const;
/// Sees to that the textclass structure has been loaded
- bool load() const;
+ bool load(std::string const & path = std::string()) const;
+ /// Has this layout file been loaded yet?
+ bool loaded() const { return loaded_; }
- /// the list of floats defined in the class
+ /// the list of floats defined in the document class
FloatList & floats();
- /// the list of floats defined in the class
+ /// the list of floats defined in the document class
FloatList const & floats() const;
-
+ /// The Counters present in this document class.
+ Counters & counters() const;
+ /// CharStyles of this doc class
+ CharStyles & charstyles() const { return charstylelist_; };
+ /// Retrieve element of name s:
+ CharStyles::iterator charstyle(std::string const & s) const;
///
- string const defaultLayoutName() const;
+ std::string const & defaultLayoutName() const;
///
LyXLayout_ptr const & defaultLayout() const;
///
- string const & name() const;
+ std::string const & name() const;
///
- string const & latexname() const;
+ std::string const & latexname() const;
///
- string const & description() const;
+ std::string const & description() const;
///
- string const & opt_fontsize() const;
+ std::string const & opt_fontsize() const;
///
- string const & opt_pagestyle() const;
+ std::string const & opt_pagestyle() const;
///
- string const & options() const;
+ std::string const & options() const;
///
- string const & pagestyle() const;
+ std::string const & class_header() const;
///
- string const & preamble() const;
-
- /// Packages that are already loaded by the class
- enum Provides {
- ///
- nothing = 0,
- ///
- amsmath = 1,
- ///
- makeidx = 2,
- ///
- url = 4,
- ///
- natbib = 8
- };
+ std::string const & pagestyle() const;
///
- bool provides(Provides p) const;
+ docstring const & preamble() const;
+
+ /// is this feature already provided by the class?
+ bool provides(std::string const & p) const;
///
unsigned int columns() const;
///
int tocdepth() const;
- ///
+ /// Can be LaTeX, DocBook, etc.
OutputType outputType() const;
///
LyXFont const & defaultfont() const;
/// Text that dictates how wide the left margin is on the screen
- string const & leftmargin() const;
+ std::string const & leftmargin() const;
/// Text that dictates how wide the right margin is on the screen
- string const & rightmargin() const;
- ///
- int maxcounter() const;
+ std::string const & rightmargin() const;
+
+ /// The type of command used to produce a title
+ LYX_TITLE_LATEX_TYPES titletype() const;
+ /// The name of the title command
+ std::string const & titlename() const;
+
///
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;
private:
///
- bool delete_layout(string const &);
+ bool delete_layout(std::string const &);
///
bool do_readStyle(LyXLex &, LyXLayout &);
- ///
- string name_;
- ///
- string latexname_;
- ///
- string description_;
+ /// Layout file name
+ std::string name_;
+ /// document class name
+ std::string latexname_;
+ /// document class description
+ std::string description_;
/// Specific class options
- string opt_fontsize_;
- ///
- string opt_pagestyle_;
+ std::string opt_fontsize_;
///
- string options_;
+ std::string opt_pagestyle_;
///
- string pagestyle_;
+ std::string options_;
///
- string defaultlayout_;
+ std::string pagestyle_;
///
- string preamble_;
+ std::string class_header_;
///
- Provides provides_;
+ std::string defaultlayout_;
+ /// preamble text to support layout styles
+ docstring preamble_;
+ /// latex packages loaded by document class.
+ std::set<std::string> provides_;
///
unsigned int columns_;
///
PageSides sides_;
- ///
+ /// header depth to have numbering
int secnumdepth_;
- ///
+ /// header depth to appear in table of contents
int tocdepth_;
- ///
+ /// Can be LaTeX, DocBook, etc.
OutputType outputType_;
/** Base font. The paragraph and layout fonts are resolved against
this font. This has to be fully instantiated. Attributes
*/
LyXFont defaultfont_;
/// Text that dictates how wide the left margin is on the screen
- string leftmargin_;
+ std::string leftmargin_;
/// Text that dictates how wide the right margin is on the screen
- string rightmargin_;
- ///
- int maxcounter_; // add approp. signedness
+ std::string rightmargin_;
- ///
+ /// The type of command used to produce a title
+ LYX_TITLE_LATEX_TYPES titletype_;
+ /// The name of the title command
+ std::string titlename_;
+
+ /// Paragraph styles used in this layout
LayoutList layoutlist_;
+ /// CharStyles available to this layout
+ mutable CharStyles charstylelist_;
- ///
- FloatList floatlist_;
+ /// 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> ctrs_;
/// Has this layout file been loaded yet?
- mutable bool loaded;
-};
+ mutable bool loaded_;
+ /// Is the TeX class available?
+ bool texClassAvail_;
-///
-inline
-void operator|=(LyXTextClass::Provides & p1, LyXTextClass::Provides p2)
-{
- p1 = static_cast<LyXTextClass::Provides>(p1 | p2);
-}
+ /// The minimal TocLevel of sectioning layouts
+ int min_toclevel_;
+ /// The maximal TocLevel of sectioning layouts
+ int max_toclevel_;
+};
-///
+/// convert page sides option to text 1 or 2
std::ostream & operator<<(std::ostream & os, LyXTextClass::PageSides p);
+
+} // namespace lyx
+
#endif