xep-support: [xep-support] Re: troubleshhoting xsl-fo validation

From: Kevin Brown <kevin@renderx.com>
Date: Sun Aug 21 2011 - 14:38:22 PDT

As a primer for everyone who experiences this, you should disable validation
in the formatter. You can always run validation in a separate step if you
would like to validate your FO. NOTE: Validation of FO is only relevant
during the development of an XSL. Since you are using docbook, there should
be no reason to validate the FO. Not to mention that this validation step
takes memory and time, your documents will run faster.

Ways to disable validation:

1) You can just edit the xep.xml configuration file, adding <option
name="VALIDATE" value="false"/> to the core formatter options near the top.
This will disable validation when running XEP all the time.

2) If you are running from the command line (xep.bat), you can use -valid
switch to disable for a specific run

3) If you are using the XEP Assistant, you would need to use method (1)

4) If you are running it in your own program, refer to the API guide for
information on setting specific parameters in the configuration prior to
creating a formatter

There are other ways like passing parameters on the actual Java command line
but the above should be sufficient for all.

Note that *if* you prefer to validate, you still can without aborting the
formatting run. You should be able to use two options in combination in the
xep.xml:

This will still run validation but not abort on errors. If you do this,
disregard errors of the nature "attributename cannot have a value of ''" as
this is the error from the XT parser in 64bit (dropping the values of
attributes randomly). Now, I have not actually set up a system this way but
I would believe it should work and would format but with errors. You can
examine those errors and only pay attention to those that are not missing
attributes.

Kevin Brown
RenderX

-----Original Message-----
From: xep-support-bounces@renderx.com
[mailto:xep-support-bounces@renderx.com] On Behalf Of Kevin Brown
Sent: Sunday, August 21, 2011 2:16 PM
To: 'RenderX Community Support List'; D-Leff@wiu.edu
Subject: [xep-support] Re: troubleshhoting xsl-fo validation errors
formatting docbookx from xep

Dr. Leff:

This issue has been posted to xep-support many times in the past.

RenderX uses Clark's XT processor for the validation stage. That parser
fails on recent releases of Java in a 64-bit environment. There is nothing
wrong with your document, just disable validation when processing.

If you need to know how to do this, please write back with what method you
use to call XEP and we can help you.

Kevin Brown
RenderX

-----Original Message-----
From: xep-support-bounces@renderx.com
[mailto:xep-support-bounces@renderx.com] On Behalf Of Laurence L Leff
Sent: Sunday, August 21, 2011 1:53 PM
To: xep-support@renderx.com
Subject: [xep-support] troubleshhoting xsl-fo validation errors formatting
docbookx from xep

I have a 320-page class notes I Prepared with docbook.
How can I trouble shoot the following type of problem:

e. g.

  (validate
    [error] Attribute 'space-before.optimum' cannot have a value of "".
    [validation total: 1 error]
Parse error: Invalid XSL FO source
'file:/home/leffstudent/225/notes.xml.fo': 1 error found during validation

This is from the XSL-FO that the docbook part of the toolchain creates.
How can I find where the problem is.

I tried searching for "space-before.optimum="" in the XSL-FO file but could
not find it.

I see the folint.xsl that render X graciously provided. I do not see
that it prints out the location in the xsl-fo file that is the problem.
(Hopefully, I can then see the corresponding place in the docbook document
and fix the one that is causing th eproblem.

Now, I do have validation errors against the docbook DTD (xmlto).
As I mentioned
in a support posting (2299) in 2004, they wwere ones that many systems are
tolerant of such as leaving out the paragraphs from a listitem tag before
writing the text to be in the list item.

<section>
<para>
<orderedlist>
<listitem>technically, text should not be in a listitem</listitem>
<listitem>It is not declared with #PCDATA in the dtd </listitem>
</orderedlist>
</para>
</section>

By the way, this version of Render X handles this specific example.

The docbook xsl 1.76 and the Version is 4.18 build 20100322 of March 22nd
2010.

Dr. Laurence Leff Western Illinois University, Macomb IL 61455 ||(309)
298-1315
Stipes 447 Assoc. Prof. of Computer Sci. Pager: 309-367-0787 FAX:
309-298-2302

!DSPAM:87,4e51704663734695721443!

_______________________________________________
(*) To unsubscribe, please visit
http://lists.renderx.com/mailman/options/xep-support
(*) By using the Service, you expressly agree to these Terms of Service
http://w
ww.renderx.com/terms-of-service.html

_______________________________________________
(*) To unsubscribe, please visit http://lists.renderx.com/mailman/options/xep-support
(*) By using the Service, you expressly agree to these Terms of Service http://w
ww.renderx.com/terms-of-service.html
Received on Sun Aug 21 14:39:42 2011

This archive was generated by hypermail 2.1.8 : Sun Aug 21 2011 - 14:39:43 PDT

[xep-support] Re: troubleshhoting xsl-fo validation errors formatting docbookx from xep