Next: @top Command, Previous: Node Line Requirements, Up: @node [Contents][Index]
The first node of a Texinfo file is the Top node, except in an included file (see Include Files). The Top node should contain a short summary, copying permissions, and a master menu. See The Top Node, for more information on the Top node contents and examples.
Here is a description of the node pointers to be used in the Top node:
Usually, all Info files are available through a single virtual Info tree, constructed from multiple directories. In this case, use ‘(dir)’ as the parent of the Top node; this specifies the top-level node in the dir file, which contains the main menu for the Info system as a whole. (Each directory with Info files is intended to contain a file named dir.)
That’s fine for Info, but for HTML output, one might well want the Up
link from the Top node to go somewhere other than ‘dir.html’.
For example, for GNU the natural place would be
http://www.gnu.org/manual/ (a web page collecting links to most
GNU manuals), better specified as just /manual/
if the manual
will be installed on www.gnu.org
. This can be specified with
the TOP_NODE_UP_URL
customization variable (see HTML Customization Variables), as in
$ makeinfo --html -c TOP_NODE_UP_URL=/manual/ ...
All links to (dir)
will be replaced by the given url.
See Installing an Info File, for more information about installing an Info file in the info directory.
It is usually best to leave the pointers off entirely and let the tools implicitly define them, with this simple result:
@node Top
Next: @top Command, Previous: Node Line Requirements, Up: @node [Contents][Index]