[#MULE-3504] schema doc XSLT is creating incorrect formatting

Mule

schema doc XSLT is creating incorrect formatting

Created: 01/Jul/08 03:26 PM Updated: 26/Nov/08 12:13 PM

Component/s:

Documentation / Website

Affects Version/s:

2.0.0

Fix Version/s:

2.x Product Backlog

Time Tracking:

Not Specified

Issue Links:

Block

This issue blocks:

~~MULE-3358~~ Update Available Transports section of 2.0 wiki

Labels:	22-candidates docs
User impact:	High
Effort points:	0.5
Affects Docs:	Yes

Description

« Hide

Take a look at http://mule.mulesource.org/display/MULE2USER/EJB+Transport.
The space between the Connector heading and the description below it
appears to be caused by the second line in the HTML that's generated
for this page:

<h2><a name="EJBTransport-Connector"></a>Connector</h2>
<p> <br clear="all" /></p>

<p> Connector for EJB beans.</p>

I'm looking at the XSL, and I can't see why this is happening. I'm
referencing the content like this:

{xslt:output=wiki|style=#http://www.mulesource.org/xslt/mule/schemadoc/2.0/individual-transport-or-module-wiki.xsl|source=#http://www.mulesource.org/schema/mule/ejb/2.0/mule-ejb.xsd|snippetBase=mule-2-current|show=connector}

All

Comments

Work Log

Change History

Transitions

FishEye

Sort Order:

[ Permlink | « Hide ]

Jackie Wheeler added a comment - 24/Jul/08 12:08 PM

This is looking better now, but there are still issues. Look at http://mule.mulesource.org/display/MULE2USER/File+Transport.

1. There is an extra line of space after the heading1 (title).
2. The tables for transformers and filters are not being rendered correctly--the columns are not being treated as columns, so the cells are not aligning.
3. The XSLT has no way of pulling all the filters, so on the filters config ref page, I had to pull each one individually. Ideally, we should have an argument to pull all filters, all transformers, etc.

[ Permlink | « Hide ]

Jackie Wheeler added a comment - 05/Aug/08 01:36 PM

Another problem: the child elements are being repeated when using the single-element-wiki XSLT. See http://www.mulesource.org/display/MULE2USER/REST+Service+Wrapper for an example: the list of child elements are entered twice.

[ Permlink | « Hide ]

Jackie Wheeler added a comment - 14/Oct/08 01:34 PM

Dan is cranking away on this issue.

[ Permlink | « Hide ]

Dan Diephouse added a comment - 14/Oct/08 02:54 PM

I believe I fixed all the issues listed here but #3 now.

Jackie highlighted one other issue - abstract elements are listed under the connector as possible child elements. We should probably list the concrete possibilities (i.e. if abstract-filter is listed, it would be nice to have a link to FooFilter, BarFilter, etc)

[ Permlink | « Hide ]

Jackie Wheeler added a comment - 25/Nov/08 05:21 PM

The other problem is that it's not picking up the inherited documentation. So the attributes listed for an element are just those defined explicitly on that element, not the attributes that are inherited from the parent object that this element extends.