2011-02-05

An Aid for DocBook Authors

I have a Perl program in work which is being discussed on the docbook-apps mailing list. Executing it at the CLI shows:

$ ./make_index_markup.pl
Usage: ./make_index_markup.pl [-h |--help][options...]  \
    <DocBook xml file(s)...>
Use the '-h' or '--help option for details.


The current version of the program, four companion class modules, and a checksum file for each of their respective sha512 check sums are available at my Dropbox site (http://dropbox.com/) at these links (note the class module names have changed):

  http://dropbox.com/u/18447611/make_index_markup.pl
  http://dropbox.com/u/18447611/DocBookSearch.pm
  http://dropbox.com/u/18447611/DocBookToken.pm
  http://dropbox.com/u/18447611/DocBookTokenList.pm
  http://dropbox.com/u/18447611/DocBookWordHash.pm

The links are the same for the check sum files but with the extension ".sha512" added.

Note: Some people have reported problems with getting the file links. I discovered that here my links didn't always match up with the correct file names which probably caused the problem. Please let me know if you can't get the files.

The text-stripping function works nicely, I think, and the index-making function is almost ready for you to try. It's not completely documented, and it needs more error checking, but maybe you can suggest fixes.

Comments encouraged.

No comments:

Post a Comment