Re: DOCBOOK-APPS: Conceptual model for processing DocBook SGML and XML

[Nik Clayton <nik at freebsd dot org>]

On Fri, Dec 21, 2001 at 07:29:23AM +0000, Ian Castle wrote:
> Very useful.
> 
> Is it re-usable?

Yes.  Give me a couple of days (possibly more given it's Xmas) to put a
standard 2 clause BSD license on it.

> One point that I'm not sure is right.
> 
> The output from Jade with the tex-backend is a single file. The diagram,
> if I am reading it correctly, implies that there is a separate output
> for PDF and PS.

Yes.  We've (FreeBSD Doc. Project) found it's worth doing this.

The reason for this is that tex and pdftex have different ideas about
what the default graphic filename extension should be.  So, when we
include graphics in the documents, we omit the extension.

When you run the output through tex it automatically adds a .eps
extension, and does the right thing.  When you run the output through
pdftex it looks for .pdf files first, before falling back to .png files.
This ensures that you get high quality images whatever your final
output.

There are other options you might want to use (such as the url package)
that might only apply to PDF output as well.  So splitting them up is
quite useful.

See the FreeBSD make(1) infrastructure files at

    http://cvsweb.freebsd.org/doc/share/mk/

for the gory details.  It's also worth noting that this toolchain
produced the published version of the second edition of the FreeBSD
Handbook (mall.daemonnews.org, Amazon, etc), so it's certainly good
enough for commercial work.

> I think it would be good if jadetex/pdfjadetex was mentioned as well -
> so that the diagram explicitly names all the pieces of the toolset that
> you need.

Good point.  Brain-o on my part.  I'll add that.

> Also, is it worth mentioning the MIF output of jade/openjade - Not sure
> if anyone uses that?

Definitely worth mentioning.  I've never used it, so wouldn't know what
you do with it after that.  I assume it's not really a final output form
in its own right.

N
-- 
FreeBSD: The Power to Serve             http://www.freebsd.org/
FreeBSD Documentation Project           http://www.freebsd.org/docproj/

          --- 15B8 3FFC DDB4 34B0 AA5F  94B7 93A8 0764 2C37 E375 ---

Attachment: msg00939/pgp00000.pgp
Description: PGP signature