Re: HTML node names: Not emitting 'Top (Manual name)'</span></a></span> </h1> <p class="darkgray font13"> <span class="sender pipe"><a href="/search?l=help-texinfo@gnu.org&q=from:%22pertusus%22" rel="nofollow"><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name">pertusus</span></span></a></span> <span class="date"><a href="/search?l=help-texinfo@gnu.org&q=date:20240316" rel="nofollow">Sat, 16 Mar 2024 09:18:48 -0700</a></span> </p> </div> <div itemprop="articleBody" class="msgBody"> <!--X-Body-of-Message--> <pre>On Sat, Mar 16, 2024 at 05:48:39PM +0200, Eli Zaretskii wrote: > > > > 1) the Copyright notice in comments at the very beginning is removed. > > > > > > Is it important? > > > > I think so, it is purposely done that way, I believe, and matches with > > the '(maintain)Copyright Notices' node information: > > The copyright is stated elsewhere anyway, so this is not relevant.</pre><pre> I do not think that the copyright visible in the brower and in comments at the beginning of the HTML file serve the same purpose. The copyright stated in the visible HTML is for people looking at the rendered HTML on a browser, the copyright in comments is for the people looking at the HTML source, so I think that both are relevant. That being said, being able to remove the copyright in comments could be a good test for the API. > > > > 2) the <link href=... rel=... > in <head> are removed, for example > > > > <link href="#Top" rel="start" title="top"> > > > > <link href="#Starting-Rules" rel="next" title="Starting Rules"> > > > > > > Look at how the produced HTML looks vs the one on the site: those > > > links are the "Short TOC", which is completely redundant for reading > > > the manual on-line. > > > > I do not understand that response. Those links are usually not directly > > visible, they are not links appearing directly in the document text, > > they are informations on the page that can be used or not by the > > browsers: > > Then maybe I don't understand what we are talking about. The <link> element appearing in HTML <head> are there to specify relationships between the document and external resources. The code in admin.el removes the <link> elements added by texi2any to associate a page to the top, the next/prev and index as external resources. It is not the same as hyperlinks appearing in the document. My understanding of this is that it is better to have them, but it is not very important either, as this kind of information is in general ignored. > > > > The other main interrogation is about the manual-html-fix-index-1, > > > > manual-html-fix-index-2 defun and closing </div> code in > > > > manual-html-mono > > > > manual-html-node. Most of these codes seems to do nothing nowadays, > > > > except for one thing, adding, right after <body ...> an > > > > <div id="content" class="inner"> > > > > and adding matching </div>. The matching </div> is at the very end of > > > > the > > > > file for the mono manual, and right before the table of contents > > > > in the node split index.html file. It is not clear to me what this div > > > > is used for. > > > > > > Sorry, I don't know. > > > > Can it be omitted? > > I don't want to make changes whose meaning I don't understand. I > trust people who came before me and wrote this code that they were > solving real problems. As long as the results are not obviously > incorrect, I'd rather not change this. Ok. Those <div> should be harmless in general, unless there is another id legitimately also called "content", but my feeling is that there is something wrong going on if they are actually used. It should be easy to use customization variables for the mono case for that, it may be more complicated for the split by node case as the closing </div> appears at a strange place (maybe because of changes in the generated HTML, but I can't know), but I think that it can be done. -- Pat </pre> </div> <div class="msgButtons margintopdouble"> <ul class="overflow"> <li class="msgButtonItems"><a class="button buttonleft " accesskey="p" href="msg03258.html">Previous message</a></li> <li class="msgButtonItems textaligncenter"><a class="button" accesskey="c" href="index.html#03259">View by thread</a></li> <li class="msgButtonItems textaligncenter"><a class="button" accesskey="i" href="maillist.html#03259">View by date</a></li> <li class="msgButtonItems textalignright"><a class="button buttonright " accesskey="n" href="msg03264.html">Next message</a></li> </ul> </div> <a name="tslice"></a> <div class="tSliceList margintopdouble"> <ul class="icons monospace"> <li><ul> <li class="icons-email"><span class="subject"><a href="msg03255.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Patrice Dumas</span></li> <li class="icons-email"><span class="subject"><a href="msg03265.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Patrice Dumas</span></li> </ul></li> <li class="icons-email"><span class="subject"><a href="msg03246.html">Re: HTML <title> node names: Not emitting 'Top (Man...</a></span> <span class="sender italic">Patrice Dumas</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg03248.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Eli Zaretskii</span></li> <li class="icons-email"><span class="subject"><a href="msg03249.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Gavin Smith</span></li> <li class="icons-email"><span class="subject"><a href="msg03251.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Eli Zaretskii</span></li> <li class="icons-email"><span class="subject"><a href="msg03253.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">pertusus</span></li> <li class="icons-email"><span class="subject"><a href="msg03256.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Eli Zaretskii</span></li> <li class="icons-email"><span class="subject"><a href="msg03257.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">pertusus</span></li> <li class="icons-email"><span class="subject"><a href="msg03258.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Eli Zaretskii</span></li> <li class="icons-email tSliceCur"><span class="subject">Re: HTML <title> node names: Not emitting 'Top...</span> <span class="sender italic">pertusus</span></li> <li class="icons-email"><span class="subject"><a href="msg03264.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Gavin Smith</span></li> <li class="icons-email"><span class="subject"><a href="msg03266.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">pertusus</span></li> <li class="icons-email"><span class="subject"><a href="msg03267.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Gavin Smith</span></li> <li class="icons-email"><span class="subject"><a href="msg03261.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Gavin Smith</span></li> <li class="icons-email"><span class="subject"><a href="msg03260.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">pertusus</span></li> <li class="icons-email"><span class="subject"><a href="msg03262.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Gavin Smith</span></li> <li class="icons-email"><span class="subject"><a href="msg03268.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Eli Zaretskii</span></li> <li class="icons-email"><span class="subject"><a href="msg03269.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">pertusus</span></li> <li class="icons-email"><span class="subject"><a href="msg03263.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Arsen Arsenović</span></li> <li class="icons-email"><span class="subject"><a href="msg03250.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Patrice Dumas</span></li> </ul> </ul> </ul> </ul> </ul> </ul> </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: HTML <title> node names: Not emitting 'Top (Manual name)'"> <input type="hidden" name="msgid" value="ZfXGVBergZxWapF2@free.fr"> <input type="hidden" name="relpath" value="help-texinfo@gnu.org/msg03259.html"> <input type="submit" value=" pertusus "> </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="help-texinfo@gnu.org"> <label class="hidden" for="q">Search the site</label> <input class="submittext" type="text" id="q" name="q" placeholder="Search help-texinfo"> <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="/help-texinfo@gnu.org/">help-texinfo - all messages</a></li> <li class="icons-about"><a href="/help-texinfo@gnu.org/info.html">help-texinfo - about the list</a></li> <li class="icons-expand"><a href="/search?l=help-texinfo@gnu.org&q=subject:%22Re%5C%3A+HTML+%3Ctitle%3E+node+names%5C%3A+Not+emitting+%27Top+%5C%28Manual+name%5C%29%27%22&o=newest&f=1" title="e" id="e">Expand</a></li> <li class="icons-prev"><a href="msg03258.html" title="p">Previous message</a></li> <li class="icons-next"><a href="msg03264.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">ZfXGVBergZxWapF2@free.fr</li> </ul> </div> </body> </html>