bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Simple documents and DocBook output


From: Noah Slater
Subject: Re: Simple documents and DocBook output
Date: Wed, 24 Dec 2008 01:37:56 +0000
User-agent: Mutt/1.5.18 (2008-05-17)

On Tue, Dec 23, 2008 at 07:28:43PM -0600, Karl Berry wrote:
>     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.

Argh, this isn't good.

> As for a short example boilerplate, perhaps this would be helpful:

Yeah, I was working through these example documents, but what concerned me was
that the manual was aimed (naturally) at large document authors, whereas my use
case is someone who's wanting to author small articles, usually containing no
subsections. When I experimented with this, and the makeinfo command generated a
DocBook file with my text in the <abstract> I figured that there was some
recommended way to produce a simple document with only one root section.

> 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.

This is interesting, thanks you. I will have a look for my GNU manual.

> 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 ...

Well, I'm not talking about maintaining a whole web site as a single documents.
I'm talking about a system that would use a single Texinfo, AsciiDoc, or
DocBook document and use it to make a web page. You would have a collection of
these documents, and they would be converted into HTML to make your site.

-- 
Noah Slater, http://tumbolia.org/nslater




reply via email to

[Prev in Thread] Current Thread [Next in Thread]