db-jdo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Lukas Theussl <ltheu...@apache.org>
Subject Re: Fwd: Trouble generating the site
Date Sun, 30 Mar 2008 19:13:07 GMT
[forwarding from the maven user list, I forgot to put jdo-dev in cc]

I had a closer look at this (bugged me because I remember working on a 
fix for custom style sheets before m1.1...  ;)  )

One issue you might experience concerns the number of slashes in the 
file url prefix. Depending on your OS, especially on different Windows 
versions, you might need

maven.xdoc.jsl=file://${basedir}/xdocs/site.jsl

or even three slashes.

The second problem is that you have an xpath syntax error in your custom 
style sheet, line 154 in site.jsl should read:

<jsl:applyTemplates select="$nav/body/menu[not(@type)] | 
$nav/body/menu[@type='header'] | $nav/body/search"/>

With that the jdo site builds fine for me.

HTH,
-Lukas


Craig L Russell wrote:
> Hi,
> 
> We are using maven to generate the Apache JDO site 
> (http://svn.apache.org/viewvc/db/jdo/site/ ).
> 
> We upgraded from Maven 1.0.2 to Maven 1.1 and the site no longer  
> generates.
> 
> The full console output is below [1].
> 
> The error message is
>  >> Unable to obtain goal [site]
>  >> /Users/clr/.maven/cache/maven-xdoc-plugin-1.10.1/xdocs/site.jsl  (No 
> such file or directory)
> 
> Any ideas?
> 
> Thanks,
> 
> Craig
> 
> Begin forwarded message:
> 
>> From: Andy Jefferson <andy@jpox.org>
>> Date: March 29, 2008 12:42:14 AM PDT
>> To: jdo-dev@db.apache.org
>> Subject: Re: Trouble generating the site
>> Reply-To: jdo-dev@db.apache.org
>>
>> Hi,
>>
>> I use Maven 1.0.2 (what I've used for the last 4 yrs ... since it  
>> works and I
>> don't trust the (lack of) backwards compatibility concerns of the  Maven
>> project
>>
>>> I see the same error as Craig if I run 'maven site' in jdo/site. I  also
>>> have a site.jsl in my
>>> .maven/cache/maven-xdoc-plugin-1.10.1/plugin-resources. But there  is a
>>> (different) site.jsl checked in into jdo/site/xdocs. In addition the
>>> file project.properties in jdo/site defines a property
>>> 'maven.xdoc.jsl=xdocs/site.jsl'. If I delete this property 'maven  site'
>>> succeds.
>>
>>
>> There is a different "site.jsl" checked in to xdocs because that is  
>> there to
>> override the default site generation of Maven1. Without it you get a  
>> chunky
>> site with none of the refinements that were added ;-)
>>
>> maven-xdoc-plugin is *supposed* to allow overriding the default  
>> stylesheet via
>> the property "maven.xdoc.jsl" (not that they can be bothered to  document
>> it) ... hence why it is in project.properties pointing to ours. It  
>> currently
>> doesn't have ${basedir} prepended and maybe should have (but that  
>> doesn't
>> solve this issue anyway so ignore that).
>>
>> The maven-xdoc-plugin bundled with Maven1.0.2 accepts that  
>> overriding. The one
>> that comes with Maven1.1 accepts it so far (since it even prints out
>> the "site.jsl" it will use ... correctly) but then tries to append  
>> that name
>> on the end of the plugin workspace!!! duh.
>>
>> If you chase the process through the plugin.jelly of that plugin you  
>> get to
>> <x:parse var="doc" xml="${file}"/>
>> <j:file name="${outFile}" encoding="${outputencoding}"
>>    omitXmlDeclaration="true" outputMode="xml"
>>    prettyPrint="no">
>>   <j:include uri="${stylesheet.toString()}"/>
>> </j:file>
>>
>> which has the correct stylesheet name going in (ours). Where that  
>> then goes to
>> I've no idea.
>>
>> Maybe some Maven team member could comment, and there's some secret  
>> setting
>> that you have to use to get it to work with your own site.jsl file  in 
>> Maven
>> 1.1 ?
>>
>>
>>
>> -- 
>> Andy  (Java Persistent Objects - http://www.jpox.org)
> 
> 
> [1]
> [CraigRussell:~/apache/jdo/site] clr% svn status
> [CraigRussell:~/apache/jdo/site] clr% svn up
> At revision 642332.
> [CraigRussell:~/apache/jdo/site] clr% maven clean  
> site                           __  __
> |  \/  |__ _Apache__ ___
> | |\/| / _` \ V / -_) ' \  ~ intelligent projects ~
> |_|  |_\__,_|\_/\___|_||_|  v. 1.1
> 
> build:start:
> 
> clean:clean:
> xdoc:clean:
> 
> 
> clean:
> 
> site:
> xdoc:register-reports:
> maven-javadoc-plugin:register:
>    [mkdir] Created dir: /Users/clr/apache/jdo/site/target/javadoc
>    [mkdir] Created dir: /Users/clr/apache/jdo/site/target/javadoc/src
> 
> 
> site:run-reports:
> 
> xdoc:init-i18n:
>    [echo] Init the i18n support
> 
> xdoc:init:
>    [echo] Generates the directory structure required for xdocs
>    [mkdir] Created dir: /Users/clr/apache/jdo/site/target/generated- xdocs
>    [mkdir] Created dir: /Users/clr/apache/jdo/site/target/docs
> 
> xdoc:i18n-validation:
>    [echo] Validation of the locale entries
> 
> xdoc:register-reports:
> maven-javadoc-plugin:register:
> 
> 
> xdoc:generate-from-pom:
>    [echo] Generating xdocs from POM ...
> 
> 
> 
> 
> 
> xdoc:transform:
> xdoc:init-i18n:
> 
> xdoc:init:
>    [echo] Generates the directory structure required for xdocs
> 
> xdoc:copy-resources:
>    [copy] Copying 5 files to /Users/clr/apache/jdo/site/target/docs/ style
>    [copy] Copying 16 files to /Users/clr/apache/jdo/site/target/docs/ 
> images
> 
> xdoc:init-i18n:
> 
> xdoc:init:
>    [echo] Generates the directory structure required for xdocs
> Copying user supplied resources.
> 
> xdoc:copy-user-resources:
>    [copy] Copying 17 files to /Users/clr/apache/jdo/site/target/docs
>    [copy] Copied 3 empty directories to 2 empty directories under / 
> Users/clr/apache/jdo/site/target/docs
> 
> xdoc:init-i18n:
> 
> xdoc:init:
>    [echo] Generates the directory structure required for xdocs
> 
> xdoc:jelly-init:
> 
> xdoc:register-reports:
> maven-javadoc-plugin:register:
> 
> 
> xdoc:jelly-transform:
> About to use JSL stylesheet xdocs/site.jsl
>    [echo] en
>    [echo] The current Locale is the default one
>    [echo] Scanning '/Users/clr/apache/jdo/site/target/generated- xdocs'...
>    [echo] Generating /Users/clr/apache/jdo/site/target/docs/ 
> dependencies.html from /Users/clr/apache/jdo/site/target/generated- 
> xdocs/dependencies.xml
> ------------------------------------------------------------------------------- 
> 
>  >> Unable to obtain goal [site]
>  >> /Users/clr/.maven/cache/maven-xdoc-plugin-1.10.1/xdocs/site.jsl  (No 
> such file or directory)
> ------------------------------------------------------------------------------- 
> 
> BUILD FAILED
> ------------------------------------------------------------------------------- 
> 
> Total time   : 20 seconds
> Finished at  : Friday, March 28, 2008 11:47:38 AM PDT
> Final Memory : 8M/15M
> 
> Craig Russell
> Architect, Sun Java Enterprise System http://java.sun.com/products/jdo
> 408 276-5638 mailto:Craig.Russell@sun.com
> P.S. A good JDO? O, Gasp!
> 

Mime
View raw message