OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook] Getting started: editors, direct rendering, which DTD?

Many thanks for your reply.

Thank you for your forbearance: my wording was indeed incorrect.  I wish to
*transform* the documents in the reader's browser, if this is at all possible.
 If that means using a simpler document model, that's likely to be fine.

I've started using XMLMind for now writing a simple document using DocBook 5. 

As per the wiki, I've installed the EDE tools to test it, but they don't seem
to like DocBook 5, complaining about an missing DTD.  I don't know if XMLMInd
should have placed a DTD or EDE should work without it for v5.  The forum says
I need to upgrade the stylesheets to get v5 to work but docbook.sourceforge
has several different version and I have no idea which to choose, if indeed
any of them will satisfy my requirement for in-browser transformation.

If all this gives you the indication I have no idea where to go, that would be
about right!

All suggestions appreciated.


------ Original Message ------
Received: Sun, 14 Oct 2007 11:46:30 AM BST
From: Dave Pawson <davep@dpawson.co.uk>
To: "Ian S. Worthington" <ianworthington@usa.net>Cc:
Subject: Re: [docbook] Getting started: editors, direct rendering, which DTD?

> Ian S. Worthington wrote:
> > Hi.
> > 
> > I'm looking to learn some more about DocBook.  I've done some reading at
> > main site and followed up some of the links and am at the stage where I'm
> > getting more confused rather than less: I believe a lot of the information
> > reading may be somewhat out of date.
> Depends where you're reading. Lots hasn't changed for some time,
> in some cases it's only minor changes.
> Ask with specifics.
> > 
> > I'm looking to author small technical documents, on a Windows platform: Am
> > right in thinking XmlMind seems to be the editor of choice for this, even
> > though its Personal Edition is not free for commercial use? Are there any
> > alternatives I should be seriously considering?
> Very personal choice.
> Mine is emacs or oXygen. The latter commercial but will do what you 
> want. Edit and apply style within a package.
> oXygen will work on windows or Linux.
> I've not used XMLMind.
> > 
> > My strong preference is to be able to render DocBook file directly in an
up to
> > date IE browser, rather than build and upload to a website. 
> The latter is usually the former with an ftp transfer, so no difference.
> IE? No interest. Docbook XSLT produces valid HTML which will work in
> all of todays browsers. A big benefit of choosing docbook!
> You don't say, but perhaps imply, that you want to transform it in the 
> browser?
> I'd suggest you become used to working docbook xml through to html on 
> disk, then just refresh the browser view of the html. Makes it easier
> to see what's going on, and deal with any errors.
>   Is this a
> > feasible objective for small documents?
> Very much so.. but it will also scale to quite large document sets too.
>    Should I be looking at the Simplified
> > DTD to do this rather than v4 or v5? 
> Your choice. v5 is ready for use, if you're happy working
> with namespaces and relax NG. v4.5 is stable.
>   If so, can you suggest suitable XSL
> > transforms and CSS style sheets that would get me up to speed quickly?
> Again your choice.
> I find Saxon (saxonica.com) good as an XSLT engine, though Xalan
> is possibly used just as much (if you're a java user).
> Others are available.
> CSS? Less sure. Decide how you want your html decorating
> then take a look at customization and how to get your CSS
> linked into the chain.
> For that I'd heartily recommend
> http://www.sagehill.net/book-description.html
> hth
> -- 
> Dave Pawson
> XSLT, XSL-FO and Docbook FAQ
> http://www.dpawson.co.uk

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]