Maven Doxia Sitetools

Provide a schema for site.xml

Details

  • Type: Improvement Improvement
  • Status: Closed Closed
  • Priority: Minor Minor
  • Resolution: Fixed
  • Affects Version/s: 1.0-alpha-9
  • Fix Version/s: 1.0
  • Component/s: Decoration model
  • Labels:
    None
  • Number of attachments :
    0

Description

Brett mentioned that a schema for site.xml will be available with maven-site-plugin 2.0 final. Just logging a reminder issue as I don't see it in svn or at http://maven.apache.org/xsd/ .

http://mail-archives.apache.org/mod_mbox/maven-users/200602.mbox/%3c9e3862d80602031847h54438b4ft42e61f5481a3f34f@mail.gmail.com%3e

Issue Links

depends upon

Improvement - An improvement or enhancement to an existing feature or task. MODELLO-49 Support for xml.attribute and xml.listStyle="flat" is missing in xsd plugin

  • Major - Major loss of function.
  • Closed - The issue is considered finished, the resolution is correct. Issues which are not closed can be reopened.
relates to

Bug - A problem which impairs or prevents the functions of the product. MSITE-320 Reference documentation

  • Major - Major loss of function.
  • Closed - The issue is considered finished, the resolution is correct. Issues which are not closed can be reopened.

Activity

Ascending order - Click to sort in descending order
Hide
Permalink
Dennis Lundberg added a comment -

I thought that I'd have a go at this.

There is a schema available for the Maven 1 xdoc plugin, that I will use as a starting ground. It can be found here:
http://maven.apache.org/maven-1.x/plugins/xdoc/maven-navigation.xsd

Should we generate the schema for site.xml using modello?

Show
Dennis Lundberg added a comment - I thought that I'd have a go at this. There is a schema available for the Maven 1 xdoc plugin, that I will use as a starting ground. It can be found here: http://maven.apache.org/maven-1.x/plugins/xdoc/maven-navigation.xsd Should we generate the schema for site.xml using modello?
Hide
Permalink
Vincent Siveton added a comment -

Modello has some bugs so we need to wait for a new release before.

http://www.nabble.com/Provide-site-descriptor--%28was%3A-Missing-site-descriptor%29-tf2042354s177.html#a5622466

Show
Vincent Siveton added a comment - Modello has some bugs so we need to wait for a new release before. http://www.nabble.com/Provide-site-descriptor--%28was%3A-Missing-site-descriptor%29-tf2042354s177.html#a5622466
Hide
Permalink
Dennis Lundberg added a comment -

So, if I understand you correctly Vincent, this issue is in reality a doxia issue. But it is held back because of bugs or missing features in modello?

Show
Dennis Lundberg added a comment - So, if I understand you correctly Vincent, this issue is in reality a doxia issue. But it is held back because of bugs or missing features in modello?
Hide
Permalink
Vincent Siveton added a comment -

The decoration model is a Doxia feature so this issue could be probably in Doxia.
Denis Cabasson fixed small bugs in Modello (like list rendering). IMHO we need to apply these before to deploy decoration descriptor.

Show
Vincent Siveton added a comment - The decoration model is a Doxia feature so this issue could be probably in Doxia. Denis Cabasson fixed small bugs in Modello (like list rendering). IMHO we need to apply these before to deploy decoration descriptor.
Hide
Permalink
Lukas Theussl added a comment -

Dennis, Vincent,

can we close this now with the current decoration-model? The xsd is already at http://maven.apache.org/xsd/decoration-1.0.0.xsd .

Show
Lukas Theussl added a comment - Dennis, Vincent, can we close this now with the current decoration-model? The xsd is already at http://maven.apache.org/xsd/decoration-1.0.0.xsd .
Hide
Permalink
Dennis Lundberg added a comment -

I didn't know we had already published the xsd. I made a diff between the "published" decoration model and one generated from the current 1.0.x branch. Here are the results:

diff published-decoration-1.0.0.xsd generated-decoration-1.0.0.xsd
62c62
<             <xs:element name="logo" minOccurs="0" maxOccurs="unbounded" type="Logo"/>
---
>             <xs:element name="poweredBy" minOccurs="0" maxOccurs="unbounded" type="Logo"/>
82c82
<       <xs:element minOccurs="0" name="custom">
---
>       <xs:element minOccurs="0">
155c155
<       <xs:element minOccurs="0" name="head">
---
>       <xs:element minOccurs="0">
177c177
<             <xs:element name="item" minOccurs="0" maxOccurs="unbounded" type="LinkItem"/>
---
>             <xs:element name="link" minOccurs="0" maxOccurs="unbounded" type="LinkItem"/>
190c190
<             <xs:element name="item" minOccurs="0" maxOccurs="unbounded" type="LinkItem"/>
---
>             <xs:element name="breadcrumb" minOccurs="0" maxOccurs="unbounded" type="LinkItem"/>

This puts us in a difficult position. Have we officially published the xsd? If so, then we must probably change the model version to 1.0.1 or something. That kind of sucks, since it is version 1.0.0 of the product itself. What do you guys think?

Show
Dennis Lundberg added a comment - I didn't know we had already published the xsd. I made a diff between the "published" decoration model and one generated from the current 1.0.x branch. Here are the results: diff published-decoration-1.0.0.xsd generated-decoration-1.0.0.xsd 62c62 < <xs:element name="logo" minOccurs="0" maxOccurs="unbounded" type="Logo"/> --- > <xs:element name="poweredBy" minOccurs="0" maxOccurs="unbounded" type="Logo"/> 82c82 < <xs:element minOccurs="0" name="custom"> --- > <xs:element minOccurs="0"> 155c155 < <xs:element minOccurs="0" name="head"> --- > <xs:element minOccurs="0"> 177c177 < <xs:element name="item" minOccurs="0" maxOccurs="unbounded" type="LinkItem"/> --- > <xs:element name="link" minOccurs="0" maxOccurs="unbounded" type="LinkItem"/> 190c190 < <xs:element name="item" minOccurs="0" maxOccurs="unbounded" type="LinkItem"/> --- > <xs:element name="breadcrumb" minOccurs="0" maxOccurs="unbounded" type="LinkItem"/> This puts us in a difficult position. Have we officially published the xsd? If so, then we must probably change the model version to 1.0.1 or something. That kind of sucks, since it is version 1.0.0 of the product itself. What do you guys think?
Hide
Permalink
Vincent Siveton added a comment -

Sounds like Modello differences. I guess the differences come that no version of modello-maven-plugin is specify [1] or its parent. Try to remake diff with Modello 1.0 in your local repo.

[1] https://svn.apache.org/repos/asf/maven/doxia/doxia-sitetools/branches/doxia-sitetools-1.0.x/doxia-decoration-model/pom.xml

Show
Vincent Siveton added a comment - Sounds like Modello differences. I guess the differences come that no version of modello-maven-plugin is specify [1] or its parent. Try to remake diff with Modello 1.0 in your local repo. [1] https://svn.apache.org/repos/asf/maven/doxia/doxia-sitetools/branches/doxia-sitetools-1.0.x/doxia-decoration-model/pom.xml
Hide
Permalink
Dennis Lundberg added a comment -

You are right Vincent. I have now locked the version for modello-maven-plugin to avoid problems in the future. Modello now produces the exact same xsd as the one published.

Show
Dennis Lundberg added a comment - You are right Vincent. I have now locked the version for modello-maven-plugin to avoid problems in the future. Modello now produces the exact same xsd as the one published.
Hide
Permalink
Herve Boutemy added a comment -

FYI, along with the xsd, model documentation is published

Show
Herve Boutemy added a comment - FYI, along with the xsd, model documentation is published
Hide
Permalink
Dennis Lundberg added a comment -

The correct URL to the model documentation is:
http://maven.apache.org/doxia/doxia-sitetools-1.0.x/doxia-decoration-model/decoration.html

Show
Dennis Lundberg added a comment - The correct URL to the model documentation is: http://maven.apache.org/doxia/doxia-sitetools-1.0.x/doxia-decoration-model/decoration.html

People

  • Assignee:
    Dennis Lundberg
    Reporter:
    Wendy Smoak
Vote (20)
Watch (15)

Dates

  • Created:
    Updated:
    Resolved: