4 * This file is part of LyX, the document processor.
5 * Licence details can be found in the file COPYING.
7 * \author Martin Vermeer
10 * Full author contact details are available in file CREDITS.
13 #ifndef INSET_LAYOUT_H
14 #define INSET_LAYOUT_H
16 #include "ColorCode.h"
20 #include "support/docstring.h"
36 enum InsetDecoration {
58 bool read(Lexer & lexrc, TextClass const & tclass,
59 bool validating = false);
61 docstring name() const { return name_; }
63 void setName(docstring const & n) { name_ = n; }
65 InsetLyXType lyxtype() const { return lyxtype_; }
67 docstring labelstring() const { return labelstring_; }
69 docstring menustring() const { return menustring_; }
71 bool contentaslabel() const { return contentaslabel_; }
73 InsetDecoration decoration() const { return decoration_; }
75 InsetLaTeXType latextype() const { return latextype_; }
77 std::string latexname() const { return latexname_; }
79 std::string latexparam() const { return latexparam_; }
81 docstring leftdelim() const { return leftdelim_; }
83 docstring rightdelim() const { return rightdelim_; }
85 FontInfo font() const { return font_; }
87 FontInfo labelfont() const { return labelfont_; }
89 ColorCode bgcolor() const { return bgcolor_; }
91 Layout::LaTeXArgMap const & latexargs() const { return latexargs_; }
93 Layout::LaTeXArgMap const & postcommandargs() const { return postcommandargs_; }
94 /// Returns latexargs() + postcommandargs().
95 /// But note that it returns a *copy*, not a reference, so do not do
97 /// Layout::LaTeXArgMap::iterator it = args().begin();
98 /// Layout::LaTeXArgMap::iterator en = args().end();
99 /// Those are iterators for different containers.
100 Layout::LaTeXArgMap args() const;
104 int requiredArgs() const;
106 docstring preamble() const { return preamble_; }
107 /// Get language dependent macro definitions needed for this inset
108 docstring const langpreamble() const { return langpreamble_; }
109 /// Get language and babel dependent macro definitions needed for
111 docstring const babelpreamble() const { return babelpreamble_; }
113 bool fixedwidthpreambleencoding() const { return fixedwidthpreambleencoding_; }
115 docstring counter() const { return counter_; }
117 docstring refprefix() const { return refprefix_; }
118 /// The tag enclosing all the material in this inset. Default is "span".
119 std::string const & htmltag() const;
120 /// Additional attributes for inclusion with the start tag. Default (if
121 /// a tag is provided) is: class="name".
122 std::string const & htmlattr() const;
123 /// Tag for individual paragraphs in the inset. Default is none.
124 std::string const & htmlinnertag() const { return htmlinnertag_; }
125 /// Attributes for that tag. Default (if a tag is provided) is:
126 /// class="name_inner".
127 std::string const & htmlinnerattr() const;
128 /// A label for this environment, possibly including a reference
129 /// to a counter. E.g., for footnote, it might be:
130 /// \arabic{footnote}
132 /// FIXME Could we get this from the layout?
133 std::string const & htmllabel() const { return htmllabel_; }
135 inline std::string htmllabeltag() const { return "span"; }
137 std::string htmllabelattr() const
138 { return "class=\"" + defaultCSSClass() + "_label\""; }
139 /// CSS associated with this inset.
140 docstring htmlstyle() const;
141 /// Additional material for the header.
142 docstring htmlpreamble() const { return htmlpreamble_; }
143 /// Whether this inset represents a "block" of material, i.e., a set
144 /// of paragraphs of its own (true), or should be run into the previous
145 /// paragraph (false). Examples:
146 /// For branches, this is false.
147 /// For footnotes, this is true.
148 /// Defaults to true.
149 bool htmlisblock() const { return htmlisblock_; }
151 std::string docbooktag() const { return docbooktag_; }
153 std::string docbooktagtype() const { return docbooktagtype_; }
155 std::string docbookattr() const { return docbookattr_; }
157 bool docbooksection() const { return docbooksection_; }
159 std::string docbookwrappertag() const { return docbookwrappertag_; }
161 std::string docbookwrappertagtype() const { return docbookwrappertagtype_; }
163 std::string docbookwrapperattr() const { return docbookwrapperattr_; }
165 std::set<std::string> required() const { return required_; }
167 bool isMultiPar() const { return multipar_; }
169 bool forcePlainLayout() const { return forceplain_; }
171 bool allowParagraphCustomization() const { return custompars_; }
173 bool isPassThru() const { return passthru_; }
175 docstring passThruChars() const { return passthru_chars_; }
177 std::string newlineCmd() const { return newline_cmd_; }
179 bool parbreakIsNewline() const { return parbreakisnewline_; }
181 bool parbreakIgnored() const { return parbreakignored_; }
183 bool isNeedProtect() const { return needprotect_; }
185 bool needsCProtect() const { return needcprotect_; }
186 /// Protection of some elements such as \ref and \cite
187 /// in \mbox (needed by commands building on soul or ulem)
188 bool isNeedMBoxProtect() const { return needmboxprotect_; }
190 bool isFreeSpacing() const { return freespacing_; }
192 bool isKeepEmpty() const { return keepempty_; }
194 bool forceLTR() const { return forceltr_; }
196 bool forceOwnlines() const { return forceownlines_; }
198 bool isInToc() const { return intoc_; }
200 bool spellcheck() const { return spellcheck_; }
202 bool resetsFont() const { return resetsfont_; }
204 bool isDisplay() const { return display_; }
206 bool forceLocalFontSwitch() const { return forcelocalfontswitch_; }
208 docstring const & obsoleted_by() const { return obsoleted_by_; }
210 bool addToToc() const { return add_to_toc_; }
212 std::string tocType() const { return toc_type_; }
214 bool isTocCaption() const { return is_toc_caption_; }
216 bool editExternally () const { return edit_external_; }
219 void makeDefaultCSS() const;
221 std::string defaultCSSClass() const;
223 void readArgument(Lexer &);
227 * This is only used (at present) to decide where to put them on the menus.
228 * Values are 'charstyle', 'custom' (things that by default look like a
229 * footnote), 'standard'.
231 InsetLyXType lyxtype_;
233 docstring labelstring_;
235 docstring menustring_;
237 bool contentaslabel_;
239 InsetDecoration decoration_;
241 InsetLaTeXType latextype_;
243 std::string latexname_;
245 std::string latexparam_;
247 docstring leftdelim_;
249 docstring rightdelim_;
260 /// Language dependent macro definitions needed for this inset
261 docstring langpreamble_;
262 /// Language and babel dependent macro definitions needed for this inset
263 docstring babelpreamble_;
265 bool fixedwidthpreambleencoding_;
267 docstring refprefix_;
269 mutable std::string htmltag_;
271 mutable std::string htmlattr_;
273 std::string htmlinnertag_;
275 mutable std::string htmlinnerattr_;
277 std::string htmllabel_;
279 docstring htmlstyle_;
280 /// Cache for default CSS info for this inset.
281 mutable docstring htmldefaultstyle_;
282 /// Cache for default CSS class.
283 mutable std::string defaultcssclass_;
284 /// Whether to force generation of default CSS even if some is given.
285 /// False by default.
288 docstring htmlpreamble_;
292 std::string docbooktag_;
294 std::string docbooktagtype_;
296 std::string docbookattr_;
298 bool docbooksection_;
300 std::string docbookwrappertag_;
302 std::string docbookwrappertagtype_;
304 std::string docbookwrapperattr_;
306 std::set<std::string> required_;
316 docstring passthru_chars_;
318 std::string newline_cmd_;
320 bool parbreakisnewline_;
322 bool parbreakignored_;
336 bool needmboxprotect_;
337 /// should the contents be written to TOC strings?
339 /// check spelling of this inset?
346 bool forcelocalfontswitch_;
347 /** Name of an insetlayout that has replaced this insetlayout.
348 This is used to rename an insetlayout, while keeping backward
351 docstring obsoleted_by_;
353 Layout::LaTeXArgMap latexargs_;
355 Layout::LaTeXArgMap postcommandargs_;
359 std::string toc_type_;
361 bool is_toc_caption_;
367 InsetLayout::InsetLyXType translateLyXType(std::string const & str);
368 InsetLayout::InsetDecoration translateDecoration(std::string const & str);