2 * \file InsetHyperlink.cpp
3 * This file is part of LyX, the document processor.
4 * Licence details can be found in the file COPYING.
9 * Full author contact details are available in file CREDITS.
14 #include "InsetHyperlink.h"
17 #include "DispatchResult.h"
19 #include "FuncRequest.h"
20 #include "FuncStatus.h"
21 #include "LaTeXFeatures.h"
22 #include "OutputParams.h"
23 #include "output_xhtml.h"
25 #include "support/docstream.h"
26 #include "support/FileName.h"
27 #include "support/filetools.h"
28 #include "support/gettext.h"
29 #include "support/lstrings.h"
32 using namespace lyx::support;
37 InsetHyperlink::InsetHyperlink(Buffer * buf, InsetCommandParams const & p)
38 : InsetCommand(buf, p, "href")
42 ParamInfo const & InsetHyperlink::findInfo(string const & /* cmdName */)
44 static ParamInfo param_info_;
45 if (param_info_.empty()) {
46 param_info_.add("name", ParamInfo::LATEX_OPTIONAL);
47 param_info_.add("target", ParamInfo::LATEX_REQUIRED);
48 param_info_.add("type", ParamInfo::LATEX_REQUIRED);
54 docstring InsetHyperlink::screenLabel() const
56 docstring const temp = from_ascii("Hyperlink: ");
60 url += getParam("name");
62 url += getParam("target");
65 if (url.length() > 30) {
66 url = url.substr(0, 10) + "..."
67 + url.substr(url.length() - 17, url.length());
72 void InsetHyperlink::doDispatch(Cursor & cur, FuncRequest & cmd)
74 switch (cmd.action()) {
81 InsetCommand::doDispatch(cur, cmd);
87 bool InsetHyperlink::getStatus(Cursor & cur, FuncRequest const & cmd,
88 FuncStatus & flag) const
90 switch (cmd.action()) {
92 flag.setEnabled(getParam("type") == "file:");
96 return InsetCommand::getStatus(cur, cmd, flag);
101 void InsetHyperlink::viewTarget() const
103 // FIXME implement viewer for web url
104 if (getParam("type") != "file:")
106 FileName url = makeAbsPath(to_utf8(getParam("target")), buffer().filePath());
107 string format = formats.getFormatFromFile(url);
108 formats.view(buffer(), url, format);
112 int InsetHyperlink::latex(odocstream & os,
113 OutputParams const & runparams) const
115 docstring url = getParam("target");
116 docstring name = getParam("name");
117 static docstring const backslash = from_ascii("\\");
118 static docstring const braces = from_ascii("{}");
119 static char_type const chars_url[2] = {'%', '#'};
120 static char_type const chars_name[6] = {
121 '&', '_', '$', '%', '#', '^'};
123 // For the case there is no name given, the target is set as name.
124 // Do this before !url.empty() and !name.empty() to handle characters
125 // like the "%" correctly.
130 // Replace the "\" character by its ASCII code according to the
131 // URL specifications because "\" is not allowed in URLs and by
132 // \href. Only do this when the following character is not also
133 // a "\", because "\\" is valid code
134 for (size_t i = 0, pos;
135 (pos = url.find('\\', i)) != string::npos;
137 if (url[pos + 1] != '\\')
138 url.replace(pos, 1, from_ascii("%5C"));
141 // The characters in chars_url[] need to be escaped in the url
142 // field because otherwise LaTeX will fail when the hyperlink is
143 // within an argument of another command, e.g. in a \footnote. It
144 // is important that they are escaped as "\#" and not as "\#{}".
145 for (int k = 0; k < 2; k++)
146 for (size_t i = 0, pos;
147 (pos = url.find(chars_url[k], i)) != string::npos;
149 url.replace(pos, 1, backslash + chars_url[k]);
151 // add "http://" when the type is web (type = empty)
152 // and no "://" or "run:" is given
153 docstring type = getParam("type");
154 if (url.find(from_ascii("://")) == string::npos
155 && url.find(from_ascii("run:")) == string::npos
157 url = from_ascii("http://") + url;
159 } // end if (!url.empty())
161 // The characters in chars_name[] need to be changed to a command when
162 // they are in the name field.
164 // handle the "\" character, but only when the following character
165 // is not also a "\", because "\\" is valid code
166 docstring const textbackslash = from_ascii("\\textbackslash{}");
167 for (size_t i = 0, pos;
168 (pos = name.find('\\', i)) != string::npos;
170 if (name[pos + 1] != '\\')
171 name.replace(pos, 1, textbackslash);
173 // The characters in chars_name[] need to be changed to a command
174 // when they are in the name field.
175 // Therefore the treatment of "\" must be the first thing
176 for (int k = 0; k < 6; k++)
177 for (size_t i = 0, pos;
178 (pos = name.find(chars_name[k], i)) != string::npos;
180 name.replace(pos, 1, backslash + chars_name[k] + braces);
182 // replace the tilde by the \sim character as suggested in the
183 // LaTeX FAQ for URLs
184 docstring const sim = from_ascii("$\\sim$");
185 for (size_t i = 0, pos;
186 (pos = name.find('~', i)) != string::npos;
188 name.replace(pos, 1, sim);
190 } // end if (!name.empty())
192 if (runparams.moving_arg)
195 // output the ready \href command
196 os << "\\href{" << getParam("type") << url << "}{" << name << '}';
202 int InsetHyperlink::plaintext(odocstream & os, OutputParams const &) const
204 odocstringstream oss;
206 oss << '[' << getParam("target");
207 if (getParam("name").empty())
210 oss << "||" << getParam("name") << ']';
212 docstring const str = oss.str();
218 int InsetHyperlink::docbook(odocstream & os, OutputParams const &) const
220 os << "<ulink url=\""
221 << subst(getParam("target"), from_ascii("&"), from_ascii("&"))
229 docstring InsetHyperlink::xhtml(XHTMLStream & xs, OutputParams const &) const
231 docstring const & target = getParam("target");
232 docstring const & name = getParam("name");
233 xs << html::StartTag("a", to_utf8("href=\"" + target + "\""));
234 xs << (name.empty() ? target : name);
235 xs << html::EndTag("a");
240 void InsetHyperlink::tocString(odocstream & os) const
242 plaintext(os, OutputParams(0));
246 docstring InsetHyperlink::toolTip(BufferView const & /*bv*/, int /*x*/, int /*y*/) const
248 docstring url = getParam("target");
249 docstring type = getParam("type");
250 docstring guitype = _("www");
251 if (type == "mailto:")
252 guitype = _("email");
253 else if (type == "file:")
255 return bformat(_("Hyperlink (%1$s) to %2$s"), guitype, url);
259 void InsetHyperlink::validate(LaTeXFeatures & features) const
261 features.require("hyperref");
265 docstring InsetHyperlink::contextMenu(BufferView const &, int, int) const
267 return from_ascii("context-hyperlink");