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
46 /// Which Language package do we use?
50 LANG_PACK_POLYGLOSSIA,
54 LaTeXFeatures(Buffer const &, BufferParams const &,
55 OutputParams const &);
56 /// The color packages
57 std::string const getColorOptions() const;
58 /// The requested package options
59 std::string const getPackageOptions() const;
60 /// The packages needed by the document
61 std::string const getPackages() const;
62 /// The macros definitions needed by the document
63 docstring const getMacros() const;
64 /// Extra preamble code before babel is called
65 std::string const getBabelPresettings() const;
66 /// Extra preamble code after babel is called
67 std::string const getBabelPostsettings() const;
68 /// Do we need to pass the languages to babel directly?
69 bool needBabelLangOptions() const;
70 /// Load AMS packages when appropriate
71 std::string const loadAMSPackages() const;
72 /// The definitions needed by the document's textclass
73 docstring const getTClassPreamble() const;
74 /// The language dependent definitions needed by the document's textclass
75 docstring const getTClassI18nPreamble(bool use_babel, bool use_polyglossia) const;
77 docstring const getTClassHTMLStyles() const;
79 docstring const getTClassHTMLPreamble() const;
80 /// The sgml definitions needed by the document (docbook)
81 docstring const getLyXSGMLEntities() const;
82 /// The SGML Required to include the files added with includeFile();
83 docstring const getIncludedFiles(std::string const & fname) const;
84 /// Include a file for use with the SGML entities
85 void includeFile(docstring const & key, std::string const & name);
86 /// The float definitions.
87 void getFloatDefinitions(odocstream & os) const;
88 /// Print requirements to lyxerr
89 void showStruct() const;
91 void addPreambleSnippet(std::string const &);
93 std::string getPreambleSnippets() const;
95 void addCSSSnippet(std::string const &);
97 std::string getCSSSnippets() const;
98 /// Add a feature name requirements
99 void require(std::string const & name);
100 /// Add a set of feature names requirements
101 void require(std::set<std::string> const & names);
102 /// Is the (required) package available?
103 static bool isAvailable(std::string const & name);
104 /// Has the package been required?
105 bool isRequired(std::string const & name) const;
106 /** Is this feature already provided
107 * e.g. by the document class?
109 bool isProvided(std::string const & name) const;
110 /** Is it necessary to load the package? This is true if
111 isRequired is true and the feature is not already provided
113 bool mustProvide(std::string const & name) const;
115 void useFloat(std::string const & name, bool subfloat = false);
117 void useLanguage(Language const *);
119 bool hasLanguages() const;
120 /// check if all used languages are supported by polyglossia
121 bool hasOnlyPolyglossiaLanguages() const;
122 /// check if a language is supported only by polyglossia
123 bool hasPolyglossiaExclusiveLanguages() const;
125 std::string getBabelLanguages() const;
127 std::map<std::string, std::string> getPolyglossiaLanguages() const;
129 std::set<std::string> getEncodingSet(std::string const & doc_encoding) const;
131 void getFontEncodings(std::vector<std::string> & encodings) const;
133 void useLayout(docstring const & lyt);
135 void useInsetLayout(InsetLayout const & lay);
137 Buffer const & buffer() const;
139 void setBuffer(Buffer const &);
141 BufferParams const & bufferParams() const;
142 /** Which language package do we require? \p englishbabel determines
143 * if we require babel even if English is the only language.
145 LangPackage langPackage() const;
146 /// Convenience function to test if we use babel
147 bool useBabel() const { return langPackage() == LANG_PACK_BABEL; }
148 /// Convenience function to test if we use polyglossia
149 bool usePolyglossia() const { return langPackage() == LANG_PACK_POLYGLOSSIA; }
150 /// are we in a float?
151 bool inFloat() const { return in_float_; }
152 /// are we in a float?
153 void inFloat(bool const b) { in_float_ = b; }
154 /// Runparams that will be used for exporting this file.
155 OutputParams const & runparams() const { return runparams_; }
156 /// Resolve alternatives like "esint|amsmath|wasysym"
157 void resolveAlternatives();
159 void setHTMLTitle(docstring const & t) { htmltitle_ = t; }
161 docstring const & htmlTitle() const { return htmltitle_; }
165 void useLayout(docstring const &, int);
167 std::list<docstring> usedLayouts_;
169 std::list<docstring> usedInsetLayouts_;
170 /// The features that are needed by the document
171 typedef std::set<std::string> Features;
174 /// Static preamble bits, from external templates, or anywhere else
175 typedef std::list<std::string> SnippetList;
177 SnippetList preamble_snippets_;
179 SnippetList css_snippets_;
181 typedef std::set<Language const *> LanguageList;
182 /// used languages (only those that are supported by babel)
183 LanguageList UsedLanguages_;
185 typedef std::map<std::string, bool> UsedFloats;
187 UsedFloats usedFloats_;
189 typedef std::map<docstring, std::string> FileMap;
191 FileMap IncludedFiles_;
192 /** Buffer of the file being processed.
193 * This may be a child buffer of the to-be-exported file and
194 * therefore may not be the buffer that belongs to params_.
195 * Only needed by InsetInclude::validate().
197 Buffer const * buffer_;
199 BufferParams const & params_;
200 /** Some insets need to know details about the to-be-produced file
203 OutputParams const & runparams_;
207 docstring htmltitle_;