Re: Do we care for manpage links in elements?</span></a></span> </h1> <p class="darkgray font13"> <span class="sender pipe"><a href="/search?l=freebsd-doc@freebsd.org&q=from:%22Giorgos+Keramidas%22" rel="nofollow"><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name">Giorgos Keramidas</span></span></a></span> <span class="date"><a href="/search?l=freebsd-doc@freebsd.org&q=date:20130226" rel="nofollow">Tue, 26 Feb 2013 09:53:59 -0800</a></span> </p> </div> <div itemprop="articleBody" class="msgBody"> <!--X-Body-of-Message--> <pre>On 2013-02-26 10:45, Warren Block <wbl...@wonkity.com> wrote: >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: >>>>> >>>>> <a rel="nofollow" href="http://people.freebsd.org/~keramida/rc8-title-link.png">http://people.freebsd.org/~keramida/rc8-title-link.png</a> >>>> >>>>This sort of diff fixes the title-link rendering: >>>><a rel="nofollow" href="http://bitbucket.org/keramida/doc-work/commits/d44757193d819f1c950f0236801a37ef77d4711a">http://bitbucket.org/keramida/doc-work/commits/d44757193d819f1c950f0236801a37ef77d4711a</a> >>>> >>>>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.</pre><pre> The 'naive' thing to do is to manually remove the &man.xxx.1; links from title elements: <a rel="nofollow" href="http://people.freebsd.org/~keramida//patch-no-title-man-links.diff">http://people.freebsd.org/~keramida//patch-no-title-man-links.diff</a> Replacing the double nested <a>...</a> element does indeed fix the rendered output. I'm gonig to dig into the DSSSL code that renders <email> elements to see if I can selectively disable this when <email>'s parent element is a <title>. "It shouldn't be so hard" (famous last words). _______________________________________________ freebsd-doc@freebsd.org mailing list <a rel="nofollow" href="http://lists.freebsd.org/mailman/listinfo/freebsd-doc">http://lists.freebsd.org/mailman/listinfo/freebsd-doc</a> To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org" </pre> </div> <div class="msgButtons margintopdouble"> <ul class="overflow"> <li class="msgButtonItems"><a class="button buttonleft " accesskey="p" href="msg00037.html">Previous message</a></li> <li class="msgButtonItems textaligncenter"><a class="button" accesskey="c" href="thrd2.html#00038">View by thread</a></li> <li class="msgButtonItems textaligncenter"><a class="button" accesskey="i" href="mail2.html#00038">View by date</a></li> <li class="msgButtonItems textalignright"><a class="button buttonright " accesskey="n" href="msg00034.html">Next message</a></li> </ul> </div> <a name="tslice"></a> <div class="tSliceList margintopdouble"> <ul class="icons monospace"> <li class="icons-email"><span class="subject"><a href="msg00032.html">Do we care for manpage links in <title> elements?</a></span> <span class="sender italic">Giorgos Keramidas</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg00033.html">Re: Do we care for manpage links in <title> e...</a></span> <span class="sender italic">Giorgos Keramidas</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg00035.html">Re: Do we care for manpage links in <title&g...</a></span> <span class="sender italic">Tom Rhodes</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg00036.html">Re: Do we care for manpage links in <tit...</a></span> <span class="sender italic">Giorgos Keramidas</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg00037.html">Re: Do we care for manpage links in <...</a></span> <span class="sender italic">Warren Block</span></li> <li><ul> <li class="icons-email tSliceCur"><span class="subject">Re: Do we care for manpage links i...</span> <span class="sender italic">Giorgos Keramidas</span></li> </ul></li> </ul></li> </ul></li> </ul></li> <li class="icons-email"><span class="subject"><a href="msg00034.html">Re: Do we care for manpage links in <title> e...</a></span> <span class="sender italic">Benjamin Kaduk</span></li> </ul> </ul> </div> <div class="overflow msgActions margintopdouble"> <div class="msgReply" > <h2> Reply via email to </h2> <form method="POST" action="/mailto.php"> <input type="hidden" name="subject" value="Re: Do we care for manpage links in <title> elements?"> <input type="hidden" name="msgid" value="20130226175343.GB10642@saturn"> <input type="hidden" name="relpath" value="freebsd-doc@freebsd.org/msg00038.html"> <input type="submit" value=" Giorgos Keramidas "> </form> </div> </div> </div> <div class="aside" role="complementary"> <div class="logo"> <a href="/"><img src="/logo.png" width=247 height=88 alt="The Mail Archive"></a> </div> <form class="overflow" action="/search" method="get"> <input type="hidden" name="l" value="freebsd-doc@freebsd.org"> <label class="hidden" for="q">Search the site</label> <input class="submittext" type="text" id="q" name="q" placeholder="Search freebsd-doc"> <input class="submitbutton" name="submit" type="image" src="/submit.png" alt="Submit"> </form> <div class="nav margintop" id="nav" role="navigation"> <ul class="icons font16"> <li class="icons-home"><a href="/">The Mail Archive home</a></li> <li class="icons-list"><a href="/freebsd-doc@freebsd.org/">freebsd-doc - all messages</a></li> <li class="icons-about"><a href="/freebsd-doc@freebsd.org/info.html">freebsd-doc - about the list</a></li> <li class="icons-expand"><a href="/search?l=freebsd-doc@freebsd.org&q=subject:%22Re%5C%3A+Do+we+care+for+manpage+links+in+%3Ctitle%3E+elements%5C%3F%22&o=newest&f=1" title="e" id="e">Expand</a></li> <li class="icons-prev"><a href="msg00037.html" title="p">Previous message</a></li> <li class="icons-next"><a href="msg00034.html" title="n">Next message</a></li> </ul> </div> <div class="listlogo margintopdouble"> </div> <div class="margintopdouble"> </div> </div> </div> <div class="footer" role="contentinfo"> <ul> <li><a href="/">The Mail Archive home</a></li> <li><a href="/faq.html#newlist">Add your mailing list</a></li> <li><a href="/faq.html">FAQ</a></li> <li><a href="/faq.html#support">Support</a></li> <li><a href="/faq.html#privacy">Privacy</a></li> <li class="darkgray">20130226175343.GB10642@saturn</li> </ul> </div> </body> </html> <script>(function(){function c(){var b=a.contentDocument||a.contentWindow.document;if(b){var d=b.createElement('script');d.innerHTML="window.__CF$cv$params={r:'9d6a2d5e985d99fe',t:'MTc3MjU1NzAxNA=='};var a=document.createElement('script');a.src='/cdn-cgi/challenge-platform/scripts/jsd/main.js';document.getElementsByTagName('head')[0].appendChild(a);";b.getElementsByTagName('head')[0].appendChild(d)}}if(document.body){var a=document.createElement('iframe');a.height=1;a.width=1;a.style.position='absolute';a.style.top=0;a.style.left=0;a.style.border='none';a.style.visibility='hidden';document.body.appendChild(a);if('loading'!==document.readyState)c();else if(window.addEventListener)document.addEventListener('DOMContentLoaded',c);else{var e=document.onreadystatechange||function(){};document.onreadystatechange=function(b){e(b);'loading'!==document.readyState&&(document.onreadystatechange=e,c())}}}})();</script>