3 * \file LaTeXFeatures.h
4 * This file is part of LyX, the document processor.
5 * Licence details can be found in the file COPYING.
7 * \author Lars Gullik Bjønnes
8 * \author Jean-Marc Lasgouttes
10 * Full author contact details are available in file CREDITS.
13 #ifndef LATEXFEATURES_H
14 #define LATEXFEATURES_H
16 #include "OutputParams.h"
17 #include "support/docstring.h"
31 /** The packages and commands that a buffer needs. This class
32 * contains a list<string>. Each of the LaTeX packages that a buffer needs
33 * should be added with void require(string const & name).
35 * i.e require("amssymb")
37 * To add support you should only need to require() the package name as
38 * packages which don't have special requirements are handled automatically.
39 * If your new package does need special consideration you'll need to alter
40 * string const getPackages() const;
41 * Remember to update the validate function in Buffer.cpp and Paragraph.cpp
47 LaTeXFeatures(Buffer const &, BufferParams const &,
48 OutputParams const &);
49 /// The color packages
50 std::string const getColorOptions() const;
51 /// The packages needed by the document
52 std::string const getPackages() const;
53 /// The macros definitions needed by the document
54 docstring const getMacros() const;
55 /// Extra preamble code before babel is called
56 std::string const getBabelPresettings() const;
57 /// Extra preamble code after babel is called
58 std::string const getBabelPostsettings() const;
59 /// Do we need to pass the languages to babel directly?
60 bool needBabelLangOptions() const;
61 /// Load AMS packages when appropriate
62 std::string const loadAMSPackages() const;
63 /// The definitions needed by the document's textclass
64 docstring const getTClassPreamble() const;
65 /// The language dependent definitions needed by the document's textclass
66 docstring const getTClassI18nPreamble(bool use_babel, bool use_polyglossia) const;
68 docstring const getTClassHTMLStyles() const;
70 docstring const getTClassHTMLPreamble() const;
71 /// The sgml definitions needed by the document (docbook)
72 docstring const getLyXSGMLEntities() const;
73 /// The SGML Required to include the files added with includeFile();
74 docstring const getIncludedFiles(std::string const & fname) const;
75 /// Include a file for use with the SGML entities
76 void includeFile(docstring const & key, std::string const & name);
77 /// The float definitions.
78 void getFloatDefinitions(odocstream & os) const;
79 /// Print requirements to lyxerr
80 void showStruct() const;
82 void addPreambleSnippet(std::string const &);
84 std::string getPreambleSnippets() const;
85 /// Add a feature name requirements
86 void require(std::string const & name);
87 /// Add a set of feature names requirements
88 void require(std::set<std::string> const & names);
89 /// Which of the required packages are installed?
90 static void getAvailable();
91 /// Is the (required) package available?
92 static bool isAvailable(std::string const & name);
93 /// Has the package been required?
94 bool isRequired(std::string const & name) const;
95 /* Is it necessary to load the package? This is true if
96 isRequired is true and the feature is not provided by the
99 bool mustProvide(std::string const & name) const;
101 void useFloat(std::string const & name, bool subfloat = false);
103 void useLanguage(Language const *);
105 bool hasLanguages() const;
106 /// check if all used languages are supported by polyglossia
107 bool hasPolyglossiaLanguages() const;
109 std::string getLanguages() const;
111 std::map<std::string, std::string> getPolyglossiaLanguages() const;
113 std::set<std::string> getEncodingSet(std::string const & doc_encoding) const;
115 void useLayout(docstring const & lyt);
117 void useInsetLayout(InsetLayout const & lay);
119 Buffer const & buffer() const;
121 void setBuffer(Buffer const &);
123 BufferParams const & bufferParams() const;
124 /// the return value is dependent upon both LyXRC and LaTeXFeatures.
125 bool useBabel() const;
127 bool usePolyglossia() const;
128 /// are we in a float?
129 bool inFloat() const { return in_float_; }
130 /// are we in a float?
131 void inFloat(bool const b) { in_float_ = b; }
132 /// Runparams that will be used for exporting this file.
133 OutputParams const & runparams() const { return runparams_; }
135 void setHTMLTitle(docstring const & t) { htmltitle_ = t; }
137 docstring const & htmlTitle() const { return htmltitle_; }
141 std::list<docstring> usedLayouts_;
143 std::list<docstring> usedInsetLayouts_;
144 /// The features that are needed by the document
145 typedef std::set<std::string> Features;
148 /// Static preamble bits, from external templates, or anywhere else
149 typedef std::list<std::string> SnippetList;
151 SnippetList preamble_snippets_;
152 /// The available (required) packages
153 typedef std::set<std::string> Packages;
155 static Packages packages_;
157 typedef std::set<Language const *> LanguageList;
158 /// used languages (only those that are supported by babel)
159 LanguageList UsedLanguages_;
161 typedef std::map<std::string, bool> UsedFloats;
163 UsedFloats usedFloats_;
165 typedef std::map<docstring, std::string> FileMap;
167 FileMap IncludedFiles_;
168 /** Buffer of the file being processed.
169 * This may be a child buffer of the to-be-exported file and
170 * therefore may not be the buffer that belongs to params_.
171 * Only needed by InsetInclude::validate().
173 Buffer const * buffer_;
175 BufferParams const & params_;
176 /** Some insets need to know details about the to-be-produced file
179 OutputParams const & runparams_;
183 docstring htmltitle_;