Date: Tue, 26 Feb 2013 13:49:34 +0100 From: Giorgos Keramidas <keramida@FreeBSD.org> To: freebsd-doc@freebsd.org Subject: Do we care for manpage links in <title> elements? Message-ID: <20130226124932.GA7258@saturn>
next in thread | raw e-mail | index | archive | help
--HcAYCG3uE/tztfnV
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Hi everyone,
I just noticed that in all the places where a chapter <title> includes a
&an.xxx.section; entity the rendering in HTML output sucks a bit. Note
how there are two separate links in the 'Using rc(8) Under FreeBSD'
title in the following screenshot:
http://people.freebsd.org/~keramida/rc8-title-link.png
The <title> itself becomes an <a>...</a> element, but when a &man.xxx.y;
macro is included in the title, the final rendering becomes:
<a link="foo">
some text
<a href="manpage link">manpage name</a>
maybe more text
</a>
The embedded <a> terminates the first link, and the first </a>
terminates the second link, so we end up with the broken rendering
pf the screenshot and two _different_ links in the same sentence.
Is there any way to automatically detect this and translate the
embedded <a> element that &man.xxx.y; generates to something harmless,
like <span>?
If not, do we really care for &man.xxx.y; in titles, or should we just
replace them with plain text?
--HcAYCG3uE/tztfnV
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: Digital signature
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
iEYEARECAAYFAlEsr1wACgkQ1g+UGjGGA7YX8ACgqJgE0IWZLlAy0E9tqw88HLqn
J4AAn3znpB0IxLTv0GHJAizndnkil1vL
=Ooln
-----END PGP SIGNATURE-----
--HcAYCG3uE/tztfnV--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20130226124932.GA7258>