Re: [help-texinfo] How to replace nodes with section titles?

[Patrice Dumas]

On Sat, Oct 25, 2014 at 02:51:14PM -0400, Jason Massey wrote:
> Greetings, and thank you for any attention given to this question.
> 
> Would someone please tell me exactly which customization variables need to
> modified (via `--set-customization-variable'), and set to what exact
> values, in order to achieve the following effects (all within the context
> of HTML rendering)?
> 
> * The document is split on nodes.
> * Neither nodes nor node-descriptions appear in the menu: only section
> names appear in the menus.
> * Nodes are not used in the "Next: ... Previous: ... Up:..." navigational
> linkage (at the top and bottom of pages) but rather section names appear.
> 
> ***
> 
> Said simply: I don't want "nodes" to appear in HTML menus or HTML
> navigational linkage; I want only the section-titles displayed.

It is not enough to use --set-customization-variable, the headings
cannot be customized with --set-customization-variable, you need a
customization file.  And in order to have both text and anchors in the
header, there is a need to use a function for the header formatting.

I attach a customization file that does what you want, if I understood
your need well.

The command-line should be along:

texi2any --html --set-customization-variable USE_NODES=0 
--set-customization-variable NODE_NAME_IN_MENU=0 --set-customization-variable 
NODE_NAME_IN_INDEX=0 --init header_with_sections.pm 

Beware that this uses interfaces that are not documented and subject to
changes.

-- 
Pat

sub _default_section_direction($$)
{
  my $self = shift;
  my $direction = shift;

  my $result = undef;
  my $href = $self->_element_direction($self->{'current_element'},
                                           $direction, 'href');
  my $node = $self->_element_direction($self->{'current_element'},
                                           $direction, 'text');
  my $anchor;                              
  if (defined($href) and defined($node) and $node =~ /\S/) {
    my $anchor_attributes = $self->_direction_href_attributes($direction);
    $anchor = "<a href=\"$href\"${anchor_attributes}>$node</a>";
  #} elsif (defined($node) and $node =~ /\S/) {
  #  $anchor = $node; 
  #} else {
  }
  if (defined($anchor)) {
    # i18n
    $result = $self->get_conf('BUTTONS_TEXT')->{$direction}.": $anchor";
  }
  return $result;
}

my @buttons = ([ 'NodeNext', \&_default_section_direction ],
               [ 'NodePrev', \&_default_section_direction ],
               [ 'NodeUp', \&_default_section_direction ], ' ',
               'Contents', 'Index');

foreach my $buttons ('SECTION_BUTTONS', 'CHAPTER_BUTTONS', 'TOP_BUTTONS',
                     'MISC_BUTTONS', 'SECTION_FOOTER_BUTTONS') {
  set_from_init_file($buttons, \@buttons);
}

set_from_init_file('LINKS_BUTTONS',
    ['Top', 'Index', 'Contents', 'About', 'Up', 'NextFile', 'PrevFile']);