[Previous] [Contents] [Next]

Q & A

Q Why and when should you use the -wxml and -wno-valid parameters when running jade?

A jade is really an SGML tool and it expects you to use the tag minimization symbols in your DTD. To stop jade complaining, use the -wxml parameter.
Jade also normally validates documents before it processes them. Unlike SGML, XML documents do not have to be valid, although they must be well-formed. To suppress jade's validation, use the -wno-valid parameter.

Q Why do you have to hide markup characters (like < ) in a DSSSL style sheet?

A The DSSSL style sheet used by jade is a perfectly standard SGML document. That's why you have to edit or specify the catalog file when you run jade to make sure it can find the DTD for style sheets. Because it is a standard SGML document, the normal rules apply for escaping markup characters that you don't want jade to interpret, but because you cannot escape them using the normal approaches (character entities, for example) you have to hide the markup inside a data keyword or CDATA section.

Q Why does a DSSSL style sheet use start and end instead of left and right?

A DSSSL is completely international. A style sheet can be used to format text from left to right, from right to left, or even vertically. The notions of left and right would be very confusing in this context and so the style sheets use direction-neutral terms such as start, end, before and after.

[Previous] [Contents] [Next]