db-jdo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Michael Bouschen <mbo.t...@spree.de>
Subject Re: Fwd: Trouble generating the site
Date Sun, 30 Mar 2008 20:41:05 GMT
Hi Lukas,

thanks for the feedback, I was able to successfully sun 'maven site' 
with the changes you proposed.

What concerns me is the issue with the slashes in the url. I'm running 
Windows XP: two slashes did not work, but three slashes worked fine:
maven.xdoc.jsl=file:///${basedir}/xdocs/site.jsl

Interestingly suing no slashes worked, too:
maven.xdoc.jsl=file:${basedir}/xdocs/site.jsl

So the question is whether we can find an url that works independend of 
the operating system.

Regards Michael


> [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!
>>


-- 
Michael Bouschen
akquinet tech@spree GmbH
Tempelhofer Ufer 23-24, 10963 Berlin
Bülowstraße 66, 10783 Berlin
Tel.: +49/(0)30/235 520-33  Fax.: +49/(0)30/217 520-12

Geschäftsführung: Martin Weber, Hendrik Saly, Prof. Dr. Christian Roth
Amtsgericht Berlin-Charlottenburg HRB 86780 B
USt.-Id. Nr.: DE 225 964 680


Mime
View raw message