Comments on: Kick-starting a DocBook Project

By: Remko Tronçon

Remko Tronçon — Wed, 21 Apr 2010 06:33:48 +0000

@Ron 4.X

The tool support (xmllint, xsltproc, docbook-xsl) for DocBook 5 isn’t perfect yet last time i checked, which is why i’m waiting to use DocBook 5. However, I think you can use the kit with 5 as is, but you’ll get a bunch of warnings from the stylesheets and the processor.

By: Ron Smith

Ron Smith — Wed, 21 Apr 2010 04:46:41 +0000

What version of Docbook does the kit support? 4.X, 5?

By: Yet Another JavaScript Blog » docbook-ant-quickstart-project

Yet Another JavaScript Blog » docbook-ant-quickstart-project — Fri, 29 Jan 2010 00:28:21 +0000

[...] for a similar project, and, surprisingly, didn’t find too much in this space. I did find one project which has precisely the same goals, but it relies on make and other command-line tools typically [...]

By: El Tramo » Integrating DocBook with WordPress

El Tramo » Integrating DocBook with WordPress — Sat, 27 Jun 2009 18:28:39 +0000

[...] added a DocBook XSL customization layer to my DocBook Kit that outputs an HTML/PHP version of the document that automatically integrates with a WordPress [...]

By: JRDegan

JRDegan — Mon, 11 May 2009 08:29:01 +0000

Thanks for that, in particular the sample customization layer. I have been bending my brain trying to get my head around that for a while and longing for a straight-forward example to push me along. This helps enormously.
For the record, I am using an editor from a company in Romania and I have found it to be excellent. Not open source, but the company is paying, so what the hell?
All the best.

By: Jonas

Jonas — Wed, 06 May 2009 18:06:21 +0000

Great!
Conglomerate is a free visual/source XML editor under GNU/Linux which have Docbook templates (Article, Book,…). I recommend it.

By: stpeter

stpeter — Thu, 30 Apr 2009 02:12:47 +0000

You rock. This looks like a great “starter kit” for working with DocBook.

By: Remko Tronçon

Remko Tronçon — Wed, 29 Apr 2009 22:16:19 +0000

@Matěj A good question. I used good ol’ Vim (without the XML plugin I found on the net, it annoyed me too much). Writing XML in Vim sounds painful, but it wasn’t, really (and I think my co-authors on the XMPP book, who also used Vim, agree).

For a non-commercial article, I did a test-drive of XMLMind, which is nice because it gives you WYSIWYG, and even expands XIncludes inline, making it very easy to review and correct the document. It’s also relatively easy to add new entries to biographies etc. However, I quickly went back to Vim, because any type of restructuring is very hard in a restrictive editor like XMLMind.

Personally, I would still recommend using your own favorite editor, be it Vim, Emacs, Textmate, or something else. And if you have good plugins for XML that don’t stand in your way, all the better!

By: Matěj Cepl

Matěj Cepl — Wed, 29 Apr 2009 22:04:54 +0000

Well, the obvious question: what did you use for actually writing the text? If it is emacs w/nxml-mode (I don’t there is much more else available in open source world), did you use Emacs before, or did you install it just because of the book?