]> git.lyx.org Git - lyx.git/blobdiff - src/LaTeXFeatures.h
Changed a '1.4.4' to '1.4.5'
[lyx.git] / src / LaTeXFeatures.h
index 70054ca33d61b436fcdac1879a6fe0db67fc5b63..878b466797505646ba5c9e564c7f544416b8b1fb 100644 (file)
 // -*- 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
 
 
-#ifdef __GNUG__
-#pragma interface
-#endif
+#include "OutputParams.h"
+#include "support/docstring.h"
 
-#include <vector>
 #include <set>
+#include <list>
+#include <map>
+#include <string>
 
-#include "LString.h"
 
-class BufferParams; 
-class LyXTextClass;
-struct Language;
+namespace lyx {
 
-/** 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(BufferParams const &, int n) ;
-       /// The packaes needed by the document
-       string getPackages();
-       /// The macros definitions needed by the document
-       string getMacros();
-       /// The definitions needed by the document's textclass
-       string getTClassPreamble();
+class Buffer;
+class BufferParams;
+class Language;
 
+/** 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 packages needed by the document
+       std::string const getPackages() const;
+       /// The macros definitions needed by the document
+       std::string const getMacros() const;
        ///
-       void showStruct();
-
+       std::string const getBabelOptions() const;
+       /// The definitions needed by the document's textclass
+       docstring const getTClassPreamble() 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(std::ostream & os) const;
+       /// Print requirements to lyxerr
+       void showStruct() const;
+       ///
+       void addPreambleSnippet(std::string const &);
        /// Provide a string name-space to the requirements
-       void require(string const & name);
-
-       /// Static preamble bits from the external material insets
-       string externalPreambles;
-
-       //@Man: Packages
-       //@{
-       ///
-       bool color;     // color.sty
-#ifdef USE_GRAPHICX
-       ///
-       bool graphicx; // graphicx.sty
-#else
-       ///
-       bool graphics;  // graphics.sty
-#endif
-       ///
-       bool setspace;  // setspace.sty
-       ///
-       bool makeidx;   // makeind.sty
-       ///
-       bool verbatim;  // verbatim.sty
-       ///
-       bool longtable; // longtable.sty
-       ///
-       bool algorithm; // algorithm.sty
-       ///
-       bool rotating;  // rotating.sty
+       void require(std::string const & name);
+       /// 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 amssymb;   // amssymb.sty
+       void useFloat(std::string const & name);
        ///
-       bool latexsym;   // latexsym.sty
+       void useLanguage(Language const *);
        ///
-       bool pifont;    // pifont.sty
+       bool hasLanguages() const;
        ///
-       bool subfigure; // subfigure.sty
+       std::string getLanguages() const;
        ///
-       bool floatflt;  // floatflt.sty
+       std::set<std::string> getEncodingSet(std::string const & doc_encoding) const;
        ///
-       bool url;       // url.sty
+       void useLayout(docstring const & lyt);
        ///
-       bool varioref;  // varioref.sty
+       Buffer const & buffer() const;
        ///
-       bool prettyref; // prettyref.sty
+       void setBuffer(Buffer const &);
        ///
-       bool chess;     // chess.sty
-       //@}
+       BufferParams const & bufferParams() const;
+       /// the return value is dependent upon both LyXRC and LaTeXFeatures.
+       bool useBabel() const;
+       /// Runparams that will be used for exporting this file.
+       OutputParams const & runparams() const { return runparams_; }
 
-       
-       //@Man: Commands
-       //@{
-       ///
-       bool lyx;
-       ///
-       bool lyxline;
-       /// \noun
-       bool noun;
-       /// \lyxarrow
-       bool lyxarrow;
-       //@}
-       
-       //@Man: Quotes
-       //@{
-       ///
-       bool quotesinglbase;
-       ///
-       bool quotedblbase;
-       ///
-       bool guilsinglleft;
-       ///
-       bool guilsinglright;
-       ///
-       bool guillemotleft;
-       ///
-       bool guillemotright;
-       //@}
-       
-       //@Man: Math mode
-       //@{
+private:
+       std::list<docstring> usedLayouts_;
+
+       /// Static preamble bits from the external material insets
+       typedef std::list<std::string> FeaturesList;
        ///
-       bool amsstyle;
+       FeaturesList features_;
        ///
-       bool boldsymbol;
+       FeaturesList preamble_snippets_;
+       /// The available (required) packages
+       typedef std::list<std::string> PackagesList;
        ///
-       bool binom;
-       //@}
-       
-       //@Man: Layouts
-       //@{
-       std::vector<bool> layout;
-       //@}
-       
-       //@Man: Special features
-       //@{
-       bool LyXParagraphIndent;
+       static PackagesList packages_;
        ///
-       bool NeedLyXFootnoteCode;
+       typedef std::set<Language const *> LanguageList;
+       /// used languages (only those that are supported by babel)
+       LanguageList UsedLanguages_;
        ///
-       bool NeedLyXMinipageIndent;
+       typedef std::set<std::string> UsedFloats;
        ///
-       typedef std::set<Language const *> LanguageList;
+       UsedFloats usedFloats_;
        ///
-       LanguageList UsedLanguages;
+       typedef std::map<docstring , std::string> FileMap;
        ///
-       typedef std::set<string> FloatList;
+       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_;
        ///
-       FloatList usedFloats;
-       //@}
-       BufferParams const & bufferParams() const;
-private:
-       BufferParams const & params;
+       BufferParams const & params_;
+       /** Some insets need to know details about the to-be-produced file
+        *  in validate().
+        */
+       OutputParams const & runparams_;
 };
 
+
+} // namespace lyx
+
 #endif