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:%22Eli+Zaretskii%22" rel="nofollow"><span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name">Eli Zaretskii</span></span></a></span> <span class="date"><a href="/search?l=help-texinfo@gnu.org&q=date:20240315" rel="nofollow">Fri, 15 Mar 2024 00:23:23 -0700</a></span> </p> </div> <div itemprop="articleBody" class="msgBody"> <!--X-Body-of-Message--> <pre>> From: Arsen Arsenović <ar...@aarsen.me> > Cc: Eli Zaretskii <e...@gnu.org>, help-texinfo@gnu.org > Date: Thu, 14 Mar 2024 22:34:00 +0100 > > >> Ha! the amount of grief those changes caused the Emacs maintainers is > >> beyond complaining. We have a script that massages the produced HTML > >> manuals for the Web site, and we run the script each time another > >> Emacs version is released and the manual needs to be updated on the > >> Web site. Every single release of Texinfo, until very recently, > >> would break the script and cause me personally and my colleagues a > >> lot of gray hair wand wasted time. So much so that I seriously > >> considered to stop updating to the latest Texinfo on the system where > >> I usually work on Emacs releases. > > May I ask, what do these scripts do?</pre><pre> Feel free to study admin/admin.el in the Emacs repository, and specifically the few manual-html-fix-* functions there. > If so much fragile post-processing is needed, perhaps Texinfo should > be altered to be more extensible or such.. Maybe. I'm just the janitor here: the procedure for an Emacs release says to run these scripts, so I'm running them, and when they fail for some reason, I get to try to understand the reason and fix it somehow, to be able to upload the latest manuals to the Web site. > IMO, the fact that a GNU project had to resolve to that is a sign of > dysfunction. I think at least some, if not most, of the issues these scripts attempt to fix were already fixed in Texinfo since the scripts where written. I didn't write those scripts and have no knowledge or documentation of the problems they attempt to fix and the reasons for those fixes, except what the code says (which isn't a lot). > Making a stable and abstract way to accommodate for all sorts of needs > isn't very simple, and won't happen overnight, but IMO, if there is > indeed need like this, it should happen. I'm not sure the HTML output of texi2any is (or can be) specifically tailored to the needs of presenting a project's manuals on the GNU Software Web site (<a rel="nofollow" href="https://www.gnu.org/software/">https://www.gnu.org/software/</a>). For example, every manual is generated in 2 forms: a single HTML file and one file per node; texi2any does support each of these outputs, but the requirements from the heading lines and preambles for each one are slightly different, when the above site is targeted. </pre> </div> <div class="msgButtons margintopdouble"> <ul class="overflow"> <li class="msgButtonItems"><a class="button buttonleft " accesskey="p" href="msg03245.html">Previous message</a></li> <li class="msgButtonItems textaligncenter"><a class="button" accesskey="c" href="index.html#03247">View by thread</a></li> <li class="msgButtonItems textaligncenter"><a class="button" accesskey="i" href="maillist.html#03247">View by date</a></li> <li class="msgButtonItems textalignright"><a class="button buttonright " accesskey="n" href="msg03255.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="msg03238.html">HTML <title> node names: Not emitting 'Top (Manual ...</a></span> <span class="sender italic">Arsen Arsenović</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg03239.html">Re: HTML <title> node names: Not emitting 'Top...</a></span> <span class="sender italic">Gavin Smith</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg03240.html">Re: HTML <title> node names: Not emitting ...</a></span> <span class="sender italic">Eli Zaretskii</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg03241.html">Re: HTML <title> node names: Not emitt...</a></span> <span class="sender italic">Arsen Arsenović</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg03242.html">Re: HTML <title> node names: Not e...</a></span> <span class="sender italic">Gavin Smith</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg03243.html">Re: HTML <title> node names: ...</a></span> <span class="sender italic">Eli Zaretskii</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg03244.html">Re: HTML <title> node nam...</a></span> <span class="sender italic">Gavin Smith</span></li> <li><ul> <li class="icons-email"><span class="subject"><a href="msg03245.html">Re: HTML <title> node...</a></span> <span class="sender italic">Arsen Arsenović</span></li> <li class="icons-email tSliceCur"><span class="subject">Re: HTML <title> node...</span> <span class="sender italic">Eli Zaretskii</span></li> <li class="icons-email"><span class="subject"><a href="msg03255.html">Re: HTML <title> node...</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...</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 nam...</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...</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...</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...</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...</a></span> <span class="sender italic">pertusus</span></li> <li class="icons-email"><span class="subject"><a href="msg03256.html">Re: HTML <title> node...</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...</a></span> <span class="sender italic">pertusus</span></li> <li class="icons-email"><span class="subject"><a href="msg03258.html">Re: HTML <title> node...</a></span> <span class="sender italic">Eli Zaretskii</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="8634ss9cxd.fsf@gnu.org"> <input type="hidden" name="relpath" value="help-texinfo@gnu.org/msg03247.html"> <input type="submit" value=" Eli Zaretskii "> </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="msg03245.html" title="p">Previous message</a></li> <li class="icons-next"><a href="msg03255.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">8634ss9cxd.fsf@gnu.org</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:'9e865e862857c60e',t:'MTc3NTUzNjk4NA=='};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>