Bug 906105 - Intermittent failures downloading XSL from sourceforge - publican is not using the local catalog?
Intermittent failures downloading XSL from sourceforge - publican is not usin...
Product: Publican
Classification: Community
Component: publican (Show other bugs)
Unspecified Unspecified
unspecified Severity unspecified
: ---
: ---
Assigned To: Jeff Fearn
Depends On:
  Show dependency treegraph
Reported: 2013-01-30 15:41 EST by Stephen Gordon
Modified: 2013-01-30 17:39 EST (History)
2 users (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Last Closed: 2013-01-30 17:39:44 EST
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)

  None (edit)
Description Stephen Gordon 2013-01-30 15:41:43 EST
Description of problem:

I have intermittently been noticing errors coming from publican when it attempts to pull the DocBook XSL from sourceforge:

$ publican build --langs=en-US --formats=html
Setting up en-US
	Processing file tmp/en-US/xml/Common_Content/Conventions.xml -> tmp/en-US/xml/Common_Content/Conventions.xml
	Processing file tmp/en-US/xml/Common_Content/Feedback.xml -> tmp/en-US/xml/Common_Content/Feedback.xml
	Processing file tmp/en-US/xml/Common_Content/Legal_Notice.xml -> tmp/en-US/xml/Common_Content/Legal_Notice.xml
	Processing file tmp/en-US/xml/Common_Content/Program_Listing.xml -> tmp/en-US/xml/Common_Content/Program_Listing.xml
	Processing file tmp/en-US/xml/Common_Content/Revision_History.xml -> tmp/en-US/xml/Common_Content/Revision_History.xml
	Processing file tmp/en-US/xml_tmp/Article_Info.xml -> tmp/en-US/xml/Article_Info.xml
	Processing file tmp/en-US/xml_tmp/Author_Group.xml -> tmp/en-US/xml/Author_Group.xml
	Processing file tmp/en-US/xml_tmp/Release_Notes.xml -> tmp/en-US/xml/Release_Notes.xml
	Processing file tmp/en-US/xml_tmp/Revision_History.xml -> tmp/en-US/xml/Revision_History.xml
Beginning work on en-US
DTD Validation OK
	Starting html
	Using XML::LibXSLT on /usr/share/publican/Common_Content/RedHat/xsl/html.xsl
http://docbook.sourceforge.net/release/xsl/current/xhtml/sections.xsl:1: parser error : Document is empty

http://docbook.sourceforge.net/release/xsl/current/xhtml/sections.xsl:1: parser error : Start tag expected, '<' not found

compilation error: file http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl line 43 element include
xsl:include : unable to load http://docbook.sourceforge.net/release/xsl/current/xhtml/sections.xsl
http://docbook.sourceforge.net/release/xsl/current/xhtml/toc.xsl:1: parser error : Document is empty


Which particular XSL files are reported as being in error varies, but it seems to result from a connectivity issue. What I am wondering is why the local DocBook catalog files aren't being used? If I retry enough times eventually all the XSL is parsed and everything works.

The /usr/share/sgml/docbook/xmlcatalog file on my system contains these entries for DocBook 4.5:

  <public publicId="-//OASIS//ELEMENTS DocBook XML Information Pool V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/dbpoolx.mod"/>
  <public publicId="-//OASIS//DTD DocBook XML V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/docbookx.dtd"/>
  <public publicId="-//OASIS//ENTITIES DocBook XML Character Entities V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/dbcentx.mod"/>
  <public publicId="-//OASIS//ENTITIES DocBook XML Notations V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/dbnotnx.mod"/>
  <public publicId="-//OASIS//ENTITIES DocBook XML Additional General Entities V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/dbgenent.mod"/>
  <public publicId="-//OASIS//ELEMENTS DocBook XML Document Hierarchy V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/dbhierx.mod"/>
  <public publicId="-//OASIS//DTD DocBook XML CALS Table Model V4.5//EN" uri="/usr/share/sgml/docbook/xml-dtd-4.5/calstblx.dtd"/>
  <rewriteSystem systemIdStartString="http://www.oasis-open.org/docbook/xml/4.5" rewritePrefix="/usr/share/sgml/docbook/xml-dtd-4.5"/>
  <rewriteURI uriStartString="http://www.oasis-open.org/docbook/xml/4.5" rewritePrefix="/usr/share/sgml/docbook/xml-dtd-4.5"/>

Running publican with the XML_CATALOG_FILES=/usr/share/sgml/docbook/xmlcatalog environment variable set doesn't seem to effect things. How can I get publican to always use the local catalog? I feel like I must be missing something?

Version-Release number of selected component (if applicable):

Comment 1 Stephen Gordon 2013-01-30 15:44:15 EST
Here is the DTD entry from an impacted article:

<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
Comment 2 Jeff Fearn 2013-01-30 17:39:44 EST
Please ask this kind of support question on the list before opening bugs. It's almost impossible for this to be a publican specific issue.

Note You need to log in before you can comment on or make changes to this bug.