Re: Re: Livedocs, the future]
| From: | Wez Furlong | Date: | Tue, 20 Jan 2004 17:12:36 +0000 |
| Subject: | Re: Re: Livedocs, the future] | ||
| References: | 1 2 3 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969358320@lists.php.net to get a copy of this message | ||
> > Keep in mind that there will be two build modes;
> > indexing for on-the-fly doc generation (for doc authors)
> > and whole-docbook pre-generation (for distribution to
> > mirrors).
>
> Are these really two different things?
Yes and no :-)
They are different in that you want on-the-fly mode while
authoring/translating, since it is fast (that was the original
idea for livedocs), but you need to configure the bulk generation
mode for mirror distribution.
> > I'm thinking of a situation where someone might want to
> > render the header at the bottom, or on the right hand
> > side of the main content, or do something else a bit
> > strange.
>
> Currently livedocs just does this strange thing. The sidebar is emitted
> after the page, with a nasty HTML trick...
Yeah, nasty but nice: it allows people using text-only browsers
to read the content before they get to the navigation. :-)
> Good ideas! I also agree that most themes will be sufficiently working
> with the default 'richly styled HTML', since it is very good to apply some
> CSS on it...
Yep.
--Wez.