[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
How to submit complex docbook document?
OK, I've converted my howto into docbook, and the result is three sgml
files, several png files, a modified collateindex.pl script, and a
mighty scary Makefile.
How do I submit this? According to the HOWTO-squared, CVS isn't
really up, and I'd rather not use a remote CVS in the first place.
And there's some concern in my mind that the usual infrastructure
won't be able to build this properly - I had to fix assorted bugs in
the tools as I went:
- The indexing process is rather half-baked, but works iff:
* You put an id= for every sect containing any indexterms.
Automagical AEN calculation doesn't appear to work for index
purposes with the print backend. The stylesheet seems to
contain code for it, but it just didn't work for me in print
until I id'd all my sects.
* You either don't use the %use-id-as-filename% option, or you
twiddle collateindex.pl to deal with it. If use-id is on, then
the role= attribute in the generate index will be the html
filename rather than the actual id for setc1's. I just
subtracted the .html if there was a trailing .html in the $role
right before printing it out in collateindex.pl.
* Debian potato has collateindex.pl installed in /usr/bin, which
is swell until you figure out that it's got # -*- perl -*- as
the first line instead of #! /usr/bin/perl.
- Pictures were fun. I still haven't put in any vector drawings, but
potato appears to ship dtd 3.0, which hasn't got the mediaobject
stuff. The regular old graphics tag works reasonably if you just
leave off the extension, rather like you do in LaTeX. It takes
some Makefile trickery to have all the proper formats floating
around, but this I just copied from Makefiles I had floating
around. Surprise du jour: pdfjadetex groks png files.
- pdfjadetex produces unsuccessful results with my table, which
features really tall rows that run off the bottom of the page.
Hopefully htmldoc does better? I suppose I should break up the big
rows and eliminate the problem.
Grant Taylor - firstname.lastname@example.org - http://www.picante.com/~gtaylor/
Linux Printing Website and HOWTO: http://www.linuxprinting.org/
I do consulting in most things Unix/Linux/*BSD/Perl/C/C++
To UNSUBSCRIBE, email to email@example.com
with a subject of "unsubscribe". Trouble? Contact firstname.lastname@example.org