Re: Docbook notes
Bram Moolenaar <[email protected]>
| Newsgroups | gmane.comp.tools.aap.user |
|---|---|
| Message-ID | <[email protected]> |
Jean Jordaan wrote: > > I suppose I'll be looking for a tool to do the conversion then. > > I don't *think* you need to change anything in the markup itself. > Hopefully only the DOCTYPE at the top of the file. That would save a lot of work, and I can try it out in a simple way. I'll still have to locate the XML DTD then. I'm using FreeBSD with KDE, perhaps it's already somewhere on my system... [PS: Dan Sharp already gave a URL that has these files] > > XML is a nice format for computers, not for humans! > > Agreed, although writing DocBook XML is miles away from machine- > oriented XML like SOAP. Bibliographies and complicated tables > can get pretty hairy, but I found the markup was mostly quite > light; lighter than HTML, certainly. > > You probably don't really need to write the docs directly in > full-blown DocBook anyway. There are some alternatives. I'll > list a couple. Well, these alternatives still require editing text in some kind of special format that makes you look in the docs about the detailed syntax. None of them is WYSIWYG. Using a restricted set of the docbook macros doesn't make it much simpler. -- Far out in the uncharted backwaters of the unfashionable end of the Western Spiral arm of the Galaxy lies a small unregarded yellow sun. Orbiting this at a distance of roughly ninety-eight million miles is an utterly insignificant little blue-green planet whose ape-descended life forms are so amazingly primitive that they still think digital watches are a pretty neat idea ... -- Douglas Adams, "The Hitchhiker's Guide to the Galaxy" /// Bram Moolenaar -- [email protected] -- http://www.Moolenaar.net \\\ /// Creator of Vim - Vi IMproved -- http://www.Vim.org \\\ \\\ Project leader for A-A-P -- http://www.A-A-P.org /// \\\ Help AIDS victims, buy here: http://ICCF-Holland.org/click1.html /// ------------------------------------------------------- This SF.Net email sponsored by: Free pre-built ASP.NET sites including Data Reports, E-commerce, Portals, and Forums are available now. Download today and enter to win an XBOX or Visual Studio .NET. http://aspnet.click-url.com/go/psa00100003ave/direct;at.aspnet_072303_01/01