]> git.lyx.org Git - lyx.git/blobdiff - src/insets/InsetHyperlink.cpp
validate encodable characters in href inset (#8357)
[lyx.git] / src / insets / InsetHyperlink.cpp
index 213e7b59ad08ce1eabd0d73a073a1794d93f092d..37692af97a634c65244245908861036357a14206 100644 (file)
@@ -3,8 +3,8 @@
  * This file is part of LyX, the document processor.
  * Licence details can be found in the file COPYING.
  *
- * \author José Matos
- * \author Uwe Stöhr
+ * \author José Matos
+ * \author Uwe Stöhr
  *
  * Full author contact details are available in file CREDITS.
  */
 
 #include "InsetHyperlink.h"
 
+#include "Buffer.h"
 #include "DispatchResult.h"
+#include "Encoding.h"
+#include "Format.h"
 #include "FuncRequest.h"
+#include "FuncStatus.h"
 #include "LaTeXFeatures.h"
-#include "gettext.h"
 #include "OutputParams.h"
+#include "output_xhtml.h"
 
+#include "support/docstream.h"
+#include "support/FileName.h"
+#include "support/filetools.h"
+#include "support/gettext.h"
 #include "support/lstrings.h"
 
-#include "support/std_ostream.h"
+#include "frontends/alert.h"
 
+using namespace std;
+using namespace lyx::support;
 
 namespace lyx {
 
-using support::subst;
 
-using std::string;
-using std::ostream;
-using std::find;
-using std::replace;
-
-static char const * const chars_url[2] = {"%", "#"};
-
-static char const * const chars_name[6] = {
-       "&", "_", "$", "%", "#", "^"};
-
-
-InsetHyperlink::InsetHyperlink(InsetCommandParams const & p)
-       : InsetCommand(p, "href")
+InsetHyperlink::InsetHyperlink(Buffer * buf, InsetCommandParams const & p)
+       : InsetCommand(buf, p)
 {}
 
 
-CommandInfo const * InsetHyperlink::findInfo(std::string const & /* cmdName */)
+ParamInfo const & InsetHyperlink::findInfo(string const & /* cmdName */)
 {
-       static const char * const paramnames[] =
-               {"name", "target", ""};
-       static const bool isoptional[] = {true, false};
-       static const CommandInfo info = {2, paramnames, isoptional};
-       return &info;
+       static ParamInfo param_info_;
+       if (param_info_.empty()) {
+               param_info_.add("name", ParamInfo::LATEX_OPTIONAL);
+               param_info_.add("target", ParamInfo::LATEX_REQUIRED);
+               param_info_.add("type", ParamInfo::LATEX_REQUIRED);
+       }
+       return param_info_;
 }
 
 
-docstring const InsetHyperlink::getScreenLabel(Buffer const &) const
+docstring InsetHyperlink::screenLabel() const
 {
        docstring const temp = from_ascii("Hyperlink: ");
 
@@ -72,71 +72,144 @@ docstring const InsetHyperlink::getScreenLabel(Buffer const &) const
        return temp + url;
 }
 
+void InsetHyperlink::doDispatch(Cursor & cur, FuncRequest & cmd)
+{
+       switch (cmd.action()) {
+
+       case LFUN_INSET_EDIT:
+               viewTarget();
+               break;
+
+       default:
+               InsetCommand::doDispatch(cur, cmd);
+               break;
+       }
+}
+
+
+bool InsetHyperlink::getStatus(Cursor & cur, FuncRequest const & cmd,
+               FuncStatus & flag) const
+{
+       switch (cmd.action()) {
+       case LFUN_INSET_EDIT:
+               flag.setEnabled(getParam("type").empty() || getParam("type") == "file:");
+               return true;
+
+       default:
+               return InsetCommand::getStatus(cur, cmd, flag);
+       }
+}
+
 
-int InsetHyperlink::latex(Buffer const &, odocstream & os,
-                   OutputParams const & runparams) const
+void InsetHyperlink::viewTarget() const
 {
-       string url = to_utf8(getParam("target"));
+       if (getParam("type") == "file:") {
+               FileName url = makeAbsPath(to_utf8(getParam("target")), buffer().filePath());
+               string const format = formats.getFormatFromFile(url);
+               formats.view(buffer(), url, format);
+       }
+}
 
-       string backslash = "\\";
-       string braces = "{}";
 
-       // The characters in chars_url[] need to be changed to a command when
-       // they are in the url field.
+void InsetHyperlink::latex(otexstream & os,
+                          OutputParams const & runparams) const
+{
+       docstring url = getParam("target");
+       docstring name = getParam("name");
+       static docstring const backslash = from_ascii("\\");
+       static docstring const braces = from_ascii("{}");
+       static char_type const chars_url[2] = {'%', '#'};
+       static char_type const chars_name[6] = {
+               '&', '_', '$', '%', '#', '^'};
+
+       // For the case there is no name given, the target is set as name.
+       // Do this before !url.empty() and !name.empty() to handle characters
+       // like the "%" correctly.
+       if (name.empty())
+               name = url;
+
        if (!url.empty()) {
-               // the chars_url[] characters must be handled for both, url and href
-               for (int k = 0; k < 2; k++) {
-                       for (int i = 0, pos;
-                               (pos = url.find(chars_url[k], i)) != string::npos;
-                               i = pos + 2) {
-                               url.replace(pos,1,backslash + chars_url[k]);
-                       }
+               // Replace the "\" character by its ASCII code according to the
+               // URL specifications because "\" is not allowed in URLs and by
+               // \href. Only do this when the following character is not also
+               // a "\", because "\\" is valid code
+               for (size_t i = 0, pos;
+                       (pos = url.find('\\', i)) != string::npos;
+                       i = pos + 2) {
+                       if (url[pos + 1] != '\\')
+                               url.replace(pos, 1, from_ascii("%5C"));
                }
-       } // end if (!url.empty())
 
-       string name = to_utf8(getParam("name"));
+               // The characters in chars_url[] need to be escaped in the url
+               // field because otherwise LaTeX will fail when the hyperlink is
+               // within an argument of another command, e.g. in a \footnote. It
+               // is important that they are escaped as "\#" and not as "\#{}".
+               for (int k = 0; k < 2; k++)
+                       for (size_t i = 0, pos;
+                               (pos = url.find(chars_url[k], i)) != string::npos;
+                               i = pos + 2)
+                               url.replace(pos, 1, backslash + chars_url[k]);
+               
+               // add "http://" when the type is web (type = empty)
+               // and no "://" or "run:" is given
+               docstring type = getParam("type");
+               if (url.find(from_ascii("://")) == string::npos
+                       && url.find(from_ascii("run:")) == string::npos
+                       && type.empty())
+                       url = from_ascii("http://") + url;
+
+       } // end if (!url.empty())
 
        // The characters in chars_name[] need to be changed to a command when
        // they are in the name field.
        if (!name.empty()) {
-
                // handle the "\" character, but only when the following character
                // is not also a "\", because "\\" is valid code
-               for (int i = 0, pos;
-                       (pos = name.find("\\", i)) != string::npos;
+               docstring const textbackslash = from_ascii("\\textbackslash{}");
+               for (size_t i = 0, pos;
+                       (pos = name.find('\\', i)) != string::npos;
                        i = pos + 2) {
-                       if      (name[pos+1] != '\\')
-                               name.replace(pos,1,"\\textbackslash{}");
+                       if (name[pos + 1] != '\\')
+                               name.replace(pos, 1, textbackslash);
                }
-               for (int k = 0; k < 6; k++) {
-                       for (int i = 0, pos;
+               // The characters in chars_name[] need to be changed to a command
+               // when they are in the name field.
+               // Therefore the treatment of "\" must be the first thing
+               for (int k = 0; k < 6; k++)
+                       for (size_t i = 0, pos;
                                (pos = name.find(chars_name[k], i)) != string::npos;
-                               i = pos + 2) {
-                               name.replace(pos,1,backslash + chars_name[k] + braces);
-                       }
-               }
-               // replace the tilde by the \sim character as suggested in the LaTeX FAQ
-               // for URLs
-               for (int i = 0, pos;
-                       (pos = name.find("~", i)) != string::npos;
+                               i = pos + 2)
+                               name.replace(pos, 1, backslash + chars_name[k] + braces);
+
+               // replace the tilde by the \sim character as suggested in the
+               // LaTeX FAQ for URLs
+               docstring const sim = from_ascii("$\\sim$");
+               for (size_t i = 0, pos;
+                       (pos = name.find('~', i)) != string::npos;
                        i = pos + 1)
-                       name.replace(pos,1,"$\\sim$");
-
+                       name.replace(pos, 1, sim);
+               pair<docstring, docstring> name_latexed =
+                       runparams.encoding->latexString(name, runparams.dryrun);
+               name = name_latexed.first;
+               if (!name_latexed.second.empty()) {
+                       // issue a warning about omitted characters
+                       // FIXME: should be passed to the error dialog
+                       frontend::Alert::warning(_("Uncodable characters"),
+                               bformat(_("The following characters that are used in the href inset are not\n"
+                                         "representable in the current encoding and therefore have been omitted:\n%1$s."),
+                                       name_latexed.second));
+               }
        }  // end if (!name.empty())
        
        if (runparams.moving_arg)
                os << "\\protect";
-       //set the target for the name when no name is given
-       if (!name.empty())
-               os << "\\href{" << from_utf8(url) << "}{" << from_utf8(name) << '}';
-       else
-               os << "\\href{" << from_utf8(url) << "}{" << from_utf8(url) << '}';
-       return 0;
+
+       // output the ready \href command
+       os << "\\href{" << getParam("type") << url << "}{" << name << '}';
 }
 
 
-int InsetHyperlink::plaintext(Buffer const &, odocstream & os,
-                       OutputParams const &) const
+int InsetHyperlink::plaintext(odocstream & os, OutputParams const &) const
 {
        odocstringstream oss;
 
@@ -152,8 +225,7 @@ int InsetHyperlink::plaintext(Buffer const &, odocstream & os,
 }
 
 
-int InsetHyperlink::docbook(Buffer const &, odocstream & os,
-                     OutputParams const &) const
+int InsetHyperlink::docbook(odocstream & os, OutputParams const &) const
 {
        os << "<ulink url=\""
           << subst(getParam("target"), from_ascii("&"), from_ascii("&amp;"))
@@ -164,10 +236,45 @@ int InsetHyperlink::docbook(Buffer const &, odocstream & os,
 }
 
 
-int InsetHyperlink::textString(Buffer const & buf, odocstream & os,
-                      OutputParams const & op) const
+docstring InsetHyperlink::xhtml(XHTMLStream & xs, OutputParams const &) const
+{
+       docstring const & target = 
+               html::htmlize(getParam("target"), XHTMLStream::ESCAPE_AND);
+       docstring const & name   = getParam("name");
+       xs << html::StartTag("a", to_utf8("href=\"" + target + "\""));
+       xs << (name.empty() ? target : name);
+       xs << html::EndTag("a");
+       return docstring();
+}
+
+
+void InsetHyperlink::toString(odocstream & os) const
 {
-       return plaintext(buf, os, op);
+       plaintext(os, OutputParams(0));
+}
+
+
+void InsetHyperlink::forToc(docstring & os, size_t) const
+{
+       docstring const & n = getParam("name");
+       if (!n.empty()) {
+               os += n;
+               return;
+       }
+       os += getParam("target");
+}
+
+
+docstring InsetHyperlink::toolTip(BufferView const & /*bv*/, int /*x*/, int /*y*/) const
+{
+       docstring url = getParam("target");
+       docstring type = getParam("type");
+       docstring guitype = _("www");
+       if (type == "mailto:")
+               guitype = _("email");
+       else if (type == "file:")
+               guitype = _("file");
+       return bformat(_("Hyperlink (%1$s) to %2$s"), guitype, url);
 }
 
 
@@ -177,4 +284,10 @@ void InsetHyperlink::validate(LaTeXFeatures & features) const
 }
 
 
+string InsetHyperlink::contextMenuName() const
+{
+       return "context-hyperlink";
+}
+
+
 } // namespace lyx