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 {
59 bool read(Lexer & lexrc, TextClass const & tclass);
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 bool contentaslabel() const { return contentaslabel_; }
71 InsetDecoration decoration() const { return decoration_; }
73 InsetLaTeXType latextype() const { return latextype_; }
75 std::string latexname() const { return latexname_; }
77 std::string latexparam() const { return latexparam_; }
79 docstring leftdelim() const { return leftdelim_; }
81 docstring rightdelim() const { return rightdelim_; }
83 FontInfo font() const { return font_; }
85 FontInfo labelfont() const { return labelfont_; }
87 ColorCode bgcolor() const { return bgcolor_; }
89 Layout::LaTeXArgMap const & latexargs() const { return latexargs_; }
91 Layout::LaTeXArgMap const & postcommandargs() const { return postcommandargs_; }
92 /// Returns latexargs() + postcommandargs().
93 /// But note that it returns a *copy*, not a reference, so do not do
95 /// Layout::LaTeXArgMap::iterator it = args().begin();
96 /// Layout::LaTeXArgMap::iterator en = args().end();
97 /// Those are iterators for different containers.
98 Layout::LaTeXArgMap args() const;
100 unsigned int optArgs() const;
102 unsigned int requiredArgs() const;
104 docstring preamble() const { return preamble_; }
105 /// Get language dependent macro definitions needed for this inset
106 docstring const langpreamble() const { return langpreamble_; }
107 /// Get language and babel dependent macro definitions needed for
109 docstring const babelpreamble() const { return babelpreamble_; }
111 bool fixedwidthpreambleencoding() const { return fixedwidthpreambleencoding_; }
113 docstring counter() const { return counter_; }
115 docstring refprefix() const { return refprefix_; }
116 /// The tag enclosing all the material in this inset. Default is "span".
117 std::string const & htmltag() const;
118 /// Additional attributes for inclusion with the start tag. Default (if
119 /// a tag is provided) is: class="name".
120 std::string const & htmlattr() const;
121 /// Tag for individual paragraphs in the inset. Default is none.
122 std::string const & htmlinnertag() const { return htmlinnertag_; }
123 /// Attributes for that tag. Default (if a tag is provided) is:
124 /// class="name_inner".
125 std::string const & htmlinnerattr() const;
126 /// A label for this environment, possibly including a reference
127 /// to a counter. E.g., for footnote, it might be:
128 /// \arabic{footnote}
130 /// FIXME Could we get this from the layout?
131 std::string const & htmllabel() const { return htmllabel_; }
133 inline std::string htmllabeltag() const { return "span"; }
135 std::string htmllabelattr() const
136 { return "class=\"" + defaultCSSClass() + "_label\""; }
137 /// CSS associated with this inset.
138 docstring htmlstyle() const;
139 /// Additional material for the header.
140 docstring htmlpreamble() const { return htmlpreamble_; }
141 /// Whether this inset represents a "block" of material, i.e., a set
142 /// of paragraphs of its own (true), or should be run into the previous
143 /// paragraph (false). Examples:
144 /// For branches, this is false.
145 /// For footnotes, this is true.
146 /// Defaults to true.
147 bool htmlisblock() const { return htmlisblock_; }
149 std::set<std::string> requires() const { return requires_; }
151 bool isMultiPar() const { return multipar_; }
153 bool forcePlainLayout() const { return forceplain_; }
155 bool allowParagraphCustomization() const { return custompars_; }
157 bool isPassThru() const { return passthru_; }
159 docstring passThruChars() const { return passthru_chars_; }
161 bool parbreakIsNewline() const { return parbreakisnewline_; }
163 bool isNeedProtect() const { return needprotect_; }
165 bool isFreeSpacing() const { return freespacing_; }
167 bool isKeepEmpty() const { return keepempty_; }
169 bool forceLTR() const { return forceltr_; }
171 bool forceOwnlines() const { return forceownlines_; }
173 bool isInToc() const { return intoc_; }
175 bool spellcheck() const { return spellcheck_; }
177 bool resetsFont() const { return resetsfont_; }
179 bool isDisplay() const { return display_; }
181 bool forcelocalfontswitch() const { return forcelocalfontswitch_; }
183 docstring const & obsoleted_by() const { return obsoleted_by_; }
185 bool addToToc() const { return add_to_toc_; }
187 std::string tocType() const { return toc_type_; }
189 bool isTocCaption() const { return is_toc_caption_; }
192 void makeDefaultCSS() const;
194 std::string defaultCSSClass() const;
196 void readArgument(Lexer &);
200 * This is only used (at present) to decide where to put them on the menus.
201 * Values are 'charstyle', 'custom' (things that by default look like a
202 * footnote), 'element' (docbook), 'standard'.
204 InsetLyXType lyxtype_;
206 docstring labelstring_;
208 bool contentaslabel_;
210 InsetDecoration decoration_;
212 InsetLaTeXType latextype_;
214 std::string latexname_;
216 std::string latexparam_;
218 docstring leftdelim_;
220 docstring rightdelim_;
231 /// Language dependent macro definitions needed for this inset
232 docstring langpreamble_;
233 /// Language and babel dependent macro definitions needed for this inset
234 docstring babelpreamble_;
236 bool fixedwidthpreambleencoding_;
238 docstring refprefix_;
240 mutable std::string htmltag_;
242 mutable std::string htmlattr_;
244 std::string htmlinnertag_;
246 mutable std::string htmlinnerattr_;
248 std::string htmllabel_;
250 docstring htmlstyle_;
251 /// Cache for default CSS info for this inset.
252 mutable docstring htmldefaultstyle_;
253 /// Cache for default CSS class.
254 mutable std::string defaultcssclass_;
255 /// Whether to force generation of default CSS even if some is given.
256 /// False by default.
259 docstring htmlpreamble_;
263 std::set<std::string> requires_;
273 docstring passthru_chars_;
275 bool parbreakisnewline_;
286 /// should the contents be written to TOC strings?
288 /// check spelling of this inset?
295 bool forcelocalfontswitch_;
296 /** Name of an insetlayout that has replaced this insetlayout.
297 This is used to rename an insetlayout, while keeping backward
300 docstring obsoleted_by_;
302 Layout::LaTeXArgMap latexargs_;
304 Layout::LaTeXArgMap postcommandargs_;
308 std::string toc_type_;
310 bool is_toc_caption_;
314 InsetLayout::InsetLyXType translateLyXType(std::string const & str);
315 InsetLayout::InsetDecoration translateDecoration(std::string const & str);