Re: ANNOUNCE: docbook-lint: a tool for checking DocBook source files

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Please compile your docbooklint suggestions on this thread, and I'll
submit one list of suggestions to Dave.

On Fri, 2006-11-10 at 16:26 -0500, David Malcolm wrote:
> [apologies for broad cross-posting]
> 
> I wanted to do a bit of checking of DocBook XML files beyond just DTD
> validation, and couldn't find a tool to so this (is there one?), so I've
> hacked one together (GPL license, python implementation)
> 
> In the spirit of "release early, release often", the code is in public
> Subversion here:
> https://testing.108.redhat.com/source/browse/testing/trunk/incubator/docbooklint/?rev=259
> 
> and the mailing list for the project is:
> dev@xxxxxxxxxxxxxxxxxxxxxx
> (see https://testing.108.redhat.com/servlets/ProjectMailingListList for
> archives and subscription info)
> 
> So far all it does is verify that text inside a <computeroutput> element
> has been properly line-wrapped [1], but the framework is hopefully clean
> enough to be expanded to cover other checks people might want to
> implement that aren't so easy to do with DTDs, for instance:
> - enforcing naming policies for node ids
> - spell-checking
> etc - any other ideas?  Patches welcome.
> 
> Hopefully this will be of use to various projects with DocBook
> toolchains.
> 
> Dave Malcolm
> 
> [1] I ran into some problems where line-endings of screen dumps in my
> DocBook files got garbled, and verbatim monospace rendering was looking
> terrible: the tool detects this now.
> 
> 
-- 
Karsten Wade, RHCE, 108 Editor    ^     Fedora Documentation Project 
 Sr. Developer Relations Mgr.     |  fedoraproject.org/wiki/DocsProject
   quaid.108.redhat.com           |          gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

Attachment: signature.asc
Description: This is a digitally signed message part

-- 
fedora-docs-list mailing list
fedora-docs-list@xxxxxxxxxx
To unsubscribe: 
https://www.redhat.com/mailman/listinfo/fedora-docs-list

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux