Free docbook doclet 5.2.0 software for linux

docbookm project is contributed with LayManSys and contains very simple XSLT drivers for generating XHTML chunks from DocBook XML.
General
The XSLT files for inline markup only recognize a limited DocBook XML subset, see the file para.xsl for details about supported tags.
Especially, there is currently no support for and which are used for code blocks.
section.xsl
This file does not handle more than one section in a file and may not deal well with subsections.
Enhancements:
- xsltoc supports many more tags:
- Code Markup: constant, varname
- Filesystem Markup: filename
- hyperlinks
- lists
- There are some bug fixes in dealing with block elements.
- Improved Stylesheet Documentation.

docbooktoc.xsl is a XSLT file for generating a XHTML table of contents from DocBook XML documents. It is used by the LayManSys project for the documentation.

Parameters

docbooktoc accepts the following parameters:

ext

The names of linked files are determined from the chapters id, which does not contain a filename suffix. This (string) parameter tells docbooktoc the suffix to use. Its default value is html.

style.sheet

This (string) parameter may contain stylesheets for styling the output document. You can pass more than one stylesheet by delimiting their filenames with a white-space (space, tab or newline).

style.type

This (string) parameter contains the MIME type used for content stylesheets. It defaults to text/css.

Program output

docbooktoc generates a XHTML document containing the books meta information (in DocBook XML, this is the subnode bookinfo and than lists all of the books chapters and section in an ordered list. The meta information are both used for generating the < head > as well as the documents header (in the XHTML < body >) and the output is the same like the DocBook XSLT driver for XHTML generates.

The books chapters and sections are presented as a n ordered, nested list, where the chapters are top level items, that contain lists of sections, where a section item again may contain a list of subsections.

You can use the Makefile distributed in this package and the LayManSys documentation for generating the example file toc.html. The make command for this is make test.

DocBook is an SGML/XML vocabulary that enables you to create document content in a presentation-neutral form that captures the logical structure of the content.

Using the DocBook stylesheets, you can publish DocBook content as HTML pages and PDF files and other formats, including man pages, HTML Help, and JavaHelp.

Pod::DocBook is a Perl module to convert pod files to DocBook SGML.

SYNOPSIS

use Pod::DocBook;
pod2docbook( [options] );

Converts files from pod format ( see perlpod ) to DocBook format. It can automatically generate indexes (but SGML does this better) and cross-references.

DocBookWiki can display DocBook documents online. Different from the other applications, which convert a DocBook document into HTML first, in order to display it online, DocBookWiki converts it on the fly, so that the format for saving the document will still be XML (DocBook). In order to do this efficiently, DocBookWiki splits it first into chunks, according to chapters, sections etc.
It can also display a list of books, and for each book it can support multiple languages (translations). When the reader is reading a certain section of a book and he changes the language, he will see the same section in the selected language.
DocBookWiki can also be used to edit a DocBook document online, from the web. Editing is done one section at a time, so the editor selects first the section that he wants to edit, and then edits it. He can edit it in several modes: text (like wiki), xml (the original format), html, latex, texi, etc., whichever is more suitable for him. The changes, however, are always saved in the XML(DocBook) format. Authentication of the editors (with username, password) can be enabled as well, if necessary. Also, different editing permissions can be assigned to editors.
It allows the viewers of a document to download the document in other formats, like PDF, RTF, Plain HTML, LaTeX, PS, etc. which can be generated automatically from the DocBook format.
DocBookWiki will also try to keep a history of all the modifications made to the document, by keeping the document chunks in CVS, and so keeping track of all the changes.
Main features:
- Can display a DocBook document online.
- Can display several documents at once (a list of books).
- Can display each of them in several languages.
- Allows to edit a certain section of a certain book in a certain language.
- Editing can be done in several modes, like text, html, xml, texi, latex etc.
- The basic format is always DocBook (XML), no matter how it is displayed or edited.
- Each document (in each language) can be converted automatically into other formats (like PDF, RTF, LaTeX, etc.) for downloading.
- All the history of modifications is kept (in CVS) and any previous versions of a document can be recovered (by tag or by date) by the admin of the site.
- Authentication of editors can be enabled and admin can assign different access rights and permissions to the editors.

docbook2X is a software package that converts DocBook documents into the GNU Texinfo format and the traditional Unix man page format.
Notable features include table support for man pages, internationalization support, and easy customization of the output using XSLT. (Easy, because unlike other converters, the docbook2X stylesheets are written in a modular way, and the character escaping and whitespace issues with the man-page and Texinfo formats are encapsulated away from the user.)
Enhancements:
- Errors in the Man-XML and Texi-XML DTD were fixed. These DTDs are now used to validate the output coming out of the stylesheets, as part of automated testing. (Validation provides some assurance that the result of the conversions are correct.)
- Several rendering errors were fixed after they had been discovered through automated testing.
- Two HTML files in the docbook2X documentation were accidentally omitted in the last release. They have been added.
- The pure-XSLT-based man-page conversion now supports table markup. The implemented was copied from the one by Michael Smith in the DocBook XSL stylesheets. Many thanks!
- As requested by Daniel Leidert, the man-pages stylesheets now support the segmentedlist, segtitle and seg DocBook elements.
- As suggested by Matthias Kievermagel, docbook2X now supports the code element.

Docbkx Maven Plugin project provides a number of tools for supporting DocBook in a Maven environment. This may seem odd to you, since
1) Maven 2 is supposed to support DocBook natively, relying on Doxia, and
2) there is already another DocBook plugin at mojo.codehaus.org.
The thruth however is that DocBook support in Doxia is fairly limited, mainly because Doxia as a framework supports only a small fraction of the concepts found in DocBook. The subset of DocBook supported by Doxia is not even close to simplified DocBook.
The DocBook plugin at mojo.codehaus.org is supporting a wider range of DocBook markup, and is in fact more similar to the DocBook tools provided with this project. There are however some significant differences:
- The focus is on ease of use.
- You should not be required to install additional stuff to your hard disk in order to generate content from your DocBook sources. Simply adding a reference to the plugin in your POM should be sufficient.
- This project focuses on providing dedicated support for particular DocBook XSL stylesheet distributions. That means you can rely on the dedicated parameterization mechanism of Maven Plugins to pass in the XSLT parameters defined for a particular version and type of XSLT stylesheet.
- In the DocBook Plugin found at mojo.codehaus.org, you will be required to download a specific version of the DocBook XSL stylesheets manually. The plugins packaged contain the stylesheets as well. (In this project, a particular version of the stylesheets is closely tied to a particular version of the plugin. That you means you can always rely on the plugins documentation to know which parameters you could pass in.)
- The DocBook plugin found at mojo.codehaus.org requires you to have access to the Internet in order allow the plugin to resolve URIs. The plugins provided in this project act differently: if your DocBook sources are referening to a DTD, then you can simply add a dependency to a jar file containing the DTD and related entities, and the plugin will make sure that all references will be resolved correctly.
Enhancements:
- Support for Eclipse help files was added.