]> git.lyx.org Git - lyx.git/blobdiff - src/insets/InsetListings.cpp
Whitespace.
[lyx.git] / src / insets / InsetListings.cpp
index 8d12b97180fa08e1da3b76082363a3342579fdaf..1afa0f3612625d663e8500d65dbbcb5c3de9ce11 100644 (file)
@@ -4,7 +4,7 @@
  * Licence details can be found in the file COPYING.
  *
  * \author Bo Peng
- * \author Jürgen Spitzmüller
+ * \author Jürgen Spitzmüller
  *
  * Full author contact details are available in file CREDITS.
  */
 #include "Counters.h"
 #include "Cursor.h"
 #include "DispatchResult.h"
+#include "Encoding.h"
 #include "FuncRequest.h"
 #include "FuncStatus.h"
 #include "InsetCaption.h"
-#include "InsetList.h"
 #include "Language.h"
-#include "MetricsInfo.h"
+#include "LaTeXFeatures.h"
+#include "Lexer.h"
+#include "output_latex.h"
+#include "output_xhtml.h"
+#include "OutputParams.h"
 #include "TextClass.h"
+#include "texstream.h"
 
 #include "support/debug.h"
 #include "support/docstream.h"
 #include "support/gettext.h"
 #include "support/lstrings.h"
+#include "support/lassert.h"
 
+#include "frontends/alert.h"
 #include "frontends/Application.h"
 
-#include <boost/regex.hpp>
+#include "support/regex.h"
 
 #include <sstream>
 
@@ -43,14 +50,12 @@ using namespace lyx::support;
 
 namespace lyx {
 
-using boost::regex;
 
-char const lstinline_delimiters[] =
-       "!*()-=+|;:'\"`,<.>/?QWERTYUIOPASDFGHJKLZXCVBNMqwertyuiopasdfghjklzxcvbnm";
-
-InsetListings::InsetListings(Buffer const & buf, InsetListingsParams const & par)
-       : InsetCollapsable(buf, par.status())
-{}
+InsetListings::InsetListings(Buffer * buf, InsetListingsParams const & par)
+       : InsetCaptionable(buf,"listing")
+{
+       status_ = par.status();
+}
 
 
 InsetListings::~InsetListings()
@@ -65,21 +70,6 @@ Inset::DisplayType InsetListings::display() const
 }
 
 
-void InsetListings::updateLabels(ParIterator const & it)
-{
-       Counters & cnts = buffer().params().documentClass().counters();
-       string const saveflt = cnts.current_float();
-
-       // Tell to captions what the current float is
-       cnts.current_float("listing");
-
-       InsetCollapsable::updateLabels(it);
-
-       //reset afterwards
-       cnts.current_float(saveflt);
-}
-
-
 void InsetListings::write(ostream & os) const
 {
        os << "listings" << "\n";
@@ -92,7 +82,7 @@ void InsetListings::write(ostream & os) const
                os << "inline true\n";
        else
                os << "inline false\n";
-       InsetCollapsable::write(os);
+       InsetCaptionable::write(os);
 }
 
 
@@ -114,29 +104,52 @@ void InsetListings::read(Lexer & lex)
                        break;
                }
        }
-       InsetCollapsable::read(lex);
-}
-
-
-docstring InsetListings::editMessage() const
-{
-       return _("Opened Listing Inset");
+       InsetCaptionable::read(lex);
 }
 
 
-int InsetListings::latex(odocstream & os, OutputParams const & runparams) const
+void InsetListings::latex(otexstream & os, OutputParams const & runparams) const
 {
        string param_string = params().params();
        // NOTE: I use {} to quote text, which is an experimental feature
        // of the listings package (see page 25 of the manual)
-       int lines = 0;
-       bool isInline = params().isInline();
+       bool const isInline = params().isInline();
        // get the paragraphs. We can not output them directly to given odocstream
        // because we can not yet determine the delimiter character of \lstinline
        docstring code;
+       docstring uncodable;
        ParagraphList::const_iterator par = paragraphs().begin();
        ParagraphList::const_iterator end = paragraphs().end();
 
+       bool encoding_switched = false;
+       Encoding const * const save_enc = runparams.encoding;
+       // The listings package cannot deal with multi-byte-encoded
+       // glyphs, except if full-unicode aware backends
+       // such as XeTeX or LuaTeX are used, and with pLaTeX.
+       bool const multibyte_possible = runparams.isFullUnicode()
+           || (buffer().params().encoding().package() == Encoding::japanese
+               && runparams.encoding->package() == Encoding::japanese);
+
+       if (!multibyte_possible && !runparams.encoding->hasFixedWidth()) {
+               // We need to switch to a singlebyte encoding, due to
+               // the restrictions of the listings package (see above).
+               // This needs to be consistent with
+               // LaTeXFeatures::getTClassI18nPreamble().
+               Language const * const outer_language =
+                       (runparams.local_font != 0) ?
+                               runparams.local_font->language()
+                               : buffer().params().language;
+               // We try if there's a singlebyte encoding for the current
+               // language; if not, fall back to latin1.
+               Encoding const * const lstenc =
+                       (outer_language->encoding()->hasFixedWidth()) ?
+                               outer_language->encoding()
+                               : encodings.fromLyXName("iso8859-1");
+               switchEncoding(os.os(), buffer().params(), runparams, *lstenc, true);
+               runparams.encoding = lstenc;
+               encoding_switched = true;
+       }
+
        while (par != end) {
                pos_type siz = par->size();
                bool captionline = false;
@@ -146,45 +159,74 @@ int InsetListings::latex(odocstream & os, OutputParams const & runparams) const
                        // ignore all struck out text and (caption) insets
                        if (par->isDeleted(i) || par->isInset(i))
                                continue;
-                       code += par->getChar(i);
+                       char_type c = par->getChar(i);
+                       // we can only output characters covered by the current
+                       // encoding!
+                       try {
+                               if (runparams.encoding->encodable(c))
+                                       code += c;
+                               else if (runparams.dryrun) {
+                                       code += "<" + _("LyX Warning: ")
+                                          + _("uncodable character") + " '";
+                                       code += docstring(1, c);
+                                       code += "'>";
+                               } else
+                                       uncodable += c;
+                       } catch (EncodingException & /* e */) {
+                               if (runparams.dryrun) {
+                                       code += "<" + _("LyX Warning: ")
+                                          + _("uncodable character") + " '";
+                                       code += docstring(1, c);
+                                       code += "'>";
+                               } else
+                                       uncodable += c;
+                       }
                }
                ++par;
                // for the inline case, if there are multiple paragraphs
                // they are simply joined. Otherwise, expect latex errors.
-               if (par != end && !isInline && !captionline) {
+               if (par != end && !isInline && !captionline)
                        code += "\n";
-                       ++lines;
-               }
        }
        if (isInline) {
-               char const * delimiter = lstinline_delimiters;
-               for (; delimiter != '\0'; ++delimiter)
-                       if (!contains(code, *delimiter))
-                               break;
+               static const docstring delimiters =
+                               from_utf8("!*()-=+|;:'\"`,<.>/?QWERTYUIOPASDFGHJKLZXCVBNMqwertyuiopasdfghjklzxcvbnm");
+
+               size_t pos = delimiters.find_first_not_of(code);
+
                // This code piece contains all possible special character? !!!
                // Replace ! with a warning message and use ! as delimiter.
-               if (*delimiter == '\0') {
-                       code = subst(code, from_ascii("!"), from_ascii(" WARNING: no lstline delimiter can be used "));
-                       delimiter = lstinline_delimiters;
+               if (pos == string::npos) {
+                       docstring delim_error = "<" + _("LyX Warning: ")
+                               + _("no more lstline delimiters available") + ">";
+                       code = subst(code, from_ascii("!"), delim_error);
+                       pos = 0;
+                       if (!runparams.dryrun && !runparams.silent) {
+                               // FIXME: warning should be passed to the error dialog
+                               frontend::Alert::warning(_("Running out of delimiters"),
+                               _("For inline program listings, one character must be reserved\n"
+                                 "as a delimiter. One of the listings, however, uses all available\n"
+                                 "characters, so none is left for delimiting purposes.\n"
+                                 "For the time being, I have replaced '!' by a warning, but you\n"
+                                 "must investigate!"));
+                       }
                }
-               if (param_string.empty())
-                       os << "\\lstinline" << *delimiter;
-               else
-                       os << "\\lstinline[" << from_ascii(param_string) << "]" << *delimiter;
-                os << code
-                   << *delimiter;
+               docstring const delim(1, delimiters[pos]);
+               os << "\\lstinline";
+               if (!param_string.empty())
+                       os << "[" << from_utf8(param_string) << "]";
+               else if (pos >= delimiters.find('Q'))
+                       // We need to terminate the command before the delimiter
+                       os << " ";
+               os << delim << code << delim;
        } else {
                OutputParams rp = runparams;
-               // FIXME: the line below would fix bug 4182,
-               // but real_current_font moved to cursor.
-               //rp.local_font = &text_.real_current_font;
                rp.moving_arg = true;
                docstring const caption = getCaption(rp);
-               runparams.encoding = rp.encoding;
                if (param_string.empty() && caption.empty())
-                       os << "\n\\begingroup\n\\inputencoding{latin1}\n\\begin{lstlisting}\n";
+                       os << breakln << "\\begin{lstlisting}\n";
                else {
-                       os << "\n\\begingroup\n\\inputencoding{latin1}\n\\begin{lstlisting}[";
+                       os << breakln << "\\begin{lstlisting}[";
                        if (!caption.empty()) {
                                os << "caption={" << caption << '}';
                                if (!param_string.empty())
@@ -192,34 +234,105 @@ int InsetListings::latex(odocstream & os, OutputParams const & runparams) const
                        }
                        os << from_utf8(param_string) << "]\n";
                }
-               lines += 4;
-               os << code << "\n\\end{lstlisting}\n\\endgroup\n";
-               lines += 3;
+               os << code << breakln << "\\end{lstlisting}\n";
+       }
+
+       if (encoding_switched){
+               // Switch back
+               switchEncoding(os.os(), buffer().params(), runparams, *save_enc, true);
+               runparams.encoding = save_enc;
        }
 
-       return lines;
+       if (!uncodable.empty() && !runparams.silent) {
+               // issue a warning about omitted characters
+               // FIXME: should be passed to the error dialog
+               if (!multibyte_possible && !runparams.encoding->hasFixedWidth())
+                       frontend::Alert::warning(_("Uncodable characters in listings inset"),
+                               bformat(_("The following characters in one of the program listings are\n"
+                                         "not representable in the current encoding and have been omitted:\n%1$s.\n"
+                                         "This is due to a restriction of the listings package, which does\n"
+                                         "not support your encoding '%2$s'.\n"
+                                         "Toggling 'Use non-TeX fonts' in Document > Settings...\n"
+                                         "might help."),
+                               uncodable, _(runparams.encoding->guiName())));
+               else
+                       frontend::Alert::warning(_("Uncodable characters in listings inset"),
+                               bformat(_("The following characters in one of the program listings are\n"
+                                         "not representable in the current encoding and have been omitted:\n%1$s."),
+                               uncodable));
+       }
+}
+
+
+docstring InsetListings::xhtml(XHTMLStream & os, OutputParams const & rp) const
+{
+       odocstringstream ods;
+       XHTMLStream out(ods);
+
+       bool const isInline = params().isInline();
+       if (isInline)
+               out << html::CompTag("br");
+       else {
+               out << html::StartTag("div", "class='float float-listings'");
+               docstring caption = getCaptionHTML(rp);
+               if (!caption.empty())
+                       out << html::StartTag("div", "class='float-caption'")
+                           << XHTMLStream::ESCAPE_NONE
+                           << caption << html::EndTag("div");
+       }
+
+       InsetLayout const & il = getLayout();
+       string const & tag = il.htmltag();
+       string attr = "class ='listings";
+       string const lang = params().getParamValue("language");
+       if (!lang.empty())
+               attr += " " + lang;
+       attr += "'";
+       out << html::StartTag(tag, attr);
+       OutputParams newrp = rp;
+       newrp.html_disable_captions = true;
+       // We don't want to convert dashes here. That's the only conversion we
+       // do for XHTML, so this is safe.
+       newrp.pass_thru = true;
+       docstring def = InsetText::insetAsXHTML(out, newrp, InsetText::JustText);
+       out << html::EndTag(tag);
+
+       if (isInline) {
+               out << html::CompTag("br");
+               // escaping will already have been done
+               os << XHTMLStream::ESCAPE_NONE << ods.str();
+       } else {
+               out << html::EndTag("div");
+               // In this case, this needs to be deferred, but we'll put it
+               // before anything the text itself deferred.
+               def = ods.str() + '\n' + def;
+       }
+       return def;
 }
 
 
-docstring InsetListings::contextMenu(BufferView const &, int, int) const
+string InsetListings::contextMenuName() const
 {
-       return from_ascii("context-listings");
+       return "context-listings";
 }
 
 
 void InsetListings::doDispatch(Cursor & cur, FuncRequest & cmd)
 {
-       switch (cmd.action) {
+       switch (cmd.action()) {
 
        case LFUN_INSET_MODIFY: {
+               cur.recordUndoInset(this);
                InsetListings::string2params(to_utf8(cmd.argument()), params());
                break;
        }
+
        case LFUN_INSET_DIALOG_UPDATE:
                cur.bv().updateDialog("listings", params2string(params()));
                break;
+
        default:
-               InsetCollapsable::doDispatch(cur, cmd);
+               InsetCaptionable::doDispatch(cur, cmd);
                break;
        }
 }
@@ -228,34 +341,41 @@ void InsetListings::doDispatch(Cursor & cur, FuncRequest & cmd)
 bool InsetListings::getStatus(Cursor & cur, FuncRequest const & cmd,
        FuncStatus & status) const
 {
-       LYXERR0("CURSOR SIZE: " << cur.depth());
-       switch (cmd.action) {
+       switch (cmd.action()) {
+               case LFUN_INSET_MODIFY:
                case LFUN_INSET_DIALOG_UPDATE:
-                       status.enabled(true);
-                       return true;
-               case LFUN_CAPTION_INSERT:
-                       status.enabled(!params().isInline());
+                       status.setEnabled(true);
                        return true;
+               case LFUN_CAPTION_INSERT: {
+                       // the inset outputs at most one caption
+                       if (params().isInline() || getCaptionInset()) {
+                               status.setEnabled(false);
+                               return true;
+                       }
+               }
                default:
-                       return InsetCollapsable::getStatus(cur, cmd, status);
+                       return InsetCaptionable::getStatus(cur, cmd, status);
        }
 }
 
 
-void InsetListings::setButtonLabel()
+docstring const InsetListings::buttonLabel(BufferView const & bv) const
 {
        // FIXME UNICODE
-       if (decoration() == InsetLayout::Classic)
-               setLabel(isOpen() ?  _("Listing") : getNewLabel(_("Listing")));
+       if (decoration() == InsetLayout::CLASSIC)
+               return isOpen(bv) ? _("Listing") : getNewLabel(_("Listing"));
        else
-               setLabel(getNewLabel(_("Listing")));
+               return getNewLabel(_("Listing"));
 }
 
 
 void InsetListings::validate(LaTeXFeatures & features) const
 {
        features.require("listings");
-       InsetCollapsable::validate(features);
+       string param_string = params().params();
+       if (param_string.find("\\color") != string::npos)
+               features.require("color");
+       InsetCaptionable::validate(features);
 }
 
 
@@ -272,37 +392,34 @@ docstring InsetListings::getCaption(OutputParams const & runparams) const
        if (paragraphs().empty())
                return docstring();
 
-       ParagraphList::const_iterator pit = paragraphs().begin();
-       for (; pit != paragraphs().end(); ++pit) {
-               InsetList::const_iterator it = pit->insetList().begin();
-               for (; it != pit->insetList().end(); ++it) {
-                       Inset & inset = *it->inset;
-                       if (inset.lyxCode() == CAPTION_CODE) {
-                               odocstringstream ods;
-                               InsetCaption * ins =
-                                       static_cast<InsetCaption *>(it->inset);
-                               ins->getOptArg(ods, runparams);
-                               ins->getArgument(ods, runparams);
-                               // the caption may contain \label{} but the listings
-                               // package prefer caption={}, label={}
-                               docstring cap = ods.str();
-                               if (!contains(to_utf8(cap), "\\label{"))
-                                       return cap;
-                               // convert from
-                               //     blah1\label{blah2} blah3
-                               // to
-                               //     blah1 blah3},label={blah2
-                               // to form options
-                               //     caption={blah1 blah3},label={blah2}
-                               //
-                               // NOTE that } is not allowed in blah2.
-                               regex const reg("(.*)\\\\label\\{(.*?)\\}(.*)");
-                               string const new_cap("\\1\\3},label={\\2");
-                               return from_utf8(regex_replace(to_utf8(cap), reg, new_cap));
-                       }
-               }
-       }
-       return docstring();
+       InsetCaption const * ins = getCaptionInset();
+       if (ins == 0)
+               return docstring();
+
+       odocstringstream ods;
+       otexstream os(ods, false);
+       ins->getArgs(os, runparams);
+       ins->getArgument(os, runparams);
+
+       // TODO: The code below should be moved to support, and then the test
+       //       in ../tests should be moved there as well.
+
+       // the caption may contain \label{} but the listings
+       // package prefer caption={}, label={}
+       docstring cap = ods.str();
+       if (!contains(to_utf8(cap), "\\label{"))
+               return cap;
+       // convert from
+       //     blah1\label{blah2} blah3
+       // to
+       //     blah1 blah3},label={blah2
+       // to form options
+       //     caption={blah1 blah3},label={blah2}
+       //
+       // NOTE that } is not allowed in blah2.
+       regex const reg("(.*)\\\\label\\{(.*?)\\}(.*)");
+       string const new_cap("$1$3},label={$2");
+       return from_utf8(regex_replace(to_utf8(cap), reg, new_cap));
 }