[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [help-texinfo] <title> in multi-node HTML

From: Akim Demaille
Subject: Re: [help-texinfo] <title> in multi-node HTML
Date: Mon, 7 Jan 2019 07:05:40 +0100

Hi Gavin,

Happy new year!

> Le 1 janv. 2019 à 00:49, Gavin Smith <address@hidden> a écrit :
> On Sun, Nov 11, 2018 at 06:41:02PM +0100, Akim Demaille wrote:
>> The HTML reads:
>> <title>Understanding (Bison 3.2.1)</title>
>> Is there a means to use the section name rather that the node name in the 
>> generated HTML?  It???s quite common to have a very short node name, but a 
>> fully blown section name, so the latter seems more appropriate to me.
>> Even in Texinfo???s own documentation, you have for instance the title « One 
>> argument », which hardly makes sense alone:
>> https://www.gnu.org/software/texinfo/manual/texinfo/html_node/One-Argument.html
>> but the page is
>> 6.4.1 @xref with One Argument
> I don't see why there couldn't be an option to use the name of the 
> chapter, section or sub-section as the HTML <title>.  The title isn't 
> seen very much in any case: in window title bars, on browser tabs and in 
> search engine results.  My feeling is that the default should remain 
> as the node name given as the argument to @node.


> It's the safer option to keep things as they are.
> Here's code to add an option SECTION_NAME_IN_TITLE, used by passing 
> "-c SECTION_NAME_IN_TITLE=1" to texi2any.  Any comments on this?

Seems right, AFAICT.  Thanks!

(Too bad Perl does not have an operator similar to Swift's "?." or Ruby's "&.", 
that propagate nil from left to right.)

reply via email to

[Prev in Thread] Current Thread [Next in Thread]