I experimented with DocBook XML a while back, and also used it professionally for documenting a few software projects, but since the tool support at the time was not very good, I soon abandoned it in favor of hand-written LaTeX, and later LyX. Now I'm considering taking another look at DocBook, and I was wondering, what are the best to...
I'm writing a manual for our new software product... and M$ Word just doesn't cut it. So what is the best software or language to use for creating/editing a software manual? ...
I've seen Best tools for working with DocBook XML documents, but my question is slightly different. Which is the currently recommended formatting toolchain - as opposed to editing tool - for XML DocBook? In Eric Raymond's 'The Art of Unix Programming' from 2003 (an excellent book!), the suggestion is XML-FO (XML Formatting Objects), bu...
I need to create Documentation for a tool (Manually written User Documentation, no Developer/API Documentation from the Source Files). Now, there are about a billion different ways to do it, but I have the following requirements: Needs to be a physical file, so that it can go to SVN Needs to be printable Needs to be readable and search...
Hi there. I was wondering what people use for Documentation and saw that this had already been asked here There seemed to be a lot of votes for LaTeX, I'm an advocate of LaTeX over Word due to its WYGIWYW (What You Get is What You Want) approach. However, its not easy to convince others to use it. I'm inertested to hear from anyone wh...
Hi, I'm just in the middle of revisiting maven. Our team had a bad experience when we last looked at this, as it was during the period when maven was rearchitecting from 1.x to 2.x, so a lot of the dependencies we needed hadn't been moved across to the new repositories. However, I have the time to reconsider now. I am interested in usi...
I'm looking for the ideal tool to use for publishing technical documentation in English & Arabic (in the same document). Should I use DocBook, or is it better to stick with TeX/LaTeX? I am a complete beginner to both systems so there's no legacy stuff to worry about. The two most import factors for me are easy of use and support for Arab...
Hi, Has anyone managed to get DocBook content output to webhelp that does not use a java applet? We are currently designing a web application that uses Ext JS and want to output the DocBook XML content into a format that can be used in parallel with our app (i.e. no Java applets). It is the desire of our management that we stick with D...
I have an article that I'm converting to Docbook format. The article contains small lightweight sections that group together a few (simple) paragraphs. The sections do not contain titles. I cannot find an element in Docbook that denotes this structure. All section-like elements I've found require a title. A close example of what I want...
I'm planing to move project documentation for a fairly big software project from using Microsoft Word files with manual versioning in the filename to storing it in the source version control system. This would all be the type of documentation written by the developer team, release notes, upgrade instructions and administration guideline...
Is there a straightforward way to take docbook content and convert it into DokuWiki content? So far I've only found the DokuWiki plugin that will interpret docbook content and output it in XHTML, but this happens on every page load. I would like to find a way to convert docbook content directly to DokuWiki's native formatting syntax so ...
I am trying to traverse Docbook section nodes. Their structure are as follows: <sect1> <sect2> <sect3> <sect4> <sect5> </sect5> </sect4> </sect3> </sect2> </sect1> So sect1 only have sect2 inside, sect2 will only have sect3 inside, and so on. We can also have multiple sub nod...
I am writing a report using Docbook and i want to customize the way that dblatex converts Docbook to Pdf. This page is supposed to document this issue but it really doesn't help me. How can i learn how the latex style package works? ...
I have only little knowledge about LaTeX, basic formatting, basic math fomulae etc.. I found that LaTeX is hard to configure to my own flavor. Recently, I've heard about Docbook, which is also a typesetting mechanism, but much easier since it uses XML. So, if my main job using LaTeX/Docbook is writing a simple document (not a class bo...
I have a 30-ish page manual in docbook. However, working with docbook is so painful that I don't really update it. I want to switch to restructedText instead. I can't find any direct translator (the best I could find is ezComponents, but it fails on the docbook sgml). Maybe there is an indirect route through RTF or some other format, bu...
As part of the build I'm processing DocBook file that produces multiple HTML files (one file per chapter). I want to postprocess those HTML files and copy them elsewhere. Those files depend on DocBook source, but I cannot know filenames in advance (filenames depend on DocBook source too). I've got rule that sort-of works if the files ...
A long shot here... I am using DocBook 4.5 and wanted to customize whether or not the table of contents is generated. I was looking over the XSD but couldn't find a way to disable it. I found ways to customize it. Could someone point me in the right direction? ...
I was thinking about creating a nice browsable HTML version of my manpages and it turns out that doclifter does just what I want via the manlifter program, since it can lift TROFF into DocBook. However, it got me thinking that it would be quite useful to have a similar library that could lift (X)HTML into DocBook, because operating on t...
So far I've only come across very bland docbook examples. I'm sure DocBook can do a LOT but does anybody have examples where styling is done and a really impressive PDF can be generated? ...
You can specify equations using <equation> and also several others, but what tag must be used to specify code? More specifically, PHP, HTML, CSS and Javascript? Is there a plugin that you can use with OxygenXML to add these features automatically? I need to output as PDF. ...