[MSITE-440] Site generation fails if unable to retrieve schema (in offline mode)

• Type: Bug
• Status: Closed
• Priority: Critical
• Resolution: Fixed
• Affects Version/s: 2.1
• Fix Version/s: 2.1.1
• Component/s: doxia integration
• Environment: Maven 2.2.1; Site Plugin 2.1-SNAPSHOT; Doxia 1.1.2
• Assignee: Lukas Theussl
• Reporter: David Meibusch
• Created: 10/Dec/09 19:55
• Updated: 07/Apr/15 18:15
• Resolved: 01/Jun/10 01:35

Description

The changes included DOXIA-263 to validate XML documents retrieves the DTD/Schema to validate the document.

For example, for FML, xsi:schemaLocation="http://maven.apache.org/FML/1.0.1 http://maven.apache.org/xsd/fml-1.0.1.xsd" the Doxia FML parser will retrieve http://maven.apache.org/xsd/fml-1.0.1.xsd before validating the document.

If in offline mode, or in an environment without connectivity to apache.org, site generation will appear to hang until the HTTP client code times out (which is many minutes for each retry) then fail.

Workaround: remove the schema definition from the document (and lose validation when online and IDE editing support).

Perhaps each Doxia parser should have some embedded schemas (for FML, at least http://maven.apache.org/FML/1.0.1) so the entities can be resolved locally.

Or at least a property for disabling document validation.

I don't think v2.1 can be released with this issue unresolved.

Issue Links

• depends upon: DOXIA-388 Use internal xdoc and fml xsds for validation when in offline mode
• depends upon: MSITE-474 Make validation configurable
• is related to: DOXIA-263 Improve validation of input documents
• is related to: MSITE-47 validate input format of docs
• is superceded by: MSITE-483 Site validation fails in off-line mode