[Opensource] Proposal: Docbook Building

[D Lloyd]

Mike R.,

I would be happy to try to improve the use of docbook.
 In an earlier post, I believe it was Sandra who
thought that the docbook should be broken into
separate html files.  I achieved a simplified
*chunk*ing of the edg into chapter files using
DocBook's chunk.xsl.  It needs some cleanup work yet. 
I have alot of experience in XSLT and love working
with it.  Maybe off list I could receive some guidance
as where this should go.  

I think the idea of allowing documents to be written
in a standard set of html that is then transformed
into the docbook xml via XSLT would be a boom for some
who could then easily use a HTML composer / previewer
and only work with the docbook when they are finished
to see what it will *really* look like.  We could add
some ant targets and / or scripts to facilitate the
document writers.  I would be willing to this also.

I am no docbook guru, but after these few days of
extensively researching it, I will have to agree with
Peter.  This is a great format with alot of
flexibility.  

- David Lloyd

--- Michael Rimov <rimovm at centercomp.com> wrote:
> At 08:51 PM 9/27/2002 +0100, you wrote:
> <snip> <snip>
> >Sandra Cann wrote:
> >>I have an odd question - would the EDG be more
> frequently updated by
> >>community contributors if each of the chapters
> were html?
> >
> >I think the problem from XML is also learning new
> tags and the correct
> >grammar. You can only learn the grammar from a DTD
> (Data Type Dictionary)
> >  or XML Schema or from a sample document (like the
> EDG).
> 
> The: "Docbook The Definitive Guide" is excellent for
> grammar reference.  It 
> tells you what tags can be children of what
> elements.  I've been using it 
> for some time now in that capacity.
> 
> >I think maybe a simple short guide to the some of
> more important
> >DocBook tags may help. Perhaps new chapter
> >"How To Update The EDG Documentation" simply can
> help here and
> >another new chapter which is a template.
> 
> I agree...it's been on my mind for a while.... You
> can even write 
> 'articles' rather than just books with docbook, so
> maybe a docbook article 
> on writing docbook would be good ;)
> 
> A decent procedure of converting html to xml would
> be great so people that 
> were afraid of docbook could submit html conformed
> to a simple set of 
> rules...  I'm not sure how best to consider that.
> 
> 
> >Also this chapter should contain a section how to
> transform the
> >XML into HTML. BTW: DocBook is new to me as well.
> 
> Ditto... I only have tested the docbook waters in
> the last 3 months... Mike 
> N. had created it all before then.
> 
>                                                 
> -Mike
> 
> 
> _______________________________________________
> Opensource mailing list
> Opensource at jcorporate.com
>
http://mail.jcorporate.com/mailman/listinfo/opensource
> Archives:
http://mail.jcorporate.com/pipermail/opensource/


__________________________________________________
Do you Yahoo!?
New DSL Internet Access from SBC & Yahoo!
http://sbc.yahoo.com