Re: Simple documents and DocBook output

[Karl Berry]

    Take a look at the following page:

      http://tumbolia.org/

I'm using stock seamonkey 1.1.7 (from CentOS 5), no special xml/html
prefs, and I also get the message
        This XML file does not appear to have any style information
        associated with it. The document tree is shown below.
Anyway.

  :waiting-room: link:misc/common/labyrinth[waiting room]

The question is whether these link targets are intended to be other
sections within the same document, or external links to some other
document.

In the former case, the "Texinfo way" would be to use @xref (or one of
its friends).  In the latter case, @uref (synonyms).

As for a short example boilerplate, perhaps this would be helpful:
http://www.gnu.org/software/texinfo/manual/texinfo/html_node/Short-Sample-Texinfo-File.html#Short-Sample-Texinfo-File

However, in general, for a large multipart document, the usual approach
is to have one top level file and @include each subfile, which is
generally an @chapter or @appendix.  Then you only process the top-level
file -- you don't process each subfile independently.  See the Emacs and
Elisp manuals for (large) examples of this.

Whether it makes sense to maintain a web site as a Texinfo (or Docbook
or AsciiDoc) document is another question.  Wouldn't be my choice.  But
then, I'm a dinosaur ...

Thanks,
Karl