On Sat, Feb 15, 2025 at 01:16:13PM +0000, Werner LEMBERG wrote: > > > So, this is not different if a @node is before an @XXXheading, it > > may appear in an explicit node direction and in another @node menu. > > Well, the behaviour of `@node` in a split HTML document is to start a > new file. However, this is exactly what I would like to avoid.
Ok, then so you do not want only to demote a node to subsub...section to a level that does not exist with a sectioning command, but you want the element to be an internal content of an 'output unit' delimited by the @node. In that case, indeed, the right solution is the @label/@anchorlabel. > > If @node becomes associated to @XXXheading command, there need to be > > a rule to have the automatic node directions take into account this > > node. [...] Menus can then be generated using the same rules as > > used for automatic node directions. > > The thing is that I don't want a menu for `@XXXheading` elements (or > rather, I don't want HTML splitting for these commands)! I think that in general it is better to consider that the @node is the delimiter for output units. But it is possible in texi2any to use @node or sectioning commands (any type of command except @XXXheading). If you set USE_NODES to 0 and you have a @node associated to an @XXXheading command, the HTML will not be split at the @node, as the sectioning command will be the reference used to set the output units. > > [...] having an @-command more similar to an @anchor associated to > > an @XXXheading, or even to another sectioning command may still be a > > good idea. Indeed, it allows to have a node that contains > > sectioning or heading commands that can be handled more similarly to > > sectioning or heading commands associated to a node but in the same > > output unit. > > Yes, exactly – in HTML split mode, `@anchorlabel` (or `@label`, which > I won't stop advertising :-) plus `@XXXheading` should be on the same > page as the last `@node` command. Indeed. If USE_NODES is 0 they also should be, but for a different reason, because sectioning commands are used for output units delimitation. -- Pat
