[TYPO3-doc] DocBook: migrating existing manuals, the first step

[Thomas Schraitle]

Hi Francois,

Thursday 30 June 2011
>
> > Well, I don't know about the other manuals. I only played with the FLOW3
> > manual so far. The stylesheets are the result of what I've found there.
> 
> The other manuals are in OpenOffice format for now. The goal is to take
> OO's XML format and transforming it to DocBook 5 and come as close as
> possible to our sample manual, so that all existing manuals can be
> migrated to DocBook as smoothly as possible. This thread is not about
> rendering DocBook to HTML and any other format. It's about converting
> legacy docs.

I'm aware of this and didn't mean the HTML rendering process. Actually quite 
the contrary. :) Probably I didn't express myself clearly enough.

What I'm talking about is how to get a good and valid DocBook 5 file _after_ 
the conversion. I've played with the FLOW3 manual which already did that. 
However, the files didn't validate with my TYPO3 schema. One big issue were 
the bridgeheads and the block elements inside paras. These issues are covered 
through my stylesheet, not more, not less. This has nothing to do with 
transforming DocBook to HTML; actually it's a DocBook to DocBook 
transformation. Name it fine-tuning if you like. ;)

Of course, these issues should be better fixed in the original conversion 
process. I don't know if this is possible at all. If it is possible, the 
stylesheets will become obsolete. If not, you can apply them _after_ the 
conversion process.

 
> > One of my stylesheets group the bridgeheads and create a reasonable sect1
> 
> > structure (or sect2, depending on the level):
> Could you do it with sections too, as we decided to use these rather
> sect1, sect2, etc.?

Sure, it's just a matter of adding the right name.


Cheers,
  Tom