// -*- C++ -*-
-/* This file is part of
-* ======================================================
-*
-* LyX, The Document Processor
-*
-* Copyright 1995 Matthias Ettrich
-* Copyright 1995-2000 the LyX Team.
-*
-* ====================================================== */
+/**
+ * \file LaTeXFeatures.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
+ *
+ * \author Lars Gullik Bjønnes
+ * \author Jean-Marc Lasgouttes
+ *
+ * Full author contact details are available in file CREDITS.
+ */
#ifndef LATEXFEATURES_H
#define LATEXFEATURES_H
+#include "OutputParams.h"
+#include "support/docstring.h"
-#ifdef __GNUG__
-#pragma interface
-#endif
-
-#include <vector>
-using std::vector;
+#include <set>
+#include <list>
+#include <map>
-#include "LString.h"
-class BufferParams;
-class LyXTextClass;
+namespace lyx {
+class Buffer;
+class BufferParams;
+class InsetLayout;
+class Language;
-/** The packages and commands that a buffer needs. This struct
- contains an entry for each of the latex packages and
- commands that a buffer might need. This struct is supposed to be
- extended as the need arises. Remember to update the validate function
- in buffer.C and paragraph.C when you do so. */
-struct LaTeXFeatures {
- ///
- LaTeXFeatures(int n) ;
- /// The packaes needed by the document
- string getPackages(BufferParams const & params);
+/** The packages and commands that a buffer needs. This class
+ * contains a list<string>. Each of the LaTeX packages that a buffer needs
+ * should be added with void require(string const & name).
+ *
+ * i.e require("amssymb")
+ *
+ * To add support you should only need to require() the package name as
+ * packages which don't have special requirements are handled automatically.
+ * If your new package does need special consideration you'll need to alter
+ * string const getPackages() const;
+ * Remember to update the validate function in Buffer.cpp and Paragraph.cpp
+ * when you do so.
+ */
+class LaTeXFeatures {
+public:
+ ///
+ LaTeXFeatures(Buffer const &, BufferParams const &,
+ OutputParams const &);
+ /// The color packages
+ std::string const getColorOptions() const;
+ /// The packages needed by the document
+ std::string const getPackages() const;
/// The macros definitions needed by the document
- string getMacros(BufferParams const & params);
+ docstring const getMacros() const;
+ /// Extra preamble code before babel is called
+ std::string const getBabelPresettings() const;
+ /// Extra preamble code after babel is called
+ std::string const getBabelPostsettings() const;
+ /// Do we need to pass the languages to babel directly?
+ bool needBabelLangOptions() const;
+ /// Load AMS packages when appropriate
+ std::string const loadAMSPackages() const;
/// The definitions needed by the document's textclass
- string getTClassPreamble(BufferParams const & params);
-
+ docstring const getTClassPreamble() const;
+ /// The language dependent definitions needed by the document's textclass
+ docstring const getTClassI18nPreamble(bool use_babel, bool use_polyglossia) const;
///
- void showStruct(BufferParams const & params);
-
- //@Man: Packages
- //@{
+ docstring const getTClassHTMLStyles() const;
///
- bool color; // color.sty
-#ifdef USE_GRAPHICX
+ docstring const getTClassHTMLPreamble() const;
+ /// The sgml definitions needed by the document (docbook)
+ docstring const getLyXSGMLEntities() const;
+ /// The SGML Required to include the files added with includeFile();
+ docstring const getIncludedFiles(std::string const & fname) const;
+ /// Include a file for use with the SGML entities
+ void includeFile(docstring const & key, std::string const & name);
+ /// The float definitions.
+ void getFloatDefinitions(odocstream & os) const;
+ /// Print requirements to lyxerr
+ void showStruct() const;
///
- bool graphicx; // graphicx.sty
-#else
+ void addPreambleSnippet(std::string const &);
///
- bool graphics; // graphics.sty
-#endif
+ std::string getPreambleSnippets() const;
+ /// Add a feature name requirements
+ void require(std::string const & name);
+ /// Add a set of feature names requirements
+ void require(std::set<std::string> const & names);
+ /// Which of the required packages are installed?
+ static void getAvailable();
+ /// Is the (required) package available?
+ static bool isAvailable(std::string const & name);
+ /// Has the package been required?
+ bool isRequired(std::string const & name) const;
+ /* Is it necessary to load the package? This is true if
+ isRequired is true and the feature is not provided by the
+ textclass.
+ */
+ bool mustProvide(std::string const & name) const;
///
- bool setspace; // setspace.sty
+ void useFloat(std::string const & name, bool subfloat = false);
///
- bool makeidx; // makeind.sty
+ void useLanguage(Language const *);
///
- bool verbatim; // verbatim.sty
+ bool hasLanguages() const;
+ /// check if all used languages are supported by polyglossia
+ bool hasPolyglossiaLanguages() const;
///
- bool longtable; // longtable.sty
+ std::string getLanguages() const;
///
- bool algorithm; // algorithm.sty
+ std::map<std::string, std::string> getPolyglossiaLanguages() const;
///
- bool rotating; // rotating.sty
+ std::set<std::string> getEncodingSet(std::string const & doc_encoding) const;
///
- bool amssymb; // amssymb.sty
+ void useLayout(docstring const & lyt);
///
- bool latexsym; // latexsym.sty
+ void useInsetLayout(InsetLayout const & lay);
///
- bool pifont; // pifont.sty
+ Buffer const & buffer() const;
///
- bool subfigure; // subfigure.sty
+ void setBuffer(Buffer const &);
///
- bool floatflt; // floatflt.sty
+ BufferParams const & bufferParams() const;
+ /// the return value is dependent upon both LyXRC and LaTeXFeatures.
+ bool useBabel() const;
///
- bool url; // url.sty
- //@}
+ bool usePolyglossia() const;
+ /// are we in a float?
+ bool inFloat() const { return in_float_; }
+ /// are we in a float?
+ void inFloat(bool const b) { in_float_ = b; }
+ /// Runparams that will be used for exporting this file.
+ OutputParams const & runparams() const { return runparams_; }
+ ///
+ void setHTMLTitle(docstring const & t) { htmltitle_ = t; }
+ ///
+ docstring const & htmlTitle() const { return htmltitle_; }
-
- //@Man: Commands
- //@{
+private:
///
- bool lyx;
+ std::list<docstring> usedLayouts_;
///
- bool lyxline;
- /// \noun
- bool noun;
- /// \lyxarrow
- bool lyxarrow;
- //@}
-
- //@Man: Quotes
- //@{
+ std::list<docstring> usedInsetLayouts_;
+ /// The features that are needed by the document
+ typedef std::set<std::string> Features;
///
- bool quotesinglbase;
+ Features features_;
+ /// Static preamble bits, from external templates, or anywhere else
+ typedef std::list<std::string> SnippetList;
///
- bool quotedblbase;
+ SnippetList preamble_snippets_;
+ /// The available (required) packages
+ typedef std::set<std::string> Packages;
///
- bool guilsinglleft;
+ static Packages packages_;
///
- bool guilsinglright;
+ typedef std::set<Language const *> LanguageList;
+ /// used languages (only those that are supported by babel)
+ LanguageList UsedLanguages_;
///
- bool guillemotleft;
+ typedef std::map<std::string, bool> UsedFloats;
///
- bool guillemotright;
- //@}
-
- //@Man: Math mode
- //@{
+ UsedFloats usedFloats_;
///
- bool amsstyle;
+ typedef std::map<docstring, std::string> FileMap;
///
- bool boldsymbol;
+ FileMap IncludedFiles_;
+ /** Buffer of the file being processed.
+ * This may be a child buffer of the to-be-exported file and
+ * therefore may not be the buffer that belongs to params_.
+ * Only needed by InsetInclude::validate().
+ */
+ Buffer const * buffer_;
///
- bool binom;
- //@}
-
- //@Man: Layouts
- //@{
- vector<bool> layout;
- //@}
-
- //@Man: Special features
- //@{
- bool LyXParagraphIndent;
+ BufferParams const & params_;
+ /** Some insets need to know details about the to-be-produced file
+ * in validate().
+ */
+ OutputParams const & runparams_;
///
- bool NeedLyXFootnoteCode;
+ bool in_float_;
///
- bool NeedLyXMinipageIndent;
- //@}
+ docstring htmltitle_;
};
+
+} // namespace lyx
+
#endif