2 * \file InsetListings.cpp
3 * This file is part of LyX, the document processor.
4 * Licence details can be found in the file COPYING.
7 * \author Jürgen Spitzmüller
9 * Full author contact details are available in file CREDITS.
14 #include "InsetListings.h"
17 #include "BufferView.h"
18 #include "BufferParams.h"
21 #include "DispatchResult.h"
23 #include "FuncRequest.h"
24 #include "FuncStatus.h"
25 #include "InsetCaption.h"
27 #include "LaTeXFeatures.h"
29 #include "output_latex.h"
30 #include "output_xhtml.h"
31 #include "OutputParams.h"
32 #include "TextClass.h"
34 #include "support/debug.h"
35 #include "support/docstream.h"
36 #include "support/gettext.h"
37 #include "support/lstrings.h"
38 #include "support/lassert.h"
40 #include "frontends/alert.h"
41 #include "frontends/Application.h"
43 #include "support/regex.h"
48 using namespace lyx::support;
53 char const lstinline_delimiters[] =
54 "!*()-=+|;:'\"`,<.>/?QWERTYUIOPASDFGHJKLZXCVBNMqwertyuiopasdfghjklzxcvbnm";
56 InsetListings::InsetListings(Buffer * buf, InsetListingsParams const & par)
57 : InsetCollapsable(buf)
59 status_ = par.status();
63 InsetListings::~InsetListings()
65 hideDialogs("listings", this);
69 Inset::DisplayType InsetListings::display() const
71 return params().isInline() || params().isFloat() ? Inline : AlignLeft;
75 void InsetListings::updateBuffer(ParIterator const & it, UpdateType utype)
78 buffer().masterBuffer()->params().documentClass().counters();
79 string const saveflt = cnts.current_float();
81 // Tell to captions what the current float is
82 cnts.current_float("listing");
84 InsetCollapsable::updateBuffer(it, utype);
87 cnts.current_float(saveflt);
91 void InsetListings::write(ostream & os) const
93 os << "listings" << "\n";
94 InsetListingsParams const & par = params();
95 // parameter string is encoded to be a valid lyx token.
96 string opt = par.encodedString();
98 os << "lstparams \"" << opt << "\"\n";
100 os << "inline true\n";
102 os << "inline false\n";
103 InsetCollapsable::write(os);
107 void InsetListings::read(Lexer & lex)
111 string token = lex.getString();
112 if (token == "lstparams") {
114 string const value = lex.getString();
115 params().fromEncodedString(value);
116 } else if (token == "inline") {
118 params().setInline(lex.getBool());
120 // no special option, push back 'status' etc
121 lex.pushToken(token);
125 InsetCollapsable::read(lex);
129 void InsetListings::latex(otexstream & os, OutputParams const & runparams) const
131 string param_string = params().params();
132 // NOTE: I use {} to quote text, which is an experimental feature
133 // of the listings package (see page 25 of the manual)
134 bool const isInline = params().isInline();
135 // get the paragraphs. We can not output them directly to given odocstream
136 // because we can not yet determine the delimiter character of \lstinline
139 ParagraphList::const_iterator par = paragraphs().begin();
140 ParagraphList::const_iterator end = paragraphs().end();
142 bool encoding_switched = false;
143 Encoding const * const save_enc = runparams.encoding;
145 if (!runparams.isFullUnicode()
146 && !runparams.encoding->hasFixedWidth()) {
147 // We need to switch to a singlebyte encoding, since the
148 // listings package cannot deal with multi-byte-encoded
149 // glyphs (not needed with full-unicode aware backends
151 Language const * const outer_language =
152 (runparams.local_font != 0) ?
153 runparams.local_font->language()
154 : buffer().params().language;
155 // We try if there's a singlebyte encoding for the current
156 // language; if not, fall back to latin1.
157 Encoding const * const lstenc =
158 (outer_language->encoding()->hasFixedWidth()) ?
159 outer_language->encoding()
160 : encodings.fromLyXName("iso8859-1");
161 pair<bool, int> const c = switchEncoding(os.os(),
162 buffer().params(), runparams, *lstenc, true);
163 runparams.encoding = lstenc;
164 encoding_switched = true;
168 pos_type siz = par->size();
169 bool captionline = false;
170 for (pos_type i = 0; i < siz; ++i) {
171 if (i == 0 && par->isInset(i) && i + 1 == siz)
173 // ignore all struck out text and (caption) insets
174 if (par->isDeleted(i) || par->isInset(i))
176 char_type c = par->getChar(i);
177 // we can only output characters covered by the current
180 if (runparams.encoding->latexChar(c) == docstring(1, c))
182 else if (runparams.dryrun) {
183 code += "<" + _("LyX Warning: ")
184 + _("uncodable character") + " '";
185 code += docstring(1, c);
189 } catch (EncodingException & /* e */) {
190 if (runparams.dryrun) {
191 code += "<" + _("LyX Warning: ")
192 + _("uncodable character") + " '";
193 code += docstring(1, c);
200 // for the inline case, if there are multiple paragraphs
201 // they are simply joined. Otherwise, expect latex errors.
202 if (par != end && !isInline && !captionline)
206 char const * delimiter = lstinline_delimiters;
207 for (; delimiter != '\0'; ++delimiter)
208 if (!contains(code, *delimiter))
210 // This code piece contains all possible special character? !!!
211 // Replace ! with a warning message and use ! as delimiter.
212 if (*delimiter == '\0') {
213 docstring delim_error = "<" + _("LyX Warning: ")
214 + _("no more lstline delimiters available") + ">";
215 code = subst(code, from_ascii("!"), delim_error);
216 delimiter = lstinline_delimiters;
217 if (!runparams.dryrun) {
218 // FIXME: warning should be passed to the error dialog
219 frontend::Alert::warning(_("Running out of delimiters"),
220 _("For inline program listings, one character must be reserved\n"
221 "as a delimiter. One of the listings, however, uses all available\n"
222 "characters, so none is left for delimiting purposes.\n"
223 "For the time being, I have replaced '!' by a warning, but you\n"
224 "must investigate!"));
227 if (param_string.empty())
228 os << "\\lstinline" << *delimiter;
230 os << "\\lstinline[" << from_utf8(param_string) << "]" << *delimiter;
234 OutputParams rp = runparams;
235 rp.moving_arg = true;
236 docstring const caption = getCaption(rp);
237 if (param_string.empty() && caption.empty())
238 os << breakln << "\\begin{lstlisting}\n";
240 os << breakln << "\\begin{lstlisting}[";
241 if (!caption.empty()) {
242 os << "caption={" << caption << '}';
243 if (!param_string.empty())
246 os << from_utf8(param_string) << "]\n";
248 os << code << breakln << "\\end{lstlisting}\n";
251 if (encoding_switched){
253 pair<bool, int> const c = switchEncoding(os.os(),
254 buffer().params(), runparams, *save_enc, true);
255 runparams.encoding = save_enc;
258 if (!uncodable.empty()) {
259 // issue a warning about omitted characters
260 // FIXME: should be passed to the error dialog
261 frontend::Alert::warning(_("Uncodable characters in listings inset"),
262 bformat(_("The following characters in one of the program listings are\n"
263 "not representable in the current encoding and have been omitted:\n%1$s."),
269 docstring InsetListings::xhtml(XHTMLStream & os, OutputParams const & rp) const
271 odocstringstream ods;
272 XHTMLStream out(ods);
274 bool const isInline = params().isInline();
276 out << html::CompTag("br");
278 out << html::StartTag("div", "class='float float-listings'");
279 docstring caption = getCaptionHTML(rp);
280 if (!caption.empty())
281 out << html::StartTag("div", "class='float-caption'")
282 << caption << html::EndTag("div");
285 out << html::StartTag("pre");
286 OutputParams newrp = rp;
287 newrp.html_disable_captions = true;
288 docstring def = InsetText::insetAsXHTML(out, newrp, InsetText::JustText);
289 out << html::EndTag("pre");
292 out << html::CompTag("br");
293 // escaping will already have been done
294 os << XHTMLStream::ESCAPE_NONE << ods.str();
296 out << html::EndTag("div");
297 // In this case, this needs to be deferred, but we'll put it
298 // before anything the text itself deferred.
299 def = ods.str() + '\n' + def;
305 docstring InsetListings::contextMenuName() const
307 return from_ascii("context-listings");
311 void InsetListings::doDispatch(Cursor & cur, FuncRequest & cmd)
313 switch (cmd.action()) {
315 case LFUN_INSET_MODIFY: {
316 cur.recordUndoInset(ATOMIC_UNDO, this);
317 InsetListings::string2params(to_utf8(cmd.argument()), params());
321 case LFUN_INSET_DIALOG_UPDATE:
322 cur.bv().updateDialog("listings", params2string(params()));
326 InsetCollapsable::doDispatch(cur, cmd);
332 bool InsetListings::getStatus(Cursor & cur, FuncRequest const & cmd,
333 FuncStatus & status) const
335 switch (cmd.action()) {
336 case LFUN_INSET_MODIFY:
337 case LFUN_INSET_DIALOG_UPDATE:
338 status.setEnabled(true);
340 case LFUN_CAPTION_INSERT:
341 status.setEnabled(!params().isInline());
344 return InsetCollapsable::getStatus(cur, cmd, status);
349 docstring const InsetListings::buttonLabel(BufferView const & bv) const
352 if (decoration() == InsetLayout::CLASSIC)
353 return isOpen(bv) ? _("Listing") : getNewLabel(_("Listing"));
355 return getNewLabel(_("Listing"));
359 void InsetListings::validate(LaTeXFeatures & features) const
361 features.require("listings");
362 string param_string = params().params();
363 if (param_string.find("\\color") != string::npos)
364 features.require("color");
365 InsetCollapsable::validate(features);
369 bool InsetListings::showInsetDialog(BufferView * bv) const
371 bv->showDialog("listings", params2string(params()),
372 const_cast<InsetListings *>(this));
377 docstring InsetListings::getCaption(OutputParams const & runparams) const
379 if (paragraphs().empty())
382 InsetCaption const * ins = getCaptionInset();
387 odocstringstream ods;
388 otexstream os(ods, texrow);
389 ins->getOptArg(os, runparams);
390 ins->getArgument(os, runparams);
391 // the caption may contain \label{} but the listings
392 // package prefer caption={}, label={}
393 docstring cap = ods.str();
394 if (!contains(to_utf8(cap), "\\label{"))
397 // blah1\label{blah2} blah3
399 // blah1 blah3},label={blah2
401 // caption={blah1 blah3},label={blah2}
403 // NOTE that } is not allowed in blah2.
404 regex const reg("(.*)\\\\label\\{(.*?)\\}(.*)");
405 string const new_cap("\\1\\3},label={\\2");
406 return from_utf8(regex_replace(to_utf8(cap), reg, new_cap));
410 void InsetListings::string2params(string const & in,
411 InsetListingsParams & params)
413 params = InsetListingsParams();
416 istringstream data(in);
419 // discard "listings", which is only used to determine inset
425 string InsetListings::params2string(InsetListingsParams const & params)
428 data << "listings" << ' ';