> > Actually, we have three main parts : > > - Build > > 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? The problematic part with the builds is however that when you are a translator and need to preview your documentation, phpdoc will be configured for you for your language (entities will be generated for that etc.). While on the php website, we need to have the dynamically generated things for all languages separately, so the approach of having one file-entities.ent, et al. will not be doable... This will need to be changed in the phpdoc build system though as far as I can see, since the XML files will go down to the mirrors preconfigured with the phpdoc configure system and indexed with the livedocs build system. So after all, as we need to change the phpdoc build system, these will not need to be differently handled in livedocs, just the appropriate language files need to be choosen from the dynamic files (eg: file-entities-it.xml, etc). > 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... > Performance wise, it might be better for the template > to request only the parts it needs: > > [...] > > Other functions could do such things as fetching the raw > XML, fetching the HTML rendition of the XML using the > default (very clean) CSS attributed XML->HTML converter; > most templates shouldn't need to do anything to that > if all they need is HTML. > > Using these things as building blocks, we can leave > template authors to do pretty much anything they want. 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... Goba
