[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: No title in HTML output
From: |
Patrice Dumas |
Subject: |
Re: No title in HTML output |
Date: |
Sat, 1 Jun 2024 12:09:11 +0200 |
On Sat, Jun 01, 2024 at 03:53:36AM +0000, Jean-Christophe Helary wrote:
> I'm wondering why the following texinfo tags do not produce visible output in
> HTML:
>
> @settitle
> @copying
> @titlepage
>
> I can see that the info is buried in <meta> tags with the @settitle contents
> appearing inside <title>, but it seems to me that such information,
> especially since Texinfo is designed for manuals, should be prominently
> displayed as <h1> and as a small paragraph below it.
For copying, if the corresponding text is to be output, @insertcopying
should be used.
For @settitle and @titlepage, in the default case they are indeed not
visible on the first page, with the rationale that for an online format
such as HTML, it is best to directly find the output, "By default the
HTML output is tailored for online viewing with a direct access to the
information at the Top node." (quoting from the development version
manual).
There is, however, some customization variables to get a title in HTML.
First, you can set NO_TOP_NODE_OUTPUT to remove the Top node, if this
what you want, it should add a title based on @titlepage or @settitle.
Second, you can set SHOW_TITLE to get a title with the Top node output.
For example
texi2any --html -c NO_TOP_NODE_OUTPUT=1 mymanual.texi
As a side note, in the upcoming version Texinfo manual, these
customizations should be much better described.
--
Pat
- Re: No title in HTML output,
Patrice Dumas <=
- Re: No title in HTML output, Jean-Christophe Helary, 2024/06/01
- Re: No title in HTML output, Patrice Dumas, 2024/06/02
- Re: No title in HTML output, Jean-Christophe Helary, 2024/06/02
- Re: No title in HTML output, Patrice Dumas, 2024/06/02
- Re: No title in HTML output, Jean-Christophe Helary, 2024/06/02
- Re: No title in HTML output, Gavin Smith, 2024/06/02
- Re: No title in HTML output, Jean-Christophe Helary, 2024/06/02