On Tue, 26 Feb 2013, Giorgos Keramidas wrote:
On 2013-02-26 09:45, Tom Rhodes <trho...@freebsd.org> wrote:
On Tue, 26 Feb 2013 14:44:15 +0100 Giorgos Keramidas <keram...@freebsd.org>
wrote:
On 2013-02-26 13:49, Giorgos Keramidas <keram...@freebsd.org> wrote:
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
This sort of diff fixes the title-link rendering:
http://bitbucket.org/keramida/doc-work/commits/d44757193d819f1c950f0236801a37ef77d4711a
But this is admittedly a "hack", and the optimal solution would be to
conditionally render &man.foo.N; differently in <title> elements.
Change the title "Using Run Control (RC)"
This is not the only case where <title> embeds a &man.xxx.N; link, so I
think we need a more general plan for all of them :-)
Agreed. If valid markup produces broken output, it's the toolchain's
fault and should be fixed.
Should man page or other entities be used in titles? Sure. Using a
different term in the title than in the text only makes things less
consistent for the reader.
_______________________________________________
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"