[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. ian ------ Original Message ------ Received: Sun, 14 Oct 2007 11:46:30 AM BST From: Dave Pawson <firstname.lastname@example.org> To: "Ian S. Worthington" <email@example.com>Cc: firstname.lastname@example.org 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 the > > 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 I'm > > 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 I > > 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 > >