db-jdo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Craig L Russell <Craig.Russ...@Sun.COM>
Subject Re: Trouble generating the site
Date Sun, 30 Mar 2008 22:31:32 GMT
I think it would be cleaner if we use no slashes at all in the jsl.

I made the changes and can generate the site on my MacOSX with either  
1.0.2 or 1.1. W00t.

I've checked in these changes. If anyone else has any issues please  
continue this thread.

Thanks, Lukas, for the help,

Craig

[CraigRussell:~/apache/jdo/site] clr% svn diff
Index: xdocs/site.jsl
===================================================================
--- xdocs/site.jsl	(revision 642826)
+++ xdocs/site.jsl	(working copy)
@@ -151,7 +151,7 @@
          <div id="leftColumn">
            <div id="navcolumn">
              <x:if select="$nav">
-              <jsl:applyTemplates select="$nav/body/menu[not(@type) |  
@type='header'] | $nav/body/search"/>
+              <jsl:applyTemplates select="$nav/body/menu[not(@type)]  
| $nav/body/menu[@type='header'] | $nav/body/search"/>
              </x:if>
              <jsl:applyTemplates select="$projectNav/body/menu"/>
              <!-- allows user to put menu items after standard  
reports -->
Index: project.properties
===================================================================
--- project.properties	(revision 642826)
+++ project.properties	(working copy)
@@ -3,7 +3,7 @@
  #  
------------------------------------------------------------------------------

  # User Interface
-maven.xdoc.jsl=xdocs/site.jsl
+maven.xdoc.jsl=file:${basedir}/xdocs/site.jsl
  maven.xdoc.date=bottom
  maven.xdoc.date.format=dd MMMM yyyy
  maven.xdoc.version=${pom.currentVersion}



On Mar 30, 2008, at 1:41 PM, Michael Bouschen wrote:

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

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