[jira] Created: (MPXDOC-77) major improvements to the xdoc plugin

[ji...@codehaus.org]

Message:

  A new issue has been created in JIRA.

---------------------------------------------------------------------
View the issue:
  http://jira.codehaus.org/secure/ViewIssue.jspa?key=MPXDOC-77

Here is an overview of the issue:
---------------------------------------------------------------------
        Key: MPXDOC-77
    Summary: major improvements to the xdoc plugin
       Type: Improvement

     Status: Open
   Priority: Major

 Original Estimate: 10 minutes
 Time Spent: Unknown
  Remaining: 10 minutes

    Project: maven-xdoc-plugin

   Assignee: Jason van Zyl
   Reporter: fabrizio giustina

    Created: Sun, 25 Jan 2004 5:04 PM
    Updated: Sun, 25 Jan 2004 5:04 PM

Description:
this patch contains multiple fixes/improvements for the xdoc plugin:

1) generated site is valid tableless XHTML with a fully css layout. This allows user to create totally different look and feel customizing the site css file. For example the navigation bar can be floated, put on the right, etc. Base css has been updated with a slightly different look and feel. Print css is also updated ( MPXDOC-75 )

2) Html elements are now used properly: link lists are <ul>, titles are <h1>, <h2>, etc. This improve accessibility making the site readable also without css or using altenative browsers (screen readers, smart phones without css support...).

3) invalid html produced for sections "name" elements is now fixed, escaping unvalid chars (replaced by "_"). Hrefs for local links (starting with "#") are fixed accordingly during transformation.

4) whitespace in output has been dramatically reduced (only preserved in sensitive elements such as <pre>, <script>, <style>) (also fixes MPXDOC-12 )

5) fixes layout during loading in internet explorer: actually empty images in the nav bar are popping up with the default blue border and text is initially unstyled. No empty images are used anymore ("handles" for nav bar are created using css)

6) this also apply an update version of MAVEN-853: add a doc:jslToSite tag which allows to transform individual file without having to call doc:performJSL on the whole site or setting a bunch of xdoc plugin internal variables. Test cases are added too. (also fixes MPXDOC-68 )

7) xdoc:copy-user-resources also copies resource from maven.gen.docs and not only from maven.docs.src: this allows for reporting plugin to generate images without copying them directly to maven.docs.dest

8) users can add links _after_ the standard project info/project reports section setting the "type" attribute to "footer" for the menu element ($nav/body/menu[@type='footer'])

9) development process URL is not included if maven.xdoc.developmentProcessUrl is empty (fixes MPXDOC-70 )

10) xhtml fix: missing "alt" attribute for images (required in xhtml) is added automatically


I'm attaching an universal diff as well as a zip with all the modified files.



---------------------------------------------------------------------
JIRA INFORMATION:
This message is automatically generated by JIRA.

If you think it was sent incorrectly contact one of the administrators:
   http://jira.codehaus.org/secure/Administrators.jspa

If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org