From: Nigel W. <ni...@e-...> - 2004-01-12 02:46:45
|
> I'm a little confused with the [MAJ] and [MIN] tags. Can > these go anywhere in the paragraph? > I understand the other tags, as they're close to HTML. > > CQ Ok. Got food. The main problem is that DocBook needs a <para> to be fairly atomic, ie, not interrupted with any new <section>'s. This may not be entirely correct(yet), but to allow the freedom, I'm adding a meta-data layer to the paragraph. This metadata stores: New section(y/n), and title New subsection(y/n), and title Close the current sub-section(y/n) Close the current section(y/n) But it's not in yet. In the mean time, if you could use a separate paragraph for each logical section/subsection, it'll make adding the layer much easier. If you're making a new section, put at the top of the paragraph: [MAJ][TTL]Title of new section[/TTL] If you start a new subsection, create a new paragraph, and do the following: [MIN][TTL]Title of new subsection[/TTL] And when you're finishing a (sub)section, use: [/MIN] or [/MAJ] This'll make it easier to pull the meta-data when I convert it. It also keeps it easy for the HTML renderer(and subsequent PDF renderer) to produce good outputs. Clear as mud? I'd better go update the 'Site Usage' page to contain this info. Good Luck! Nige. |