Bug 906105

Summary: Intermittent failures downloading XSL from sourceforge - publican is not using the local catalog?
Product: [Community] Publican Reporter: Stephen Gordon <sgordon>
Component: publicanAssignee: Jeff Fearn 🐞 <jfearn>
Status: CLOSED NOTABUG QA Contact: tools-bugs <tools-bugs>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 3.1CC: rglasz, rlandman+disabled
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2013-01-30 22:39:44 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Stephen Gordon 2013-01-30 20:41:43 UTC
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):

publican-3.0-0.fc17.t216.noarch
docbook-style-xsl-1.76.1-5.fc17.noarch
docbook-dtds-1.0-56.fc17.noarch
docbook5-schemas-5.0-6.fc17.noarch

Comment 1 Stephen Gordon 2013-01-30 20:44:15 UTC
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">
%BOOK_ENTITIES;
]>

Comment 2 Jeff Fearn 🐞 2013-01-30 22:39:44 UTC
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.