Here are some good resources: http://www.docbook.org/tdg/en/html/docbook.html
(if you want to see the XML for the above book, goto http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/docbook/defguide/en/) http://www.docbook.org/ http://www.oasis-open.org/specs/docbook.shtml http://nwalsh.com/docbook/ http://sourceforge.net/projects/docbook --- [EMAIL PROTECTED] wrote: > I know my XML/XSLT , but I dont know squat about > docbook, > where would be a good place to find an overview? > > -----Original Message----- > From: Shawn Anderson > [mailto:[EMAIL PROTECTED]] > Sent: 04 October 2001 06:15 > To: [EMAIL PROTECTED] > Subject: RE: DOC Project format > > > I am all for the XML/XSL DocBook concept as well :) > And I'll even help > write the setup/installation section as soon as we > have a central place > to check files in an out.. > > Shawn > > -----Original Message----- > From: [EMAIL PROTECTED] > [mailto:[EMAIL PROTECTED]] > Sent: Thursday, October 04, 2001 5:26 AM > To: [EMAIL PROTECTED] > Subject: RE: DOC Project format > > > XML/XSL is a good technology, > you can have one core document, maintained by > someone > who knows XML/XSL , and translate it to > HTML,TEXT,PDF > and many other formats in seconds. It allows > everyone > to have a copy of the manual in their favorite > format. > The only reason that XML/XSL would get in your way, > is > if you want to make additions to the manual. i'm > sure > in the long term a web interface could be set up > that > would'nt require much in the way of skills to use, > and > in the short term whoever ends up maintaining the > manual > will probably be happy to add your changes. > > -----Original Message----- > From: [EMAIL PROTECTED] > [mailto:[EMAIL PROTECTED]] > Sent: 03 October 2001 19:57 > To: [EMAIL PROTECTED] > Subject: Re: DOC Project format > > > As it turns out, I couldn't care less what tool you > use to make the doc. > If it is poorly organized, and contains the same > information - then it's > not going to be a good tool for someone trying to > understand xmail > server. > > I thought perhaps the installation guide should be > put together to > please the users, and not the programmers. Davide > (and others) already > said they don't want to learn a new publishing > program to create and > maintain this doc. > > David Bitton, I take it you market the docbook tool? > Why not tell us > why you feel that it's the way to go instead of > republishing the same > examples over and over again? Those examples only > demonstrated that the > resulting document would be unpleasant to look at, > and as poorly > organized as the exisitng document. I must admit, I > thought it was a > real nice touch the way you added "Edited By David > Bitton" to the > example doc - and in such nice, big type too! > > So - why docbook? No more samples - just some > answers. Tell us why > thats the "only way" to go. ok? > > ----- Original Message ----- > From: "David Bitton" <[EMAIL PROTECTED]> > To: "Davide Libenzi" <[EMAIL PROTECTED]> > Cc: <[EMAIL PROTECTED]> > Sent: Wednesday, October 03, 2001 7:32 PM > Subject: Re: DOC Project format > > > > What is being missed here is the issue is not > output > > format, but input content management. Ok, so you > want > > RTF, ok... > > > > http://www.codenoevil.com/Xmail/xmail.rtf > > > > all that took was changing two items in the single > > command line command it took to create that. > > > > Ladies and Gentlemen, DocBook is the way for > > management, we can see that. As for output, the > > format is the limit. Oh yeah, I did up a HTML > frames > > version too: > > > > http://www.codenoevil.com/Xmail/frames.htm > > > > but do pardon the broken image links for now. I > > didn't feel like editing the .js file to add > images/ > > to each image filename ('course when we roll this > out, that'll be a > > no-brainer). > > > > Davide, let's get the CVS setup and let me plop > some > > file in and let's get going. > > > > -dave > > > > > > --- Davide Libenzi <[EMAIL PROTECTED]> > wrote: > > > On Wed, 3 Oct 2001 [EMAIL PROTECTED] wrote: > > > > > > > The present documentation is a terrible > struggle > > > to use for these reasons, > > > > as well as grammer, spelling, and other > general > > > english language concerns. > > > > > > You should have seen it two years ago :) > > > > > > Everyone agree on RTF ? > > > > > > > > > > > > > > > - Davide > > > > > > > > > > > > ===== > > ---- > > David B. Bitton > > [EMAIL PROTECTED] > > > > We will overcome. > > http://www.libertyunites.org > > > > __________________________________________________ > > Do You Yahoo!? > > NEW from Yahoo! GeoCities - quick and easy web > site hosting, just > $8.95/month. > > http://geocities.yahoo.com/ps/info1 > > > > ===== ---- David B. Bitton [EMAIL PROTECTED] We will overcome. http://www.libertyunites.org __________________________________________________ Do You Yahoo!? NEW from Yahoo! GeoCities - quick and easy web site hosting, just $8.95/month. http://geocities.yahoo.com/ps/info1
