How to make an email link clickable?

Shaun McCance <shaunm at gnome.org>
Thu Dec 2 11:00:53 EST 2010

On Thu, 2010-12-02 at 15:56 +0100, Mario Blättermann wrote:
> Hi Jim,
> 
> Am Mittwoch, den 01.12.2010, 15:53 -0600 schrieb Jim Campbell:
> > Hi Mario,
> > 
> > 2010/12/1 Jim Campbell <jwcampbell at gmail.com>
> > Hi Mario,
> > 
> > I think that this should work: <link href="mailto:joe at example.com">Joe Smith</link>.
> > 
> > Let me know if this helps,
> > 
> > Jim
> > 
> > If you want the actual email to be listed, I *think* you should also be able to do this: <link href="mailto:joe at example.com"/>. > Let me know if that will work.
> 
> The first one works fine. The mail address is hidden, only the 
> name of the recipient is displayed. That's precisely what I want. 
> The second one also works, but the "mailto:" part is also displayed. 
> Well, it's a cosmetic problem, but the first one is better.

Right, if there's no content in the link tag, and if Mallard
can't resolve a title (as it can for xref attributes), then
the URL is used as the text content. So if you want to show
the email address, you have to provide it.

<link href="mailto:shaunm at gnome.org">shaunm at gnome.org</link>

Or if you want to use <sys> for monospace text (which I prefer
for email addresses), you can use href on any inline.

<sys href="mailto:shaunm at gnome.org">shaunm at gnome.org</sys>

Possibly Mallard should special-case mailto: href attributes
to show only the email address, to get rid of the redundancy.

> Thanks for pointing this out. In any case, somebody should add 
> this to the Mallard manual. As I already wrote, the current 
> recommendations for replacing the "email" tag from DocBook 
> points to <sys> in an inline context or <name> inside an 
> <credit> element. But both are not really useful in this case.

Noted. I'll add that to the DocBook reference. Note that
DocBook does not actually define <email> as creating a
clickable link, but I think Yelp just does it anyway.

--
Shaun